Laravel 9 + Intervention Image：图片保存路径写入失败问题求助

1. 确保目标目录已存在 #

Intervention Image 的 save() 方法不会自动创建不存在的多级目录，这是最容易忽略的问题。你需要先检查并手动创建目录：

$resizePath = 'uploads/resized/2024/05/image.jpg';
// 提取路径中的目录部分
$directory = dirname(storage_path($resizePath));

// 递归创建不存在的目录（0755是常规读写权限）
if (!File::exists($directory)) {
    File::makeDirectory($directory, 0755, true);
}

// 再执行保存操作
Image::make($uploadedFile)->resize(300, 200)->save(storage_path($resizePath));

注意：需要引入 Laravel 的 Illuminate\Support\Facades\File 门面。

2. 检查目录权限 #

Web 服务器进程（通常是 www-data、apache 或 nginx 用户）需要对目标目录有写入权限。在项目根目录执行以下命令调整权限：

# 递归设置storage目录权限
chmod -R 755 storage/
# 将目录归属设置为Web服务器用户（根据你的环境调整）
chown -R www-data:www-data storage/

3. 确认storage_path的拼接逻辑 #

storage_path() 默认指向项目根目录下的 storage 文件夹，而非 storage/app。如果你的目标是保存到 storage/app/uploads，路径拼接要准确：

// 正确指向 storage/app/uploads/resized/...
$resizePath = 'app/uploads/resized/2024/05/image.jpg';
$fullPath = storage_path($resizePath);

如果要保存到可公开访问的目录，应该用 public_path()，且需提前执行 php artisan storage:link 建立软链接：

// 指向 public/storage/uploads/resized/...
$resizePath = 'storage/uploads/resized/2024/05/image.jpg';
$fullPath = public_path($resizePath);

4. 检查文件名与路径合法性 #

避免路径中包含特殊字符（比如中文、空格、非常规符号），可以先对文件名做安全处理：

// 生成仅含合法字符的文件名
$originalName = pathinfo($uploadedFile->getClientOriginalName(), PATHINFO_FILENAME);
$extension = $uploadedFile->getClientOriginalExtension();
$safeFileName = preg_replace('/[^A-Za-z0-9_\-\.]/', '_', $originalName) . '.' . $extension;

$resizePath = "app/uploads/resized/" . date('Y/m') . "/" . $safeFileName;

完整可运行示例 #

use Illuminate\Support\Facades\File;
use Intervention\Image\Facades\Image;

public function handleImageResize($uploadedFile)
{
    // 生成安全文件名
    $originalName = pathinfo($uploadedFile->getClientOriginalName(), PATHINFO_FILENAME);
    $extension = $uploadedFile->getClientOriginalExtension();
    $safeFileName = preg_replace('/[^A-Za-z0-9_\-\.]/', '_', $originalName) . '.' . $extension;
    
    // 拼接目标路径
    $resizePath = "app/uploads/resized/" . date('Y/m') . "/" . $safeFileName;
    $fullPath = storage_path($resizePath);
    $directory = dirname($fullPath);

    // 创建目录（如果不存在）
    if (!File::exists($directory)) {
        File::makeDirectory($directory, 0755, true);
    }

    // 调整尺寸并保存
    return Image::make($uploadedFile)
        ->resize(300, 200, function ($constraint) {
            $constraint->aspectRatio(); // 保持宽高比
            $constraint->upsize(); // 避免放大小图
        })
        ->save($fullPath);
}

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