Installation
Runtime requirements
- PHP
^8.3in web, CLI, cron and worker processes - WordPress REST context (register routes in
rest_api_init) - OpenSSL extension (required for
Rs256JwksJwtVerifiersince v0.6.0) - Better Route 2.0 CI tests PHP 8.3–8.5 and runs WordPress 6.9.4 / WooCommerce 10.9.4 on PHP 8.3/8.5 in HPOS/CPT modes. Static-analysis stubs and this measured runtime matrix do not establish every version combination.
Read Upgrade to 2.0 before updating an existing installation. Older
PHP 8.1/8.2 consumers should install the 1.1.3 security patch
with composer require better-route/better-route:^1.1.3. On 1.1.2 or older, use an
explicit URL-bound Resource ownership policy until that fix is installed.
Composer setup
As of v1.0.0 the package is published on Packagist — install it directly, no repository entry needed:
composer require better-route/better-route:^2.0
composer check-platform-reqs --no-dev
Or in composer.json:
{
"require": {
"better-route/better-route": "^2.0"
}
}
If you need to track an unreleased branch (or a fork), add a VCS repository pointing at GitHub:
{
"require": {
"better-route/better-route": "dev-main"
},
"repositories": [
{
"type": "vcs",
"url": "https://github.com/Lonsdale201/better-route"
}
]
}
Local quality commands
composer test
composer analyse
composer cs-check
Composer scripts run tools through php vendor/bin/... so missing executable bits on shared mounts no longer break CI/local runs.
Validation checklist
composer show better-route/better-routeresolves correctlycomposer testpasses- routes are registered only inside
rest_api_init