PHP执行file_put_contents报错：无法打开流，已排查权限等配置

看起来你踩了两个常见的小坑：一个是路径指向了目录而非具体文件，另一个是数据传递环节可能出了问题。咱们一步步来解决：

1. 为什么会报「failed to open stream: Is a directory」错误？ #

你用的file_put_contents(data/)是把目录data/当成了目标文件，但file_put_contents要求必须指定具体的文件名，而不是目录。PHP没法直接往目录里写内容，所以才会抛出这个错误。

举个例子，你应该写成：

file_put_contents('data/saved-data.json', $yourData);

或者data/output.txt这类明确的文件名，而不是只写data/。

2. 为什么改成「X」会创建空文件？ #

这说明你的服务器权限、php.ini配置（比如allow_url_fopen、open_basedir）其实是没问题的——因为PHP能成功创建文件。空文件的问题几乎肯定是JS生成的数据没正确传递到PHP，或者PHP没正确接收。

排查数据传递环节： #

• JS端检查：
  如果你用AJAX发送数据，要确保：

  • 用JSON.stringify()把JS对象转成字符串（如果是JSON数据的话）；
  • 设置正确的请求头，比如Content-Type: application/json；
  • 请求方法是POST（GET不适合传大量数据）。

  示例JS代码：

  // 假设这是JS生成的数据
  const userData = { name: "John", scores: [85, 90] };
  
  // 发送到PHP脚本
  fetch('save-data.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(userData)
  })
  .then(res => res.text())
  .then(msg => console.log(msg))
  .catch(err => console.error('发送失败:', err));
  

• PHP端检查：
  如果是POST过来的JSON数据，不能直接用$_POST获取，得用file_get_contents('php://input')读取原始请求体：

  // 读取JS传来的原始数据
  $rawData = file_get_contents('php://input');
  if (empty($rawData)) {
      echo '错误：未接收到任何数据';
      exit;
  }
  

3. 完整可运行的示例代码 #

把上述步骤整合起来，这里给你一个完整的例子：

PHP脚本（save-data.php） #

<?php
// 目标文件路径：data目录下的user-data.json
$targetFile = 'data/user-data.json';

// 先确保data目录存在，不存在就创建
if (!is_dir('data')) {
    // 0755是常规目录权限，true表示递归创建父目录
    mkdir('data', 0755, true);
}

// 检查data目录是否可写
if (!is_writable('data')) {
    echo '错误：data目录不可写，请检查权限';
    exit;
}

// 读取请求数据
$rawData = file_get_contents('php://input');
if (empty($rawData)) {
    echo '错误：没有接收到JS传递的数据';
    exit;
}

// 写入文件
$writeResult = file_put_contents($targetFile, $rawData);
if ($writeResult !== false) {
    echo "成功保存数据，共写入{$writeResult}字节";
} else {
    echo '错误：写入文件失败';
}
?>

4. 额外排查点 #

如果还是有问题，可以试试这些：

• 在PHP里输出var_dump(is_writable('data/'));，确认目录确实可写；
• 检查PHP的open_basedir配置，确保data目录在允许的路径范围内；
• 如果是Linux服务器，检查SELinux状态（可以用getenforce命令查看），如果是Enforcing模式，可能需要设置目录的SELinux上下文。

内容的提问来源于stack exchange，提问作者Petr Palíšek