README

包

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

我创建此存储库的原因如下

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

版本

基于2017年5月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的原因。请告诉我是否有不适合现代框架使用类图的情况。

复选框

我添加了对复选框的支持。该功能测试不多，但对我有效。可以通过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();
?>

查看结果这里。

spenwall / fpdm

维护者

详细信息