使用dompdf保存文件时，变量文件名触发file_put_contents报错求助

兄弟，我之前也碰到过一模一样的问题，咱们一步步拆解排查，肯定能搞定：

首先明确核心：硬编码文件名能正常保存，用变量就报错，说明问题大概率出在$filename变量本身，或者拼接后的路径上，和dompdf的输出逻辑无关。

1. 先搞清楚拼接后的路径到底是什么 #

先把最终路径打印出来，看看是不是和你预期的一致——很多时候问题就藏在这里：

$fullPath = "../pdf/".$filename.".pdf";
var_dump($fullPath); // 直接输出实际路径，检查是否有异常

比如可能$filename是空值，导致路径变成../pdf/.pdf；或者$filename里包含了系统禁止的字符（Windows下的:、*、?、"、<、>、|，Linux下的/），这些都会直接导致文件无法创建。

2. 确保目标目录存在且有写入权限 #

别想当然认为../pdf目录一定存在，或者权限没问题：

$dir = "../pdf";
// 如果目录不存在，就递归创建（包括父目录）
if (!is_dir($dir)) {
    mkdir($dir, 0755, true);
}
// 检查目录是否允许写入
if (!is_writable($dir)) {
    die("目录 {$dir} 没有写入权限，请调整权限后重试！");
}

另外注意Linux环境的用户权限：如果你的web服务器是www-data用户，那../pdf目录需要给这个用户开放写入权限，可以用命令chown www-data:www-data ../pdf或者chmod 775 ../pdf调整。

3. 清理$filename里的非法字符 #

不管是Windows还是Linux，文件名都有严格的字符限制，先把非法字符过滤掉：

// 把所有非法字符替换成下划线，保留字母、数字、空格、短横线
$filename = preg_replace('/[^\w\s\-]/', '_', $filename);
// 如果你想更严格，只保留字母数字和下划线：
// $filename = preg_replace('/[^a-zA-Z0-9_]/', '', $filename);

这一步能彻底避免因为文件名里的特殊字符导致路径无效。

4. 整合后的完整代码 #

把上面的步骤串起来，代码大概是这样：

// 先处理文件名，清理非法字符
$filename = preg_replace('/[^\w\s\-]/', '_', $filename);
$fullPath = "../pdf/".$filename.".pdf";

// 检查并创建目标目录
$dir = dirname($fullPath);
if (!is_dir($dir)) {
    mkdir($dir, 0755, true);
}

// 检查目录写入权限
if (!is_writable($dir)) {
    throw new Exception("无法写入目录: {$dir}，请检查权限设置");
}

// 最后执行保存
$output = $dompdf->output();
file_put_contents($fullPath, $output);

按照这个流程排查，应该能解决你的问题。

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