PHP生成PDF浏览器显示正常，保存至本地指定文件夹失败求助

你已经成功生成PDF并能在浏览器正常显示，但保存到本地文件夹时遇到了问题。file_put_contents返回false通常和权限、路径或内容捕获方式有关，下面是一步步的排查和解决方法：

1. 检查目标文件夹的权限 #

Web服务器的运行用户（比如www-data、apache或nginx）需要对目标文件夹拥有写入权限。你可以：

• 查看文件夹当前权限：执行命令 ls -l /path/to/your/folder
• 调整权限（如果需要）：chmod 755 /path/to/your/folder（允许所有者读写执行，其他用户读执行）
• 或者修改文件夹所属用户为服务器用户：chown www-data:www-data /path/to/your/folder

2. 使用绝对路径而非相对路径 #

相对路径容易出错，尤其是当PHP脚本不在当前工作目录时。建议使用绝对路径确保准确性：

// 示例：定义绝对目标目录
$targetDir = '/var/www/html/your-project/pdf-storage/';
// 确保目录存在，不存在则递归创建
if (!is_dir($targetDir)) {
    mkdir($targetDir, 0755, true);
}
$newFileName = $targetDir . 'generated-document.pdf';

你可以用realpath('.')查看当前脚本的绝对路径，辅助确认目标路径是否正确。

3. 正确捕获PDF生成的内容 #

如果你的PDF生成代码直接输出到浏览器（比如echo $pdf->output();），那么$newFileContent可能为空。需要先捕获输出缓冲的内容再保存：

// 开启输出缓冲
ob_start();
// 执行PDF生成逻辑（比如FPDF/TCPDF的代码）
$pdf->Output();
// 获取缓冲的PDF内容
$pdfContent = ob_get_clean();

// 尝试保存文件
$result = file_put_contents($newFileName, $pdfContent);
if ($result === false) {
    // 打印具体错误信息
    $error = error_get_last();
    echo "保存失败：" . $error['message'];
} else {
    echo "PDF已成功保存，文件大小：" . $result . "字节";
}

4. 排查PHP的文件系统限制 #

• 查看open_basedir配置：这个设置会限制PHP能访问的目录范围，可通过phpinfo()查看。若目标文件夹不在允许范围内，需修改php.ini或.htaccess解除限制。
• 检查磁盘空间：目标磁盘是否已满？可通过df -h命令查看剩余空间。
• 检查内存限制：如果PDF文件过大，可能超过memory_limit配置，需在php.ini中适当调整。

5. 调试技巧 #

当file_put_contents失败时，用error_get_last()获取具体错误信息，能快速定位问题：

if (file_put_contents($newFileName, $newFileContent) === false) {
    $error = error_get_last();
    var_dump($error);
}

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