源码分析系列之json_encode()如何转化一个对象-巨人网络通讯

源码分析系列之json_encode()如何转化一个对象

初步测试

我们需要新建一个具有多种属性的对象

新建 JsonTest

class JsonTest
{
    public const TEST = 'c';
    public $a = 'a';
    public static $b = 'b';
    protected $e = 'e';
    private $d = 'd';
 
    protected function test1()
    {
        return __FUNCTION__;
    }
 
    private function test2()
    {
        return __FUNCTION__;
    }
 
    public function test3()
    {
        return __FUNCTION__;
    }
 
    public static function test4()
    {
        return __FUNCTION__;
    }
}

执行打印结果

echo json_encode(new JsonTest());

输出

{ "a": "a" }

可以看得出，只有公开非静态的属性被打印出来了，其他东西（常量、私有变量、方法等等）都丢失了。

思考

在实际的应用中，多数情况下，我们的属性都是非公开的，但是我们又想在执行 json_encode() 的时候将它打印出来，该怎么办呢？

JsonSerializable

JsonSerializable 是一个 PHP 的 JSON 序列化接口

官方定义

JSON 序列化接口

(PHP 5 >= 5.4.0, PHP 7)

简介

实现 JsonSerializable 的类可以在 json_encode() 时定制他们的 JSON 表示法。

接口摘要

JsonSerializable {
    /* 方法 */
    abstract public jsonSerialize ( void ) : mixed
}

可以看出 php 版本低于 5.4 是没有这个接口的

修改 JsonTest 继续测试

修改 JsonTest 让它实现 JsonSerializable，并为其写一个 jsonSerialize 方法

class JsonTest implements JsonSerializable
{
    public const TEST = 'c';
    public $a = 'a';
    public static $b = 'b';
    protected $e = 'e';
    private $d = 'd';
 
    protected function test1()
    {
        return __FUNCTION__;
    }
 
    private function test2()
    {
        return __FUNCTION__;
    }
 
    public function test3()
    {
        return __FUNCTION__;
    }
 
    public static function test4()
    {
        return __FUNCTION__;
    }
 
    public function jsonSerialize()
    {
        $json = array();
        foreach ($this as $key => $value) {
            $json[$key] = $value;
        }
        return $json;
    }
}

执行打印结果

echo json_encode(new JsonTest());

输出

{ "a": "a", "e": "e", "d": "d" }

可以看得出，公开属性和私有属性都被打印出来了，方法，常量以及静态变量没有打印出来（这是因为类(class)中静态变量和常量的实现方式是所有对象共享的，并不具体属于某个类）

源码分析

这部分源码较多，我会按照源码中的 function 来一个一个进行分析，注意看代码块中的注释

里边对应有一些 option 的位运算，我先贴出来每个 option 常量对应的值，是左移

/* json_encode() options */
#define PHP_JSON_HEX_TAG                    (10)
#define PHP_JSON_HEX_AMP                    (11)
#define PHP_JSON_HEX_APOS                   (12)
#define PHP_JSON_HEX_QUOT                   (13)
#define PHP_JSON_FORCE_OBJECT               (14)
#define PHP_JSON_NUMERIC_CHECK              (15)
#define PHP_JSON_UNESCAPED_SLASHES          (16)
#define PHP_JSON_PRETTY_PRINT               (17)
#define PHP_JSON_UNESCAPED_UNICODE          (18)
#define PHP_JSON_PARTIAL_OUTPUT_ON_ERROR    (19)
#define PHP_JSON_PRESERVE_ZERO_FRACTION     (110)
#define PHP_JSON_UNESCAPED_LINE_TERMINATORS (111)

函数本身

PHP_JSON_API int php_json_encode(smart_str *buf, zval *val, int options) /* {{{ */
{
	return php_json_encode_ex(buf, val, options, JSON_G(encode_max_depth));
}
PHP_JSON_API int php_json_encode_ex(smart_str *buf, zval *val, int options, zend_long depth) /* {{{ */
{
	php_json_encoder encoder;
	int return_code;
    // 初始化，开辟内存空间
	php_json_encode_init(encoder);
	encoder.max_depth = depth;
    // 真正用于编码的函数体
	return_code = php_json_encode_zval(buf, val, options, encoder);
	JSON_G(error_code) = encoder.error_code;
	return return_code;
}
/* }}} */

可以看出真正的编码函数是 php_json_encode_zval()

php_json_encode_zval()

smart_str_appendl() 是一个拼接字符串的函数，第三个参数是字符串的长度

