Files
computer-playbook/utils/install/php.py
T
kevinveenbirkenbachandClaude Opus 5 ebb835d541 chore(deps-dev): update phpunit/phpunit requirement from ^11.0 to ^13.3
Adopts infinito-nexus/core#568. The composer.json hunk is byte-identical to that PR; vendor/ and composer.lock are gitignored, so it is the only file the PR touches.

The docstring in utils/install/php.py names the constraint verbatim and would have gone stale, which dependabot cannot see.

Verified rather than assumed: phpunit 13.3.2 requires php >=8.4.1 where 11.x asked for >=8.2, and the project container runs 8.4.24. A partial update fails because the lock pins the transitive packages, so resolving needs -W, which carries fourteen packages along including php-code-coverage 11.0.12 to 14.3.2. The suite then runs green under the new major: 26 tests, 56 assertions, no deprecation and no warning, with phpunit.xml setting failOnWarning and failOnRisky.

Open: ensure_php_toolchain takes whatever php the distro ships and states no minimum, so a matrix row on php below 8.4.1 breaks at composer install rather than at a named check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-08 22:42:02 +02:00

68 lines
2.2 KiB
Python

"""PHP toolchain provisioning for the PHP unit suite."""
from __future__ import annotations
import subprocess
from utils import PROJECT_ROOT
from utils.install.primitives import log
from utils.install.system_pkg import (
ensure_command_present,
ensure_php_extension_present,
)
_PHPUNIT = PROJECT_ROOT / "vendor" / "bin" / "phpunit"
_PHPUNIT_EXTENSIONS = ("dom", "mbstring", "xmlwriter")
def ensure_php_toolchain() -> None:
"""Install the PHP interpreter, Composer and the extensions PHPUnit needs.
``phpunit/phpunit ^13`` declares ``_PHPUNIT_EXTENSIONS`` as platform
requirements and Composer refuses to resolve the vendor tree without them,
so they are part of the toolchain rather than of the suite consuming it.
A distro ships them as packages separate from the interpreter, which is why
a present ``php`` binary does not imply they are there.
Composer needs an archive extractor for its dist downloads. Without one it
silently falls back to ``--prefer-source`` and mirror-clones every
dependency, which blows its 300 s process timeout on ``phpunit.git``. Arch
ships no zip extension and no ``php-zip`` package, so the extractor has to
be the ``unzip`` binary rather than the extension.
Raises:
RuntimeError: php, composer, unzip or one of the extensions is still
absent.
"""
ensure_command_present("php")
ensure_command_present("composer")
ensure_command_present("unzip")
for extension in _PHPUNIT_EXTENSIONS:
ensure_php_extension_present(extension)
def ensure_php_present() -> None:
"""Install the PHP toolchain and the Composer vendor tree.
Raises:
RuntimeError: php, composer or phpunit is still absent afterwards.
subprocess.CalledProcessError: ``composer install`` failed.
"""
ensure_php_toolchain()
if not _PHPUNIT.is_file():
log("phpunit missing; running composer install.")
subprocess.run(
["composer", "install", "--no-interaction", "--no-progress"],
cwd=PROJECT_ROOT,
check=True,
)
if not _PHPUNIT.is_file():
raise RuntimeError(f"{_PHPUNIT} missing after composer install")
if __name__ == "__main__":
ensure_php_present()