Laravel中将public目录移至项目外后报错的解决求助

问题场景 #

需要将Laravel项目的public目录迁移至项目外部，调整后的目录结构如下：

-->|-Project
   |  |___app
   |  |___bootstrap
   |  |___....
   |-public

移动目录后出现错误：

Symfony\Component\Process\Exception\RuntimeException 

The provided cwd "C:\xampp\htdocs\site\ProjectNamexx\public" does not exist.

创建空public目录绕过该错误后，修改bootstrap/app.php中的路径配置：

$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);
$app->usePublicPath($app->basePath("public"));

将原本的dirname(__DIR__)替换为dirname(getcwd(), 1)，试图指向父目录的public文件夹，但又出现新错误：

In RecursiveDirectoryIterator.php line 43:

RecursiveDirectoryIterator::__construct(): Argument #1 ($directory) cannot be empty  

硬编码路径也未解决问题，需可行的解决思路。

解决思路 #

1. 正确指定public绝对路径 #

避免使用getcwd()（其依赖当前工作目录，CLI/Web环境下可能不一致），直接通过层级定位外部public目录：
修改bootstrap/app.php：

$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);
// 向上一级目录定位外部public
$app->usePublicPath(dirname(__DIR__, 1) . '/public');

或通过.env配置实现灵活路径：
在.env中添加：

APP_PUBLIC_PATH=../public

再修改bootstrap/app.php：

$app->usePublicPath($_ENV['APP_PUBLIC_PATH'] ?? $app->basePath('public'));

2. 清理无效空目录并修复CLI命令路径 #

删除之前创建的空public目录，避免系统混淆路径。部分CLI命令会默认读取项目内的public目录，可通过以下方式处理：

• 修改项目根目录的server.php（若使用内置开发服务器），将其中的public路径指向外部目录；
• 执行命令时，确保所有依赖public路径的操作都使用正确的外部路径参数。

3. 检查配置文件中的路径引用 #

确认配置文件中所有关联public目录的路径都已更新：

• config/filesystems.php中的public磁盘配置：

'public' => [
    'driver' => 'local',
    'root' => dirname(__DIR__, 1) . '/public/storage',
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

• config/app.php中的asset_url配置，确保指向外部public目录的URL。

4. 验证路径有效性 #

可在bootstrap/app.php中临时添加调试代码，确认路径是否正确存在：

$publicPath = dirname(__DIR__, 1) . '/public';
dd($publicPath, file_exists($publicPath)); // 输出路径并检查是否存在

确保输出的绝对路径与实际外部public目录完全匹配。

内容的提问来源于stack exchange，提问作者TAHER El Mehdi