buf 就是最终要返回的 json 字符串

int php_json_encode_zval(smart_str *buf, zval *val, int options, php_json_encoder *encoder) /* {{{ */
{
again:
	switch (Z_TYPE_P(val))
	{
		case IS_NULL:
			smart_str_appendl(buf, "null", 4);
			break;
		case IS_TRUE:
			smart_str_appendl(buf, "true", 4);
			break;
		case IS_FALSE:
			smart_str_appendl(buf, "false", 5);
			break;
		case IS_LONG:
			smart_str_append_long(buf, Z_LVAL_P(val));
			break;
		case IS_DOUBLE:
			if (php_json_is_valid_double(Z_DVAL_P(val))) {
				php_json_encode_double(buf, Z_DVAL_P(val), options);
			} else {
				encoder->error_code = PHP_JSON_ERROR_INF_OR_NAN;
				smart_str_appendc(buf, '0');
			}
			break;
		case IS_STRING:
			return php_json_escape_string(buf, Z_STRVAL_P(val), Z_STRLEN_P(val), options, encoder);
		case IS_OBJECT:
            // 如果对象实现了JsonSerializable，就将对象中的jsonSerialize()返回的结果进行编码
			if (instanceof_function(Z_OBJCE_P(val), php_json_serializable_ce)) {
				return php_json_encode_serializable_object(buf, val, options, encoder);
			}
            // 如果对象没有实现了JsonSerializable，就执行下边的这个php_json_encode_array()
			/* fallthrough -- Non-serializable object */
		case IS_ARRAY:
            // 解析数组
			return php_json_encode_array(buf, val, options, encoder);
		case IS_REFERENCE:
            //忽略引用
			val = Z_REFVAL_P(val);
			goto again;
		default:
			encoder->error_code = PHP_JSON_ERROR_UNSUPPORTED_TYPE;
			if (options  PHP_JSON_PARTIAL_OUTPUT_ON_ERROR) {
				smart_str_appendl(buf, "null", 4);
			}
			return FAILURE;
	}
	return SUCCESS;
}
/* }}} */

php_json_encode_array()

这个函数递归编码数组及没有实现JsonSerializable()的对象（只编码对象的公开属性）

