PHP wkhtmltox 库安装与使用教程

PHP wkhtmltox 库安装与使用教程

php-wkhtmltoxPHP bindings for libwkhtmltox项目地址:https://gitcode.com/gh_mirrors/ph/php-wkhtmltox

1. 项目目录结构及介绍

在 mreiferson/php-wkhtmltox 开源项目中，主要目录和文件包括：

• LICENSE：项目的MIT授权许可文件。
• README.md：项目简介和安装指南。
• config.m4 和 config.h：配置脚本和头文件，用于编译时的设置。
• phpwkhtmltox.c 和 phpwkhtmltox.h：C语言实现的核心扩展代码。
• test_image.php 和 test_pdf.php：测试脚本，分别用于验证图像转换和PDF转换功能。

这些文件共同构成了将libwkhtmltox库集成到PHP环境中的扩展模块。

2. 项目的启动文件介绍

由于这是个PHP扩展，没有传统意义上的"启动文件"。不过，你可以通过以下步骤来激活这个扩展并开始使用它：

1. 安装依赖：确保系统已经安装了wkhtmltopdf和必要的库（例如libwkhtmltox）。
2. 执行PHP配置脚本：phpize 来准备构建PHP扩展。
3. 配置扩展：./configure 指令通常会查找wkhtmltopdf命令和相应的库路径。
4. 编译扩展：make 命令生成编译后的扩展模块。
5. 安装扩展：make install 将模块移动到PHP的扩展目录。
6. 更新PHP配置：在你的 php.ini 文件中添加 extension=phpwkhtmltox.so 或相应平台的扩展名。
7. 重启PHP服务器或服务以应用更改。

然后，你可以导入wkhtmltox类并在PHP脚本中直接使用它们进行网页到PDF或图像的转换。

3. 项目的配置文件介绍

mreiferson/php-wkhtmltox 的配置主要是通过在运行时传递参数给构造函数来完成的，而不是传统的配置文件。例如，可以设置binary（wkhtmltopdf命令的完整路径）、commandOptions（传递给命令行的选项）等。此外，还可以通过调用setOptions() 方法来更改对象的配置。这里是一些例子：

// 创建PDF转换器实例
$convPdf = new \wkhtmltox\PDF\Converter([
    'binary' => '/path/to/wkhtmltopdf',
]);

// 添加页面选项
$pageOptions = [
    'page-width' => 'A4',
];
$convPdf->add('http://example.com', $pageOptions);

// 进行转换
$result = $convPdf->convert();

// 处理结果，如保存到文件
file_put_contents('output.pdf', $result);

请注意，更多关于可用选项的信息可以在 wkhtmltopdf 的官方文档中找到，尤其是页面设置部分。

至此，你应该了解了如何安装和使用这个PHP扩展来利用wkhtmltopdf的功能。如果有任何问题，记得查看项目页面上的Readme和其他资源，或者查阅官方文档以获取更详细的帮助。

php-wkhtmltoxPHP bindings for libwkhtmltox项目地址:https://gitcode.com/gh_mirrors/ph/php-wkhtmltox