Thinkphp5框架默认入口为public目录下的index.php。
首先从index.php进行代码分析。
index.php(public目录下的index.php)代码如下:
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2016 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
//D:\phpStudy\WWW\tpfive\public __DIR__
// [ 应用入口文件 ]
/* 定义应用目录,定义了常量APP_PATH, __DIR__ 为魔术方法,获取当前执行的PHP脚本所在的目录
../application/ 返回上一级application目录里, */
define(
'APP_PATH',
__DIR__ .
'/../application/');
// 加载框架引导文件 载入thinkphp目录下的start.php文件
require
__DIR__ .
'/../thinkphp/start.php';
start.php(thinkphp目录下的start.php)代码如下:
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
//首先定义了命名空间为think
namespace
think;
// ThinkPHP 引导文件
// 1. 加载基础文件
//__DIR__指向当前执行的PHP脚本所在的目录,载入当前目录下的base.php(\thinkphp\base.php)
require
__DIR__ .
'/base.php';
/* 2. 执行应用 执行\thinkphp\library\think\App.php文件中的run方法,而后返回
\thinkphp\library\think\Response.php 中Response类的实例,在执行Response类中send方法 */
App::
run()->
send();
先分析start.php中的这句:
//__DIR__指向当前执行的PHP脚本所在的目录,载入当前目录下的base.php(\thinkphp\base.php)
require
__DIR__ .
'/base.php';
从start.php中加载了base.php。
base.php(thinkphp目录下的base.php)代码如下:
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
//这里定义了tp5的一些基本常量
//定义了当前tp框架的版本为'5.0.20',可在任意控制器或视图echo THINK_VERSION;获取框架版本号
define(
'THINK_VERSION',
'5.0.20');
//microtime()返回当前 Unix 时间戳的微秒数,用于对php脚本的运行计时
define(
'THINK_START_TIME',
microtime(
true));
//memory_get_usage返回当前分配给你的 PHP 脚本的内存量,单位是字节(byte)
define(
'THINK_START_MEM',
memory_get_usage());
//定义了.php后缀
define(
'EXT',
'.php');
// DIRECTORY_SEPARATOR,路径分隔符,linux上是 "/" windows上是 "\"
define(
'DS', DIRECTORY_SEPARATOR);
//判断是否定义了常量THINK_PATH,没有则定义常量THINK_PATH为根目录下\thinkphp\
defined(
'THINK_PATH') or
define(
'THINK_PATH',
__DIR__ . DS);
//定义了library文件夹路径,根目录下\thinkphp\library\
define(
'LIB_PATH', THINK_PATH .
'library' . DS);
//定义常量CORE_PATH为根目录下\thinkphp\library\think\
define(
'CORE_PATH', LIB_PATH .
'think' . DS);
//定义了traits文件夹路径,根目录下\thinkphp\library\traits\
define(
'TRAIT_PATH', LIB_PATH .
'traits' . DS);
/* $_SERVER['SCRIPT_FILENAME']获取的是当前执行脚本的绝对路径,不是当前PHP脚本所在的目录路径,
执行脚本指的是/public下的index.php,不是当前base.php文件,注意区分,dirname返回路径中的目录部分
这里APP_PATH常量在/public/index.php已经定义,
因此后面这句 define('APP_PATH', dirname($_SERVER['SCRIPT_FILENAME']) . DS)不会执行
*/
defined(
'APP_PATH') or
define(
'APP_PATH',
dirname(
$_SERVER[
'SCRIPT_FILENAME']) . DS);
//判断是否定义了常量ROOT_PATH,没有则定义常量ROOT_PATH为框架application目录所在的路径
defined(
'ROOT_PATH') or
define(
'ROOT_PATH',
dirname(
realpath(APP_PATH)) . DS);
//判断是否定义了常量EXTEND_PATH,没有则定义常量EXTEND_PATH为框架extend目录所在的路径
defined(
'EXTEND_PATH') or
define(
'EXTEND_PATH', ROOT_PATH .
'extend' . DS);
//判断是否定义了常量VENDOR_PATH,没有则定义常量VENDOR_PATH为框架vendor目录所在的路径
defined(
'VENDOR_PATH') or
define(
'VENDOR_PATH', ROOT_PATH .
'vendor' . DS);
//判断是否定义了常量RUNTIME_PATH,没有则定义常量RUNTIME_PATH为框架runtime目录所在的路径
defined(
'RUNTIME_PATH') or
define(
'RUNTIME_PATH', ROOT_PATH .
'runtime' . DS);
//判断是否定义了常量LOG_PATH,没有则定义常量LOG_PATH为框架\runtime\log所在的路径
defined(
'LOG_PATH') or
define(
'LOG_PATH', RUNTIME_PATH .
'log' . DS);
//判断是否定义了常量CACHE_PATH,没有则定义常量CACHE_PATH为框架\runtime\cache目录所在的路径
defined(
'CACHE_PATH') or
define(
'CACHE_PATH', RUNTIME_PATH .
'cache' . DS);
//判断是否定义了常量TEMP_PATH,没有则定义常量TEMP_PATH为框架\runtime\temp目录所在的路径
defined(
'TEMP_PATH') or
define(
'TEMP_PATH', RUNTIME_PATH .
'temp' . DS);
//判断是否定义了常量CONF_PATH,没有则定义常量CONF_PATH为框架application目录所在的路径
defined(
'CONF_PATH') or
define(
'CONF_PATH', APP_PATH);
// 配置文件目录
//判断是否定义了常量CONF_EXT,没有则定义常量CONF_EXT为.php后缀
defined(
'CONF_EXT') or
define(
'CONF_EXT', EXT);
// 配置文件后缀
//判断是否定义了常量ENV_PREFIX,没有则定义常量ENV_PREFIX为PHP_
defined(
'ENV_PREFIX') or
define(
'ENV_PREFIX',
'PHP_');
// 环境变量的配置前缀
//PHP_SAPI 用来判断是使用命令行还是浏览器执行的,nginx下PHP_SAPI输出cgi-fcgi,命令行输出cli
define(
'IS_CLI', PHP_SAPI ==
'cli' ?
true :
false);
/*PHP_OS检查php运行环境,linux下输出linux,windows下输出WINNT
strpos是查找字符串WINNT下WIN的位置,找不到为false,说明当前运行环境不是windows系统 */
define(
'IS_WIN',
strpos(PHP_OS,
'WIN') !==
false);
// 载入\thinkphp\library\think\Loader.php文件
require CORE_PATH .
'Loader.php';
// 加载环境变量配置文件 根目录下的.env文件,默认.env文件没有,需要自行创建,.env是仿laravel框架的全局变量配置
if (
is_file(ROOT_PATH .
'.env')) {
$env =
parse_ini_file(ROOT_PATH .
'.env',
true);
foreach (
$env as
$key =>
$val) {
$name = ENV_PREFIX .
strtoupper(
$key);
if (
is_array(
$val)) {
foreach (
$val as
$k =>
$v) {
$item =
$name .
'_' .
strtoupper(
$k);
putenv(
"
$item
=
$v
");
}
}
else {
putenv(
"
$name
=
$val
");
}
}
}
// 注册自动加载,执行上述载入\thinkphp\library\think\Loader.php文件中Loader类的register方法
\think\
Loader::
register();
/*注册错误和异常处理机制,由于当前php脚本没有Error这个类,因此触发了
\thinkphp\library\think\Loader.php文件Loader类中的register方法中
spl_autoload_register这个函数,而这个函数就会触发Loader类中的autoload方法,autoload方法会根据所该类,
找到该类对应的文件所在的目录,include进来,\think\Error会找到\thinkphp\library\think\Error.php文件
需要注意的是tp3.2中错误函数set_error_handler, 异常处理函数set_exception_handler,
php脚本执行完成函数register_shutdown_function都写在同一个类中,而tp5并没有写在当前类中,从当前类中分离出去
这三个函数写在了\thinkphp\library\think\Error.php文件里面,所以tp5比tp3加载的文件数量更多
*/
\think\
Error::
register();
/* \think\Config这个类在当前文件同样找不到,因此触发了
\thinkphp\library\think\Loader.php文件Loader类中的register方法,道理同上述一样
include了 \thinkphp\library\think\Config.php文件,执行Config.php文件中Config类中set方法,
加载惯例配置文件 载入 \thinkphp\convention.php文件里的配置*/
\think\
Config::
set(
include THINK_PATH .
'convention' . EXT);
可以看出从base.php中加载了Loader.php。先分析base.php中这句重要的代码:
// 注册自动加载
\think\
Loader::
register();
执行了Loader.php文件中Loader类里的register方法,建议从register方法读起。
Loader.php(\thinkphp\library\think\Loader.php)代码如下:
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
namespace
think;
use think\exception\
ClassNotFoundException;
class
Loader
{
/**
*
@var
array
实例数组
*/
protected
static
$instance = [];
/**
*
@var
array
类名映射
*/
protected
static
$classMap = [];
/**
*
@var
array
命名空间别名
*/
protected
static
$namespaceAlias = [];
/**
*
@var
array
PSR-4 命名空间前缀长度映射
*/
private
static
$prefixLengthsPsr4 = [];
/**
*
@var
array
PSR-4 的加载目录
*/
private
static
$prefixDirsPsr4 = [];
/**
*
@var
array
PSR-4 加载失败的回退目录
*/
private
static
$fallbackDirsPsr4 = [];
/**
*
@var
array
PSR-0 命名空间前缀映射
*/
private
static
$prefixesPsr0 = [];
/**
*
@var
array
PSR-0 加载失败的回退目录
*/
private
static
$fallbackDirsPsr0 = [];
/**
*
@var
array
需要加载的文件
*/
private
static
$files = [];
/**
* 自动加载
*
@access
public
*
@param
string
$class 类名
*
@return
bool
*/
//执行不存在类时,执行autoload方法
public
static
function
autoload(
$class)
{
// 检测命名空间别名,别名不等于空时执行
if (!
empty(
self::
$namespaceAlias)) {
$namespace =
dirname(
$class);
if (
isset(
self::
$namespaceAlias[
$namespace])) {
$original =
self::
$namespaceAlias[
$namespace] .
'
\\
' .
basename(
$class);
if (
class_exists(
$original)) {
return
class_alias(
$original,
$class,
false);
}
}
}
//判断类所在的文件是否存在
if (
$file =
self::
findFile(
$class)) {
// 非 Win 环境不严格区分大小写
if (!IS_WIN ||
pathinfo(
$file, PATHINFO_FILENAME) ==
pathinfo(
realpath(
$file), PATHINFO_FILENAME)) {
//载入类所在的文件,执行当前类的 __include_file方法
__include_file(
$file);
return
true;
}
}
return
false;
}
/**
* 查找文件
*
@access
private
*
@param
string
$class 类名
*
@return
bool
|
string
*/
//寻找注册类
private
static
function
findFile(
$class)
{
// 类库映射
if (!
empty(
self::
$classMap[
$class])) {
return
self::
$classMap[
$class];
}
/* 查找 PSR-4 strtr转换指定字符,EXT,DS为tp5框架在\thinkphp\base.php中设置的常量,值为php, \
例如$class='think\\Error';strtr($class, '\\', DS) . EXT相当于strtr($class, '\\', '\') . 'php',
'\\'转换成'\', think\\Error 转换成 think\Error.php,找到类所在文件的路径
*/
$logicalPathPsr4 =
strtr(
$class,
'
\\
', DS) . EXT;
// 例如$class='think\\Error'; $first=$class[0]='t';
$first =
strtolower(
$class[
0]);
/* 在base.php中,在执行 \think\Error::register() 前,就已经执行了\think\Loader::register(),
所以当前类的prefixLengthsPsr4属性是有值的,具体怎么赋值请查看当前类的register方法。
self::$prefixLengthsPsr4== array (
't' => array (
'think\\composer\\' => 15,
'think\\' => 6,
),
'a' => array (
'app\\' => 4,
)
当然不同版本的tp5框架,可能prefixLengthsPsr4值会有所不同。
具体查看vendor\composer目录下autoload_static.php文件中 prefixLengthsPsr4属性便可知。
例如$first='t',self::$prefixLengthsPsr4[$first]=self::$prefixLengthsPsr4['t']=array (
'think\\composer\\' => 15,
'think\\' => 6,
),
判断self::$prefixLengthsPsr4[$first]是否有值,在thinkphp5框架通常将
命名空间开头定为think,所以获取到的$first=t或者a,这里就可知道如果控制器命名空间开头不是
think,因为找不到文件 */
if (
isset(
self::
$prefixLengthsPsr4[
$first])) {
foreach (
self::
$prefixLengthsPsr4[
$first] as
$prefix =>
$length) {
//查找self::$prefixLengthsPsr4数组中对应的属性值在执行类中的位置,找到则执行以下语句
if (
0 ===
strpos(
$class,
$prefix)) {
/*根据$prefix属性查找文件所在的路径 例如: $prefix='think';
self::$prefixDirsPsr4['think']='__DIR__ . '/../..' . '/thinkphp/library/think';
*/
foreach (
self::
$prefixDirsPsr4[
$prefix] as
$dir) {
/* 例如:$logicalPathPsr4 = think\Error.php */
if (
is_file(
$file =
$dir . DS .
substr(
$logicalPathPsr4,
$length))) {
//返回文件路径
return
$file;
}
}
}
}
}
// 查找 PSR-4 fallback dirs
foreach (
self::
$fallbackDirsPsr4 as
$dir) {
if (
is_file(
$file =
$dir . DS .
$logicalPathPsr4)) {
return
$file;
}
}
// 查找 PSR-0
if (
false !==
$pos =
strrpos(
$class,
'
\\
')) {
// namespace class name
$logicalPathPsr0 =
substr(
$logicalPathPsr4,
0,
$pos +
1)
.
strtr(
substr(
$logicalPathPsr4,
$pos +
1),
'_', DS);
}
else {
// PEAR-like class name
$logicalPathPsr0 =
strtr(
$class,
'_', DS) . EXT;
}
if (
isset(
self::
$prefixesPsr0[
$first])) {
foreach (
self::
$prefixesPsr0[
$first] as
$prefix =>
$dirs) {
if (
0 ===
strpos(
$class,
$prefix)) {
foreach (
$dirs as
$dir) {
if (
is_file(
$file =
$dir . DS .
$logicalPathPsr0)) {
return
$file;
}
}
}
}
}
// 查找 PSR-0 fallback dirs
foreach (
self::
$fallbackDirsPsr0 as
$dir) {
if (
is_file(
$file =
$dir . DS .
$logicalPathPsr0)) {
return
$file;
}
}
// 找不到则设置映射为 false 并返回
return
self::
$classMap[
$class] =
false;
}
/**
* 注册 classmap
*
@access
public
*
@param
string
|
array
$class 类名
*
@param
string
$map 映射
*
@return
void
*/
public
static
function
addClassMap(
$class,
$map =
'')
{
if (
is_array(
$class)) {
self::
$classMap =
array_merge(
self::
$classMap,
$class);
}
else {
self::
$classMap[
$class] =
$map;
}
}
/**
* 注册命名空间
*
@access
public
*
@param
string
|
array
$namespace 命名空间
*
@param
string
$path 路径
*
@return
void
*/
public
static
function
addNamespace(
$namespace,
$path =
'')
{
if (
is_array(
$namespace)) {
foreach (
$namespace as
$prefix =>
$paths) {
self::
addPsr4(
$prefix .
'
\\
',
rtrim(
$paths, DS),
true);
}
}
else {
//为属性$prefixDirsPsr4添加数组成员
self::
addPsr4(
$namespace .
'
\\
',
rtrim(
$path, DS),
true);
}
}
/**
* 添加 PSR-0 命名空间
*
@access
private
*
@param
array
|
string
$prefix 空间前缀
*
@param
array
$paths 路径
*
@param
bool
$prepend 预先设置的优先级更高
*
@return
void
*/
private
static
function
addPsr0(
$prefix,
$paths,
$prepend =
false)
{
if (!
$prefix) {
self::
$fallbackDirsPsr0 =
$prepend ?
array_merge((
array)
$paths,
self::
$fallbackDirsPsr0) :
array_merge(
self::
$fallbackDirsPsr0, (
array)
$paths);
}
else {
$first =
$prefix[
0];
if (!
isset(
self::
$prefixesPsr0[
$first][
$prefix])) {
self::
$prefixesPsr0[
$first][
$prefix] = (
array)
$paths;
}
else {
self::
$prefixesPsr0[
$first][
$prefix] =
$prepend ?
array_merge((
array)
$paths,
self::
$prefixesPsr0[
$first][
$prefix]) :
array_merge(
self::
$prefixesPsr0[
$first][
$prefix], (
array)
$paths);
}
}
}
/**
* 添加 PSR-4 空间
*
@access
private
*
@param
array
|
string
$prefix 空间前缀
*
@param
string
$paths 路径
*
@param
bool
$prepend 预先设置的优先级更高
*
@return
void
*/
private
static
function
addPsr4(
$prefix,
$paths,
$prepend =
false)
{
if (!
$prefix) {
// Register directories for the root namespace.
self::
$fallbackDirsPsr4 =
$prepend ?
array_merge((
array)
$paths,
self::
$fallbackDirsPsr4) :
array_merge(
self::
$fallbackDirsPsr4, (
array)
$paths);
}
elseif (!
isset(
self::
$prefixDirsPsr4[
$prefix])) {
// Register directories for a new namespace.
$length =
strlen(
$prefix);
if (
'
\\
' !==
$prefix[
$length -
1]) {
throw
new
\InvalidArgumentException(
"A non-empty PSR-4 prefix must end with a namespace separator."
);
}
self::
$prefixLengthsPsr4[
$prefix[
0]][
$prefix] =
$length;
self::
$prefixDirsPsr4[
$prefix] = (
array)
$paths;
}
else {
//例如$prefix='app', self::$prefixDirsPsr4['app'] = applicaiton目录所在的路径
self::
$prefixDirsPsr4[
$prefix] =
$prepend ?
array_merge((
array)
$paths,
self::
$prefixDirsPsr4[
$prefix]) :
array_merge(
self::
$prefixDirsPsr4[
$prefix], (
array)
$paths);
}
}
/**
* 注册命名空间别名
*
@access
public
*
@param
array
|
string
$namespace 命名空间
*
@param
string
$original 源文件
*
@return
void
*/
public
static
function
addNamespaceAlias(
$namespace,
$original =
'')
{
if (
is_array(
$namespace)) {
self::
$namespaceAlias =
array_merge(
self::
$namespaceAlias,
$namespace);
}
else {
self::
$namespaceAlias[
$namespace] =
$original;
}
}
/**
* 注册自动加载机制
*
@access
public
*
@param
callable
$autoload 自动加载处理方法
*
@return
void
*/
public
static
function
register(
$autoload =
null)
{
/*注册系统自动加载,加载不存在的类时,会执行此函数里的方法,$autoload一般为空值,所以加载不存在的类时,
执行的是think\\Loader::autoload,也就是当前类的autoload方法,think\\Loader为当前类的命名空间 */
spl_autoload_register(
$autoload ?:
'think
\\
Loader::autoload',
true,
true);
// Composer 自动加载支持
if (
is_dir(VENDOR_PATH .
'composer')) {
//php版本大于5.6并且存在vendor\composer目录下autoload_static.php文件
if (PHP_VERSION_ID >=
50600 &&
is_file(VENDOR_PATH .
'composer' . DS .
'autoload_static.php')) {
//载入vendor\composer目录下autoload_static.php文件
require VENDOR_PATH .
'composer' . DS .
'autoload_static.php';
//获取当前脚本所有类的集合 $declaredClass 为得到所有类的数组
$declaredClass =
get_declared_classes();
/*array_pop出栈,遵循后进先出的原则,获取declaredClass数组中最后一个元素,
得到Composer\Autoload\ComposerStaticInit34a41e2841af1a67f3ddef099fc7b348,
即为Composer\Autoload命名空间下 ComposerStaticInit34a41e2841af1a67f3ddef099fc7b348 类
该类存在于vendor\composer目录下autoload_static.php文件中 */
$composerClass =
array_pop(
$declaredClass);
//循环遍历执行autoload_static.php文件中存在的类
foreach ([
'prefixLengthsPsr4',
'prefixDirsPsr4',
'fallbackDirsPsr4',
'prefixesPsr0',
'fallbackDirsPsr0',
'classMap',
'files'] as
$attr) {
//property_exists函数检查composer类是否具有数组里'prefixLengthsPsr4', 'prefixDirsPsr4'等属性
if (
property_exists(
$composerClass,
$attr)) {
/*${$attr}是el表达式的写法$attr变量可以直接解析,无须拼接的方式,例如:
$a = 'hello';echo ${$a}; 直接解析变量
*/
self::${
$attr} =
$composerClass::${
$attr};
}
}
}
else {
//如果不存在composer目录,执行以下方法,默认是不执行以下方法
self::
registerComposerLoader();
}
}
// 注册命名空间定义,也就是文件目录的路径
self::
addNamespace([
'think' => LIB_PATH .
'think' . DS,
'behavior' => LIB_PATH .
'behavior' . DS,
'traits' => LIB_PATH .
'traits' . DS,
]);
// 加载类库映射文件,runtime下如果没有classmap.php文件则不执行,默认是不执行以下方法
if (
is_file(RUNTIME_PATH .
'classmap' . EXT)) {
self::
addClassMap(
__include_file(RUNTIME_PATH .
'classmap' . EXT));
}
//执行当前类的loadComposerAutoloadFiles方法
self::
loadComposerAutoloadFiles();
// 自动加载 extend 目录,rtrim删除字符串末尾的'\'
self::
$fallbackDirsPsr4[] =
rtrim(EXTEND_PATH, DS);
}
/**
* 注册 composer 自动加载
*
@access
private
*
@return
void
*/
//载入composer目录下的文件
private
static
function
registerComposerLoader()
{
if (
is_file(VENDOR_PATH .
'composer/autoload_namespaces.php')) {
$map =
require VENDOR_PATH .
'composer/autoload_namespaces.php';
foreach (
$map as
$namespace =>
$path) {
self::
addPsr0(
$namespace,
$path);
}
}
if (
is_file(VENDOR_PATH .
'composer/autoload_psr4.php')) {
$map =
require VENDOR_PATH .
'composer/autoload_psr4.php';
foreach (
$map as
$namespace =>
$path) {
self::
addPsr4(
$namespace,
$path);
}
}
if (
is_file(VENDOR_PATH .
'composer/autoload_classmap.php')) {
$classMap =
require VENDOR_PATH .
'composer/autoload_classmap.php';
if (
$classMap) {
self::
addClassMap(
$classMap);
}
}
if (
is_file(VENDOR_PATH .
'composer/autoload_files.php')) {
self::
$files =
require VENDOR_PATH .
'composer/autoload_files.php';
}
}
// 加载composer autofile文件
public
static
function
loadComposerAutoloadFiles()
{
//$files不为空时执行
foreach (
self::
$files as
$fileIdentifier =>
$file) {
if (
empty(
$GLOBALS[
'__composer_autoload_files'][
$fileIdentifier])) {
__require_file(
$file);
$GLOBALS[
'__composer_autoload_files'][
$fileIdentifier] =
true;
}
}
}
/**
* 导入所需的类库 同 Java 的 Import 本函数有缓存功能
*
@access
public
*
@param
string
$class 类库命名空间字符串
*
@param
string
$baseUrl 起始路径
*
@param
string
$ext 导入的文件扩展名
*
@return
bool
*/
public
static
function
import(
$class,
$baseUrl =
'',
$ext = EXT)
{
static
$_file = [];
$key =
$class .
$baseUrl;
$class =
str_replace([
'.',
'#'], [DS,
'.'],
$class);
if (
isset(
$_file[
$key])) {
return
true;
}
if (
empty(
$baseUrl)) {
list(
$name,
$class) =
explode(DS,
$class,
2);
if (
isset(
self::
$prefixDirsPsr4[
$name .
'
\\
'])) {
// 注册的命名空间
$baseUrl =
self::
$prefixDirsPsr4[
$name .
'
\\
'];
}
elseif (
'@' ==
$name) {
// 加载当前模块应用类库
$baseUrl =
App::
$modulePath;
}
elseif (
is_dir(EXTEND_PATH .
$name)) {
$baseUrl = EXTEND_PATH .
$name . DS;
}
else {
// 加载其它模块的类库
$baseUrl = APP_PATH .
$name . DS;
}
}
elseif (
substr(
$baseUrl, -
1) != DS) {
$baseUrl .= DS;
}
// 如果类存在则导入类库文件
if (
is_array(
$baseUrl)) {
foreach (
$baseUrl as
$path) {
if (
is_file(
$filename =
$path . DS .
$class .
$ext)) {
break;
}
}
}
else {
$filename =
$baseUrl .
$class .
$ext;
}
if (!
empty(
$filename) &&
is_file(
$filename) &&
(!IS_WIN ||
pathinfo(
$filename, PATHINFO_FILENAME) ==
pathinfo(
realpath(
$filename), PATHINFO_FILENAME))
) {
__include_file(
$filename);
$_file[
$key] =
true;
return
true;
}
return
false;
}
/**
* 实例化(分层)模型
*
@access
public
*
@param
string
$name Model名称
*
@param
string
$layer 业务层名称
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@param
string
$common 公共模块名
*
@return
object
*
@throws
ClassNotFoundException
*/
public
static
function
model(
$name =
'',
$layer =
'model',
$appendSuffix =
false,
$common =
'common')
{
$uid =
$name .
$layer;
if (
isset(
self::
$instance[
$uid])) {
return
self::
$instance[
$uid];
}
list(
$module,
$class) =
self::
getModuleAndClass(
$name,
$layer,
$appendSuffix);
if (
class_exists(
$class)) {
$model =
new $
class();
}
else {
$class =
str_replace(
'
\\
' .
$module .
'
\\
',
'
\\
' .
$common .
'
\\
',
$class);
if (
class_exists(
$class)) {
$model =
new $
class();
}
else {
throw
new
ClassNotFoundException(
'class not exists:' .
$class,
$class);
}
}
return
self::
$instance[
$uid] =
$model;
}
/**
* 实例化(分层)控制器 格式:[模块名/]控制器名
*
@access
public
*
@param
string
$name 资源地址
*
@param
string
$layer 控制层名称
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@param
string
$empty 空控制器名称
*
@return
object
*
@throws
ClassNotFoundException
*/
public
static
function
controller(
$name,
$layer =
'controller',
$appendSuffix =
false,
$empty =
'')
{
list(
$module,
$class) =
self::
getModuleAndClass(
$name,
$layer,
$appendSuffix);
if (
class_exists(
$class)) {
return
App::
invokeClass(
$class);
}
if (
$empty) {
$emptyClass =
self::
parseClass(
$module,
$layer,
$empty,
$appendSuffix);
if (
class_exists(
$emptyClass)) {
return
new $
emptyClass(
Request::
instance());
}
}
throw
new
ClassNotFoundException(
'class not exists:' .
$class,
$class);
}
/**
* 实例化验证类 格式:[模块名/]验证器名
*
@access
public
*
@param
string
$name 资源地址
*
@param
string
$layer 验证层名称
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@param
string
$common 公共模块名
*
@return
object
|
false
*
@throws
ClassNotFoundException
*/
public
static
function
validate(
$name =
'',
$layer =
'validate',
$appendSuffix =
false,
$common =
'common')
{
$name =
$name ?:
Config::
get(
'default_validate');
if (
empty(
$name)) {
return
new
Validate;
}
$uid =
$name .
$layer;
if (
isset(
self::
$instance[
$uid])) {
return
self::
$instance[
$uid];
}
list(
$module,
$class) =
self::
getModuleAndClass(
$name,
$layer,
$appendSuffix);
if (
class_exists(
$class)) {
$validate =
new
$class;
}
else {
$class =
str_replace(
'
\\
' .
$module .
'
\\
',
'
\\
' .
$common .
'
\\
',
$class);
if (
class_exists(
$class)) {
$validate =
new
$class;
}
else {
throw
new
ClassNotFoundException(
'class not exists:' .
$class,
$class);
}
}
return
self::
$instance[
$uid] =
$validate;
}
/**
* 解析模块和类名
*
@access
protected
*
@param
string
$name 资源地址
*
@param
string
$layer 验证层名称
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@return
array
*/
protected
static
function
getModuleAndClass(
$name,
$layer,
$appendSuffix)
{
if (
false !==
strpos(
$name,
'
\\
')) {
$module =
Request::
instance()->
module();
$class =
$name;
}
else {
if (
strpos(
$name,
'/')) {
list(
$module,
$name) =
explode(
'/',
$name,
2);
}
else {
$module =
Request::
instance()->
module();
}
$class =
self::
parseClass(
$module,
$layer,
$name,
$appendSuffix);
}
return [
$module,
$class];
}
/**
* 数据库初始化 并取得数据库类实例
*
@access
public
*
@param
mixed
$config 数据库配置
*
@param
bool
|
string
$name 连接标识 true 强制重新连接
*
@return
\think\db\
Connection
*/
public
static
function
db(
$config = [],
$name =
false)
{
return
Db::
connect(
$config,
$name);
}
/**
* 远程调用模块的操作方法 参数格式 [模块/控制器/]操作
*
@access
public
*
@param
string
$url 调用地址
*
@param
string
|
array
$vars 调用参数 支持字符串和数组
*
@param
string
$layer 要调用的控制层名称
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@return
mixed
*/
public
static
function
action(
$url,
$vars = [],
$layer =
'controller',
$appendSuffix =
false)
{
$info =
pathinfo(
$url);
$action =
$info[
'basename'];
$module =
'.' !=
$info[
'dirname'] ?
$info[
'dirname'] :
Request::
instance()->
controller();
$class =
self::
controller(
$module,
$layer,
$appendSuffix);
if (
$class) {
if (
is_scalar(
$vars)) {
if (
strpos(
$vars,
'=')) {
parse_str(
$vars,
$vars);
}
else {
$vars = [
$vars];
}
}
return
App::
invokeMethod([
$class,
$action .
Config::
get(
'action_suffix')],
$vars);
}
return
false;
}
/**
* 字符串命名风格转换
* type 0 将 Java 风格转换为 C 的风格 1 将 C 风格转换为 Java 的风格
*
@access
public
*
@param
string
$name 字符串
*
@param
integer
$type 转换类型
*
@param
bool
$ucfirst 首字母是否大写(驼峰规则)
*
@return
string
*/
public
static
function
parseName(
$name,
$type =
0,
$ucfirst =
true)
{
if (
$type) {
$name =
preg_replace_callback(
'/_([a-zA-Z])/',
function (
$match) {
return
strtoupper(
$match[
1]);
},
$name);
return
$ucfirst ?
ucfirst(
$name) :
lcfirst(
$name);
}
return
strtolower(
trim(
preg_replace(
"/[A-Z]/",
"_
\\
0",
$name),
"_"));
}
/**
* 解析应用类的类名
*
@access
public
*
@param
string
$module 模块名
*
@param
string
$layer 层名 controller model ...
*
@param
string
$name 类名
*
@param
bool
$appendSuffix 是否添加类名后缀
*
@return
string
*/
public
static
function
parseClass(
$module,
$layer,
$name,
$appendSuffix =
false)
{
$array =
explode(
'
\\
',
str_replace([
'/',
'.'],
'
\\
',
$name));
$class =
self::
parseName(
array_pop(
$array),
1);
$class =
$class . (
App::
$suffix ||
$appendSuffix ?
ucfirst(
$layer) :
'');
$path =
$array ?
implode(
'
\\
',
$array) .
'
\\
' :
'';
return
App::
$namespace .
'
\\
' .
(
$module ?
$module .
'
\\
' :
'') .
$layer .
'
\\
' .
$path .
$class;
}
/**
* 初始化类的实例
*
@access
public
*
@return
void
*/
public
static
function
clearInstance()
{
self::
$instance = [];
}
}
// 作用范围隔离
/**
* include
*
@param
string
$file 文件路径
*
@return
mixed
*/
//载入文件
function
__include_file(
$file)
{
return
include
$file;
}
/**
* require
*
@param
string
$file 文件路径
*
@return
mixed
*/
function
__require_file(
$file)
{
return
require
$file;
}