From 0e4a716983043b13a60fbf4468b252c82a8f48ad Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 21 Nov 2026 00:15:03 +0000 Subject: [PATCH] docs: drop the beta qualifier from PHP 8.6 support PHP 8.6.0 is GA and all legs were already required; the suite, the integration gate and PHPStan pass on the release build. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FxhC1D34vSRsQVcgd3HwS6 --- .github/workflows/ci.yml | 4 ++-- AGENTS.md | 4 ++-- README.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index e097871..64817a5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -15,8 +15,8 @@ jobs: fail-fast: false matrix: include: - # PHP 8.6 is still in beta: setup-php installs the beta build and - # Composer resolves z-engine 8.6.x-dev (the master branch alias). + # Every leg is required, PHP 8.6 (GA) included. Composer resolves + # z-engine 8.6.x-dev (the master branch alias) on that minor. - { os: ubuntu-latest, php: '8.4' } - { os: ubuntu-latest, php: '8.5' } - { os: ubuntu-latest, php: '8.6' } diff --git a/AGENTS.md b/AGENTS.md index 4a4d1c5..e310931 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,14 +11,14 @@ split: prose says ZDebug, code says `zdebug`. ## Branch model -`main` supports PHP 8.4, 8.5 and 8.6 (beta) in parallel. Engine memory layouts change +`main` supports PHP 8.4, 8.5 and 8.6 in parallel. Engine memory layouts change between PHP minors, so each minor rides its own z-engine line (`8.4.x-dev` on PHP 8.4, `8.5.x-dev` on PHP 8.5, `8.6.x-dev` — the master branch alias — on PHP 8.6) and Composer resolves the matching one for the running PHP. ## Environment requirements -- PHP `^8.4` (8.4, 8.5 and the 8.6 beta are tested in CI), **NTS, linux-x64 or darwin-x64/arm64** (the platforms z-engine ships definitions for). The PHP 8.6 tail-call VM bug that used to break engine hooks on darwin-arm64 (lisachenko/z-engine#280) is fixed upstream (php/php-src#24109); all legs are required again. +- PHP `^8.4` (8.4, 8.5 and 8.6 are tested in CI, every leg required), **NTS, linux-x64 or darwin-x64/arm64** (the platforms z-engine ships definitions for). The PHP 8.6 tail-call VM bug that used to break engine hooks on darwin-arm64 (lisachenko/z-engine#280) is fixed upstream (php/php-src#24109); all legs are required again. - `ffi.enable=1` and **JIT off** (`opcache.jit=off`) — the JIT rewrites the executor internals the statement hook plugs into. Both must come from `php.ini`/`-d`. - The debuggee's code must be compiled **after** the debugger initializes; the diff --git a/README.md b/README.md index bbb9e4d..5f5dd88 100644 --- a/README.md +++ b/README.md @@ -161,13 +161,13 @@ Precedence, lowest to highest: built-in defaults → Xdebug ini/env → `ZDEBUG_ ## Requirements -- PHP **8.4, 8.5 or 8.6 (beta)** (supported in parallel), **NTS**, **linux-x64 or macOS x64/arm64** (platforms z-engine ships definitions for); Composer resolves the matching z-engine line per minor. (The PHP 8.6 tail-call VM bug that used to break engine hooks on Apple Silicon — [lisachenko/z-engine#280](https://github.com/lisachenko/z-engine/issues/280) — is fixed upstream by [php/php-src#24109](https://github.com/php/php-src/pull/24109)) +- PHP **8.4, 8.5 or 8.6** (supported in parallel), **NTS**, **linux-x64 or macOS x64/arm64** (platforms z-engine ships definitions for); Composer resolves the matching z-engine line per minor. (The PHP 8.6 tail-call VM bug that used to break engine hooks on Apple Silicon — [lisachenko/z-engine#280](https://github.com/lisachenko/z-engine/issues/280) — is fixed upstream by [php/php-src#24109](https://github.com/php/php-src/pull/24109)) - `ffi.enable=1` and **`opcache.jit=off`** (the JIT rewrites the executor internals the hook plugs into) - Your app's code must load **after** ZDebug attaches — `auto_prepend_file` guarantees this ## Status -The debugger is complete enough to use as one: an IDE attaches, sets line, conditional, call, return and exception breakpoints, steps over/into/out, walks the stack, reads and writes variables, evaluates expressions, fetches source and detaches — all of it proven end-to-end by a test suite that plays a fake IDE against a real spawned child process, on PHP 8.4, 8.5 and the 8.6 beta across linux-x64 and macOS (x64 + arm64). +The debugger is complete enough to use as one: an IDE attaches, sets line, conditional, call, return and exception breakpoints, steps over/into/out, walks the stack, reads and writes variables, evaluates expressions, fetches source and detaches — all of it proven end-to-end by a test suite that plays a fake IDE against a real spawned child process, on PHP 8.4, 8.5 and 8.6 across linux-x64 and macOS (x64 + arm64). What is left is a short list, and most of it is the engine's doing rather than unfinished plumbing: