http://serverName/index.php(或者其它入口文件)/模块/控制器/操作/参数/值…
入口文件
public/index.php
应用
一个管理系统架构及生命周期的对象,由系统的 \think\App
类完成,应用通常在入口文件中被调用和执行
路由
如果没有定义路由,则可以直接使用“模块/控制器/操作”的方式访问,如果定义了路由,则该路由对应的路由地址就被不能直接访问了。一旦开启强制路由参数,则必须为每个请求定义路由(包括首页)。还可以实现验证、权限、参数绑定及响应设置等功能
模块
控制器
控制器主要负责请求的接收,并调用相关的模型处理,并最终通过视图输出。严格来说,控制器不应该过多的介入业务逻辑处理
操作
一个控制器包含多个操作(方法),操作方法是一个URL访问的最小单元
模型
模型类通常完成实际的业务逻辑和数据封装,并返回和格式无关的数据 可以对模型层进行更细化的设计和分工,例如把模型层分为逻辑层/服务层/事件层等等
视图
模板引擎
驱动
很多的组件都采用驱动式设计,从而可以更灵活的扩展,驱动类的位置默认是放入核心类库目录下面,也可以重新定义驱动类库的命名空间而改变驱动的文件位置。
5.1版本的驱动更多是采用
Composer
的方式安装和管理。
行为
行为(Behavior
)是在预先定义好的一个应用钩子(Hook
)位置执行的一些操作。类似于AOP
编程中的“切面”的概念,给某一个钩子绑定相关行为就成了一种类AOP
编程的思想。行为通常是和某个Hook
位置相关,行为的执行时间取决于行为绑定到了哪个位置上。要执行行为,首先要在应用程序中进行行为侦听,一个位置上如果绑定了多个行为的,按照绑定的顺序依次执行,除非遇到中断 例如:
// 在app_init位置侦听行为
\think\facade\Hook::listen('app_init');
// 绑定行为到app_init位置
\think\facade\Hook::add('app_init','\app\index\behavior\Test');
中间件
中间件主要用于HTTP请求的拦截处理
事件
一般是指数据库操作和模型操作在完成数据写入之后的回调机制。数据库操作的回调也称为查询事件,是针对数据库的CURD操作而设计的回调方法,主要包括:
| 事件 | 描述 |
|---|---|
| before_select | select查询前回调 |
| before_find | find查询前回调 |
| after_insert | insert操作成功后回调 |
| after_update | update操作成功后回调 |
| after_delete | delete操作成功后回调 |
模型事件可以看成是模型层的钩子和行为,只不过钩子的位置主要针对模型数据的写入操作,包含下面这些:
| 钩子 | 对应操作 | 快捷注册方法 |
|---|---|---|
| before_insert | 新增前 | beforeInsert |
| after_insert | 新增后 | afterInsert |
| before_update | 更新前 | beforeUpdate |
| after_update | 更新后 | afterUpdate |
| before_write | 写入前 | beforeWrite |
| after_write | 写入后 | afterWrite |
| before_delete | 删除前 | beforeDelete |
| after_delete | 删除后 | afterDelete |
before_write
和after_write
表示无论是新增还是更新都会执行的钩子。
助手函数
使用助手函数和性能并无直接影响只是某些时候无法享受IDE自动提醒的便利
URL设计
如果不支持PATHINFO的服务器可以使用兼容模式访问如下:
http://serverName/index.php(或者其它应用入口文件)?s=/模块/控制器/操作/[参数名/参数值...]
URL重写
伪静态: .htaccess
目录结构

