在PHP开发中，判断一个文件是否为JSON格式需要结合文件属性校验和内容解析校验两个维度，单一的判断方式很容易出现误判或者错误。下面详细介绍完整的检测流程。
基础文件属性校验
在解析文件内容之前，首先需要确认文件的基本属性符合要求，避免后续操作出现不必要的错误。
- 确认文件是否存在，避免读取不存在的路径
- 确认文件是否可读，避免权限不足导致的读取失败
- 确认文件大小不为0，空文件不可能包含合法的JSON内容
下面是实现基础校验的代码示例：
<?php
/**
* 基础文件属性校验
* @param string $filePath 文件路径
* @return bool|string 校验通过返回true，否则返回错误信息
*/
function checkFileBasicAttr($filePath) {
// 判断文件是否存在
if (!file_exists($filePath)) {
return "文件不存在";
}
// 判断是否是文件
if (!is_file($filePath)) {
return "路径不是文件";
}
// 判断文件是否可读
if (!is_readable($filePath)) {
return "文件不可读";
}
// 获取文件大小
$fileSize = filesize($filePath);
if ($fileSize === 0) {
return "文件为空";
}
return true;
}
?>
核心JSON内容校验
完成基础属性校验后，需要读取文件内容并判断是否为合法的JSON格式，核心是使用json_decode函数解析内容，同时结合json_last_error判断解析是否成功。
需要注意json_decode的特殊情况：当传入的内容是字符串"null"时，解析结果会是null，但此时json_last_error返回的是JSON_ERROR_NONE，因此需要额外判断原内容是否是"null"字符串，避免误判。
下面是核心校验的代码实现：
<?php
/**
* 判断文件内容是否为合法JSON
* @param string $filePath 文件路径
* @return bool 是合法JSON返回true，否则返回false
*/
function isJsonFile($filePath) {
// 先执行基础属性校验
$basicCheck = checkFileBasicAttr($filePath);
if ($basicCheck !== true) {
return false;
}
// 读取文件内容
$content = file_get_contents($filePath);
if ($content === false) {
return false;
}
// 尝试解析JSON
$data = json_decode($content, true);
// 如果解析结果是null，需要判断原内容是否是字符串"null"
if ($data === null) {
$trimmedContent = trim($content);
// 原内容不是"null"字符串，说明解析失败
if ($trimmedContent !== "null") {
return false;
}
}
// 检查是否有JSON解析错误
if (json_last_error() !== JSON_ERROR_NONE) {
return false;
}
return true;
}
?>
完整使用示例
下面是调用上述函数判断文件是否为JSON的完整示例：
<?php
$testFile = "test.json";
if (isJsonFile($testFile)) {
echo "该文件是合法的JSON文件";
} else {
echo "该文件不是合法的JSON文件";
}
?>
不同场景的适配方案
根据使用场景的不同，可以调整判断逻辑：
- 如果是判断用户上传的文件，建议先校验文件扩展名是否为.json，再执行上述完整校验，减少不必要的文件读取操作
- 如果是判断系统内部生成的临时文件，可以跳过扩展名校验，直接执行内容和属性校验
- 如果需要校验JSON的结构是否符合预期，可以在解析成功后额外判断解析结果的类型，比如是否是数组、是否包含指定字段等
注意事项
json_decode函数在解析深度过大的JSON时可能会失败，默认解析深度是512，如果处理的JSON结构层级很深，可以通过json_decode的第三个参数指定更大的解析深度。
同时，读取大文件时file_get_contents可能会占用过多内存，如果处理的文件体积较大，建议使用流式读取的方式分段读取内容，避免内存溢出。
另外，不要仅通过文件扩展名判断是否为JSON文件，很多恶意文件可以伪造扩展名，必须结合内容解析校验才能保证判断的准确性。
PHPJSON文件检测json_decode修改时间：2026-07-02 12:21:16