ThinkPHP3.2 单字母函数

因为工作需要使用ThinkPHP3.2, 所以请叫我考古学家!

A方法

A方法用于在内部实例化控制器,调用格式:A(‘[项目://][分组/]模块’,’控制器层名称’)

1
$User = A('User');

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
* 实例化多层控制器 格式:[资源://][模块/]控制器
* @param string $name 资源地址
* @param string $layer 控制层名称
* @param integer $level 控制器层次
* @return Think\Controller|false
*/
function A($name, $layer = '', $level = 0) {
static $_action = array();
$layer = $layer ?: C('DEFAULT_C_LAYER');
$level = $level ?: ($layer == C('DEFAULT_C_LAYER') ? C('CONTROLLER_LEVEL') : 1);
if (isset($_action[$name.$layer]))
return $_action[$name.$layer];

$class = parse_res_name($name, $layer, $level);
if (class_exists($class)) {
$action = new $class();
$_action[$name.$layer] = $action;

return $action;
} else {
return false;
}
}

B方法

这是随着行为应运而生的新生函数,可以执行某个行为,例如

1
B('app_begin');

就是在项目开始之前,执行这个行为定义的所有函数。支持2个参数,第二个参数支持需要接受一个数组,例如

1
B('app_begin',array("name"=& gt;"tdweb","time"=>time()));

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/**
* 执行某个行为
* @param string $name 行为名称
* @param string $tag 标签名称(行为类无需传入)
* @param Mixed $params 传入的参数
* @return mixed
*/
function B($name, $tag = '', &$params = null) {
if ('' == $tag) {
$name .= 'Behavior';
}

return \Think\Hook::exec($name, $tag, $params);
}

C方法

C方法是Think用于设置、获取,以及保存配置参数的方法,使用频率较高。

  • 设置参数
1
C('DB_NAME','think');

表示设置DB_NAME配置参数的值为think,由于配置参数不区分大小写,所以下面的写法也是一样:

1
C('db_name','think');
  • 支持二级配置参数的设置,例如:
1
C('USER.USER_ID',8);
  • 如果要设置多个参数,可以使用批量设置,例如:
1
2
3
$config['user_id'] = 1;
$config['user_type'] = 1;
C($config);

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/**
* 获取和设置配置参数 支持批量定义
* @param string|array $name 配置变量
* @param mixed $value 配置值
* @param mixed $default 默认值
* @return array|mixed|null
*/
function C($name = null, $value = null, $default = null) {
static $_config = array();
// 无参数时获取所有
if (empty($name)) {
return $_config;
}
// 优先执行设置获取或赋值
if (is_string($name)) {
if (!strpos($name, '.')) {
$name = strtoupper($name);
if (is_null($value))
return isset($_config[$name]) ? $_config[$name] : $default;
$_config[$name] = $value;

return null;
}
// 二维数组设置和获取支持
$name = explode('.', $name);
$name[0] = strtoupper($name[0]);
if (is_null($value))
return isset($_config[$name[0]][$name[1]]) ? $_config[$name[0][$name[1]]] : $default;
$_config[$name[0][$name[1]]] = $value;

return null;
}
// 批量设置
if (is_array($name)) {
$_config = array_merge($_config, array_change_key_case($name, CASE_UPPER));

return null;
}

// 避免非法参数
return null;
}

D方法

D方法应该是用的比较多的方法了,用于实例化自定义模型类,
是Think框架对Model类实例化的一种封装,并实现了单例模式,支持跨项目和分组调用,调用格式如下:

D(‘[项目://][分组/]模型’,’模型层名称’)

1
2
// 实例化User模型
$User = D('User');
  • D方法可以支持跨分组和项目实例化模型,例如:
1
2
3
4
5
//实例化Admin项目的User模型
D('Admin://User')

//实例化Admin分组的User模型
D('Admin/User')
  • 由于增加了分层模型的支持,所以D方法也可以实例化其他的模型,例如:
1
2
3
4
5
// 实例化UserService类
$User = D('User','Service');

// 实例化UserLogic类
$User = D('User','Logic');

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/**
* 实例化模型类 格式 [资源://][模块/]模型
* @param string $name 资源地址
* @param string $layer 模型层名称
* @return mixed|\Think\Model
*/
function D($name = '', $layer = '') {
if (empty($name)) return new Think\Model;
static $_model = array();
$layer = $layer ?: C('DEFAULT_M_LAYER');
if (isset($_model[$name.$layer]))
return $_model[$name.$layer];
$class = parse_res_name($name, $layer);
if (class_exists($class)) {
$model = new $class(basename($name));
} elseif (false === strpos($name, '/')) {
// 自动加载公共模块下面的模型
if (! C('APP_USE_NAMESPACE')) {
import('Common/' . $layer . '/' . $class);
} else {
$class = '\\Common\\' . $layer . '\\' . $name . $layer;
}
$model = class_exists($class) ? new $class($name) : new Think\Model($name);
} else {
Think\Log::record('D方法实例化没找到模型类' . $class, Think\Log::NOTICE);
$model = new Think\Model(basename($name));
}
$_model[$name.$layer] = $model;

return $model;
}

E方法

抛出异常处理

1
E($msg, $code=0)

源码

1
2
3
4
5
6
7
8
9
10
/**
* 抛出异常处理
* @param string $msg 异常消息
* @param integer $code 异常代码 默认为0
* @throws Think\Exception
* @return void
*/
function E($msg, $code = 0) {
throw new Think\Exception($msg, $code);
}

F方法

F方法其实是S方法的一个子集功能,仅用于简单数据缓存,并且只能支持文件形式,不支持缓存有效期,
因为采用的是返回方式,所以其效率较S方法较高,因此我们也称之为快速缓存方法。

  • 写入和读取缓存
1
F('data','test data');

默认的保存起始路径是DATA_PATH(该常量在默认配置位于RUNTIME_PATH.'Data/'下面),
也就是说会生成文件名为DATA_PATH.'data.'的缓存文件。

注意:确保你的缓存标识的唯一,避免数据覆盖和冲突。

  • 下次读取缓存数据的时候,使用:
1
$Data = F('data');
  • 我们可以采用子目录方式保存,例如:
1
2
F('user/data',$data); // 缓存写入
F('user/data'); // 读取缓存
  • 删除缓存
1
2
F('data',NULL); 
// 第二个参数传入NULL,则表示删除标识为data的数据缓存。
  • 支持批量删除功能,尤其是针对子目录缓存的情况,假设我们要删除user子目录下面的所有缓存数据,可以使用:
1
F('user/*',NULL);
  • 又或者使用过滤条件删除,例如:
1
F('user/[^a]*',NULL);

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
/**
* 快速文件数据读取和保存 针对简单类型数据 字符串、数组
* @param string $name 缓存名称
* @param mixed $value 缓存值
* @param string $path 缓存路径
* @return mixed
*/
function F($name, $value = '', $path = DATA_PATH) {
static $_cache = array();
$filename = $path . $name . '.php';
if ('' !== $value) {
if (is_null($value)) {
// 删除缓存
if (false !== strpos($name, '*')) {
return false;
} else {
unset($_cache[$name]);
return Think\Storage::unlink($filename, 'F');
}
} else {
Think\Storage::put($filename, serialize($value), 'F');
// 缓存数据
$_cache[$name] = $value;
return null;
}
}
// 获取缓存数据
if (isset($_cache[$name])) {
return $_cache[$name];
}
if (Think\Storage::has($filename, 'F')) {
$value = unserialize(Think\Storage::read($filename, 'F'));
$_cache[$name] = $value;
} else {
$value = false;
}

return $value;
}

G方法

G方法的作用包括标记位置和区间统计两个功能

标记位置

  • G方法的第一个用法就是标记位置,例如:
1
G('begin');

表示把当前位置标记为begin标签,并且记录当前位置的执行时间,如果环境支持的话,还能记录内存占用情况。可以在任何位置调用G方法标记。

运行时间统计

标记位置后,我们就可以再次调用G方法进行区间统计了,例如:

1
2
3
4
5
6
G('begin');
// ...其他代码段
G('end');
// ...也许这里还有其他代码
// 进行统计区间
echo G('begin','end').'s';

G(‘begin’,’end’) 表示统计begin位置到end位置的执行时间(单位是秒),begin必须是一个已经标记过的位置,
如果这个时候end位置还没被标记过,则会自动把当前位置标记为end标签,输出的结果类似于:

1
0.0056s

默认的统计精度是小数点后4位,如果觉得这个统计精度不够,还可以设置例如:

1
G('begin','end',6).'s';

可能的输出会变成:

1
0.005587s

内存开销统计

如果你的环境支持内存占用统计的话,还可以使用G方法进行区间内存开销统计(单位为kb)

1
echo G('begin','end','m').'kb';

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// 记录内存初始使用
define('MEMORY_LIMIT_ON',function_exists('memory_get_usage'));

/**
* 记录和统计时间(微秒)和内存使用情况
* 使用方法:
* <code>
* G('begin'); // 记录开始标记位
* // ... 区间运行代码
* G('end'); // 记录结束标签位
* echo G('begin','end',6); // 统计区间运行时间 精确到小数后6位
* echo G('begin','end','m'); // 统计区间内存使用情况
* 如果end标记位没有定义,则会自动以当前作为标记位
* 其中统计内存使用需要 MEMORY_LIMIT_ON 常量为true才有效
* </code>
* @param string $start 开始标签
* @param string $end 结束标签
* @param integer|string $dec 小数位或者m
* @return null|string
*/
function G($start, $end = '', $dec = 4) {
static $_info = array();
static $_mem = array();
if (is_float($end)) {
// 记录时间
$_info[$start] = $end;
} elseif (!empty($end)) {
// 统计时间和内存使用
if (!isset($_info[$end])) $_info[$end] = microtime(true);
if (MEMORY_LIMIT_ON && $dec == 'm') {
if (!isset($_mem[$end])) $_mem[$end] = memory_get_usage();
return number_format(($_mem[$end] - $_mem[$start]) / 1024);
} else {
return number_format(($_info[$end] - $_info[$start]), $dec);
}
} else {
// 记录时间和内存使用
$_info[$start] = microtime(true);
if (MEMORY_LIMIT_ON) $_mem[$start] = memory_get_usage();
}

return null;
}

I方法

主要用于更加方便和安全的获取系统输入变量,可以用于任何地方,用法格式如下:

I(‘变量类型.变量名’,[‘默认值’],[‘过滤方法’])

  • 我们以GET变量类型为例
1
2
echo I('get.id'); // 相当于 $_GET['id']
echo I('get.name'); // 相当于 $_GET['name']
  • 支持默认值:
1
2
echo I('get.id',0); // 如果不存在$_GET['id'] 则返回0
echo I('get.name',''); // 如果不存在$_GET['name'] 则返回空字符串
  • 采用方法过滤:
1
2
echo I('get.name','','htmlspecialchars'); 
// 采用htmlspecialchars方法对$_GET['name'] 进行过滤,如果不存在则返回空字符串
  • 支持直接获取整个变量类型,例如:
1
I('get.'); // 获取整个$_GET 数组

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
/**
* 获取输入参数 支持过滤和默认值
* 使用方法:
* <code>
* I('id',0); 获取id参数 自动判断get或者post
* I('post.name','','htmlspecialchars'); 获取$_POST['name']
* I('get.'); 获取$_GET
* </code>
* @param string $name 变量的名称 支持指定类型
* @param mixed $default 不存在的时候默认值
* @param mixed $filter 参数过滤方法
* @param mixed $datas 要获取的额外数据源
* @return mixed
*/
function I($name, $default = '', $filter = null, $datas = null) {
static $_PUT = null;
if (strpos($name, '/')) { //指定修饰符
list($name, $type) = explode('/', $name, 2);
} elseif (C('VAR_AUTO_STRING')) { // 默认强制转换为字符串
$type = 's';
}
if (strpos($name, '.')) { // 指定参数来源
list($method, $name) = explode('.', $name, 2);
} else { // 默认为自动判断
$method = 'param';
}
switch (strtolower($method)) {
case 'get':
$input = &$_GET;
break;
case 'post':
$input = &$_POST;
break;
case 'put':
if (is_null($_PUT)) {
parse_str(file_get_contents('php://input'), $_PUT);
}
$input = &$_PUT;
break;
case 'param':
switch ($_SERVER['REQUEST_METHOD']) {
case 'POST':
$input = $_POST;
break;
case 'PUT':
if (is_null($_PUT)) {
parse_str(file_get_contents('php://input'), $_PUT);
}
$input = $_PUT;
break;
default:
$input = $_GET;
}
break;
case 'path':
$input = array();
if (!empty($_SERVER['PATH_INFO'])) {
$depr = C('URL_PATHINFO_DEPR');
$input = explode($depr, trim($_SERVER['PATH_INFO'], $depr));
}
break;
case 'request':
$input = &$_REQUEST;
break;
case 'session' :
$input =& $_SESSION;
break;
case 'cookie' :
$input =& $_COOKIE;
break;
case 'server' :
$input =& $_SERVER;
break;
case 'globals' :
$input =& $GLOBALS;
break;
case 'data' :
$input =& $datas;
break;
default:
return null;
}
if ('' == $name) {
// 获取全部变量
$data = $input;
$filters = isset($filter) ? $filter : C('DEFAULT_FILTER');
if ($filters) {
if (is_string($filters)) {
$filters = explode(',', $filters);
}
foreach ($filters as $filter) {
$data = array_map_recursive($filter, $data); // 参数过滤
}
}
} elseif (isset($input[$name])) { //取值操作
$data = $input[$name];
$filters = isset($filter) ? $filter : C('DEFAULT_FILTER');
if ($filter) {
if (is_string($filters)) {
if (0 === strpos($filters, '/')) {
if (1 !== preg_match($filters, (string)$data)) {
// 支持正则验证
return isset($default) ? $default : null;
}
} else {
$filters = explode(',', $filters);
}
} elseif (is_int($filters)) {
$filters = array($filters);
}
if (is_array($filters)) {
foreach ($filters as $filter) {
if (function_exists($filter)) {
$data = is_array($data) ? array_map_recursive($filter,$data) : $filter($data); // 参数过滤
} else {
$data = filter_var($data, is_int($filter)) ? $filter : filter_id($filter);
if (false === $data) {
return isset($default) ? $default : null;
}
}
}
}
}
if (!empty($type)) {
switch (strtolower($type)) {
case 'a': // 数组
$data = (array)$data;
break;
case 'd': // 数字
$data = (int)$data;
break;
case 'f': // 浮点
$data = (float)$data;
break;
case 'b': // 布尔
$data = (boolean)$data;
break;
case 's': // 字符串
default:
$data = (string)$data;
}
}
} else {
// 变量默认值
$data = isset($default) ? $default : null;
}
is_array($data) && array_walk_recursive($data, 'think_filter');

return $data;
}

function array_map_recursive($filter, $data) {
$result = array();
foreach ($data as $key => $val) {
$result[$key] = is_array($val)
? array_map_recursive($filter, $val)
: call_user_func($filter, $val);
}

return $result;
}

L方法

L方法用于启用多语言的情况下,设置和获取当前的语言定义。

L(‘语言变量’,[‘语言值’])

  • 除了使用语言包定义语言变量之外,我们可以用L方法动态设置语言变量,例如:
1
L('LANG_VAR','语言定义');
  • 获取语言变量
1
$langVar = L('LANG_VAR');

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
/**
* 获取和设置语言定义(不区分大小写)
* @param string|array $name 语言变量
* @param null mixed $value 语言值或者变量
* @return array|mixed|null|string
*/
function L($name = null, $value = null) {
static $_lang = array();
// 空参数返回所有定义
if (empty($name))
return $_lang;
// 判断语言获取(或设置)
// 若不存在,直接返回全大写$name
if (is_string($name)) {
$name = strtoupper($name);
if (is_null($value)) {
return isset($_lang[$name]) ? $_lang[$name] : $name;
} elseif (is_array($value)) {
// 支持变量
$replace = array_keys($value);
foreach ($replace as &$v) {
$v = '{$'.$v.'}';
}
return str_replace($replace, $value, isset($_lang[$name]) ? $_lang[$name] : $name);
}
// 语言定义
$_lang[$name] = $value;

return null;
}
// 批量定义
if (is_array($name))
$_lang = array_merge($_lang, array_change_key_case($name, CASE_UPPER));
return null;
}

M方法

M方法用于实例化一个基础模型类,和D方法的区别在于:

  1. 不需要自定义模型类,减少IO加载,性能较好;
  2. 实例化后只能调用基础模型类(默认是Model类)中的方法;
  3. 可以在实例化的时候指定表前缀、数据库和数据库的连接信息;

M(‘[基础模型名:]模型名’,’数据表前缀’,’数据库连接信息’)

1
2
$User = M('User');
$User = M('db2.User','think_');
  • 第三个连接信息参数可以使用DSN配置或者数组配置,甚至可以支持配置参数。

例如,在项目配置文件中配置了:

1
'DB_CONFIG'=>'mysql://user_a:1234@localhost:3306/think';
  • 则可以使用:
1
$User = M('User','think_','DB_CONFIG');

基础模型类和数据库可以一起使用,例如:

1
$User = M('CommonModel:db2.User','think_');

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/**
* 实例化一个没有模型文件的Model
* @param string $name Model名称 支持指定基础模型 例如 MongoModel:User
* @param string $tablePrefix 表前缀
* @param mixed $connection 数据库连接信息
* @return mixed
*/
function M($name = '', $tablePrefix = '', $connection = '') {
static $_model = array();
if (strpos($name, ':')) {
list($class, $name) = explode(':', $name);
} else {
$class = 'Think\\Model';
}
$guid = (is_array($connection) ? implode('', $connection) : $connection) . $tablePrefix . $name . '_' . $class;
if (!isset($_model[$guid]))
$_model[$guid] = new $class($name, $tablePrefix, $connection);

return $_model[$guid];
}

N方法

用于核心的查询、缓存统计的计数和统计。也可用于其他计数引用。

格式:N(‘计数位置’[,’步进值’])

1
2
3
N('read',1);//统计页面的查询次数,表示每次执行到该位置都会引起计数器加1
//N('score',5);//计数器每次增加5
$count = N('read');//来统计当前页面执行的查询数目。

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/**
* 设置和获取统计数据
* 使用方法:
* <code>
* N('db',1); // 记录数据库操作次数
* N('read',1); // 记录读取次数
* echo N('db'); // 获取当前页面数据库的所有操作次数
* echo N('read'); // 获取当前页面读取次数
* </code>
* @param string $key 标识位置
* @param integer $step 步进值
* @param boolean $save 是否保存结果
* @return mixed
*/
function N($key, $step = 0, $save = false) {
static $_num = array();
if (!isset($_num[$key])) {
$_num[$key] = (false !== $save) ? S('N_' . $key) :0;
}
if (empty($step)) {
return $_num[$key];
} else {
$_num[$key] = $_num[$key] + (int)$step;
}
if (false !== $save) {
// 保存结果
S('N_' . $key, $_num[$key], $save);
}

return null;
}

R方法

R方法用于调用某个控制器的操作方法,是A方法的进一步增强和补充。

R(‘[项目://][分组/]模块/操作’,’参数’,’控制器层名称’)

1
$data = R('User/detail',array('5'));

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/**
* 远程调用控制器的操作方法 URL 参数格式 [资源://][模块/]控制器/操作
* @param string $url 调用地址
* @param string|array $vars 调用参数 支持字符串和数组
* @param string $layer 要调用的控制层名称
* @return bool|mixed
*/
function R($url, $vars = array(), $layer = '') {
$info = pathinfo($url);
$action = $info['basename'];
$module = $info['dirname'];
$class = A($module, $layer);
if ($class) {
if (is_string($vars)) {
parse_str($vars, $vars);
}

return call_user_func_array(array(&$class, $action.C('ACTION_SUFFIX')), $vars);
} else {
return false;
}
}

S方法

S方法还支持对当前的缓存方式传入缓存参数,例如:

1
S('data',$Data,3600,'File',array('length'=>10,'temp'=>RUNTIME_PATH.'temp/'));

经测试,这样使用 只有前三个参数有效,后面的均无效

1
{ 'File',array('length'=>10,'temp'=>RUNTIME_PATH.'temp/')}

最终这么用:

1
S('data1',$list,array('prefix'=>aaa','expire'=>'3600','temp'=>RUNTIME_PATH.'temp/1236'));

获取的时候:

1
$sdata = S('data1','',array('prefix'=>'aaa','temp'=>RUNTIME_PATH.'temp/1236'));

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
/**
* 缓存管理
* @param mixed $name 缓存名称,如果为数组表示进行缓存设置
* @param mixed $value 缓存值
* @param mixed $options 缓存参数
* @return mixed
*/
function S($name, $value = '', $options = null) {
static $cache = '';
if (is_array($options)) {
// 缓存操作的同时初始化
$type = isset($options['type']) ? $options['type'] : '';
$cache = Think\Cache::getInstance($type, $options);
} elseif (is_array($name)) { // 缓存初始化
$type = isset($name['type']) ? $name['type'] : '';
$cache = Think\Cache::getInstance($type, $name);
} elseif (empty($cache)) { // 自动初始化
$cache = Think\Cache::getInstance();
}

if ('' === $value) {
// 获取缓存
return $cache->get($name);
} elseif (is_null($value)) {
// 删除缓存
return $cache->rm($name);
} else {
// 缓存数据
if (is_array($options)) {
$expire = isset($options['expire']) ? $options['expire'] : null;
} else {
$expire = is_numeric($options) ? $options : null;
}

return $cache->set($name, $value, $expire);
}
}

T方法

为了更方便的输出模板文件,新版封装了一个T函数用于生成模板文件名。

T([资源://][模块@][主题/][控制器/]操作,[视图分层])

T函数的返回值是一个完整的模板文件名,可以直接用于display和fetch方法进行渲染输出。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
T('Public/menu');
// 返回 当前模块/View/Public/menu.html
T('blue/Public/menu');
// 返回 当前模块/View/blue/Public/menu.html
T('Public/menu','Tpl');
// 返回 当前模块/Tpl/Public/menu.html
T('Public/menu');
// 如果TMPL_FILE_DEPR 为 _ 返回 当前模块/Tpl/Public_menu.html
T('Public/menu');
// 如果TMPL_TEMPLATE_SUFFIX 为.tpl 返回 当前模块/Tpl/Public/menu.tpl
T('Admin@Public/menu');
// 返回 Admin/View/Public/menu.html
T('Extend://Admin@Public/menu');
// 返回 Extend/Admin/View/Public/menu.html (Extend目录取决于AUTOLOAD_NAMESPACE中的配置)

在display方法中直接使用T函数:

1
2
// 使用T函数输出模板
$this->display(T('Admin@Public/menu'));

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
/**
* 获取输入参数 支持过滤和默认值
* 使用方法:
* <code>
* I('id',0); 获取id参数 自动判断get或者post
* I('post.name','','htmlspecialchars'); 获取$_POST['name']
* I('get.'); 获取$_GET
* </code>
* @param string $name 变量的名称 支持指定类型
* @param mixed $default 不存在的时候默认值
* @param mixed $filter 参数过滤方法
* @param mixed $datas 要获取的额外数据源
* @return mixed
*/
function T($template = '', $layer = '') {
// 解析模板资源地址
if (false === strpos($template, '://')) {
$template = 'http://' . str_replace(':', '/', $template);
}
$info = parse_url($template);
$file = $info['host'] . (isset($info['path']) ? $info['path'] : '');
$module = isset($info['user']) ? $info['user'] . '/' : MODULE_NAME . '/';
$extend = $info['scheme'];
$layer = $layer ? $layer : C('DEFAULT_V_LAYER');

// 获取当前主题的模板路径
$auto = C('AUTOLOAD_NAMESPACE');
if ($auto && isset($auto[$extend])) {
// 扩展资源
$baseUrl = $auto[$extend] . $module . $layer . '/';
} elseif (C('VIEW_PATH')) {
// 改变模块视图目录
$baseUrl = C('VIEW_PATH');
} elseif (defined('TMPL_PATH')) {
// 指定全局视图目录
$baseUrl = TMPL_PATH . $module;
} else {
$baseUrl = APP_PATH . $module . $layer . '/';
}

// 获取主题
$theme = substr_count($file, '/') < 2 ? C('DEFAULT_THEME') : '';

// 分析模板文件规则
$depr = C('TMPL_FILE_DEPR');
if ('' == $file) {
// 如果模板文件名为空, 按照默认规则定位
$file = CONTROLLER_NAME . $depr . ACTION_NAME;
} elseif (false === strpos($file, '/')) {
$file = CONTROLLER_NAME . $depr . $file;
} elseif ('/' != $depr) {
$file = substr_count($file, '/') > 1 ? substr_replace($file, $depr, strpos($file, '/'), 1) : str_replace('/', $depr, $file);
}

return $baseUrl . ($theme ? $theme . '/' : '') . $file . C('TMPL_TEMPLATE_SUFFIX');
}

U方法

U方法用于完成对URL地址的组装,特点在于可以自动根据当前的URL模式和设置生成对应的URL地址,格式为:

U(‘地址’,’参数’,’伪静态’,’是否跳转’,’显示域名’);

1
2
3
4
U('User/add') // 生成User模块的add操作地址
U('Home/User/add') // 生成Home分组的User模块的add操作地址
U('add') // 生成当前访问模块的add操作地址
U('add') // 生成当前访问模块的add操作地址

源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
/**
* URL组装 支持不同URL模式
* @param string $url URL表达式,格式:'[模块/控制器/操作#锚点@域名]?参数1=值1&参数2=值2...'
* @param string|array $vars 传入的参数,支持数组和字符串
* @param string|boolean $suffix 伪静态后缀,默认为true表示获取配置值
* @param boolean $domain 是否显示域名
* @return string
*/
function U($url = '', $vars = '', $suffix = true, $domain = false) {
// 解析URL
$info = parse_url($url);
$url = !empty($info['path'])?$info['path']:ACTION_NAME;
if (isset($info['fragment'])) { // 解析锚点
$anchor = $info['fragment'];
if (false !== strpos($anchor,'?')) { // 解析参数
list($anchor,$info['query']) = explode('?',$anchor,2);
}
if (false !== strpos($anchor,'@')) { // 解析域名
list($anchor,$host) = explode('@',$anchor, 2);
}
} elseif (false !== strpos($url,'@')) { // 解析域名
list($url,$host) = explode('@',$info['path'], 2);
}
// 解析子域名
if (isset($host)) {
$domain = $host.(strpos($host,'.')?'':strstr($_SERVER['HTTP_HOST'],'.'));
} elseif ($domain === true){
$domain = $_SERVER['HTTP_HOST'];
if (C('APP_SUB_DOMAIN_DEPLOY')) { // 开启子域名部署
$domain = $domain == 'localhost' ? 'localhost' : 'www' . strstr($_SERVER['HTTP_HOST'],'.');
// '子域名'=>array('模块[/控制器]');
foreach (C('APP_SUB_DOMAIN_RULES') as $key => $rule) {
$rule = is_array($rule) ? $rule[0] : $rule;
if(false === strpos($key,'*') && 0=== strpos($url,$rule)) {
$domain = $key.strstr($domain,'.'); // 生成对应子域名
$url = substr_replace($url,'',0,strlen($rule));
break;
}
}
}
}

// 解析参数
if (is_string($vars)) { // aaa=1&bbb=2 转换成数组
parse_str($vars,$vars);
} elseif (!is_array($vars)) {
$vars = array();
}
if (isset($info['query'])) { // 解析地址里面参数 合并到vars
parse_str($info['query'],$params);
$vars = array_merge($params,$vars);
}

// URL组装
$depr = C('URL_PATHINFO_DEPR');
$urlCase = C('URL_CASE_INSENSITIVE');
if ($url) {
if (0=== strpos($url,'/')) {// 定义路由
$route = true;
$url = substr($url,1);
if('/' != $depr) {
$url = str_replace('/',$depr,$url);
}
} else {
if('/' != $depr) { // 安全替换
$url = str_replace('/',$depr,$url);
}
// 解析模块、控制器和操作
$url = trim($url,$depr);
$path = explode($depr,$url);
$var = array();
$varModule = C('VAR_MODULE');
$varController = C('VAR_CONTROLLER');
$varAction = C('VAR_ACTION');
$var[$varAction] = !empty($path) ? array_pop($path) : ACTION_NAME;
$var[$varController] = !empty($path) ? array_pop($path) : CONTROLLER_NAME;
if($maps = C('URL_ACTION_MAP')) {
if (isset($maps[strtolower($var[$varController])])) {
$maps = $maps[strtolower($var[$varController])];
if ($action = array_search(strtolower($var[$varAction]), $maps)) {
$var[$varAction] = $action;
}
}
}
if ($maps = C('URL_CONTROLLER_MAP')) {
if ($controller = array_search(strtolower($var[$varController]),$maps)) {
$var[$varController] = $controller;
}
}
if ($urlCase) {
$var[$varController] = parse_name($var[$varController]);
}
$module = '';

if (!empty($path)) {
$var[$varModule] = implode($depr,$path);
} else {
if (C('MULTI_MODULE')) {
if(MODULE_NAME != C('DEFAULT_MODULE') || !C('MODULE_ALLOW_LIST')) {
$var[$varModule] = MODULE_NAME;
}
}
}
if ($maps = C('URL_MODULE_MAP')) {
if ($_module = array_search(strtolower($var[$varModule]), $maps)) {
$var[$varModule] = $_module;
}
}
if (isset($var[$varModule])) {
$module = $var[$varModule];
unset($var[$varModule]);
}
}
}

if (C('URL_MODEL') == 0) { // 普通模式URL转换
$url = __APP__.'?'.C('VAR_MODULE')."={$module}&".http_build_query(array_reverse($var));
if ($urlCase){
$url = strtolower($url);
}
if(!empty($vars)) {
$vars = http_build_query($vars);
$url .= '&'.$vars;
}
} else { // PATHINFO模式或者兼容URL模式
if(isset($route)) {
$url = __APP__.'/'.rtrim($url,$depr);
}else{
$module = (defined('BIND_MODULE') && BIND_MODULE==$module )? '' : $module;
$url = __APP__.'/'.($module?$module.MODULE_PATHINFO_DEPR:'').implode($depr,array_reverse($var));
}
if($urlCase){
$url = strtolower($url);
}
if(!empty($vars)) { // 添加参数
foreach ($vars as $var => $val){
if('' !== trim($val)) $url .= $depr . $var . $depr . urlencode($val);
}
}
if($suffix) {
$suffix = $suffix===true?C('URL_HTML_SUFFIX'):$suffix;
if($pos = strpos($suffix, '|')){
$suffix = substr($suffix, 0, $pos);
}
if($suffix && '/' != substr($url,-1)){
$url .= '.'.ltrim($suffix,'.');
}
}
}
if (isset($anchor)) {
$url .= '#'.$anchor;
}
if ($domain) {
$url = (is_ssl() ? 'https://' : 'http://') . $domain.$url;
}

return $url;
}

其他

M和D方法的区别:

  • 都用于实例化一个模型类,M方法用于高效实例化一个基础模型类D方法用于实例化一个用于自定义模型类
  1. 不需要自定义模型类,减少IO加载,性能较好;
  2. 实例化后只能调用基础模型类(默认是Model类)中的方法;
  3. 可以在实例化的时候指定表前缀、数据库和数据库的连接信息;

使用M方法

如果是如下情况,请考虑使用 M方法:

  1. 对数据表进行简单的 CURD 操作而无复杂的业务逻辑时
  2. 只有个别的表有较为复杂的业务逻辑时,将 M方法 与实例化 CommonModel 类进行结合使用

M方法 甚至可以简单看着就是对参数表名对应的数据表的操作:

1
$User = M('User');

使用D方法

如果是如下情况,请考虑使用 D方法:

  1. 需要使用 ThinkPHP 模型中一些高级功能如自动验证功能(create()方法中实现)、关联模型等
  2. 业务逻辑比较复杂,且涉及的表众多
  3. 将业务逻辑定义在了自定义的模型类里面(Lib/Model目录下),而想在操作中实现这些业务逻辑

Powered by Hexo and Hexo-theme-hiker

Copyright © 2017 - 2022 Keep It Simple And Stupid All Rights Reserved.

访客数 : | 访问量 :