Composer 脚本可自动化项目初始化，通过定义 scripts 字段执行 post-install-cmd、post-update-cmd 和 post-create-project-cmd 事件，在安装或创建项目时自动运行 PHP 或 shell 命令；可编写 init.php 等脚本生成 .env 文件、设置权限、调用 Artisan 命令，并通过 Event 接口传递上下文参数，实现复制配置、生成密钥、创建软链接、运行迁移、检查扩展和权限等任务，提升效率与一致性。
通过 Composer 脚本自动化项目的初始化和设置，可以大幅提升开发效率，减少重复操作。Composer 支持在安装或更新依赖时自动执行 PHP 脚本或 shell 命令，适合用于生成配置文件、设置权限、创建目录、运行数据库迁移等。
定义 composer.json 中的脚本
Composer 使用 scripts 字段来绑定自定义操作。你可以在 composer.json 文件中添加脚本，例如：
{
"scripts": {
"post-install-cmd": [
"php scripts/init.php",
"chmod -R 755 storage bootstrap/cache"
],
"post-update-cmd": [
"php scripts/init.php"
],
"post-create-project-cmd": [
"php scripts/setup.php"
]
}
}
post-install-cmd 和 post-update-cmd 在依赖安装或更新后触发，适合做项目环境检查或权限设置。post-create-project-cmd 只在使用 create-project 创建新项目时运行，常用于初始配置。
编写可复用的初始化脚本
你可以创建独立的 PHP 脚本来处理初始化逻辑。例如，在 scripts/init.php 中：
<?php
// scripts/init.php
echo "开始初始化项目...
";
$envFile = __DIR__ . '/../.env';
if (!file_exists($envFile)) {
copy(__DIR__ . '/../.env.example', $envFile);
echo ".env 文件已生成。
";
}
$configDir = __DIR__ . '/../config';
if (is_dir($configDir)) {
echo "配置目录正常。
";
}
echo "初始化完成。
";
这类脚本可以检测是否存在配置文件、生成密钥、提示用户输入数据库信息，甚至调用 Artisan 命令（在 Laravel 中）。
利用 Composer 的事件系统传递参数
脚本可以通过实现 ComposerScriptEvent 接口接收上下文信息。例如：
public static function postInstall(Event $event)
{
$composer = $event->getComposer();
$io = $event->getIO();
$io->write("项目依赖已安装，正在执行后续设置...");
// 可读取配置或根据选项跳过某些步骤
if ($io->isInteractive()) {
$io->write("进入交互模式...");
}
}
将该类方法注册到 composer.json：
"scripts": {
"post-install-cmd": "MyScripts\Installer::postInstall"
}
确保命名空间正确，并在 autoload 中包含脚本目录。
常见自动化任务示例
以下是一些实用的自动化场景：
- 复制 .env.example 到 .env 并生成应用密钥
- 创建软链接（如 Laravel 的 storage:link）
- 运行数据库迁移或种子填充
- 检查扩展是否启用（如 mbstring、openssl）
- 设置目录写权限（storage、cache）
例如，在 Laravel 项目中常用：
"scripts": {
"post-create-project-cmd": [
"php artisan key:generate",
"php artisan storage:link"
]
}
基本上就这些。合理使用 Composer 脚本能让你的项目开箱即用，减少文档说明和人为出错。关键是把重复的手动步骤转化为可靠的自动化流程。不复杂但容易忽略。
