Laravel动态创建目录权限异常：产品图片无法读取

场景说明 #

• 产品图片先上传至uploads临时目录，再移至products目录，最终路径示例：products/1/variants/1/image.jpeg
• 主目录products权限为0755，可正常访问
• 动态生成的/1/variants/1/目录权限为0700，导致图片无法读取

当前代码 #

$sourcePath = 'public/'.$image['path'];
$destinationPath = "products/".$product->id."/variants/".$variantImages['variantId']."/".pathinfo($sourcePath, PATHINFO_BASENAME);

Storage::makeDirectory("public/images/products/".$product->id."/variants/".$variantImages['variantId']);

Storage::move($sourcePath, "public/images/".$destinationPath);

注：使用Hostinger主机，图片已成功移动到目标目录，但权限问题导致无法读取

已尝试的解决方法 #

• storage:link符号链接配置正确
• storage磁盘的filesystem配置正确，权限设置为0755
• 尝试使用Storage::setVisibility()方法
• 使用Storage::makeDirectory($dir, 0755, true)创建目录

解决方案 #

1. 递归创建目录并指定权限 #

创建目录时开启递归生成父目录，并明确设置0755权限，确保Web服务器能访问所有层级目录：

$dir = "public/images/products/".$product->id."/variants/".$variantImages['variantId'];
// 第三个参数true表示递归创建所有不存在的父目录
Storage::makeDirectory($dir, 0755, true);

2. 移动文件后设置文件公开可见性 #

文件移动完成后，单独设置图片文件的可见性为公开，同时确保目录权限生效：

$finalPath = "public/images/".$destinationPath;
Storage::move($sourcePath, $finalPath);
// 设置文件为公开可读
Storage::setVisibility($finalPath, 'public');

3. 强制修改目录权限（针对Hostinger主机） #

部分主机的umask设置会覆盖代码中的权限配置，可在创建目录后手动修改权限：

$dir = "public/images/products/".$product->id."/variants/".$variantImages['variantId'];
Storage::makeDirectory($dir, 0755, true);
// 强制修改目录权限
chmod(storage_path($dir), 0755);

也可通过SSH执行命令验证：

chmod -R 0755 public/images/products/1/variants/1/

4. 确认filesystems配置正确性 #

检查config/filesystems.php中public磁盘的权限配置，确保目录和文件的默认权限符合要求：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
    'permissions' => [
        'file' => [
            'public' => 0644,
            'private' => 0600,
        ],
        'dir' => [
            'public' => 0755,
            'private' => 0700,
        ],
    ],
],

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