Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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' }
Expand Down
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
Loading