Composer钩子需严格匹配事件名与时机,post-install-cmd和post-update-cmd是唯二可靠部署钩子;脚本应使用数组格式确保顺序执行与错误中断;权限设置须分层控制,避免chmod -R引发Web服务器写入拒绝;生产环境不应依赖钩子自动触发,推荐显式运行composer run-script。

Composer钩子脚本不是“配了就自动跑”,关键得看事件名对不对、执行时机合不合适、生产环境有没有被静默禁用。
post-install-cmd 和 post-update-cmd 是唯二靠谱的部署钩子
这两个是实际部署中真正能用的事件,其他如 pre-autoload-dump 或 post-dump-autoload 只在 autoloader 重建时触发,跟文件权限、缓存清理、前端构建完全无关。
-
post-install-cmd:CI 拉完代码首次装依赖后触发,适合初始化 storage 目录、生成密钥、设权限 -
post-update-cmd:本地开发composer update后同步环境,适合重编前端资源、刷新路由缓存 - 别把关键逻辑塞进
pre-install-cmd——它在 install 前执行,一旦失败(比如.env缺失),整个安装中断 - 所有钩子默认在
--no-scripts下不执行;生产部署加了--no-dev不影响钩子,但加了--no-scripts就全失效
脚本值写成数组还是字符串?执行顺序和错误处理很关键
脚本值用数组更可控:每项顺序执行,前一项失败,后续不会继续;而单个字符串命令(如 "php artisan cache:clear && php artisan config:clear")里只要一个失败,&& 后面就跳过,你还以为全成功了。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 推荐写法:
"post-install-cmd": ["@php artisan key:generate", "php artisan migrate --force", "@clear-cache"] -
@clear-cache是自定义脚本名,必须在同个scripts对象里定义,例如:"clear-cache": ["php artisan cache:clear", "php artisan view:clear"] - 避免在钩子里直接写
chmod -R 775 storage:递归设权会把storage/logs/2026-10.log也设成 775,Web 服务器可能因权限过高拒绝写入 - PHP 脚本比 shell 更稳:
@php -r "mkdir('storage', 0755, true); chmod('storage', 0755);"可以精确控制目录权限,且不依赖系统命令可用性
生产环境钩子不执行?不是 bug,是设计使然
CI 构建机上跑 composer install --no-dev,post-install-cmd 默认仍会执行;但如果你显式设了环境变量 COMPOSER_NO_DEV=1,或用了某些定制镜像,钩子可能被跳过——这不是异常,是 Composer 的明确行为。
- 安全做法:把真正要跑的部署动作(如清缓存、生成配置)拆成独立脚本名,例如
"deploy:cache": "php artisan config:cache" - 部署命令改写为:
composer install --no-dev --optimize-autoloader && composer run-script deploy:cache - 不要依赖
post-install-cmd在生产环境自动触发——它太不可控;显式composer run-script才是可审计、可重试的动作 - 检查你的部署用户是否对
bootstrap/cache有写权限;钩子脚本是以当前 shell 用户身份运行的,不是 Web 服务器用户(如 www-data),权限不一致时会静默失败
权限设置别硬套 chmod -R,storage 子目录要分治
用 chmod -R 775 storage 看似省事,但会导致 storage/logs/ 下日志文件变成 775,Nginx/Apache 可能因“组写权限开启”拒绝写入,报错 file_put_contents(storage/logs/laravel.log): failed to open stream: Permission denied。
- 正确做法是分层设权:
find storage -type d -exec chmod 755 {} \;(目录 755),find storage -type f -exec chmod 644 {} \;(文件 644) - 更稳妥的是用 PHP 脚本判断并创建:
@php -r "if (!is_dir('storage/logs')) { mkdir('storage/logs', 0755, true); } touch('storage/logs/.gitkeep');" -
.env文件权限必须是 644,不能是 664 或 600——Laravel 8+ 会因权限过严拒绝加载,报The environment file is invalid - Windows 部署机无法用
chmod,此时必须用 PHP 脚本替代,否则钩子直接报 command not found
钩子本身不解决权限、路径、用户上下文问题,它只是个触发器。真正容易被忽略的是:你写的每条命令,都运行在当前 shell 用户下,而不是 Laravel 应用运行时的 Web 用户;这个差异,往往要等到线上报错才暴露出来。

















