Alma9/Ubuntu22.04下PHP8.2配置PDFlib遇函数缺失及编译错误求助

• 运行环境：Alma 9 或 Ubuntu 22.04，PHP 8.2，无可用的PECL PDFlib二进制包
• 直接使用下载的php_pdflib.so扩展：核心函数可正常调用，但旧代码依赖的PDF_new()/pdf_new()函数缺失
• 尝试编译老旧版本源码（pdflib-4.1.4.tgz、PDFlib-Lite）时出现编译错误，具体错误信息如下：

/var/tmp/pdflib/pdf.c:144:19: note: to match this _(_
  144 |     _pdf_exception(PDF_get_errnum(pdf), PDF_get_apiname(pdf), \
      |                   ^
/var/tmp/pdflib/pdf.c:925:7: note: in expansion of macro _pdf_catch_
  925 |     } pdf_catch;
      |       ^~~~~~~~~
/var/tmp/pdflib/pdf.c: In function _zim_PDFlibException_get_errmsg_:
/var/tmp/pdflib/pdf.c:929:1: error: expected declaration or statement at end of input
  929 | } /* }}} */
      | ^
/var/tmp/pdflib/pdf.c: In function _zim_PDFlibException_get_apiname_:
/var/tmp/pdflib/pdf.c:929:1: error: expected declaration or statement at end of input
make: *** [Makefile:210: pdf.lo] Error 1
ERROR: `make' failed

现有大量基于PDFlib的PHP5.4代码需要迁移升级，按常规教程操作仍报错，需解决兼容问题。

解决方案 #

1. 使用兼容PHP8.2的PDFlib版本 #

pdflib-4.1.4、PDFlib-Lite都是针对PHP5.x的老旧版本，完全不兼容PHP8的语法和API规范。必须使用PDFlib 8.x及以上版本（推荐10.x稳定版），官方提供了适配PHP8.x的预编译扩展或源码：

• 替换现有php_pdflib.so：下载官方提供的匹配PHP8.2系统架构的预编译扩展，覆盖原有文件后重启PHP服务
• 自行编译：下载PDFlib最新版本的PHP绑定源码，而非老旧的4.x/Lite版本

2. 迁移旧代码到面向对象接口 #

PHP8.x下PDFlib已废弃PDF_new()这类过程式旧函数，需将代码迁移到官方推荐的面向对象接口：

• 旧PHP5.4代码示例：

$pdf = PDF_new();
PDF_open_file($pdf, "output.pdf");
PDF_begin_page($pdf, 595, 842);
// ...其他操作
PDF_end_page($pdf);
PDF_close($pdf);

• 适配PHP8.2的新代码：

$pdf = new PDFlib();
// 初始化文档
if ($pdf->begin_document("output.pdf", "") == 0) {
    die("初始化PDF失败: " . $pdf->get_errmsg());
}
$pdf->begin_page_ext(595, 842, "");
// ...其他操作
$pdf->end_page_ext("");
$pdf->end_document("");

3. 编译最新PDFlib扩展步骤（Ubuntu 22.04为例） #

• 安装编译依赖：

sudo apt update && sudo apt install php8.2-dev gcc make libc6-dev

• 下载PDFlib 10.x版本的PHP绑定源码包
• 解压后进入源码目录，执行编译安装：

phpize
./configure --with-pdflib=/path/to/pdflib-install-dir
make
sudo make install

• 编辑php.ini添加extension=pdflib.so，重启PHP-FPM或Apache服务

4. 临时兼容封装（应急用） #

若无法快速完成全量代码迁移，可通过自定义函数封装OO接口，模拟旧的过程式函数：

function PDF_new() {
    return new PDFlib();
}

function PDF_open_file($pdf, $filename) {
    return $pdf->begin_document($filename, "");
}

function PDF_begin_page($pdf, $w, $h) {
    return $pdf->begin_page_ext($w, $h, "");
}

// 按需封装其他旧函数，如PDF_end_page、PDF_close等

内容的提问来源于stack exchange，提问作者srvnk