如何在不影响生产环境的情况下，为 Composer 项目引入新的开发工具？

在不影响生产环境的前提下为 Composer 项目引入新开发工具，关键是严格分离开发与运行时依赖：使用 composer require --dev 安装工具、部署时加 --no-dev 参数、禁用自动发现、条件加载服务提供者、隔离配置与脚本，并通过 composer install --no-dev 验证生产构建干净性。

在不影响生产环境的前提下为 Composer 项目引入新开发工具，核心是严格分离开发依赖与运行时依赖，并确保部署流程不加载或执行 dev-only 的代码和配置。

只在 dev 环境安装工具

使用 composer require --dev 安装所有开发专用工具（如 PHPUnit、PHPStan、PHP-CS-Fixer、Laravel Pint、infection 等）。这样它们只会写入 require-dev 区块，不会进入生产依赖树。

• 执行命令示例：composer require --dev phpunit/phpunit ^10
• 检查 composer.json，确认新增项出现在 "require-dev" 下，而非 "require"
• CI/CD 或上线部署时务必加 --no-dev 参数（如 composer install --no-dev --optimize-autoloader）

避免开发工具污染生产自动加载和配置

某些工具（尤其是带 ServiceProvider 或配置文件的 Laravel 扩展）可能在启动时被自动加载，即使未调用也会触发副作用。

• 禁用开发包的自动发现：在 composer.json 的 "extra" 中关闭自动发现，例如：
  "laravel": { "dont-discover": ["barryvdh/laravel-debugbar"] }
• 条件加载服务提供者：在 Laravel 中，仅在 APP_DEBUG=true 或 app()->environment('local', 'testing') 时注册调试类
• 将工具配置（如 phpstan.neon、phpcs.xml）放在项目根目录，不通过框架配置机制加载

隔离开发脚本与入口逻辑

不要把开发工具调用逻辑硬编码进生产入口文件（如 public/index.php 或 bootstrap/app.php）。

标签： composer 开发工具 php laravel js bootstrap json 编码 app 工具 配置文件