如何在Laravel应用中无需下载直接用Google Sheets打开上传的Excel文档

实现前提 #

你上传的Excel文件需要可被公网访问，Google Sheets预览服务需要拉取到目标文件资源才可正常渲染。

实现步骤 #

• 配置文件访问权限：如果文件存储在Laravel的public磁盘，先执行php artisan storage:link创建存储软链，确保文件可通过公网URL访问；如果是私有存储，使用Laravel的签名路由生成临时可访问链接，控制访问权限与有效期。
• 拼接Google预览地址：将你的文件访问URL进行URL编码后，拼接至Google Sheets预览固定前缀后，完整格式为：https://docs.google.com/gview?url=编码后的文件URL&embedded=true
• 页面渲染预览：可直接跳转该预览地址，也可以通过iframe标签将预览页内嵌到你的Laravel应用页面内，用户无需离开应用即可查看Excel内容。

代码示例 #

控制器逻辑 #

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\URL;

class ExcelPreviewController extends Controller
{
    public function preview($fileId)
    {
        // 此处替换为你自己的文件查询逻辑
        $file = \App\Models\UploadFile::findOrFail($fileId);
        
        // 公开存储文件获取访问URL
        $fileUrl = Storage::disk('public')->url('excel/' . $file->save_name);
        
        // 私有存储生成30分钟有效期的临时签名URL示例
        // $fileUrl = URL::temporarySignedRoute(
        //     'file.download',
        //     now()->addMinutes(30),
        //     ['id' => $fileId]
        // );
        
        $googlePreviewUrl = 'https://docs.google.com/gview?url=' . urlencode($fileUrl) . '&embedded=true';
        
        return view('excel.preview', compact('googlePreviewUrl'));
    }
}

Blade模板内嵌预览代码 #

<!DOCTYPE html>
<html>
<head>
    <title>Excel预览</title>
</head>
<body>
    <div style="width: 100%; height: 90vh;">
        <iframe src="{{ $googlePreviewUrl }}" width="100%" height="100%" frameborder="0"></iframe>
    </div>
</body>
</html>

注意事项 #

• 如果你的应用部署在内网环境、无公网访问地址，该方案无法使用，Google服务无法拉取内网文件资源
• 如果Excel包含敏感数据，务必使用临时签名链接，并且设置较短的有效期，避免文件地址泄露后被未授权人员访问

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