Browsershot：网页截图和转换工具

Browsershot：网页截图和转换工具

browsershotConvert HTML to an image, PDF or string项目地址:https://gitcode.com/gh_mirrors/br/browsershot

1. 项目介绍

Browsershot 是一个 PHP 库，它允许你在后台通过控制无头版谷歌浏览器（Chromium）来捕获网页的快照并将其保存为图像或PDF。该项目依赖于 Puppeteer，一个Node.js库，提供了高级API来操控Chrome或Chromium。Browsershot 提供了简单易用的PHP接口，使得无需深入了解JavaScript，也能实现网页截图和页面转PDF的功能。

2. 项目快速启动

安装

首先确保你已经安装了Composer，然后在你的项目中运行以下命令安装Browsershot：

composer require spatie/browsershot

使用示例

创建一张网页快照：

use Spatie\Browsershot\Browsershot;

Browsershot::url('https://example.com')
    ->save(__DIR__.'/example.png');

生成PDF文件：

Browsershot::url('https://example.com')
    ->save(__DIR__.'/example.pdf');

从HTML字符串创建图片：

Browsershot::html('<h1>Hello world</h1>')
    ->save(__DIR__.'/example.png');

3. 应用案例和最佳实践

• 网站预览：在邮件通知或者管理面板中，可以生成网站的缩略图作为预览。
• PDF报告：将动态生成的HTML数据转换为PDF格式，方便用户下载或打印。
• 测试：验证网页在特定浏览器中的布局和样式。

最佳实践包括：

1. 避免在生产环境中生成大量截图，因为这可能会消耗大量的系统资源。
2. 在需要的时候才生成截图，而不是提前生成和存储。
3. 当处理大型或复杂的页面时，考虑分批处理，以防止内存溢出。

4. 典型生态项目

• Puppeteer：Browsershot 的底层实现工具，Node.js库，用于自动化和测试基于Chromium的浏览器。
• PhantomJS：一个已废弃的无头浏览器，Browsershot曾支持其作为备选方案。
• Spatie：提供了一系列高质量的PHP包，包括这个项目。

要了解更多关于Browsershot的详细功能、配置选项和解决方案，请参考其官方文档：

https://spatie.be/docs/browsershot/v4/introduction

在这个文档中，你可以找到如设置自定义浏览器语言、添加请求头、处理跨域问题等更多高级用法。

browsershotConvert HTML to an image, PDF or string项目地址:https://gitcode.com/gh_mirrors/br/browsershot