snappy

PHP 一键把网页转成 PDF 或图片，省时省力

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 440 🐛 待处理 21 👀 关注 126

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4473

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源PHP库，MIT许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类图像生成

开发团队KnpLabs

官网地址https://knplabs.com

GitHubhttps://github.com/KnpLabs/snappy

定价模式🏷️完全免费

价格说明开源PHP库，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言PHP

技术栈/模型hacktoberfest,html-to-image,html-to-pdf,image-generation,pdf-generation,php

GitHub 星标★ 4473

上线时间2010-06-16 00:00:00

代码更新2026-07-29

仓库体积649 KB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数10

项目介绍

Snappy 是一个 PHP 库，用于将 URL 或 HTML 页面转换为缩略图、快照或 PDF 文件。它本质上是 wkhtmltopdf 和 wkhtmltoimage 命令行工具的封装，通过 PHP 接口提供简洁的调用方式。该项目解决了 PHP 开发者需要快速生成网页截图或 PDF 文档时，直接调用底层工具复杂且易出错的问题。核心能力包括：从 URL 或 HTML 字符串生成 PDF、图片和缩略图；支持设置页面尺寸、边距、缩放等参数；提供流式输出或保存到文件；支持批量生成和缓存。Snappy 的 API 设计直观，易于集成到 Laravel 等框架中，适合报表生成、网页预览、文档存档等场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4473

技术标签

hacktoberfest image-generation php

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 20 分钟部署方式：库/依赖 4 步

环境要求

PHP 环境（用于运行 Composer 与代码）
Composer 包管理器
已安装 wkhtmltopdf / wkhtmltoimage 0.12.x 命令行工具（OSX、Linux、Windows 均可）

安装与启动步骤

1安装 wkhtmltox

Snappy 只是 wkhtmltopdf/wkhtmltoimage 的封装，必须先自行下载安装 0.12.x 版本，否则无法生成 PDF 或图片。
2引入 Snappy 库

在项目根目录用 Composer 安装 KnpLabs 官方的 Snappy 包，安装后即可在 PHP 代码中调用。
```
composer require knplabs/knp-snappy
```
3编写调用代码

在 PHP 中实例化 Snappy 的 PDF 或 Image 对象，调用 generateFromHtml/generateFromUrl 等方法生成文件或输出流。
4按需集成框架

若使用 Symfony、Laravel 或 Zend Framework，可改用对应的官方集成包简化配置。