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:phpStudyWWW pfivepublic __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( hinkphpase.php)
require __DIR__ . '/base.php';
/* 2. 执行应用 执行 hinkphplibrary hinkApp.php文件中的run方法,而后返回
hinkphplibrary hinkResponse.php 中Response类的实例,在执行Response类中send方法 */
App::run()->send();
先分析start.php中的这句:
//__DIR__指向当前执行的PHP脚本所在的目录,载入当前目录下的base.php( hinkphpase.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为根目录下 hinkphp
defined('THINK_PATH') or define('THINK_PATH', __DIR__ . DS);
//定义了library文件夹路径,根目录下 hinkphplibrary
define('LIB_PATH', THINK_PATH . 'library' . DS);
//定义常量CORE_PATH为根目录下 hinkphplibrary hink
define('CORE_PATH', LIB_PATH . 'think' . DS);
//定义了traits文件夹路径,根目录下 hinkphplibrary raits
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为框架untimelog所在的路径
defined('LOG_PATH') or define('LOG_PATH', RUNTIME_PATH . 'log' . DS);
//判断是否定义了常量CACHE_PATH,没有则定义常量CACHE_PATH为框架untimecache目录所在的路径
defined('CACHE_PATH') or define('CACHE_PATH', RUNTIME_PATH . 'cache' . DS);
//判断是否定义了常量TEMP_PATH,没有则定义常量TEMP_PATH为框架untime emp目录所在的路径
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);
// 载入 hinkphplibrary hinkLoader.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");
}
}
}
// 注册自动加载,执行上述载入 hinkphplibrary hinkLoader.php文件中Loader类的register方法
hinkLoader::register();
/*注册错误和异常处理机制,由于当前php脚本没有Error这个类,因此触发了
hinkphplibrary hinkLoader.php文件Loader类中的register方法中
spl_autoload_register这个函数,而这个函数就会触发Loader类中的autoload方法,autoload方法会根据所该类,
找到该类对应的文件所在的目录,include进来, hinkError会找到 hinkphplibrary hinkError.php文件
需要注意的是tp3.2中错误函数set_error_handler, 异常处理函数set_exception_handler,
php脚本执行完成函数register_shutdown_function都写在同一个类中,而tp5并没有写在当前类中,从当前类中分离出去
这三个函数写在了 hinkphplibrary hinkError.php文件里面,所以tp5比tp3加载的文件数量更多
*/
hinkError::register();
/* hinkConfig这个类在当前文件同样找不到,因此触发了
hinkphplibrary hinkLoader.php文件Loader类中的register方法,道理同上述一样
include了 hinkphplibrary hinkConfig.php文件,执行Config.php文件中Config类中set方法,
加载惯例配置文件 载入 hinkphpconvention.php文件里的配置*/
hinkConfig::set(include THINK_PATH . 'convention' . EXT);
可以看出从base.php中加载了Loader.php。先分析base.php中这句重要的代码:
// 注册自动加载
hinkLoader::register();
执行了Loader.php文件中Loader类里的register方法,建议从register方法读起。
Loader.php( hinkphplibrary hinkLoader.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 thinkexceptionClassNotFoundException;
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框架在 hinkphpase.php中设置的常量,值为php,
例如$class='think\Error';strtr($class, '\', DS) . EXT相当于strtr($class, '\', '') . 'php',
'\'转换成'', think\Error 转换成 thinkError.php,找到类所在文件的路径
*/
$logicalPathPsr4 = strtr($class, '\', DS) . EXT;
// 例如$class='think\Error'; $first=$class[0]='t';
$first = strtolower($class[0]);
/* 在base.php中,在执行 hinkError::register() 前,就已经执行了 hinkLoader::register(),
所以当前类的prefixLengthsPsr4属性是有值的,具体怎么赋值请查看当前类的register方法。
self::$prefixLengthsPsr4== array (
't' => array (
'think\composer\' => 15,
'think\' => 6,
),
'a' => array (
'app\' => 4,
)
当然不同版本的tp5框架,可能prefixLengthsPsr4值会有所不同。
具体查看vendorcomposer目录下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 = thinkError.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并且存在vendorcomposer目录下autoload_static.php文件
if (PHP_VERSION_ID >= 50600 && is_file(VENDOR_PATH . 'composer' . DS . 'autoload_static.php')) {
//载入vendorcomposer目录下autoload_static.php文件
require VENDOR_PATH . 'composer' . DS . 'autoload_static.php';
//获取当前脚本所有类的集合 $declaredClass 为得到所有类的数组
$declaredClass = get_declared_classes();
/*array_pop出栈,遵循后进先出的原则,获取declaredClass数组中最后一个元素,
得到ComposerAutoloadComposerStaticInit34a41e2841af1a67f3ddef099fc7b348,
即为ComposerAutoload命名空间下 ComposerStaticInit34a41e2841af1a67f3ddef099fc7b348 类
该类存在于vendorcomposer目录下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 hinkdbConnection
*/
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;
}