求助：在Linux服务器通过PHP调用pdf2htmlEX转换PDF失败

我来帮你一步步排查这个跨环境部署的问题——毕竟从WAMP（Windows）转到Linux，工具运行的环境差异经常会导致这类故障：

1. 确认pdf2htmlEX已在Linux服务器上正确安装且可被PHP访问 #

Windows上的WAMP环境你已经配置好了pdf2htmlEX，但Linux服务器上大概率是默认没装的。先登录服务器终端，直接运行：

pdf2htmlEX --version

如果提示“command not found”，说明你需要先安装它（比如Ubuntu可以用apt-get install pdf2htmlex，CentOS用yum install pdf2htmlex，或者从源码编译安装）。

另外，即使安装了，PHP的exec调用可能找不到工具路径（因为web服务器用户的环境变量和你终端用户的不一样）。可以用which pdf2htmlEX获取工具的绝对路径，然后把PHP命令改成绝对路径调用：

<?php 
$cmd= "/usr/bin/pdf2htmlEX --zoom 1.3 sample.pdf sample.html"; 
exec($cmd, $output, $return);
?>

（注意替换成你实际查到的绝对路径）

2. 检查web服务器用户的权限 #

浏览器运行PHP时，执行命令的用户是web服务器的系统用户（比如www-data、apache或nginx），这个用户需要：

• 能读取sample.pdf文件
• 能写入生成sample.html的目录
• 有权限执行pdf2htmlEX工具

你可以在终端切换到web用户，手动执行命令测试：

sudo -u www-data pdf2htmlEX --zoom 1.3 /path/to/sample.pdf /path/to/sample.html

（替换成实际的文件绝对路径）如果这里报错，就能直接看到权限或路径的问题了。

3. 捕获命令的错误输出 #

默认情况下，exec只会捕获命令的标准输出（stdout），但工具运行失败的错误信息通常在标准错误（stderr）里。修改你的PHP代码，把stderr重定向到stdout，这样就能看到具体错误：

<?php 
$cmd= "pdf2htmlEX --zoom 1.3 sample.pdf sample.html 2>&1"; 
exec($cmd, $output, $return);
// 打印输出看错误
print_r($output);
echo "Return code: " . $return;
?>

返回码$return如果不为0，说明命令执行失败，$output里的内容会告诉你具体原因（比如依赖缺失、文件不存在等）。

4. 检查文件路径是否正确 #

PHP的工作目录可能不是你预期的web根目录，所以尽量使用绝对路径指定PDF源文件和生成的HTML文件，避免相对路径导致的找不到文件问题：

<?php 
$pdfPath = realpath(__DIR__ . '/sample.pdf');
$htmlPath = __DIR__ . '/sample.html';
$cmd= "/usr/bin/pdf2htmlEX --zoom 1.3 " . escapeshellarg($pdfPath) . " " . escapeshellarg($htmlPath);
exec($cmd, $output, $return);
?>

这里用escapeshellarg()包裹路径，避免路径里有空格或特殊字符导致命令解析错误。

5. 检查pdf2htmlEX的依赖库 #

Linux上pdf2htmlEX依赖一些底层库（比如poppler、fontconfig、cairo等），即使工具本身安装了，依赖缺失也会导致运行失败。直接在终端运行工具命令，如果有依赖错误，会明确提示你需要安装哪些库，按照提示安装即可。

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