PHP写入JSON失败怎么办

本文深入剖析了PHP开发中一个看似微小却极易引发致命错误的常见陷阱——误将JSON编码函数`json_encode()`写成带美元符的变量`$json_encode`，导致“未定义变量”警告和“空值不可调用”的严重崩溃；不仅提供精准修复方案，更系统梳理了生产环境中安全操作JSON文件的全套实践：从基础语法辨析、输入输出错误校验、目录写权限检查，到关键的原子写入机制（临时文件+重命名），以及中文支持、错误报告启用等细节，帮助开发者彻底规避静默失败与数据损坏风险，实现健壮可靠的JSON持久化。

本文详解 PHP 操作 JSON 文件时因误将函数名 json_encode 写成变量 $json_encode 导致的致命错误，提供完整修复方案、安全编码实践及常见陷阱总结。

本文详解 PHP 操作 JSON 文件时因误将函数名 `json_encode` 写成变量 `$json_encode` 导致的致命错误，提供完整修复方案、安全编码实践及常见陷阱总结。

在 PHP 开发中，动态读写 JSON 配置或数据文件（如待办清单 todo.json）是常见需求。但初学者常因语法混淆引发严重运行时错误——正如示例中所示：

file_put_contents('todo.json', $json_encode($jsonArray, JSON_PRETTY_PRINT));

该行代码试图调用一个名为 $json_encode 的变量（带 $ 前缀），而实际应调用的是内置函数 json_encode()。PHP 解析器因此报出两个关键错误：

• Warning: Undefined variable $json_encode（未定义变量警告）
• Fatal error: Value of type null is not callable（空值不可调用，因未定义变量默认为 null）

✅ 正确写法（修正后）：

file_put_contents('todo.json', json_encode($jsonArray, JSON_PRETTY_PRINT));

⚠️ 但仅修复拼写仍不够！以下是生产级 JSON 文件操作的必备实践：

1. 增加错误处理，避免静默失败

$json = file_get_contents('todo.json');
if ($json === false) {
    die("Error: Failed to read todo.json");
}

$jsonArray = json_decode($json, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    die("Error: Invalid JSON format in todo.json");
}

2. 写入前验证并确保目录可写

$filePath = 'todo.json';
if (!is_writable(dirname($filePath))) {
    die("Error: Directory containing {$filePath} is not writable.");
}

3. 使用原子写入，防止数据损坏（推荐）

$tempFile = $filePath . '.tmp';
$result = file_put_contents($tempFile, json_encode($jsonArray, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));
if ($result === false) {
    unlink($tempFile);
    die("Error: Failed to write temporary file.");
}
if (!rename($tempFile, $filePath)) {
    unlink($tempFile);
    die("Error: Failed to replace original file atomically.");
}

4. 完整健壮示例（含表单提交处理）

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $todoname = $_POST['todoname'] ?? '';
    $todoname = trim($todoname);

    if (empty($todoname)) {
        die("Error: Todo name cannot be empty.");
    }

    $filePath = 'todo.json';

    // 读取并解析
    $json = file_get_contents($filePath);
    if ($json === false) throw new Exception("Cannot read {$filePath}");
    $data = json_decode($json, true);
    if (json_last_error() !== JSON_ERROR_NONE) throw new Exception("Invalid JSON in {$filePath}");

    // 添加新条目（使用时间戳作唯一键更安全，避免重复名称冲突）
    $data[] = [
        'id' => uniqid(),
        'name' => $todoname,
        'completed' => false,
        'created_at' => date('c')
    ];

    // 原子写入
    $temp = $filePath . '.tmp';
    if (file_put_contents($temp, json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)) === false) {
        unlink($temp);
        throw new Exception("Write failed");
    }
    rename($temp, $filePath);

    echo "✓ Todo added successfully.";
}
?>

? 关键总结：

• ✅ 函数名无 $，变量名必须有 $ —— 这是 PHP 基础语法铁律；
• ✅ 永远校验 file_get_contents 和 json_decode 的返回值；
• ✅ 使用 JSON_UNESCAPED_UNICODE 避免中文被转义；
• ✅ 优先采用原子写入（临时文件 + rename），杜绝并发写入导致的数据截断；
• ✅ 初学阶段建议启用 error_reporting(E_ALL);，让所有警告/错误显式暴露。

遵循以上规范，即可安全、可靠地在 PHP 中持久化 JSON 数据，远离 undefined variable 和 not callable 类错误。

终于介绍完啦！小伙伴们，这篇关于《PHP写入JSON失败怎么办》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！