Laravel拆分前后端仓库后设置public、resources文件夹别名的实现方案

之前两类操作失败的核心原因各有不同：

• 直接手动创建的文件夹别名无法运行：这类别名多是系统快捷方式（.lnk文件），并非系统级的目录联接，程序访问时会识别为单个快捷方式文件，无法读取内部的目录结构，自然导致Laravel加载失败
• 创建symlink后框架能跑但入口index.php无法识别：Laravel内核的CLI路径解析已经兼容符号链接场景，但Web服务器的文档根权限、路径配置没有适配符号链接的真实跳转逻辑，触发了安全校验拦截

第一步：创建系统级可兼容的目录链接 #

根据操作系统执行对应命令，必须先删除后端目录下原有的空public、resources文件夹，再建立链接，不能直接在原有文件夹上叠加链接：

• Windows 环境（需以管理员身份打开命令提示符/PowerShell）：

  # 移除后端目录下原有空文件夹
  rmdir D:\laravel-backend\public
  rmdir D:\laravel-backend\resources
  # 创建目录联接（对程序兼容性远优于软符号链接、快捷方式）
  mklink /J D:\laravel-backend\public D:\laravel-frontend\public
  mklink /J D:\laravel-backend\resources D:\laravel-frontend\resources
  

• macOS / Linux 环境：

  # 移除后端目录下原有空文件夹
  rm -rf /var/www/laravel-backend/public /var/www/laravel-backend/resources
  # 创建软符号链接
  ln -s /var/www/laravel-frontend/public /var/www/laravel-backend/public
  ln -s /var/www/laravel-frontend/resources /var/www/laravel-backend/resources
  

第二步：适配Laravel的符号链接兼容配置 #

完成链接创建后，需要调整两处Laravel核心配置，避免框架的路径校验拦截跨目录的符号链接：

1. 强制Laravel使用解析后的真实绝对路径定位public目录
   打开bootstrap/app.php，在应用实例初始化位置添加路径覆盖逻辑：

   $app->usePublicPath(realpath(__DIR__.'/../public'));
   

   该配置会绕过Laravel默认的路径越权校验，直接读取符号链接指向的真实物理路径，不会再触发“路径不在项目目录内”的报错
2. 关闭文件系统适配器的符号链接拦截
   编辑config/filesystems.php，给本地磁盘的配置项增加符号链接兼容参数：

   'local' => [
       'driver' => 'local',
       'root' => storage_path('app'),
       'links' => \Illuminate\Filesystem\Filesystem::LINK_SYMLINK,
   ],
   

第三步：修复Web服务器对入口index.php的识别问题 #

这是CLI正常运行但网页访问失败的核心原因，需要根据使用的Web服务器调整配置：

• Apache 服务器适配
  打开站点配置文件，给后端public目录增加FollowSymLinks权限，不要禁止符号链接跳转：

  <Directory "/var/www/laravel-backend/public">
      Options Indexes FollowSymLinks
      AllowOverride All
      Require all granted
  </Directory>
  

  确保配置中没有强制关闭符号链接的规则，重启Apache服务即可
• Nginx 服务器适配
  不要把文档根路径指向符号链接所在的后端public路径，直接指向符号链接解析后的真实物理路径，绕过Nginx的跨目录安全校验：

  # 错误写法：指向符号链接路径，容易被安全规则拦截
  # root /var/www/laravel-backend/public;
  # 正确写法：指向符号链接对应的前端真实public路径
  root /var/www/laravel-frontend/public;
  index index.php index.html;
  

  同时确认Nginx运行账号对前端目录下的public、resources文件夹有读权限，不要开启disable_symlinks on的全局配置

最终校验 #

配置完成后执行两个验证步骤：

• 在后端项目根目录执行php artisan about，检查输出中public、resources的路径是否正常指向前端仓库的对应目录，没有报路径不存在的错误
• 在浏览器访问任意前端静态资源（比如编译后的css、js文件路径），确认能正常返回资源内容，不会触发404

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