This package can replace legacy Composer asset compiler integrations in projects that need a PHP 8.5-compatible build workflow.
Remove the old package and require the new one:
{
"require": {
"sympress/asset-compiler": "^1.0"
},
"config": {
"allow-plugins": {
"sympress/asset-compiler": true
}
}
}Packages that still require a legacy asset compiler should be migrated to require sympress/asset-compiler directly.
Preferred root config:
{
"extra": {
"sympress.asset-compiler": {
"auto-run": true
}
}
}Preferred package config:
{
"extra": {
"sympress": {
"asset-compiler": {
"script": "build"
}
}
}
}The flat key extra.sympress.asset-compiler is supported. The legacy key extra.composer-asset-compiler is also supported during migration.
Use:
composer compile-assets
composer assets-hashThe compiler focuses on Composer package workspaces and package-local build locks. Use --dry-run to inspect the commands before running them:
composer compile-assets --dry-runSuccessful package builds write .sympress_asset_compiler.lock in each package directory. Existing locks can be ignored during migration:
composer compile-assets --ignore-lock='*'- Replace the Composer dependency and allowed plugin.
- Move root configuration to
extra.sympress.asset-compiler. - Move package-level configuration to nested
extra.sympress.asset-compileror flatextra["sympress.asset-compiler"]. - Run
composer assets-hash. - Run
composer compile-assets --dry-run. - Run
composer compile-assets --ignore-lock='*'. - Keep the generated package-local lock files if the project tracks build state.