在Laravel中高效返回二进制数据并动态识别MIME类型

// 示例：从某个服务或仓库获取二进制图片数据
// 假设 $this->repository->getImage($query) 返回的是原始二进制字符串
$binaryImageData = $this->repository->getImage($request->query);

// 确保数据非空，否则后续处理可能出错
if (empty($binaryImageData)) {
    return response('Image not found or empty.', 404);
}

/**
 * 从二进制数据中检测MIME类型
 *
 * @param string $binaryData 原始二进制数据
 * @return string 检测到的MIME类型，如果失败则返回 'application/octet-stream'
 */
function detectMimeTypeFromBinary(string $binaryData): string
{
    // 检查 fileinfo 扩展是否可用
    if (!extension_loaded('fileinfo')) {
        // 如果不可用，生产环境中应记录日志或抛出异常
        // 对于无法识别的二进制数据，通常使用 'application/octet-stream'
        return 'application/octet-stream';
    }

    $finfo = finfo_open(FILEINFO_MIME_TYPE); // 返回MIME类型
    if ($finfo === false) {
        // finfo_open 失败，可能是内存不足或其他系统问题，生产环境中应记录日志
        return 'application/octet-stream';
    }

    $mimeType = finfo_buffer($finfo, $binaryData);
    finfo_close($finfo);

    // finfo_buffer 可能会返回 false 或空字符串，处理这种情况
    if ($mimeType === false || empty($mimeType)) {
        return 'application/octet-stream';
    }

    return $mimeType;
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Response; // 可以使用此Facade

class ExampleController extends Controller
{
    // ... 假设 $this->repository 已经注入或可用

    public function testImage(Request $request)
    {
        // 1. 从某个源（如数据库或API）获取原始二进制数据
        $binaryImageData = $this->repository->getImage($request->query);

        if (empty($binaryImageData)) {
            return response('Image not found or empty.', 404);
        }

        // 2. 动态检测MIME类型
        $mimeType = $this->detectMimeTypeFromBinary($binaryImageData);

        // 3. 构建响应
        return Response::make($binaryImageData)
            ->header('Content-Type', $mimeType)
            // 示例文件名，可根据实际情况动态生成。
            // 'inline' 表示浏览器尝试显示内容，'attachment' 表示强制下载。
            ->header('Content-Disposition', 'inline; filename="image.jpg"');
    }

    /**
     * 从二进制数据中检测MIME类型
     *
     * @param string $binaryData 原始二进制数据
     * @return string 检测到的MIME类型，如果失败则返回 'application/octet-stream'
     */
    private function detectMimeTypeFromBinary(string $binaryData): string
    {
        if (!extension_loaded('fileinfo')) {
            // 生产环境中应记录日志：fileinfo 扩展未加载
            return 'application/octet-stream';
        }

        $finfo = finfo_open(FILEINFO_MIME_TYPE);
        if ($finfo === false) {
            // 生产环境中应记录日志：finfo_open 失败
            return 'application/octet-stream';
        }

        $mimeType = finfo_buffer($finfo, $binaryData);
        finfo_close($finfo);

        if ($mimeType === false || empty($mimeType)) {
            return 'application/octet-stream';
        }

        return $mimeType;
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Response;

class FileDownloadController extends Controller
{
    /**
     * 从存储中返回文件，并自动检测MIME类型
     *
     * @param Request $request
     * @param string $filename 要返回的文件名（在storage中）
     *