PHP: json_encode()

开发过程中经常使用到的API大部分使用JSON作为数据交换的格式,PHP使用json_encode()将PHP的不同类型的变量转换为对应的JSON字符串。虽然经常使用,但直到今天我才注意到原来json_encode()还支持第二个参数options。

函数原型

string json_encode(mixed $value [, int $options = 0])

参数说明

value

value可以为非resource类型的任意PHP变量。

options

目前我本地的PHP版本为5.3.2,因此只试验了5.3.0引入的常量,所有可用的常量以及它们含义可以在JSON Constant页面查看。每一个常量的字面意思表达的都很清楚,不过对于它们的使用场景我还有些疑惑,比如:可不可以混搭使用?

PHP 5.3.0

  • JSON_HEX_QUOT: 将所有的双引号(”)转换为\u0022。
    // 实例代码:
    $data = '"';
    echo json_encode($data); // "\""
    echo json_encode($data, JSON_HEX_QUOT); // "\u0022"
  • JSON_HEX_TAG: 将所有的大于号(>)转换为\u003E,将所有的小于号(<)转换为 \u003C。
  • JSON_HEX_AMP: 将所有的与号(&)转换为 \u0026。
  • JSON_HEX_APOS: 将所有的单引号(’)转换为\u0027。
  • JSON_FORCE_OBJECT: 当value为非关联数组时强制输出结果为JSON对象。在接收者要求数据为对象且value为空数组时使用。
    // 实例代码:
    $data = array();
    echo json_encode($data); // []
    echo json_encode($data, JSON_FORCE_OBJECT); // {}

PHP 5.3.3

  • JSON_NUMERIC_CHECK: Encodes numeric strings as numbers.

PHP 5.4.0

  • JSON_BIGINT_AS_STRING: Encodes large integers as their original string value. Available since PHP 5.4.0.
  • JSON_PRETTY_PRINT: Use whitespace in returned data to format it. Available since PHP 5.4.0.
  • JSON_UNESCAPED_SLASHES: Don’t escape /. Available since PHP 5.4.0.
  • JSON_UNESCAPED_UNICODE: Encode multibyte Unicode characters literally (default is to escape as \uXXXX). Available since PHP 5.4.0.

PS:今天花在浏览网页的时间太多了,也不知道写些什么,最后挑了个简单的话题完成了今天的更新任务。

Update:

多种JSON常量可以混搭使用,如将所有的单引号和双引号转换为对应的16进制Unicode编码:json_encode($data, JSON_HEX_QUOT + JSON_HEX_APOS);