Laravel中自定义PDF新标签页打开时的图标名称方法

当你直接通过asset()链接打开服务器上的PDF文件时，浏览器标签页的名称默认取的是PDF文件的元数据标题；如果PDF没有设置元数据，就会显示文件本身的名称（如果你的文件名是随机生成的，就会出现随机名称的情况）。下面提供两种可行的解决方法：

方法一：修改PDF文件的元数据标题 #

如果允许修改PDF文件本身，可以在上传PDF时，用第三方库给PDF添加自定义的标题元数据，这样浏览器打开时会自动读取这个标题作为标签页名称。

1. 安装处理PDF的库，比如setasign/fpdi：

composer require setasign/fpdi

2. 上传文件时添加处理逻辑（示例）：

use setasign\Fpdi\Fpdi;

// 假设这是上传后的文件路径
$uploadedFilePath = public_path('download/ca/' . $doc->file_name);
$newFilePath = $uploadedFilePath; // 直接覆盖原文件，或者生成新文件

$pdf = new Fpdi();
$pageCount = $pdf->setSourceFile($uploadedFilePath);

// 复制原PDF的所有页面
for ($pageNo = 1; $pageNo <= $pageCount; $pageNo++) {
    $templateId = $pdf->importPage($pageNo);
    $size = $pdf->getTemplateSize($templateId);
    $pdf->AddPage($size['orientation'], $size);
    $pdf->useTemplate($templateId);
}

// 设置PDF的标题元数据（用你自定义的名称，比如数据库里的文档标题$doc->title）
$pdf->setTitle($doc->title);

// 输出保存修改后的PDF
$pdf->Output('F', $newFilePath);

方法二：通过Laravel路由包裹PDF，自定义标签页标题 #

如果不想修改PDF文件，可以创建一个路由，用HTML页面嵌入PDF，从而完全控制标签页的标题。

1. 定义路由：

// routes/web.php
use App\Http\Controllers\PdfController;

Route::get('/view-pdf/{doc}', [PdfController::class, 'show'])->name('pdf.view');

2. 编写控制器方法：

// app/Http/Controllers/PdfController.php
namespace App\Http\Controllers;

use App\Models\Document; // 替换成你的文档模型类

class PdfController extends Controller
{
    public function show(Document $doc)
    {
        $pdfUrl = asset('download/ca/' . $doc->file_name);
        return view('pdf.view', compact('doc', 'pdfUrl'));
    }
}

3. 创建视图文件resources/views/pdf/view.blade.php：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{{ $doc->title }}</title> <!-- 这里就是自定义的标签页名称 -->
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }
        body {
            width: 100vw;
            height: 100vh;
            overflow: hidden;
        }
        iframe {
            width: 100%;
            height: 100%;
            border: none;
        }
    </style>
</head>
<body>
    <iframe src="{{ $pdfUrl }}"></iframe>
</body>
</html>

4. 修改前端链接：

<a class="download" target="_blank" href="{{ route('pdf.view', $doc) }}">打开PDF</a>

这样点击链接后，新标签页会打开这个HTML页面，标签名称就是你设置的$doc->title，页面里嵌入的PDF也能正常显示。

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