模块名称请避免使用PHP保留关键字(保留字列表参见 http://php.net/manual/zh/reserved.keywords.php ),否则会造成系统错误
模块类库
一个模块下面的类库文件的命名空间统一以app\模块名
开头
// index模块的Index控制器类
app\index\controller\Index
// index模块的User模型类
app\index\model\User
模块和控制器隐藏
如果只有一个模块的话,可以在入口文件中进行模块绑定
// 执行应用并响应(绑定当前访问到index模块)
Container::get('app')->bind('index')->run()->send();
// 绑定当前访问到index模块的index控制器
Container::get('app')->bind('index/index')->run()->send();
单一模块
// 关闭多模块设计
'app_multi_module' => false,
空模块
可以把不存在的模块访问统一指向一个空模块,设置
// 设置空模块名为home
'empty_module' => 'home',
环境变量
使用Env
类获取(需要引入think\facade\Env
):
// 获取应用目录(不区分大小写)
echo Env::get('app_path');
// 或者
echo Env::get('APP_PATH');
| 系统路径 | Env参数名称 |
|---|---|
| 应用根目录 | root_path |
| 应用目录 | app_path |
| 框架目录 | think_path |
| 配置目录 | config_path |
| 扩展目录 | extend_path |
| composer目录 | vendor_path |
| 运行缓存目录 | runtime_path |
| 路由目录 | route_path |
| 当前模块目录 | module_path |
命名空间
特别注意的是,如果你需要调用PHP内置的类库,或者第三方没有使用命名空间的类库,记得在实例化类库的时候加上 \
,例如:
// 错误的用法
$class = new stdClass();
$xml = new SimpleXmlElement($xmlstr);
// 正确的用法
$class = new \stdClass();
$xml = new \SimpleXmlElement($xmlstr);
根命名空间(类库包)
以上面的\think\cache\driver\File
类为例,think
就是一个根命名空间,其对应的初始命名空间目录就是系统的类库目录(thinkphp/library/think
),我们可以简单的理解一个根命名空间对应了一个类库包
系统内置的几个根命名空间(类库包)如下:
| 名称 | 描述 | 类库目录 |
|---|---|---|
| think | 系统核心类库 | thinkphp/library/think |
| traits | 系统Trait类库 | thinkphp/library/traits |
| app | 应用类库 | application |
如果需要增加新的根命名空间,我们只需要把自己的类库包目录放入extend
目录,就可以自动注册对应的命名空间
如果你的扩展类库不希望放入系统默认的extend
目录,就需要在应用配置文件中设置root_namespace
注册根命名空间,例如下面注册了my
和org
两个根命名空间到application/extend
目录下面。
'root_namespace' => [
'my' => '../application/extend/my/',
'org' => '../application/extend/org/',
]
应用类库包
为了避免和Composer
自动加载的类库存在冲突 ,应用类库的命名空间的根都统一以app
命名
容器和依赖注入
容器 ,用来更方便的管理类依赖及运行依赖注入 容器类的工作由think\Container
类完成,通过app
助手函数也可完成大部分操作。
依赖注入其实本质上是指对类的依赖通过构造器完成自动注入,例如在控制器架构方法和操作方法中一旦对参数进行对象类型约束则会自动触发依赖注入,由于访问控制器的参数都来自于URL请求,普通变量就是通过参数绑定自动获取,对象变量则是通过依赖注入生成。
class Index
{
protected $user;
public function __construct(User $user)
{
$this->user = $user;
}
public function hello()
{
return 'Hello,' . $this->user->name . '!';
}
}
支持使用依赖注入的场景包括(但不限于):
控制器架构方法;
控制器操作方法;
数据库和模型事件方法;
路由的闭包定义;
行为类的方法;
在ThinkPHP的设计中,
think\App
类虽然自身不是容器,但却是一个容器管理类,可以完成容器的所有操作。
绑定
依赖注入的类统一由容器进行管理,大多数情况下是在自动绑定并且实例化的。不过你可以随时进行手动绑定类到容器中,支持多种绑定方式
绑定类标识
可以对已有的类库绑定一个标识(唯一),便于快速调用。
// 绑定类库标识
bind('cache','think\Cache');
// 快速调用(自动实例化)
$cache = app('cache');
调用和绑定的标识必须保持一致(包括大小写)
容器中已经调用过的类会自动使用单例,除非你使用下面的方式强制重新实例化。
// 每次调用都会重新实例化
$cache = app('cache',true);
你可以绑定一个类到容器中(第一个参数直接传入类名):
bind('app\common\Test');
但实际上这个操作是多余的,因为只要调用过一次后就会自动绑定
app('app\common\Test');
绑定的类标识可以自己定义(只要不冲突)。
绑定闭包
可以把一个闭包方法绑定到容器中
bind('sayHello', function ($name) {
return 'hello,' . $name;
});
echo app('sayHello',['thinkphp']);
绑定类的实例
也可以直接绑定一个类的实例
$cache = new think\Cache;
// 绑定类实例
bind('cache',$cache);
// 快速调用类的实例
$cache = app('cache');
绑定至接口实现
对于依赖注入使用接口类的情况,我们需要告诉系统使用哪个具体的接口实现类来进行注入,这个使用可以把某个类绑定到接口
// 绑定think\LoggerInterface接口实现到think\Log
bind('think\LoggerInterface','think\Log');
使用接口作为依赖注入的类型
<?php
namespace app\index\controller;
use think\LoggerInterface;
class Index
{
public function hello(LoggerInterface $log)
{
$log->record('hello,world!');
}
}
批量绑定
如果传入一个数组的话,就表示进行批量绑定,例如:
bind([
'route' => \think\Route::class,
'session' => \think\Session::class,
'url' => \think\Url::class,
]);
可以在应用或者模块目录下面定义provider.php
文件(返回一个数组),系统会自动批量绑定类库到容器中。
return [
'route' => \think\Route::class,
'session' => \think\Session::class,
'url' => \think\Url::class,
];
绑定标识调用的时候区分大小写,系统已经内置绑定了核心常用类库,无需重复绑定
系统内置绑定到容器中的类库包括
| 系统类库 | 容器绑定标识 |
|---|---|
| think\Build | build |
| think\Cache | cache |
| think\Config | config |
| think\Cookie | cookie |
| think\Debug | debug |
| think\Env | env |
| think\Hook | hook |
| think\Lang | lang |
| think\Log | log |
| think\Request | request |
| think\Response | response |
| think\Route | route |
| think\Session | session |
| think\Url | url |
| think\Validate | validate |
| think\View | view |
解析
助手函数方式
使用app
助手函数进行容器中的类解析调用,对于已经绑定的类标识,会自动快速实例化
app('cache');
上面的app助手函数相当于调用了
Container::get('cache');
带参数实例化调用
app('cache',['file']);
对于没有绑定的类,也可以直接解析
app('org\utils\ArrayItem');
对象化调用
使用app
助手函数获取容器中的对象实例(支持依赖注入)。
$app = app();
// 判断对象实例是否存在
isset($app->cache);
// 注册容器对象实例
$app->cache = think\Cache::class;
// 获取容器中的对象实例
$cache = $app->cache;
不带任何参数调用app
助手函数其实是实例化think\App
类,可以方便的操作容器、绑定和调用对象实例。
// 绑定类到容器
app()->test = new Test;
// 实例调用
$test = app()->test;
也就是说,你可以在任何地方使用app()
方法调用容器中的任何类。
// 调用配置类
app()->config->get('app_name');
// 调用session类
app()->session->get('user_name');
自动注入
容器的更多使用主要用于依赖注入,和5.0自动注入的方式有所区别,类的绑定操作不再使用Request
对象而是直接注册到容器中,并且支持模型事件和数据库事件的依赖注入,依赖注入会首先检查容器中是否注册过该对象实例,如果有的话就会自动注入,例如:
我们可以给路由绑定模型对象实例
Route::get('user/:id','index/Index/hello')
->model('\app\index\model\User');
然后在操作方法中自动注入User模型
<?php
namespace app\index\controller;
use app\index\model\User;
use think\Controller;
class Index extends Controller
{
public function hello(User $user)
{
return 'Hello,'.$user->name;
}
}
自定义实例化
V5.1.13+
版本开始,容器中的对象实例化支持自定义,可以在你的容器中需要依赖注入的对象中增加__make
方法定义,例如:
如果你希望User
模型类在依赖注入的时候 使用自定义实例化的方式,可以用下面的方法。
<?php
namespace app\index\model;
use think\Model;
use think\db\Query;
class User extends Model
{
public static function __make(Query $query)
{
return (new self())->setQuery($query);
}
}




