如何使用chrome-php/chrome将Blade视图直接输出为PDF到浏览器？

完整实现代码 #

use HeadlessChromium\BrowserFactory;

public function createPdf(Request $request)
{
    // 初始化无头浏览器实例
    $browserFactory = new BrowserFactory();
    $browser = $browserFactory->createBrowser();

    try {
        // 直接渲染Blade视图为HTML字符串（无需依赖外部URL）
        $bladeHtml = view('your.blade.view.path', [
            // 传入Blade模板所需的变量，例如 'data' => $request->input('data')
        ])->render();

        // 创建页面并加载渲染好的HTML
        $page = $browser->createPage();
        $page->setHtml($bladeHtml);
        // 等待页面资源加载完成（根据视图是否有异步内容调整等待策略）
        $page->waitForNavigation(['waitUntil' => 'networkidle0']);

        // 生成PDF二进制数据
        $pdfBinary = $page->printToPdf([
            'format' => 'A4',
            'displayHeaderFooter' => false,
            // 可添加更多PDF配置，比如 margins、printBackground 等
        ])->get();

        // 设置响应头并输出PDF到浏览器
        return response($pdfBinary)
            ->header('Content-Type', 'application/pdf')
            ->header('Content-Disposition', 'inline; filename="document.pdf"')
            ->header('Content-Transfer-Encoding', 'binary')
            ->header('Expires', '0')
            ->header('Cache-Control', 'must-revalidate, post-check=0, pre-check=0')
            ->header('Pragma', 'public');
    } finally {
        // 确保浏览器实例被关闭，避免资源泄漏
        $browser->close();
    }
}

关键说明 #

• 跳过外部URL加载：直接用view()->render()把Blade模板转成HTML字符串，不需要走HTTP请求，既提升性能，也避免了域名配置、权限验证等额外问题。
• 直接生成PDF：chrome-php的printToPdf()方法会直接将当前页面渲染为PDF，调用get()就能拿到二进制数据，不需要额外处理HTML转PDF的中间步骤。
• 资源清理：用finally块确保浏览器实例无论成功失败都会被关闭，防止服务器资源占用过高。
• Laravel规范响应：用框架自带的response()方法设置头信息，比手动写header()更安全，也符合Laravel的开发规范。

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