自定义命令脚本通过在composer.json的scripts中定义快捷指令提升开发效率，如clear-cache、deploy和test等命令可简化执行流程；支持通过%param%传递参数或使用环境变量，结合&&和||实现错误处理，还可执行自定义PHP代码并利用Composer API进行复杂操作。
Composer自定义命令脚本，简单来说，就是让你在
composer.json里定义一些快捷指令，省去敲长命令的麻烦。想象一下，你经常需要执行一连串的 Composer 命令，每次都得复制粘贴，是不是很烦？自定义命令脚本就能解决这个问题，让你的开发效率嗖嗖地提升。
解决方案
在
composer.json文件的
scripts部分添加自定义命令。
scripts允许你定义事件（比如
post-install-cmd，
pre-update-cmd），也可以定义你自己的命令别名。
例如：
{
"name": "your-vendor/your-package",
"description": "Your package description",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Your Name",
"email": "your.email@example.com"
}
],
"require": {
"php": ">=7.4"
},
"scripts": {
"clear-cache": [
"rm -rf var/cache/*",
"echo 'Cache cleared!'"
],
"deploy": [
"@clear-cache",
"composer install --no-dev --optimize-autoloader",
"echo 'Deployment complete!'"
],
"test": "phpunit"
}
}解释一下：
clear-cache
: 定义了一个清除缓存的命令，实际上是执行rm -rf var/cache/*
和echo 'Cache cleared!'
这两个 shell 命令。deploy
: 定义了一个部署命令，它首先调用了clear-cache
命令（通过@clear-cache
），然后执行安装命令，最后输出一条消息。test
: 定义了一个测试命令，直接调用phpunit
。
执行自定义命令，只需在命令行输入：
composer clear-cache composer deploy composer test
是不是方便多了？
如何在Composer脚本中传递参数？
在定义 Composer 脚本时，你可能需要传递参数。Composer 提供了一种简单的方式来实现这一点。
例如，假设你有一个脚本需要传递一个环境参数：
{
"scripts": {
"build": "node build.js %env%"
}
}在命令行中，你可以这样运行：
composer build --env=production
%env%会被替换为
production。 注意，你需要在运行命令时使用
--来分隔 Composer 命令和传递给脚本的参数。如果没有
--，Composer 会尝试将
--env=production解释为 Composer 的选项，这通常会导致错误。
另外，你也可以使用环境变量：
{
"scripts": {
"build": "node build.js $ENV_VAR"
}
}这种情况下，
$ENV_VAR会被系统环境变量的值替换。
Composer脚本中如何处理错误和异常？
在 Composer 脚本中，错误处理很重要，否则一个脚本的失败可能会导致整个流程中断。Composer 默认情况下，如果脚本中的任何一个命令返回非零退出码，它就会停止执行。
你可以使用
&&和
||来链接命令，以实现更复杂的错误处理逻辑。
&&
: 只有前一个命令成功（退出码为 0）时，才会执行下一个命令。||
: 只有前一个命令失败（退出码非 0）时，才会执行下一个命令。
例如：
{
"scripts": {
"deploy": [
"composer install && echo 'Dependencies installed' || echo 'Failed to install dependencies'",
"php artisan migrate && echo 'Migration successful' || echo 'Migration failed'"
]
}
}在这个例子中，如果
composer install失败，会输出 "Failed to install dependencies"，但脚本会继续执行。 同样，
php artisan migrate也做了类似的错误处理。
另外，你也可以使用
set -e命令来让脚本在遇到错误时立即退出（这在 Linux/macOS 系统中有效）。
{
"scripts": {
"deploy": [
"set -e",
"composer install",
"php artisan migrate"
]
}
}在这个例子中，如果
composer install失败，脚本会立即退出，不会执行
php artisan migrate。
如何在Composer脚本中使用自定义PHP代码？
有时候，简单的 shell 命令无法满足你的需求，你可能需要在 Composer 脚本中执行一些 PHP 代码。 Composer 提供了一种方式来执行自定义 PHP 代码。
首先，创建一个 PHP 脚本，例如
scripts/my-script.php：
<?php // scripts/my-script.php echo "Hello from PHP script!\n"; $param = $argv[1] ?? 'default'; // 获取参数 echo "Parameter: " . $param . "\n"; // 执行一些复杂的逻辑
然后，在
composer.json中定义脚本：
{
"scripts": {
"my-command": "php scripts/my-script.php"
}
}或者，如果你想传递参数：
{
"scripts": {
"my-command": "php scripts/my-script.php %param%"
}
}运行命令：
composer my-command --param=custom_value
在 PHP 脚本中，你可以使用
$argv数组来获取传递的参数。
另外，你也可以使用 Composer 提供的 API。 首先，你需要引入 Composer 的 autoloader：
<?php // scripts/my-script.php require __DIR__ . '/../vendor/autoload.php'; use Composer\Factory; use Composer\IO\NullIO; $composer = Factory::create(new NullIO()); $package = $composer->getPackage(); echo "Package name: " . $package->getName() . "\n"; // 执行一些操作
这种方式可以让你访问 Composer 的配置信息，执行更复杂的操作。
