Composer scripts 可在事件触发时自动执行任务,如通过 post-update-cmd 清除缓存或调用 PHP 方法构建资源;可在 composer.json 中定义脚本,支持命令行指令和静态方法,还可手动运行自定义脚本,提升项目自动化效率。

Composer scripts 是 Composer 提供的一种机制,允许你在 Composer 执行某些事件(如安装、更新、加载自动加载器等)时自动运行自定义的 PHP 函数或命令行脚本。它们常用于自动化项目中的常见任务,比如清空缓存、生成代码、执行数据库迁移等。
常见的 Composer 脚本事件
Composer 内置了一系列生命周期事件,你可以绑定脚本来响应这些事件。例如:
-
pre-install-cmd:在
composer install执行前运行 -
post-install-cmd:在
composer install执行后运行 -
pre-update-cmd:在
composer update前运行 -
post-update-cmd:在
composer update后运行 - post-autoload-dump:在自动加载器生成后运行
-
post-create-project-cmd:使用
create-project创建项目后运行
如何定义自定义脚本
你可以在项目的 composer.json 文件中通过 scripts 字段来定义脚本。支持两种类型的脚本:闭包函数(PHP 回调)和命令行命令。
例如,在每次依赖更新后清除缓存:
{
"scripts": {
"post-update-cmd": "php clear-cache.php"
}
}
2. 执行 PHP 方法(静态方法或闭包)
需要指定类名和方法名,格式为 ClassName::methodName 或 [$className, $methodName]。
例如:
{
"scripts": {
"post-update-cmd": [
"MyScript::buildAssets",
"MyScript::notifyDeployment"
]
}
}
对应的 PHP 类:
这本书假定你没有任何关于脚本或一般程序的编程知识, 但是如果你具备相关的知识, 那么你将很容易就能够达到中高级的水平. . . 所有这些只是UNIX®浩瀚知识的一小部分. 你可以把本书作为教材, 自学手册, 或者是关于shell脚本技术的文档. 书中的练习和样例脚本中的注释将会与读者进行更好的互动, 但是最关键的前提是: 想真正学习脚本编程的唯一途径就是亲自动手编写脚本. 这本书也可作为教材来讲解一般的编程概念. 向伟大的中华民族的Linux用户致意! 我希望这本书能够帮助你们学习和理解L
注意:方法接收一个
Composer\Script\Event对象,可用于获取上下文信息(如是否是更新操作、IO 对象等)。如何手动运行自定义脚本
除了绑定到特定事件外,你也可以将脚本作为“命令别名”来运行。
例如定义一个名为
clear-cache的脚本:{ "scripts": { "clear-cache": "php clear-cache.php" } }然后通过以下命令运行:
composer run clear-cache这相当于把 Composer 当作一个简单的任务运行器使用。
实用建议
- 脚本命令可以是任何可执行的 shell 命令,比如
php artisan optimize、npm run build等 - 多个脚本可以用数组形式依次执行
- 使用闭包时需确保类文件能被自动加载(通常放在
autoload区域中) - 调试脚本时可添加日志输出或使用
composer run查看详情
基本上就这些。合理使用 Composer scripts 可以显著提升项目初始化和维护效率。









