refactor!: require PHP 8.4
Tests / PHP 8.4 (push) Failing after 1m26s

Drop support for PHP 8.3 and lower. The package now declares >=8.4, and CI runs
only on 8.4.

- composer.json: require php >=8.4.
- mago.toml: php-version = "8.4", matching the minimum supported version.
- phpstan.neon: phpVersion 80400.
- Upgrade phpstan/phpstan to ^2.3: 1.x cannot parse `new Foo()->bar()`, which the
  8.4 formatter now emits.
- Narrow ArrayGateway::count() to int, matching what the fixture actually returns.
- CI: single PHP 8.4 job using the php:8.4-cli container instead of setup-php,
  which failed with a TLS handshake timeout on the runner.

BREAKING CHANGE: PHP 8.4 is now required.
This commit is contained in:
dgarcia committed 2026-11-15 10:58:17 -03:00
1 parent a20762a715
commit 807992ecab
15 files changed
+57 -62

No files matched your search

+8 -7
View File
@@ -37,8 +37,8 @@ salvo lo que difiere abajo. Léelos antes de tocar el toolchain.
| | aquí | en `../orm` |
|---|---|---|
| PHP declarado | `>=8.3` | `>=8.3` (su prosa dice 8.2: gana el composer.json) |
| Parser Mago / PHPStan | 8.2 / `80300` | 8.2 / `80200` |
| PHP declarado | `>=8.4` | `>=8.4` |
| Parser Mago / PHPStan | 8.4 / `80400` | 8.4 / `80400` |
| `mago-baseline.toml` | **no existe**, y no debe crearse | existe |
## Independencia del ORM (decisión de diseño, no descuido)
@@ -65,8 +65,8 @@ la app conecta el ORM por composición. Consecuencias que un agente rompería po
## Entorno local
- PHP: `C:\php8.4\php.exe` (8.4.19), Composer 2.10.3. La librería declara `>=8.3`, así que **no**
uses sintaxis exclusiva de 8.4; por eso `(new Foo())->bar()` conserva los paréntesis.
- PHP: `C:\php8.4\php.exe` (8.4.19), Composer 2.10.3. La librería declara `>=8.4`, así que toda la
sintaxis de 8.4 está disponible.
- `declare(strict_types=1)` en todo archivo, incluidos los tests.
- Sin `.env` ni servicios externos. Los tests son unitarios y puros: no levantan servidor, ni base,
ni red. Un test que necesite un socket real está mal ubicado aquí.
@@ -87,9 +87,10 @@ vendor/bin/phpunit --configuration phpunit.xml.dist --filter NombreDelTest
## Trampas del toolchain
- **`php-version = "8.2"` en `mago.toml` es obligatorio.** Subirlo a 8.4 hace que `mago fmt`
reescriba `(new X())->m()` como `new X()->m()`, que rompe el soporte declarado y ni siquiera parsea
cuando el resultado se asigna.
- **`php-version = "8.4"` en `mago.toml` debe coincidir con el mínimo declarado.** El paquete
promete `>=8.4`, así que `mago fmt` puede emitir `new X()->m()`. Si el soporte mínimo bajara,
`php-version` tendría que bajar con él: con 8.4 el formatter elimina los paréntesis de
`(new X())->m()`, sintaxis que no parsea en 8.3 ni inferiores.
- `mago analyze` excluye `tests/` (no carga el autoloader de Composer): reportaría `TestCase` como
clase inexistente. PHPStan sí cubre los tests.
- **Sin baseline.** El baseline del ORM acepta `mixed` inherente a PDO. Aquí no hay PDO como