README

包

FPDM类允许填充PDF表单，即填充PDF文件的字段。它由FDPF库的作者Olivier Plathey开发，并被作为Skript 93发布。

我创建这个仓库的原因如下

通过composer使当前的FPDM源代码可用，通过classmaps自动加载
修复错误
- 修复：与PHP 7.x的兼容性问题 e376dc1 v2.9.1
- 修复：在多个文件中填充表单（错误的缓冲区使用，无效的偏移量） e376dc1 v2.9.1
- 修复：将ASCII对象名称转换为utf-8 1eddba7 v2.9.2
改进（对原始代码库的更改以//FIX: change description开头，并以//ENDFIX结尾）
- 新增：支持复选框（默认禁用，使用$pdf->useCheckboxParser = true;激活） 0375dd9 v2.9.2

版本

基于2017-05-11可从fpdf.org/en/script/script93.php获得的版本2.9。

注意：如果您发现新版本已托管在fpdf.org上，请随时给我发条简短信息，以确保我不会错过。

此仓库仅包含用于表单填充（FPDM）的单独PHP类。如果您在寻找包含主FPDF库的仓库，请前往github.com/Setasign/FPDF。

再次感谢Olivier Plathey提供了易于使用的脚本，用于表单填充，以及他的FPDF库！

安装

Composer

使FPDM在您的应用程序中可用的首选方式是使用以下命令通过composer安装

composer require tmw/fpdm

用法

Composer (自动加载)

通过添加以下内容到您的代码中自动加载 FPDM类文件

require 'vendor/autoload.php';

独立脚本（旧版）

通过调用以下内容加载顶级入口点

require_once '/abolute/path/to/fpdm.php';

或者

require_once './relative/path/to/fpdm.php';

对原始代码的修改

classmaps与psr-4（或：旧代码与现代化框架如Laravel）

使用命名空间和遵循PSR-4: Autoloader自动加载类是理想的。特别是通过使用供应商命名空间来减少命名冲突的风险。

然而，FPDM已经存在很长时间，因此它被用于许多使用非命名空间代码的项目（我称它们为旧项目）。旧项目通过调用$mypdf = new FPDM()实例化FPDM，这是无资格的，但默认为具有非命名空间代码的全局命名空间。

使用psr-4会将类自动加载到子命名空间（例如：\codeshell\fpdm\FPDM）而不是全局命名空间（例如：\FPDM），因此无论使用new FPDM()还是new \FPDM()，都会破坏任何旧代码。

类映射是一种折衷方案。 它允许利用Composers的自动加载和依赖管理。然而，类被添加到全局命名空间。旧项目可以在不重构代码的情况下切换到Composers。较新的项目（例如：使用laravel等框架，这些框架高度依赖命名空间）仍然可以通过使用完全限定名称（在这种情况下，类名前加全局前缀运算符，如new \FPDM()）来使用旧类。

这就是我选择使用类映射而不是psr-4进行FPDM的理由。请告诉我是否有使用类映射而无法与现代框架协同工作的用例。

复选框

我添加了对复选框的支持。这个功能测试不多，但对我来说是可行的。可以通过将useCheckboxParser = true启用，如下所示

<?php
$fields = array(
    'my_checkbox'    => 'anything that evaluates to true.', // checkbox will be checked;  Careful, that includes ANY non-empty string (even "no" or "unchecked")
    'another_checkbox' => false, // checkbox will be UNchecked; empty string or 0 work as well
);

$pdf = new FPDM('template.pdf');
$pdf->useCheckboxParser = true; // Checkbox parsing is ignored (default FPDM behaviour) unless enabled with this setting
$pdf->Load($fields, true);
$pdf->Merge();
$pdf->Output();

您不需要弄清楚复选框状态的技术名称。它们在解析过程中被检索。

原始信息页面

以下所有内容均来自http://www.fpdf.org/en/script/script93.php。

信息

作者：Olivier

许可证：FPDF

描述

此脚本允许将数据合并到PDF表单中。给定一个带有文本字段的模板PDF，可以以两种不同的方式注入值

从PHP数组
从FDF文件

生成的文档由Output()方法生成，该方法与FPDF相同。

注意：如果您的模板PDF与该脚本不兼容，您可以使用PDFtk按以下方式进行处理

pdftk modele.pdf output modele2.pdf

然后再次使用modele2.pdf尝试。

示例

此示例显示了如何从数组合并数据

<?php

/***************************
  Sample using a PHP array
****************************/

$fields = array(
    'name'    => 'My name',
    'address' => 'My address',
    'city'    => 'My city',
    'phone'   => 'My phone number'
);

$pdf = new FPDM('template.pdf');
$pdf->Load($fields, false); // second parameter: false if field values are in ISO-8859-1, true if UTF-8
$pdf->Merge();
$pdf->Output();
?>

查看结果这里。

paulferrett / fpdm

维护者

详细信息