static int php_json_encode_array(smart_str *buf, zval *val, int options, php_json_encoder *encoder) /* {{{ */
{
	int i, r, need_comma = 0;
	HashTable *myht;
	// r用来表示输出 `json` 的结构类型是数组还是对象
    // 只有自然排序的数组（['a','b','c']）才有可能被输出为数组（考虑option可能为JSON_FORCE_OBJECT）
	if (Z_TYPE_P(val) == IS_ARRAY) {
        // 如果是数组
		myht = Z_ARRVAL_P(val);
     	// options中有JSON_FORCE_OBJECT 就强制输出对象，否则就判断数组是不是自然数组
		r = (options  PHP_JSON_FORCE_OBJECT) ? PHP_JSON_OUTPUT_OBJECT : php_json_determine_array_type(val);
	} else {
		myht = Z_OBJPROP_P(val);
        //对象就是输出对象
		r = PHP_JSON_OUTPUT_OBJECT;
	}
	if (myht  ZEND_HASH_GET_APPLY_COUNT(myht) > 0) {
		encoder->error_code = PHP_JSON_ERROR_RECURSION;
		smart_str_appendl(buf, "null", 4);
		return FAILURE;
	}
	PHP_JSON_HASH_APPLY_PROTECTION_INC(myht);
	if (r == PHP_JSON_OUTPUT_ARRAY) {
        //输出为数组 就用 [ 做开头
		smart_str_appendc(buf, '[');
	} else {
        //输出为对象 就用 { 做开头
		smart_str_appendc(buf, '{');
	}
    // 当前递归的深度
	++encoder->depth;
    // zend_hash_num_elements 返回哈希表中元素的数量
	i = myht ? zend_hash_num_elements(myht) : 0;
	if (i > 0) {
		zend_string *key;
		zval *data;
		zend_ulong index;
        //遍历当前维度的数组 如果当前元素不是数组
		ZEND_HASH_FOREACH_KEY_VAL_IND(myht, index, key, data) {
            // ↓ begin 从这里开始都是判断key怎么处理以及元素末尾怎么处理  ↓↓↓↓
			if (r == PHP_JSON_OUTPUT_ARRAY) {
                //need_comma初始值是0
				if (need_comma) {
					smart_str_appendc(buf, ',');
				} else {
					need_comma = 1;
				}
				//这两个方法是option中有JSON_PRETTY_PRINT的时候才会执行的
				php_json_pretty_print_char(buf, options, '\n');
				php_json_pretty_print_indent(buf, options, encoder);
			} else if (r == PHP_JSON_OUTPUT_OBJECT) {
				if (key) {
					if (ZSTR_VAL(key)[0] == '\0'  ZSTR_LEN(key) > 0  Z_TYPE_P(val) == IS_OBJECT) {
                        //跳过受保护的属性和私有属性
						/* Skip protected and private members. */
						continue;
					}
 					//need_comma初始值是0
					if (need_comma) {
						smart_str_appendc(buf, ',');
					} else {
						need_comma = 1;
					}
					php_json_pretty_print_char(buf, options, '\n');
					php_json_pretty_print_indent(buf, options, encoder);
                    // 处理字符串属性的key（例如判断key中的中文或者特殊字符的处理）
					if (php_json_escape_string(buf, ZSTR_VAL(key), ZSTR_LEN(key),
								options  ~PHP_JSON_NUMERIC_CHECK, encoder) == FAILURE 
							(options  PHP_JSON_PARTIAL_OUTPUT_ON_ERROR) 
							buf->s) {
						ZSTR_LEN(buf->s) -= 4;
						smart_str_appendl(buf, "\"\"", 2);
					}
				} else {
					if (need_comma) {
						smart_str_appendc(buf, ',');
					} else {
						need_comma = 1;
					}
					php_json_pretty_print_char(buf, options, '\n');
					php_json_pretty_print_indent(buf, options, encoder);
					smart_str_appendc(buf, '"');
					smart_str_append_long(buf, (zend_long) index);
					smart_str_appendc(buf, '"');
				}
				smart_str_appendc(buf, ':');
				php_json_pretty_print_char(buf, options, ' ');
			}
			// ↑ end 从这里之前都是判断key怎么处理以及元素末尾怎么处理  ↑↑↑↑
            //继续调用对普通元素编码的 php_json_encode_zval() （实现数组和对象的递归闭环）
			if (php_json_encode_zval(buf, data, options, encoder) == FAILURE 
					!(options  PHP_JSON_PARTIAL_OUTPUT_ON_ERROR)) {
				PHP_JSON_HASH_APPLY_PROTECTION_DEC(myht);
				return FAILURE;
			}
		} ZEND_HASH_FOREACH_END();
	}
	PHP_JSON_HASH_APPLY_PROTECTION_DEC(myht);
    // 当前深度是否到达了设定的最大深度（默认512）
	if (encoder->depth > encoder->max_depth) {
		encoder->error_code = PHP_JSON_ERROR_DEPTH;
		if (!(options  PHP_JSON_PARTIAL_OUTPUT_ON_ERROR)) {
			return FAILURE;
		}
	}
	--encoder->depth;
	/* Only keep closing bracket on same line for empty arrays/objects */
	if (need_comma) {
		php_json_pretty_print_char(buf, options, '\n');
		php_json_pretty_print_indent(buf, options, encoder);
	}
	if (r == PHP_JSON_OUTPUT_ARRAY) {
		smart_str_appendc(buf, ']');
	} else {
		smart_str_appendc(buf, '}');
	}
	return SUCCESS;
}
/* }}} */

分析

看了源码，我得出了一些结论。

只有 null，布尔值，浮点数，整数，字符串才会被直接编码
对象要么实现 JsonSerializable 并定义一个 jsonSerialize() ，要么就被当成一个数组，只会被处理公开非静态属性
json_encode() 并不会直接编码数组和对象，而是会递归遍历出所有可遍历的元素，并处理 key
源码中 php_json_encode_zval() 和 php_json_encode_array() 的相互调用，实现了数组和对象遍历的闭环
引用不会被编码

另外，关于 json_encode() 的 options ，我觉得这里处理的技巧非常有趣，巧妙利用位运算来区别多个常量，有兴趣的慢慢看看研究研究。（提示，将 options 每个常量转成二进制来看，json_encode() 接受多个 option 是按位或 | ）

Demo

>>> $a = [1,2,3,4];
=> [
     1,
     2,
     3,
     4,
   ]
>>> json_encode($a);
=> "[1,2,3,4]"
>>> json_encode((object)$a);
=> "{"0":1,"1":2,"2":3,"3":4}"
>>> json_encode($a,JSON_FORCE_OBJECT);
=> "{"0":1,"1":2,"2":3,"3":4}"
>>> json_encode($a,JSON_FORCE_OBJECT|JSON_PRETTY_PRINT);
=> """
   {\n
       "0": 1,\n
       "1": 2,\n
       "2": 3,\n
       "3": 4\n
   }
   """

