同父目录下两个拆分Laravel项目如何互相调用对方程序类

方案核心选型 #

结合现有两个项目同根目录部署、无跨服务器调用需求的场景，最优方案为基于Composer的本地PSR-4路径自动加载双向注册，完全依托PHP原生类自动加载机制实现，无额外网络/服务开销，类调用性能与项目内部类完全一致，相比私有Composer仓库、HTTP/RPC接口调用、手动文件引入等方案，落地成本最低、维护效率最高。

具体落地步骤 #

1. 统一命名空间边界
   为避免两个项目的类命名冲突，首先给需要跨项目调用的公共业务类设置独立的、带项目标识的命名空间：
   • application-a（原1stlaravelproject）下custom-classes目录的类，统一使用AppA\\CustomClasses\\作为根命名空间，例如MyClass1.php文件开头声明namespace AppA\CustomClasses;
   • application-b（原2ndlaravelproject）下custom-classes目录的类，统一使用AppB\\CustomClasses\\作为根命名空间，例如MyClass2.php文件开头声明namespace AppB\CustomClasses;
     注意：不要两个项目的跨调用类都使用默认的App\\命名空间，避免自动加载映射互相覆盖。
2. 双向修改各自项目的composer.json自动加载规则
   两个项目均保留自身原有Laravel框架的自动加载配置（即原有的App\\指向app/目录的映射），在此基础上新增两类路径映射：
   • application-a的composer.json的autoload.psr-4段新增：
     • 自身跨调用类的映射："AppA\\CustomClasses\\": "custom-classes/"
     • 对方项目跨调用类的路径映射："AppB\\CustomClasses\\": "../application-b/custom-classes/"
       参考配置片段：

     "autoload": {
         "psr-4": {
             "App\\": "app/",
             "AppA\\CustomClasses\\": "custom-classes/",
             "AppB\\CustomClasses\\": "../application-b/custom-classes/"
         }
     }
     

   • application-b的composer.json的autoload.psr-4段做对称反向配置：
     • 自身跨调用类的映射："AppB\\CustomClasses\\": "custom-classes/"
     • 对方项目跨调用类的路径映射："AppA\\CustomClasses\\": "../application-a/custom-classes/"
3. 重新生成自动加载映射
   两个项目分别在自身根目录执行命令，刷新Composer类加载索引：
   composer dump-autoload

调用效果验证 #

完成配置后即可实现无差别双向调用：

• 在application-a的任意控制器/业务逻辑中，可直接引入并实例化对方项目的类：use AppB\CustomClasses\MyClass2;
• 在application-b的任意控制器/业务逻辑中，可直接引入并实例化对方项目的类：use AppA\CustomClasses\MyClass1;

关键注意事项 #

• 不要跨项目共享Laravel核心框架目录，仅将需要跨项目调用的独立业务逻辑目录做命名空间映射即可，否则会因两个项目的框架版本、依赖版本不一致出现自动加载冲突。
• 跨项目调用的类尽量设计为无状态纯逻辑，不要在类内部直接依赖本项目的容器、配置、请求上下文（如直接调用config()、auth()、request()等Laravel助手函数），否则在对面项目中调用时，读取到的是对方项目的上下文配置，会出现逻辑不符合预期的问题。
• 若后续两个项目互相依赖的类数量持续增加，说明项目拆分边界设计存在耦合问题，建议将公共逻辑抽离为同目录下的独立公共业务目录，两个项目均映射该公共目录的命名空间，取消双向互相依赖的结构，避免循环引用问题。

非适配场景说明 #

如果后续两个项目出现跨服务器部署、多团队独立发版的需求，可再切换为私有Composer仓库或RPC接口的方案，当前同根目录部署的场景下，路径自动加载的方案是效率最高、开销最小的选择。 #

内容的提问来源于stack exchange，提问作者Anonymous