Laravel中使用file_get_contents()无法读取storage图片问题求助

1. 修复本地文件路径读取问题 #

你遇到的第一个错误核心是路径中包含URL编码的%20——本地文件系统无法识别URL编码的空格，必须替换为实际空格，同时确保storage_path指向正确位置：

// 直接使用带空格的文件名（推荐）
$templatePath = storage_path('img/lankstinukas mvp3.png');

// 或者用rawurldecode解码URL编码的路径
// $templatePath = rawurldecode(storage_path('img/lankstinukas%20mvp3.png'));

// 先检查文件是否存在，方便排查
if (!file_exists($templatePath)) {
    die("模板文件不存在，请检查路径：{$templatePath}");
}

$templateImage = imagecreatefromstring(file_get_contents($templatePath));

2. 绝对禁止用URL读取本地文件 #

用file_get_contents请求本地URL会触发请求阻塞（PHP单进程运行特性），导致请求超时卡死。本地文件必须用本地路径读取，绝对不要通过HTTP URL访问。

3. 修正GD库操作的其他错误 #

你的代码还有几处GD库使用问题，一并修正：

• getimagesize不能直接传入图片字符串，改用imagesx()/imagesy()获取GD资源的宽高
• imagecopymerge的目标资源应该是你用imagecreatefromstring生成的GD资源（而非原始二维码字符串）
• 循环中避免覆盖同一个输出文件，生成唯一文件名

修正后的完整代码：

use Illuminate\Support\Str;
use SimpleSoftwareIO\QrCode\Facades\QrCode;

for ($i=1; $i <= $data['table_count']; $i++) { 
    // 生成二维码图片字符串
    $qrImage = QrCode::format('png')
         ->size(200)
         ->generate('http://192.168.8.103:8000/detectagent?table='.$i);
    
    // 生成唯一输出文件名，避免循环覆盖
    $outputFile = 'qr_images/merged-' . Str::random() . '.png';
    // 确保输出目录存在
    if (!is_dir('qr_images')) {
        mkdir('qr_images', 0755, true);
    }

    // 转换为GD资源
    $qrGd = imagecreatefromstring($qrImage);
    
    // 读取模板图片
    $templatePath = storage_path('img/lankstinukas mvp3.png');
    if (!file_exists($templatePath)) {
        die("模板文件不存在，请检查路径：{$templatePath}");
    }
    $templateGd = imagecreatefromstring(file_get_contents($templatePath));

    // 获取二维码宽高
    $qrWidth = imagesx($qrGd);
    $qrHeight = imagesy($qrGd);

    // 合并图片（参数：目标图, 源图, 目标X, 目标Y, 源X, 源Y, 宽, 高, 透明度）
    // 如需将模板放到二维码上，交换两个GD资源位置即可
    imagecopymerge($templateGd, $qrGd, 100, 100, 0, 0, $qrWidth, $qrHeight, 100);

    // 保存合并后的图片
    imagepng($templateGd, $outputFile);
    
    // 释放GD资源，避免内存泄漏
    imagedestroy($qrGd);
    imagedestroy($templateGd);
}

额外检查项 #

• 确认storage/img目录和文件权限：给PHP进程分配读取权限（一般设为目录755、文件644）
• 软链接仅影响浏览器访问public/storage下的文件，你的模板在storage/img，所以软链接不影响本地路径读取，无需担心

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