PHP json_encode() 函数
示例
如何将关联数组编码为 JSON 对象
$age = array("Peter"=>35, "Ben"=>37, "Joe"=>43);
echo json_encode($age);
运行示例 »
定义和用法
The json_encode()
函数用于将值编码为 JSON 格式。
语法
json_encode(value, options, depth)
参数值
参数 | 描述 |
---|---|
value | 必填。指定要编码的值 |
options | 可选。指定位掩码 (JSON_FORCE_OBJECT, JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_INVALID_UTF8_IGNORE, JSON_INVALID_UTF8_SUBSTITUTE, JSON_NUMERIC_CHECK, JSON_PARTIAL_OUTPUT_ON_ERROR, JSON_PRESERVE_ZERO_FRACTION, JSON_PRETTY_PRINT, JSON_UNESCAPED_LINE_TERMINATORS, JSON_UNESCAPED_SLASHES, JSON_UNESCAPED_UNICODE, JSON_THROW_ON_ERROR) |
depth | 可选。指定最大深度 |
技术细节
返回值 | 成功时返回 JSON 编码字符串。失败时返回 FALSE |
---|---|
PHP 版本 | 5.2+ |
PHP 变更日志 | PHP 7.3: 添加了 JSON_THROWN_ON_ERROR 选项 PHP 7.2: 添加了 JSON_INVALID_UTF8_IGNORE 和 JSON_INVALID_UTF8_SUBSTITUTE 选项 PHP 7.1: 添加了 JSON_UNESCAPED_LINE_TERMINATORS 选项 PHP 5.6: 添加了 JSON_PRESERVE_ZERO_FRACTION 选项 PHP 5.5: 添加了 depth 参数 PHP 5.5: 添加了 JSON_PARTIAL_OUTPUT_ON_ERROR 选项 PHP 5.5: 将失败时的返回值从 null 更改为 FALSE PHP 5.4: 添加了 JSON_PRETTY_PRINT、JSON_UNESCAPED_SLASHES 和 JSON_UNESCAPED_UNICODE 选项 PHP 5.3: 添加了 JSON_FORCE_OBJECT、JSON_HEX_AMP、JSON_HEX_APOS、JSON_HEX_QUOT、JSON_HEX_TAG 和 JSON_NUMERIC_CHECK 选项 PHP 5.3: 添加了 options 参数 |
更多示例
❮ PHP JSON 参考