Composer本地与远程环境包加载技巧

本文介绍如何利用 franzl/studio 包，在本地开发环境中使用本地 Composer 包，而在生产环境中从远程 Git 仓库加载 Composer 包。通过 studio load 命令和 studio.json 文件，可以方便地管理本地包的 symlink，实现开发环境和生产环境的灵活切换，无需修改 composer.json 文件。

在开发 Laravel 包时，我们经常需要在本地环境中进行测试，而不想每次修改后都推送到远程仓库。一种高效的方法是利用 franzl/studio 包，它允许 Composer 在本地优先加载指定的包，而在生产环境中则从远程仓库拉取。

以下是具体步骤：

1. 全局安装 franzl/studio：

   首先，确保你已经全局安装了 franzl/studio。这只需要执行以下命令：

   composer global require franzl/studio

   虽然也可以在单个项目中安装 franzl/studio，但全局安装更方便，因为它主要用于本地开发环境。

2. 加载本地包：

   在你的项目根目录下，使用 studio load 命令来指定本地包的路径。例如，如果你想加载 packages 目录下所有的包，可以执行：

   studio load path/to/your/local/vendor/directory/*

   如果只想加载特定的包，例如 my-package，则执行：

   studio load path/to/your/local/package

   执行这些命令后，franzl/studio 会在你的项目根目录下创建一个 studio.json 文件，其中包含了本地包的路径信息。例如：

   {
       "version": 2,
       "paths": [
           "path/to/local/vendor/directory/*",
           "path/to/local/package"
       ]
   }

3. Composer 更新：

   每次运行 composer update 命令时，Composer 会首先检查 studio.json 文件。如果找到了对应的本地包，Composer 会创建一个指向本地包的 symlink。否则，Composer 会从远程仓库拉取包。

注意事项：

• 忽略 studio.json：
  务必将 studio.json 文件添加到 .gitignore 中，以防止将其提交到远程仓库。

• 生产环境处理：
  在将代码推送到生产环境之前，需要清空 studio.json 文件中的 paths 数组，并运行 composer update 命令，以生成新的 composer.lock 文件。这是为了确保生产环境从远程仓库加载包，而不是尝试使用本地 symlink。

  {
      "version": 2,
      "paths": [
  
      ]
  }

• 生产环境部署：
  在服务器上运行 composer install 命令。

• 开发环境恢复：
  在本地开发环境中，将 studio.json 文件恢复到初始状态，继续进行开发。

• 推送包到远程仓库：
  不要忘记将你的包推送到远程仓库，否则生产环境将无法获取到更新。

总结：

通过使用 franzl/studio 包，你可以方便地在本地开发环境中使用本地 Composer 包，而在生产环境中从远程 Git 仓库加载 Composer 包。这种方法避免了在不同环境之间修改 composer.json 文件的麻烦，提高了开发效率。只需记住在部署到生产环境之前，清空 studio.json 文件并更新 Composer 即可。