PHP libwkhtmltox 绑定项目技术文档

2024-12-23 01:18:29作者：田桥桑Industrious

1. 安装指南

1.1 系统要求

CentOS 5.5 或更高版本，PHP 5.3.3 或更高版本（64位）
Mac OSX 10.6.4 Snow Leopard 或更高版本，PHP 5.2.12 或更高版本（64位）

1.2 前置条件

需要在系统的 LD 路径（如 /usr/local/lib）中安装 libwkhtmltox.* 库。
需要在系统的 include 路径（如 /usr/local/include）中安装 wkhtmltox 目录，该目录通常位于 wkhtmltopdf 项目的 src/include/wkhtmltox 路径下。

1.3 安装步骤

打开终端并进入项目目录。
运行以下命令进行安装：
```
$ phpize
$ ./configure
$ make install
```
编辑 php.ini 文件，添加以下行以加载扩展：
```
extension=phpwkhtmltox.so
```

1.4 OSX 特别说明

由于 QTBUG-5952 问题，需要在 libwkhtmltox.* 库文件所在的目录中放置 qt_menu.nib 目录，该目录可以从 QT 源码树中获取。

2. 项目的使用说明

2.1 基本使用

安装完成后，phpwkhtmltox 扩展将自动加载到 PHP 中。
可以通过 PHP 代码调用 libwkhtmltox 库的功能，生成 HTML 到 PDF 或图片的转换。

2.2 示例代码

<?php
// 初始化 wkhtmltox 库
$pdf = new WkHtmlToPdf();

// 设置页面内容
$pdf->addPage('<html><body><h1>Hello World</h1></body></html>');

// 生成 PDF 文件
$pdf->saveAs('output.pdf');
?>

3. 项目API使用文档

3.1 WkHtmlToPdf 类

addPage($html): 添加一个 HTML 页面到 PDF 生成队列。
saveAs($filename): 将生成的 PDF 保存到指定文件。
toString(): 将生成的 PDF 作为字符串返回。

3.2 WkHtmlToImage 类

addPage($html): 添加一个 HTML 页面到图片生成队列。
saveAs($filename): 将生成的图片保存到指定文件。
toString(): 将生成的图片作为字符串返回。

4. 项目安装方式

4.1 源码安装

下载项目源码并解压。
按照安装指南中的步骤进行安装。

4.2 包管理器安装

某些操作系统可能提供包管理器安装方式，具体请参考操作系统的包管理器文档。

通过以上文档，您应该能够顺利安装和使用 phpwkhtmltox 项目，并了解其基本 API 的使用方法。如有任何问题，请参考项目源码或相关文档。

登录后查看全文

PHP libwkhtmltox 绑定项目技术文档

1. 安装指南

1.1 系统要求

1.2 前置条件

1.3 安装步骤

1.4 OSX 特别说明

2. 项目的使用说明

2.1 基本使用

2.2 示例代码

3. 项目API使用文档

3.1 WkHtmlToPdf 类

3.2 WkHtmlToImage 类

4. 项目安装方式

4.1 源码安装

4.2 包管理器安装

项目优选