add docker page, resolve version at build time

[carlos-granados]

Replaces the Docker placeholder with the real page, covering both routes into a container.

Prebuilt images — the one-line FROM change, tag table, what differs from the official image (static extension, JIT off), the opcache rebuild caveat, a compose example, and removing a previously installed debugger.

PIE — a Dockerfile that installs the extension into an official image, for anyone who prefers the extension to the bundled interpreter.

Tested rather than transcribed

The PIE route was run end to end before being written down, on Debian/arm64/PHP 8.4:

• The first Dockerfile attempt failed to build: PIE downloads the package as a zip and dies with The zip extension and unzip/7z commands are both missing, because the official php: images have no unzip. The documented Dockerfile installs unzip and libtool alongside $PHPIZE_DEPS, and builds clean.
• Result verified: php -v reports the debugger, extension_loaded("php_debugger") is true, PIE auto-enables it, and the defaults are mode=debug, start_with_request=yes, port 9003.
• The prebuilt image was checked the same way, including that the extension really is static and that opcache JIT is unset.
• PHP_DEBUGGER_CONFIG was confirmed to work live, so the compose example uses the native name.

Not tested: Alpine variants and amd64, so the PIE recipe is presented as Debian only.

Version resolved at build time

Versions were written down by hand in several places and had drifted — the navbar claimed v1.3.0 against an actual latest release of 0.3.0.

docusaurus.config.js is now an async factory that reads the latest release tag from the GitHub API and exposes it as customFields.debuggerVersion. The navbar and the ConsoleSample component both read from it, so a rebuild refreshes every version on the site. FALLBACK_VERSION keeps builds working when the API is unreachable or rate limited — verified by stubbing fetch to throw.

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-08-24 15:07 UTC