Release 3.6.0 for Phalcon 5.16

Author: jturbide

.github/workflows/main.yml

@@ -19,11 +19,11 @@ on:
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  PHALCON_VERSION: 5.15.0
-  PHALCON_PECL_URL: https://github.com/phalcon/cphalcon/releases/download/v5.15.0/phalcon-pecl.tgz
+  PHALCON_VERSION: 5.16.0
+  PHALCON_PECL_URL: https://github.com/phalcon/cphalcon/releases/download/v5.16.0/phalcon-pecl.tgz
   # PHP extensions required by Composer
   EXTENSIONS: apcu, gettext, gd, igbinary, imagick, intl, json, mbstring, msgpack, memcached, sqlite3, yaml, redis, openssl, swoole, :memcache, :psr
-  EXTENSIONS_CACHE_KEY: php-ext-v4-php8.5-phalcon-helper-5.15.0
+  EXTENSIONS_CACHE_KEY: php-ext-v4-php8.5-phalcon-helper-5.16.0
 
 permissions:
   contents: read
@@ -67,7 +67,7 @@ jobs:
           extensions: ${{ env.EXTENSIONS }}
           tools: composer
 
-      - name: Ensure Phalcon 5.15.0
+      - name: Ensure Phalcon 5.16.0
         run: bash .github/scripts/install-phalcon.sh
 
       - uses: ramsey/composer-install@v4
@@ -119,7 +119,7 @@ jobs:
           extensions: ${{ env.EXTENSIONS }}
           tools: composer, phpcs
 
-      - name: Ensure Phalcon 5.15.0
+      - name: Ensure Phalcon 5.16.0
         run: bash .github/scripts/install-phalcon.sh
 
       - uses: ramsey/composer-install@v4
@@ -168,7 +168,7 @@ jobs:
           extensions: ${{ env.EXTENSIONS }}
           tools: composer, phpstan
 
-      - name: Ensure Phalcon 5.15.0
+      - name: Ensure Phalcon 5.16.0
         run: bash .github/scripts/install-phalcon.sh
 
       - uses: ramsey/composer-install@v4
@@ -222,7 +222,7 @@ jobs:
           extensions: ${{ env.EXTENSIONS }}
           tools: composer, psalm
 
-      - name: Ensure Phalcon 5.15.0
+      - name: Ensure Phalcon 5.16.0
         run: bash .github/scripts/install-phalcon.sh
 
       - uses: ramsey/composer-install@v4
@@ -322,7 +322,7 @@ jobs:
           extensions: ${{ env.EXTENSIONS }}
           tools: composer, phpunit
 
-      - name: Ensure Phalcon 5.15.0
+      - name: Ensure Phalcon 5.16.0
         run: bash .github/scripts/install-phalcon.sh
 
       - uses: ramsey/composer-install@v4

CHANGELOG.md

@@ -15,6 +15,19 @@ history, the old changelog, and committed file changes. Older Zemit-era entries
 are summarized where the commit history is too granular to be useful as
 release notes.
 
+## 3.6.0 - 2026-06-23
+
+### Changed
+
+- Prepared the package, CI baseline, runtime upgrade guide, reusable skill
+  references, and Phalcon documentation links for Phalcon 5.16.0 by raising
+  the `ext-phalcon` and `phalcon/ide-stubs` floors.
+
+### Fixed
+
+- Kept PhalconKit debug table header normalization stable with Phalcon 5.16.0's
+  one-row debug table markup.
+
 ## 3.5.2 - 2026-06-19
 
 ### Fixed

composer.json

@@ -68,7 +68,7 @@
     "ext-json": "*",
     "ext-mbstring": "*",
     "ext-pdo": "*",
-    "ext-phalcon": "^5.15.0",
+    "ext-phalcon": "^5.16.0",
     "ext-sodium": "*",
     "docopt/docopt": "^1.0.6",
     "league/flysystem": "^3.34.0",
@@ -100,7 +100,7 @@
     "league/oauth2-instagram": "^3.1.0",
     "league/oauth2-linkedin": "^5.1.2",
     "openai-php/client": "^0.20.0",
-    "phalcon/ide-stubs": "^5.15.0",
+    "phalcon/ide-stubs": "^5.16.0",
     "php-imap/php-imap": "^6.0",
     "saggre/phpdocumentor-markdown": "^1.0.0",
     "shuchkin/simplexlsxgen": "^1.5.17",
@@ -133,7 +133,7 @@
     "league/oauth2-instagram": "^3.1.0",
     "league/oauth2-linkedin": "^5.1.2",
     "openai-php/client": "^0.20.0",
-    "phalcon/ide-stubs": "^5.15.0",
+    "phalcon/ide-stubs": "^5.16.0",
     "php-imap/php-imap": "^6.0",
     "saggre/phpdocumentor-markdown": "^1.0.0",
     "shuchkin/simplexlsxgen": "^1.5.17",

guides/README.md

