当前位置：首页 > 文章列表 > 文章 > php教程 > PHP写入JSON失败怎么办

PHP写入JSON失败怎么办

2026-02-27 20:51:47 0浏览收藏

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

PHP 中 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.";
}
?>

? 关键总结：