Composer的scripts钩子可在特定命令阶段自动执行代码,用于自动化安装后生成文件、清缓存等操作。常见钩子包括pre-install-cmd、post-install-cmd、post-update-cmd等,支持shell命令或PHP回调函数。通过composer.json的scripts字段配置,可定义字符串或数组形式的命令,PHP方法需为静态且可调用。自定义类需确保自动加载,调试时可用composer install -v查看执行过程,合理使用可提升项目维护效率。

Composer 的 scripts 钩子允许你在执行 Composer 命令的特定阶段自动运行自定义 PHP 代码或 shell 脚本。它们的作用是增强项目在安装、更新、部署等过程中的自动化能力,比如自动生成文件、清理缓存、执行测试或发送通知。
常见 scripts 钩子用途
这些钩子会在 Composer 执行对应操作时触发:
- pre-install-cmd:在 install 执行前运行
- post-install-cmd:install 完成后运行(常用于生成 autoload 文件或初始化配置)
- pre-update-cmd:update 前执行
- post-update-cmd:update 完成后运行(适合清缓存或迁移)
- post-autoload-dump:自动加载生成后执行
- post-create-project-cmd:项目创建完成后运行(如 Laravel 新项目初始化)
这些脚本能直接写命令行指令,也可以调用 PHP 回调函数(需注册为可调用类方法)。
如何配置 scripts
在项目的 composer.json 文件中添加 scripts 字段:
{
"scripts": {
"post-install-cmd": [
"echo '安装完成'",
"php artisan optimize"
],
"post-update-cmd": "php artisan clear-compiled",
"post-autoload-dump": [
"Illuminate\\Foundation\\ComposerScripts::postAutoloadDump"
]
}
}
说明:
- 每个钩子可以是一个字符串或数组
- 数组形式可按顺序执行多个命令
- PHP 类方法必须是静态且可被 Composer 调用(参数会传入 Event 对象)
自定义 PHP 脚本示例
创建一个处理类:
// scripts/MyScript.php
class MyScript {
public static function postUpdate($event) {
echo "依赖已更新,事件名:" . $event->getName() . "\n";
}
}
在 composer.json 中引用:
"scripts": {
"post-update-cmd": "MyScript::postUpdate"
}
确保该类能被自动加载(通常放在 src 或指定目录,并配置 autoload)。
查看和调试 scripts
运行 Composer 时加上 -v 参数可看到脚本执行详情:
composer install -v也可使用以下命令列出所有可用钩子:
composer run-script --list基本上就这些。合理使用 scripts 能让项目维护更高效,但避免在钩子里做耗时或不稳定操作,以免影响依赖管理流程。