$arr = array(
    '0'=>'a','1'=>'b','2'=>'c','3'=>'d'
);
echo json_encode($arr);

但是结果是

["a","b","c","d"]

需求是要返回JSON对象，是这样似的

{"0":"a","1":"b","2":"c","3":"d"}

You can do it，you nee add

$arr = array(
    '0'=>'a','1'=>'b','2'=>'c','3'=>'d'
);
echo json_encode((object)$arr);

输出结果

{"0":"a","1":"b","2":"c","3":"d"}

以上就是源码分析系列之json_encode()如何转化一个对象的详细内容，更多关于源码json_encode()的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Thinkphp 框架基础之源码获取、环境要求与目录结构分析
php源码的安装方法和实例
php源码的使用方法讲解
PHP后台备份MySQL数据库的源码实例
PHP自动生成缩略图函数的源码示例
PHP json_encode中文乱码解决方法
基于php解决json_encode中文UNICODE转码问题
浅析PHP中json_encode与json_decode的区别
php让json_encode不自动转义斜杠“/”的方法
关于php unset对json_encode的影响详解
PHP中让json_encode不自动转义斜杠“/”的方法
php json_encode与json_decode详解及实例
php中json_encode不兼容JSON_UNESCAPED_UNICODE的解决方案
java解析php函数json_encode unicode 编码问题

上一篇：SublimeText3配置PHP函数追踪定位插件
下一篇：再谈PHP未来之路

源码分析系列之json_encode()如何转化一个对象

目录初步测试 JsonSerializable 源码分析分析 Demo json_encode()如何转化一个对象？使用json_encode()将数组array转化成json字符串我们都已经很熟悉了那么使用json_encode()转化一个对象是什么样的源码,分析,系列,之,json,...

专业的抖音代运营公司的合作方案？

为了更好地方便抖音代运营公司为客户提供优质的代运营服务，在协作之初确立协作方...

电销机器人有什么帮助（电销机器人有什么帮助和帮助）

今日给各位共享电销机器人有什么协助的常识，其间也会对电销机器人有什么协助和协...

怎么在地图上显示号码？地图上怎么显示店铺号码？

百度地图上单位号码错了怎么修改？百度的地图是我们提供的，如何联系你？怎么在...

铜陵防封电销卡真的好用吗

铜陵防封电销卡真的好用吗到2021年，电话销售公司越来越多。随着一些非法使用手机...

杭州服务外包年均增长95% 欧美大单接踵而来

谁把握了趋势，谁就拥有了未来。我们之所以兴奋，是因为在这个行业的增长空间非常...

宁波推动开放型经济全面升级(组图)

本报讯记者郁进东报道：今年以来，浙江省宁波市坚持开放强市战略，加快转变开放型...

发明勇攀高峰创新思潮激荡——第二十四届全国发明展

来源：中国知识产权报/中国知识产权资讯网 11月21日，为期3天的第二十四届全国发明...

天津房产防封号系统开发-服务为先

天津房产防封号系统开发话外呼系统机器人在多线路进行群呼时，会筛选出意向客户，...

强讯科技为北京现代技术学院搭建呼叫中心实训系统

一、北京现代职业技术学院简介北京现代职业技术学院于2003年8月经北京市人民政府批...

办理400电话需要注意什么400电话开通需要哪些费用

决定申请400电话，企业也必须考虑很多方面，这样的400电话可能伴随我们的企业多年，...

森赫外呼系统（森赫电梯外呼设置）

本文目次一览： 1、森赫电梯怎样做井道进修 2、森赫电梯设置装备摆设品质怎样样？...

吕梁电话机器人代劳 ai电话系统三合一产物强势

汇港通科技组装于2018年，是一家潜心于大中小企业精准经营销售和企业管理效劳处置计...

400电话比普通固话好在哪里

400电话在企业通讯中的优势越来越明显，而400电话作为企业的服务热线，不仅提升了企...

包含电销卡源头厂家世纪通信的词条

本篇文章给咱们谈谈电销卡源头厂家世纪通讯，以及对应的知识点，期望对各位有所协...

沈阳防封号财税案例-优质服务！

沈阳防封号财税案例提升了工作效率。并且电销系统机器人在沟通的时候不会受到环境...

源码分析系列之json_encode()如何转化一个对象

全 部 栏 目

目录

初步测试

JsonSerializable

源码分析

分析

Demo

全部栏目