Works with the AI Agents you already use
PHP 8.6 Upgrade Audit: Every Breaking Change & Deprecation, Found and Fixed
Scans a PHP 8.4/8.5 codebase and writes a go/no-go PHP 8.6 report with file:line findings, blocking dependencies and exact fixes.
$1
PHP 8.6 Upgrade Audit: Every Breaking Change & Deprecation, Found and Fixed
Example session with this skill installed
Is our Laravel shop app ready for PHP 8.6? We're on PHP 8.5. Audit it and tell me what to fix.
- Read your context and instructions
- Compiled the php 8 6
PHP 8.6 Upgrade Report — acme/shop — 2026-11-15
Verdict: NO-GO (5 blockers, 2 BREAK)
Current PHP: 8.5.12 · Native sessions: yes (src/Checkout.php:17)
Blockers
| # | Where | Value | Fix |
|---|---|---|---|
| 1 | composer.json require.php | ~8.4.0 || 8.5.* | ^8.4 |
| 2 | composer.json config.platform.php | 8.5.12 | 8.6.0 |
| 3 | composer.lock acme/legacy-pdf 2.3.1 | >=8.1 <8.6 | upgrade or replace the package |
| 4 | Dockerfile:1 | php:8.5-fpm-alpine | php:8.6-fpm-alpine |
| 5 | .github/workflows/ci.yml:5 | ['8.4', '8.5'] | add '8.6' |
Findings
| # | Sev | ID | Location | Status | Issue | Fix |
|---|---|---|---|---|---|---|
| 1 | BREAK | B05 | src/Checkout.php:44 | CONFIRMED | unpack('n<length/...') — '<' now an endianness modifier | 'n1<length' or rename key |
| 2 | BREAK | B30 | src/Upload.php:2 | CONFIRMED | allow-list has font/sfnt; TTF now font/ttf | add font/ttf |
| 3 | DEPRECATION | D09 | src/Checkout.php:4 | CONFIRMED | define() third argument | remove it |
| 4 | DEPRECATION | D01 | src/Checkout.php:22 | CONFIRMED | return inside finally | return after try/finally |
| 5 | DEPRECATION | D04 | src/Checkout.php:11 | CONFIRMED | return false in __construct() | throw or use return; |
| 6 | DEPRECATION | D17 | src/DbSessionHandler.php:4 | CONFIRMED | handler lacks validateId() and create_sid() | implement both |
| 7 | DEPRECATION | D32 | src/ShopDate.php:8 | CONFIRMED | setTimezone() override lacks : static | declare : static |
| 8 | DEPRECATION | D26 | src/Checkout.php:39 | CONFIRMED | is_double()/doubleval() | is_float()/floatval() |
| … | 6 more |
Session defaults (B01)
Checkout uses session_start() and the card gateway POSTs back to /checkout/return → under SameSite=Lax the session cookie is dropped. Fix: signed order token on the return URL.
Runtime on PHP 8.6
NOT RUN — blockers first. Command prepared: docker run … php:8.6-cli vendor/bin/phpunit
Connects securely to your tools. The creator never sees your data.
About this skill
PHP 8.6 is scheduled for general availability on 19 November 2026. It adds about 30
deprecations (E_DEPRECATED today, removal planned for PHP 9) and a long list of behaviour
changes, the most dangerous being new secure session defaults (use_strict_mode=1,
cookie_httponly=1, cookie_samesite=Lax) that can silently break payment-gateway returns and
SSO POST flows. This skill turns that change list into an evidence-backed audit of one codebase:
a static scan with file:line findings, a dependency and infrastructure check, a runtime test
plan on PHP 8.6, fixes, and a report that ends in a clear verdict.
Facts in this skill were checked on 15 November 2026 against the php-src PHP-8.6 branch
UPGRADING file and the release timetable at https://wiki.php.net/todo/php86 (RC5 shipped
5 November 2026). The full catalogue with IDs is in reference/php86-changes.md.
- Planning or executing a move from PHP 8.4 or 8.5 to PHP 8.6.
- A CI matrix is gaining a PHP 8.6 job and deprecation notices or failures appeared.
- A hosting provider, Docker base image or Linux distribution is about to switch to 8.6.
- Someone asks whether a specific library, plugin or app works on PHP 8.6.
Do not use it for upgrades from PHP 8.3 or older: first reach 8.5 (8.4 and 8.5 changes are not covered here), then run this audit.
Covers PHP 8.5 to 8.6 changes only (upgrade older apps to 8.5 first). Static scanning cannot know variable types, so some findings are marked "verify" and must be confirmed by reading the code; behaviour changes such as by-reference foreach and magic-property semantics are listed as manual checks. Facts were checked against the php-src PHP-8.6 UPGRADING file on 15 Nov 2026, four days before the scheduled 19 Nov GA; the skill tells the agent to re-check after GA. It does not edit vendor/ and does not auto-apply fixes without review.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 2 days ago
Requires
Permissions
Allowed Hosts
File Scopes
The bundled scanner is read-only, uses only the Python standard library, never executes project code and never uses the network.