@@ -64,7 +64,7 @@ docs for native framework behavior and these guides for PhalconKit conventions.
 Phalcon Kit is independently maintained and is not affiliated with, endorsed by,
 or sponsored by the official Phalcon PHP Framework project.
 
-- Phalcon docs: https://docs.phalcon.io/5.15/
+- Phalcon docs: https://docs.phalcon.io/5.16/
 - Phalcon framework: https://phalcon.io
 
 ## Agent References

guides/architecture.md

@@ -6,11 +6,11 @@ focus on its models, API resources, workflows, and permissions.
 
 Official Phalcon references:
 
-- MVC: https://docs.phalcon.io/5.15/mvc/
-- Dependency injection: https://docs.phalcon.io/5.15/di/
-- Loader/autoloading: https://docs.phalcon.io/5.15/autoload/
-- Routing: https://docs.phalcon.io/5.15/routing/
-- Models: https://docs.phalcon.io/5.15/db-models/
+- MVC: https://docs.phalcon.io/5.16/mvc/
+- Dependency injection: https://docs.phalcon.io/5.16/di/
+- Loader/autoloading: https://docs.phalcon.io/5.16/autoload/
+- Routing: https://docs.phalcon.io/5.16/routing/
+- Models: https://docs.phalcon.io/5.16/db-models/
 
 ## Request Flow
 

guides/configuration.md

@@ -13,9 +13,9 @@ secrets in environment files and keep application structure in code:
 
 Official Phalcon references:
 
-- Config: https://docs.phalcon.io/5.15/config/
-- Dependency injection: https://docs.phalcon.io/5.15/di/
-- Routing: https://docs.phalcon.io/5.15/routing/
+- Config: https://docs.phalcon.io/5.16/config/
+- Dependency injection: https://docs.phalcon.io/5.16/di/
+- Routing: https://docs.phalcon.io/5.16/routing/
 
 ## Environment
 

guides/database-scaffolding.md

@@ -30,11 +30,11 @@ concrete app models.
 
 Official Phalcon references:
 
-- Models: https://docs.phalcon.io/5.15/db-models/
-- Relationships: https://docs.phalcon.io/5.15/db-models-relationships/
-- Model validation: https://docs.phalcon.io/5.15/db-models-validation/
-- Migrations: https://docs.phalcon.io/5.15/db-migrations/
-- DevTools: https://docs.phalcon.io/5.15/devtools/
+- Models: https://docs.phalcon.io/5.16/db-models/
+- Relationships: https://docs.phalcon.io/5.16/db-models-relationships/
+- Model validation: https://docs.phalcon.io/5.16/db-models-validation/
+- Migrations: https://docs.phalcon.io/5.16/db-migrations/
+- DevTools: https://docs.phalcon.io/5.16/devtools/
 
 ## 1. Run Migrations
 

guides/identity-and-permissions.md

@@ -5,10 +5,10 @@ controller permissions, model permissions, CLI tasks, and WebSocket tasks.
 
 Official Phalcon references:
 
-- ACL: https://docs.phalcon.io/5.15/acl/
-- Security: https://docs.phalcon.io/5.15/encryption-security/
-- JWT: https://docs.phalcon.io/5.15/encryption-security-jwt/
-- Sessions: https://docs.phalcon.io/5.15/session/
+- ACL: https://docs.phalcon.io/5.16/acl/
+- Security: https://docs.phalcon.io/5.16/encryption-security/
+- JWT: https://docs.phalcon.io/5.16/encryption-security-jwt/
+- Sessions: https://docs.phalcon.io/5.16/session/
 
 ## Identity Responsibilities
 

guides/migration-restful-0x-to-1x.md

@@ -54,7 +54,7 @@ The most important practical changes are:
 - Composer package and namespace changed from `zemit-cms/core` / `Zemit\...` to
   `phalcon-kit/core` / `PhalconKit\...`.
 - The Phalcon baseline moved from the older 5.9.x package surface toward the
-  current 5.15.x surface.
+  current 5.16.x surface.
 - `Restful::initialize()` now calls `initializeQuery()` as the normal query
   bootstrap path.
 - The old monolithic `Mvc\Controller\Traits\Query` getter API was split into

guides/models-and-eager-loading.md

@@ -5,10 +5,10 @@ relationship-aware assignment, model behaviors, and batch eager loading.
 
 Official Phalcon references:
 
-- Models: https://docs.phalcon.io/5.15/db-models/
-- Relationships: https://docs.phalcon.io/5.15/db-models-relationships/
-- Behaviors: https://docs.phalcon.io/5.15/db-models-behaviors/
-- Model validation: https://docs.phalcon.io/5.15/db-models-validation/
+- Models: https://docs.phalcon.io/5.16/db-models/
+- Relationships: https://docs.phalcon.io/5.16/db-models-relationships/
+- Behaviors: https://docs.phalcon.io/5.16/db-models-behaviors/
+- Model validation: https://docs.phalcon.io/5.16/db-models-validation/
 
 ## Generated And Concrete Layers