composer scripts 是 composer.json 中 "scripts" 字段定义的命令别名，用于在部署中执行清理、编译等轻量操作；它不替代 ci/cd 工具，而是作为项目级可复现钩子，在 composer install 后自动触发 cache 清理与 temp 文件删除。
什么是 Composer Scripts，它在部署中起什么作用？
Composer Scripts 是 composer.json 中 "scripts" 字段定义的一组命令别名，它们不是构建工具，但能被 composer install、composer update 或手动调用（如 composer run-script）触发。在部署阶段，它常被用来衔接「安装依赖」和「服务启动」之间的清理、编译、权限修复等轻量操作。
关键点在于：它不替代 CI/CD 工具（如 GitHub Actions、Deployer），而是作为项目级的、可复现的钩子存在。如果你的部署流程靠 git pull && composer install 驱动，那 Scripts 就是最自然的清理入口。
如何配置 cache:clear 和 temp cleanup 脚本？
以 Laravel 或 Symfony 风格项目为例，缓存和临时文件通常分布在：storage/cache/、bootstrap/cache/、var/cache/、var/log/（Symfony）或 storage/logs/（Laravel）。Composer 本身不清理这些，需靠脚本调用系统命令或框架命令。
在 composer.json 的 "scripts" 下添加：
"scripts": {
"post-install-cmd": [
"@clear-cache",
"@clear-temp"
],
"clear-cache": "if [ -d 'bootstrap/cache' ]; then rm -rf bootstrap/cache/*; fi && if [ -d 'storage/cache' ]; then find storage/cache -type f -delete; fi",
"clear-temp": "if [ -d 'storage/framework/views' ]; then rm -rf storage/framework/views/*; fi && if [ -d 'storage/framework/sessions' ]; then find storage/framework/sessions -type f -mmin +60 -delete; fi"
}
说明：
-
post-install-cmd在每次composer install后自动执行，适合部署时触发 -
clear-cache优先清空bootstrap/cache/（Laravel 的 compiled.php 等），再安全清理storage/cache/中的键值缓存文件 -
clear-temp清理视图缓存和过期会话（-mmin +60表示修改时间超 60 分钟的文件），避免误删活跃会话 - 所有路径判断都加了
[ -d '...' ]，防止在非标准目录结构下报错中断
为什么不能直接用 php artisan cache:clear 或 bin/console cache:clear？
因为这些命令依赖框架完整加载，而 composer install 执行时，vendor/autoload.php 刚生成，APP_ENV、APP_DEBUG 等环境变量往往未就位，框架引导失败会导致命令退出并报错（如 Class 'App\Providers\AppServiceProvider' not found）。
更稳妥的做法是：只用 shell 命令清理物理文件，把框架级缓存重建留给应用首次请求（Laravel 自动重建 bootstrap/cache/config.php）或后续健康检查步骤。
如果你坚持用框架命令，必须确保：
- 环境变量已通过
.env或部署脚本注入 -
APP_KEY已存在（否则 Laravel 无法解密配置） - 使用
--no-interaction和--quiet避免交互阻塞 - 加
|| true容错（如php artisan cache:clear || true），否则失败会中断整个composer install
常见陷阱与兼容性注意
Linux 和 macOS 的 find 语法一致，但 Windows（Git Bash 除外）不原生支持。若部署目标含 Windows，应避免依赖 find，改用 rm -rf 或分拆为 PHP 脚本。
另一个容易被忽略的是权限问题：如果部署用户和 Web 用户不同（如部署用 deploy，Web 用 www-data），直接 rm -rf 可能导致后续写入失败。建议清理后补一句 chown -R www-data:www-data storage/（仅限 Linux）。
最后提醒：Composer Scripts 不支持条件判断（如 if $ENV == 'prod'），所有逻辑必须硬编码或委托给外部脚本。复杂流程（如备份旧缓存、校验磁盘空间）请移出 Composer，交给部署工具处理。
