在日常的 PHP 项目开发中，我们都会利用 Composer 来管理项目的依赖。同时，Composer 的 scripts 功能也为我们提供了极大的便利，可以在特定的生命周期事件（如 post-install-cmd、post-update-cmd）或者通过自定义命令来执行各种自动化任务。然而，随着项目复杂度的增加，一个常见的问题也随之浮现：如何区分和管理那些仅限于开发环境的脚本？
遇到的困境：开发脚本与生产环境的混淆
想象一下这样的场景：你的项目需要前端构建工具，所以你在 post-install-cmd 中加入了 npm install。为了运行单元测试，你又添加了 phpunit 命令。这些都是开发过程中必不可少的步骤。但问题是，当你的项目部署到生产服务器时，你可能不希望执行 npm install --dev（因为生产环境只需要编译好的静态文件），更不希望在生产环境中安装和运行 phpunit。
一开始，我尝试过手动管理：在部署到生产环境前，手动修改 composer.json，注释掉或移除那些开发脚本；或者依赖复杂的部署脚本来判断环境。这不仅繁琐，容易出错，而且让 composer.json 变得混乱不堪，难以维护。我的 composer.json 文件一度因为这些来回修改而变得面目全非，团队成员也常常因为忘记某个步骤而导致开发环境或生产环境配置不一致。
neronmoon/scriptsdev：为开发脚本而生
就在我为这种混乱感到沮丧时，我发现了 neronmoon/scriptsdev 这个 Composer 插件。它的核心思想非常简单却又极其强大：像 require-dev 管理开发依赖一样，管理开发环境专属的脚本。这意味着你可以定义一组脚本，它们只会在 Composer 处于开发模式（即安装了开发依赖）时才会被执行。
如何使用 neronmoon/scriptsdev 解决问题？
解决这个问题，只需要简单的两步：
-
安装插件
首先，你需要将
neronmoon/scriptsdev作为开发依赖安装到你的项目中。composer require neronmoon/scriptsdev --dev
--dev标志确保这个插件本身也只在开发环境中安装，不会污染你的生产环境。 -
配置
composer.json安装完成后，你就可以在
composer.json文件的extra部分，添加一个scripts-dev指令来定义你的开发专属脚本了。{ "name": "your-vendor/your-project", "description": "Your project description", "require": { "php": ">=7.4" // ... 其他生产依赖 }, "require-dev": { "phpunit/phpunit": "^9.5", "neronmoon/scriptsdev": "^1.0" // 插件本身作为开发依赖 // ... 其他开发依赖 }, "scripts": { "post-install-cmd": [ "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"" // 这里放置生产和开发都需要的脚本 ], "post-update-cmd": [ // ... ] }, "extra": { "scripts-dev": { "post-install-cmd": [ "npm install --dev", "php artisan migrate --seed" // 例如，开发环境需要迁移并填充数据 ], "post-update-cmd": "php ./someCoolDevCommand.php", "test": "phpunit", "cs-fix": "php-cs-fixer fix" } }, "config": { "allow-plugins": { "neronmoon/scriptsdev": true } } }在这个配置中，
extra.scripts-dev下的脚本（如npm install --dev、phpunit）将只在你运行composer install或composer update且没有使用--no-dev标志时执行。当你运行composer install --no-dev来部署生产环境时，这些脚本则会被完全忽略，大大提升了部署的效率和安全性。你甚至可以定义自定义的开发脚本，比如
composer test将会执行phpunit。
优势与实际应用效果
使用 neronmoon/scriptsdev 带来了多方面的显著优势：
-
清晰的职责分离：
composer.json变得更加整洁和易读。生产环境的脚本和开发环境的脚本泾渭分明，一目了然。 - 提高部署效率：生产环境部署时，不再需要执行不必要的开发任务，加快了 CI/CD 流水线，减少了潜在的错误。
- 环境一致性：确保了开发团队成员在设置新项目时，所有开发工具和依赖都能自动正确地初始化，避免了“在我机器上能跑”的问题。
- 自动化开发流程：可以轻松自动化开发环境的初始化步骤，如安装前端构建工具、生成测试数据、运行代码风格检查等。
-
减少维护负担：不再需要手动修改
composer.json或编写复杂的条件判断逻辑来区分环境。
虽然 composer validate 命令可能会提示一些关于 extra.scripts-dev 的次要警告（因为它不是 Composer 官方 schema 的一部分），但这通常是一个可以接受的权衡，相比它带来的便利性，这些警告微不足道。
总结
neronmoon/scriptsdev 是一个简单而强大的 Composer 插件，它通过引入“开发脚本”的概念，极大地优化了 PHP 项目的开发和部署流程。如果你也曾为开发环境和生产环境脚本的混淆而烦恼，那么我强烈推荐你尝试一下这个工具。它能让你的 composer.json 更干净、你的工作流更高效、你的团队协作更顺畅。告别混乱，拥抱清晰，从今天开始用 neronmoon/scriptsdev 提升你的开发体验吧！
