README

❗ 本文档适用于 FPDI 2。版本 1 已弃用，开发已停止。❗

FPDI 是一组 PHP 类，帮助开发者从现有的 PDF 文档中读取页面，并将它们用作 FPDF 中的模板，由 Olivier Plathey 开发。除了包含 FPDF 的副本外，FPDI 不需要任何特殊的 PHP 扩展。

FPDI 也可以作为 TCPDF 或 tFPDF 的扩展使用。

使用 Composer 安装

由于 FPDI 可以与 FPDF、TCPDF 或 tFPDF 一起使用，我们没有在主 composer.json 文件中添加固定的依赖关系。您需要自己将依赖关系添加到您选择的 PDF 生成库中。

要使用 FPDI 与 FPDF 一起使用，请在您的 composer.json 文件中包含以下内容

{
    "require": {
        "setasign/fpdf": "1.8.*",
        "setasign/fpdi": "^2.0"
    }
}

如果您想使用 TCPDF，您必须更新您的 composer.json 为

{
    "require": {
        "tecnickcom/tcpdf": "6.2.*",
        "setasign/fpdi": "^2.0"
    }
}

如果您想使用 tFPDF，您必须更新您的 composer.json 为

{
    "require": {
        "setasign/tfpdf": "1.31.*",
        "setasign/fpdi": "^2.3"
    }
}

手动安装

如果您不使用 composer，只需在 /src 文件夹中要求 autoload.php 即可

require_once('src/autoload.php');

如果您实现了一个 PSR-4 自动加载器，只需按以下方式注册 src 路径

$loader = new \Example\Psr4AutoloaderClass;
$loader->register();
$loader->addNamespace('kadudutra\Fpdi', 'path/to/src/');

对版本 1 的更改

版本 2 是从零开始完全重写的 FPDI，它包含

• 命名空间代码
• 干净、最新的代码库和风格
• PSR-4 兼容的自动加载
• 性能提升高达 100%
• 更低的内存消耗
• 支持从字符串或流资源中读取 PDF 的本地支持
• 支持文件头之前有“无效”数据的文档
• 优化页面树解析
• 使用单独的异常
• 多种测试类型（单元测试、功能测试和视觉测试）

我们尽量保持主要方法和逻辑流程与版本 1 相同，但请注意，有一些不兼容的更改，您在升级到版本 2 时应考虑。

• 您需要使用 src/autoload.php 文件而不是 classes/FPDI.php 来加载代码。
• 类和特性现在是命名空间：kadudutra\Fpdi
• 以斜杠开始的页面边界，例如 /MediaBox，不再受支持。删除斜杠或使用 PdfReader\PageBoundaries 的常量。
• useTemplate() 或 getTemplateSize() 方法的 $x、$y、$width 和 $height 参数现在有更合理的默认值。将 0 作为宽度或高度将导致 InvalidArgumentException。
• getTemplateSize() 的返回值已更改为具有更多描述性键和可重用性的数组：使用 width 而不是 w，使用 height 而不是 h。
• 如果您想使用 FPDI 与 TCPDF，您需要重构代码以使用类 Tcpdf\Fpdi（自 2.1 版本起；在此之前为 TcpdfFpdi），而不是使用 FPDI。

示例与文档

一个简单的示例，导入单个页面并将其放置在新创建的页面上

<?php
use kadudutra\Fpdi\Fpdi;
// or for usage with TCPDF:
// use kadudutra\Fpdi\Tcpdf\Fpdi;

// or for usage with tFPDF:
// use kadudutra\Fpdi\Tfpdf\Fpdi;

// setup the autoload function
require_once('vendor/autoload.php');

// initiate FPDI
$pdf = new Fpdi();
// add a page
$pdf->AddPage();
// set the source file
$pdf->setSourceFile("Fantastic-Speaker.pdf");
// import page 1
$tplId = $pdf->importPage(1);
// use the imported page and place it at point 10,10 with a width of 100 mm
$pdf->useTemplate($tplId, 10, 10, 100);

$pdf->Output();

完整的用户文档和 API 参考文档可在此处找到：这里。