PHP写入JSON失败的解决方法

PHP开发者在向JSON文件写入数据时，常因一个看似微小的拼写错误——将内置函数`json_encode()`误写为带美元符的`$json_encode()`——导致“未定义变量”警告和“null不可调用”的致命错误；本文不仅一针见血地指出这一高频陷阱，更提供经过实战验证的完整解决方案：从正确调用函数、读取-修改-重写原子操作，到添加文件锁、错误检测与JSON编码容错机制，助你写出稳定、安全、可维护的JSON持久化代码。

本文详解 PHP 操作 JSON 文件时因拼写错误导致的致命错误，重点解决将 json_encode() 误写为 $json_encode() 引发的“undefined variable”和“value of type null is not callable”问题，并提供完整、安全的 JSON 增量写入实践方案。

本文详解 PHP 操作 JSON 文件时因拼写错误导致的致命错误，重点解决将 `json_encode()` 误写为 `$json_encode()` 引发的“undefined variable”和“value of type null is not callable”问题，并提供完整、安全的 JSON 增量写入实践方案。

在 PHP 中向 JSON 文件追加或更新数据是常见需求，但初学者极易因函数名拼写疏忽引发严重运行时错误。如题所示，代码第 16 行出现：

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

此处 $json_encode 被解析为一个变量（而非函数），而该变量未定义，因此触发：

• Warning: Undefined variable $json_encode
• Fatal error: Value of type null is not callable

✅ 正确写法应为调用内置函数 json_encode()（无 $ 符号）：

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

但仅修正拼写仍不够健壮。以下是推荐的生产就绪型 JSON 写入流程，包含错误处理与数据安全措施：

✅ 完整修复版代码（含防御性编程）

<?php
$todoname = $_POST['todoname'] ?? '';
$todoname = trim($todoname);

if ($todoname === '') {
    http_response_code(400);
    echo "Error: Todo name cannot be empty.";
    exit;
}

// 1. 读取并验证 JSON 文件
$jsonFile = 'todo.json';
if (!file_exists($jsonFile)) {
    $jsonArray = [];
} else {
    $jsonContent = file_get_contents($jsonFile);
    if ($jsonContent === false) {
        die("Error: Failed to read $jsonFile");
    }
    $jsonArray = json_decode($jsonContent, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        die("Error: Invalid JSON in $jsonFile");
    }
}

// 2. 更新数据（避免重复键，支持去重逻辑）
if (!isset($jsonArray[$todoname])) {
    $jsonArray[$todoname] = ['completed' => false];
} else {
    // 可选：更新时间戳或忽略重复项
    $jsonArray[$todoname]['updated_at'] = date('c');
}

// 3. 安全写入（使用 LOCK_EX 防止并发冲突）
$encoded = json_encode($jsonArray, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
if ($encoded === false) {
    die("Error: Failed to encode JSON — " . json_last_error_msg());
}

if (file_put_contents($jsonFile, $encoded, LOCK_EX) === false) {
    die("Error: Failed to write to $jsonFile");
}

echo "Success: '$todoname' added to todo.json";
?>

⚠️ 关键注意事项

• 永远不要信任用户输入：对 $_POST['todoname'] 进行 trim() 和空值校验，必要时增加 htmlspecialchars() 或正则过滤（如仅允许字母、数字、短横线）。
• JSON 文件权限：确保 Web 服务器进程对 todo.json 有读写权限（如 chmod 644 todo.json），但切勿设为 777。
• 并发安全：使用 LOCK_EX 参数防止多请求同时写入导致数据丢失。
• 编码一致性：添加 JSON_UNESCAPED_UNICODE 确保中文等 Unicode 字符正确保存。
• 调试技巧：开发阶段可临时启用 error_reporting(E_ALL); ini_set('display_errors', 1); 快速定位问题。

掌握 json_encode() 的正确调用方式只是起点；构建可靠的数据持久层，需兼顾健壮性、安全性与可维护性。从一次拼写错误出发，理解 PHP 函数调用机制与文件 I/O 最佳实践，正是进阶的关键一步。

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