yaf_dispatcher.c 的 yaf_dispatcher_fix_default函数

前言

本小节主要是介绍yaf_dispatcher_fix_default函数的做用以及实现细节。

函数原型

static inline void yaf_dispatcher_fix_default(yaf_dispatcher_t *dispatcher, yaf_request_t *request)

该函数用于对module/controller/action三个值进行标准化处理。以便于后续对具体类文件进行检索定位。

处理逻辑

• module先所有小写，而后首字母大写。
• controller先所有小写，而后以'_'或'\'为分隔符首字母大写。
• action所有小写

示例

• 处理前：demo\index_sub\index
• 处理后：Demo\Index_Sub\index

参数说明

• yaf_dispatcher_t *dispatcher

  zval数据类型， Yaf_Dispatcher类实例。

• yaf_request_t *request

  zval数据类型， Yaf_Reqeust_Http实例

具体代码

/**
 * 对module/controller/action作相应的大小写处理
 * 处理逻辑以下
 * 1) 从yaf_request_ce中读取出module, constorller, action
 * 2) 若是1)读取的参数为空或非字符类型, 则从yaf_dispatcher_ce中读取相应的default值
 * 3) module的处理是先所有小写而后首字母大写
 * 4) controller是先所有小写，而后依据'_'为分隔符作首字母大写处理, 例如 Index_sub => Index_Sub
 * 5) action的处理是所有小写
 * 6) 以上处理完成后均将处理后的结果值回写yaf_request_ce对应的成员属性
 */
static inline void yaf_dispatcher_fix_default(yaf_dispatcher_t *dispatcher, yaf_request_t *request) /* {{{ */ {
	zval *module, *controller, *action;

	module = zend_read_property(yaf_request_ce,
			request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_MODULE), 1, NULL);
	action = zend_read_property(yaf_request_ce,
			request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_ACTION), 1, NULL);
	controller = zend_read_property(yaf_request_ce, request,
			ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_CONTROLLER), 1, NULL);

	// module先所有小写而后首字母大写
	if (Z_TYPE_P(module) != IS_STRING || !Z_STRLEN_P(module)) {
		zval *default_module = zend_read_property(yaf_dispatcher_ce,
				dispatcher, ZEND_STRL(YAF_DISPATCHER_PROPERTY_NAME_MODULE), 1, NULL);
		zend_update_property(yaf_request_ce, request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_MODULE), default_module);
	} else {
		char *p = zend_str_tolower_dup(Z_STRVAL_P(module), Z_STRLEN_P(module));
		*p = toupper(*p);
		zend_update_property_stringl(yaf_request_ce,
				request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_MODULE), p, Z_STRLEN_P(module));
		efree(p);
	}

	// controller先所有小写而后以'_'或'\\'为界首字母大写, 例 index_sub => Index_Sub
	if (Z_TYPE_P(controller) != IS_STRING || !Z_STRLEN_P(controller)) {
		zval *default_controller = zend_read_property(yaf_dispatcher_ce,
				dispatcher, ZEND_STRL(YAF_DISPATCHER_PROPERTY_NAME_CONTROLLER), 1, NULL);
		zend_update_property(yaf_request_ce,
				request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_CONTROLLER), default_controller);
	} else {
		char *q, *p = zend_str_tolower_dup(Z_STRVAL_P(controller), Z_STRLEN_P(controller));
		/**
		 * Upper controller name
		 * eg: Index_sub -> Index_Sub
		 */
		q = p;
		*q = toupper(*q);
		while (*q != '\0') {
			if (*q == '_' || *q == '\\') {
			   	if (*(q+1) != '\0') {
					*(q+1) = toupper(*(q+1));
					q++;
				}
			}
			q++;
		}

		zend_update_property_stringl(yaf_request_ce, request,
				ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_CONTROLLER), p, Z_STRLEN_P(controller));
		efree(p);
	}

	// action所有小写
	if (Z_TYPE_P(action) != IS_STRING || !Z_STRLEN_P(action)) {
		zval *default_action = zend_read_property(yaf_dispatcher_ce,
				dispatcher, ZEND_STRL(YAF_DISPATCHER_PROPERTY_NAME_ACTION), 1, NULL);
		zend_update_property(yaf_request_ce, request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_ACTION), default_action);
	} else {
		char *p = zend_str_tolower_dup(Z_STRVAL_P(action), Z_STRLEN_P(action));
		zend_update_property_stringl(yaf_request_ce,
				request, ZEND_STRL(YAF_REQUEST_PROPERTY_NAME_ACTION), p, Z_STRLEN_P(action));
		efree(p);
	}
}
/* }}} */

细节

在这里，须要注意一个细节， 就是controller的那段处理逻辑。在C语言中有两种定义字符串的方式

1. 字符数组
2. 字符串常量

二者的区别体如今

1. 字符数组存储在全局数据区或栈区，有读取和写入的权限。
2. 字符串常量存储在常量区，只有读取权限，没有写入权限。

那么在上述代码里是怎么实现的字符修改呢？为了理解上面的知识点，写段测试代码用于验证。以下

#include<stdio.h>
#include<ctype.h>
#include<string.h>
int main() {
	const char *controller = "index_sub";
	char *q, *p = strdup(controller);

	q = p;
	*q = toupper(*q);
	while (*q != '\0') {
		if (*q == '_') {
			if (*(q+1) != '\0') {
				*(q+1) = toupper(*(q+1));
				q++;
			}
		}
		q++;
	}
	printf("%s\n", p);

    return 0;
}

参考资料

1. yaf_dispatcher.c
2. C语言字符串
3. Yaf_Loader自动加载策略及Dispatcher路由分发策略
4. 知乎