README

包

此包是codeshell/fpdm的分支。我需要它与php 8.1兼容并通过composer可用，因此创建了此分支。我打算在将来将PDF表单填充功能放入一个完全兼容php 8.1的库中。

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

我创建此仓库的原因如下

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

版本

基于2.9版本（2017-05-11），可在fpdf.org/en/script/script93.php找到。

注意：如果您发现新版本已托管在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：自动加载器来自动加载类将是可取的。特别是通过使用供应商命名空间来减少命名冲突的风险。

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

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

类映射是一个折衷方案。 它允许利用composer的自动加载和依赖管理。然而，类被添加到全局命名空间。旧项目可以切换到composer而无需重构代码。较新的项目（例如利用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();

您不必找出复选框状态的 technical 名称。它们在解析过程中检索。

原始信息页面

以下所有内容均来自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();
?>

查看结果这里。

williamgall / fpdm

维护者

详细信息