Thinkphp5学习笔记

Thinkphp5学习笔记

架构

Thinkphp5目录架构

thinkphp  应用部署目录
├─application           应用目录（可设置）
│  ├─common             公共模块目录（可更改）
│  ├─index              模块目录(可更改)
│  │  ├─config.php      模块配置文件
│  │  ├─common.php      模块函数文件
│  │  ├─controller      控制器目录
│  │  ├─model           模型目录
│  │  ├─view            视图目录
│  │  └─ ...            更多类库目录
│  ├─command.php        命令行工具配置文件
│  ├─common.php         应用公共（函数）文件
│  ├─config.php         应用（公共）配置文件
│  ├─database.php       数据库配置文件
│  ├─tags.php           应用行为扩展定义文件
│  └─route.php          路由配置文件
├─extend                扩展类库目录（可定义）
├─public                WEB 部署目录（对外访问目录）
│  ├─static             静态资源存放目录(css,js,image)
│  ├─index.php          应用入口文件
│  ├─router.php         快速测试文件
│  └─.htaccess          用于 apache 的重写
├─runtime               应用的运行时目录（可写，可设置）
├─vendor                第三方类库目录（Composer）
├─thinkphp              框架系统目录
│  ├─lang               语言包目录
│  ├─library            框架核心类库目录
│  │  ├─think           Think 类库包目录
│  │  └─traits          系统 Traits 目录
│  ├─tpl                系统模板目录
│  ├─.htaccess          用于 apache 的重写
│  ├─.travis.yml        CI 定义文件
│  ├─base.php           基础定义文件
│  ├─composer.json      composer 定义文件
│  ├─console.php        控制台入口文件
│  ├─convention.php     惯例配置文件
│  ├─helper.php         助手函数文件（可选）
│  ├─LICENSE.txt        授权说明文件
│  ├─phpunit.xml        单元测试配置文件
│  ├─README.md          README 文件
│  └─start.php          框架引导文件
├─build.php             自动生成定义文件（参考）
├─composer.json         composer 定义文件
├─LICENSE.txt           授权说明文件
├─README.md             README 文件
├─think                 命令行入口文件

规范

​ ThinkPHP5.0的URl访问受路由决定，如果关闭路由或者没有匹配路由的情况下，则是基于：

​ http://serverName/index.php(或者其他应用入口文件，可省略) /模块/ 控制器/操作 / 参数 /值

​ 在Thinkphp5.0框架中，在url地址栏里面如果不写模块、控制器和操作名，默认访问的就是index模块下面的index控制器下面的index操作，可以在config.php文件中进行修改。

入口文件

​ 用户请求的PHP文件，负责处理一个请求（注意，不一定是URL请求）的生命周期，最常见的入口文件就是index.php, 有时候也会为了某些特殊的需求而增加新的入口文件，例如给后台模块单独设置的一个入口文件admin.php或者一个控制器程序入口think都属于入口文件。

命名空间规范

应用类库的根命名空间统一为app(可以设置app_namespace配置参数更改)；
例如：appindexcontrollerIndex 和 appindexmodelUser;

属性命名

• 类的命名采用驼峰法，并且首字母大写，例如User、UserType，默认不需要添加后缀，例如UserController应该直接命名为User;
• 在Thinkphp3中需要UserController等命名方式；
• 函数的命名使用小写和下划线（小写字母开头的方式），例如get_client_ip ;
• 方法的命名使用驼峰法，并且首字母小写，例如getUserName ;
• 属性的命名使用驼峰法，并且首字母小写，例如tableName 、 instance;

应用类库命名空间规范

应用类库的根命名空间统一为app(可以设置app_namespace配置参数更改)；
例如：appindexcontrollerIndex 和 appindexmodelUser;

请求

Thinkphp助手参数

1.判断变量是否定义

input('?get.id');
input('?post.name');

变量类型方法:

方法	描述
param	获取当前请求的变量
get	获取 $_GET 变量
post	获取 $_POST 变量
put	获取 $_PUT 变量
delete	获取 $_DELETE 变量
session	获取 $_SESSION 变量
cookie	获取 $_COOKIE 变量
request	获取 $_REQUEST 变量
server	获取 $_SERVER 变量
env	获取 $_ENV 变量
route	获取 路由（包括PATHINFO） 变量
file	获取 $_FILE 变量

获取PARAM参数

input('param.name'); // 获取单个参数
input('param.'); // 获取全部参数
// 下面是等效的
input('name'); 
input('');

获取GET参数

// 获取单个变量
input('get.id');
// 使用过滤方法获取 默认为空字符串
input('get.name');
// 获取全部变量
input('get.');

使用过滤方法

input('get.name','','htmlspecialchars'); // 获取get变量 并用htmlspecialchars函数过滤
input('username','','strip_tags'); // 获取param变量 并用strip_tags函数过滤
input('post.name','','orgFilter::safeHtml'); // 获取post变量 并用orgFilter类的safeHtml方法过滤

使用变量修饰符

input('get.id/d');
input('post.name/s');
input('post.ids/a');

修饰符

修饰符	作用
s	强制转换为字符串类型
d	强制转换为整形类型
b	强制转换为布尔类型
a	强制转换为数组类型
f	强制转换为浮点类型

请求

Request对象的主要职责是统一和更安全地获取当前的请求信息，你需要避免直接操作$_GET、$_POST、$_REQUEST、$_SESSION、$_COOKIE、$_FILES等全局变量，而是统一使用Request对象提供的方法来获取请求变量。

​ ThinkPHP5的Request对象由thinkRequest类完成。

​ $request = Request::instance();

​ 也可以使用助手函数

​ $request = request();

`$request = Request::instance();`
// 获取当前域名
`echo 'domain: ' . $request->domain() . '<br/>';`

方法	描述
param	获取当前请求的变量（自动识别GET、POST、PUT请求的一种变量获取方式，是系统推荐的获取请求参数方法）
get	获取$_GET变量
post	获取$_POST变量
put	获取PUT变量
delete	获取DELETE变量
session	获取$_SESSION变量
cookie	获取$_COOKIE变量
request	获取$_REQUEST变量
server	获取$_SERVER变量
env	获取$_ENV变量
file	获取$_FILES变量

改变变量

​ 如果需要更改请求变量的值，可以通过下面的方式：

​ 更改GET变量

​ Request::instance()->get(['id'=>10]);

​ 更改POST变量

​ Request::instance()->post(['name'=>'thinkphp']);

​ 尽量避免直接修改$_GET或者$_POST 数据,同时也不能直接修改param变量，例如下面的操作是无效的。

​ 更改请求变量

​ Request::instance()->param(['id'=>10]);

伪静态

​ URL伪静态通常是为了满足更好的SEO效果，ThinkPHP支持伪静态URL设置，可以通过设置url_html_suffix参数随意在URL的最后增加你想要的静态后缀，而不影响当前操作的正常执行。例如，我们设置

​ 'url_html_suffix'=>'shtml'

如果要获取当前的伪静态后缀，可以使用Request对象的ext方法。

路由

路由功能由 hinkRoute类完成。

由于ThinkPHP5.0默认采用的URL规则是：

http://server/module/controller/action/param/value/.....

路由的作用是简化URL访问地址，并根据定义的路由类型做出正确的解析。

路由模式

ThinkPHP5.0的路由比较灵活，并且不需要强制定义，可以总结归纳为如下三种方式：

普通模式

关闭路由，完全使用默认的PATH_INFO方式URL：

url_route_on => false,

路由关闭后，不会解析任何路由规则，采用默认的PATH_INFO模式访问URL:

http://serverName/index.php/module/controller/action/param/value/...

混合模式

开启路由，并使用路由定义+默认PATH_INFO方式的混合:

'url_route_on' => true,

'url_route_must' => false,

该方式下面，只需要对需要定义路由规则的访问地址定义路由规则，其他的仍然按照第一种普通模式的PATH_INFO模式访问URL。

强制模式

开启路由，并设置必须定义路由才能访问：

url_route_on => true,

url_route_must => true,

这种方式下面必须严格给每一个访问地址定义路由规则（包括首页），否则将抛出异常。

首页的路由规则采用/定义即可，例如下面把网站首页路由输出Hello,world!我们需要在route.php这个文件中配置路由，要使用官方的 use thinkRoute

Route::get('/',function(){
	return 'Hello,world!';
});

路由定义

路由注册可以采用方法动态单个和批量注册，也可以直接定义路由定义文件的方式进行集中注册。

动态注册

路由定义采用 hinkRoute类的rule方法注册，通常是在应用的路由配置文件

application/route.php进行注册，格式是：

Route::rule('路由表达式'，'路由地址'，'请求类型'，'路由参数（数组）'，'变量规则（数组）')；

use thinkRoute;
// 注册路由到index模块的Index控制器的list操作
Route::rule('new/:id','index/Index/list');

我们访问：

http://serverName/new/5

会自动路由到：

http://serverName/index/index/list/id/5

ThinkPHP5.0的路由规则定义是从根目录开始，而不是基于模块名的。

路由命名标识必须唯一，定义后可以用于URL的快速生成。

可以在rule方法中指定请求类型，不指定的话默认为任何请求类型，例如：

Route::rule('new/:id','News/update','POST'); 表示定义的路由规则在POST请求下才有效。注意：请求类型参数必须大写。

请求类型包括：	类型
GET	GET请求
POST	POST请求
PUT	PUT请求
DELETE	DELETE请求
*	任何请求类型

系统提供了为不同的请求类型定义路由规则的简化方法，例如：

Route::get('new/:id','News/read'); // 定义GET请求路由规则
Route::post('new/:id','News/update'); // 定义POST请求路由规则
Route::put('new/:id','News/update'); // 定义PUT请求路由规则
Route::delete('new/:id','News/delete'); // 定义DELETE请求路由规则
Route::any('new/:id','News/read'); // 所有请求都支持的路由规则

如果要定义get和post请求支持的路由规则，也可以用：

Route::rule('new/:id','News/read','GET|POST');

也可以批量注册路由规则

Route::rule(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::get(['new/:id'=>'News/read','blog/:name'=>'Blog/detail']);
Route::post(['new/:id'=>'News/update','blog/:name'=>'Blog/detail']);

注册多个路由规则后，系统会依次遍历注册过的满足请求类型的路由规则，一旦匹配到正确的路由规则后则开始调用控制器的操作方法，后续规则就不再检测。

定义路由配置文件

除了支持动态注册，也可以直接在应用目录下面的route.php的最后通过返回数组的方式直接定义路由规则

return [
    'new/:id' => 'News/read',
    'blog/:id' => ['Blog/update',['method' => 'post|put'], ['id' => 'd+']],
];

路由动态注册和配置定义的方式可以并存。由于检测机制问题，动态注册的性能比路由配置要高一些，尤其是多种请求类型混合定义的时候。

默认情况下，只会加载一个路由配置文件route.php，如果需要定义多个路由文件，可以修改route_config_file的配置参数，例如：

定义路由配置文件（数组）
'route_config_file' => ['route', 'route1', 'route2'],

资源路由

5.0支持设置RESTFul请求的资源路由，方式如下：

Route::resource('blog','index/blog');

或者在路由配置文件中使用__rest__添加资源路由定义：

return [
    // 定义资源路由
    '__rest__'=>[
    // 指向index模块的blog控制器
    'blog'=>'index/blog',
],	

设置过后会自动注册7个路由规则，如下：

标识	请求类型	生成路由规则	对应操作方法（默认）
index	GET	blog	index
create	GET	blog/create	create
save	POST	blog	save
read	GET	blog/:id	read
edit	GET	blog/:id/edit	edit
update	PUT	blog/:id	update
delete	DELETE	blog/:id	delete

具体指向的控制器由路由地址决定，例如上面的设置，会对应index模块的blog控制器，你只需要为Blog控制器创建以上对应的操作方法就可以支持下面的URL访问：

http://serverName/blog/
http://serverName/blog/128
http://serverName/blog/28/edit

Blog控制器中对应的方法如下：

namespace appindexcontroller;
class Blog 
{
    public function index()
    {	
    	dump(index);
    }
    public function update($id)
    {
    	dump(update);
    }
    public function delete($id)
    {
    	dump(delete);
    }
}

快捷路由

快捷路由允许你快速给控制器注册路由，并且针对不同的请求类型可以设置方法前缀

// 给User控制器设置快捷路由
Route::controller('user','index/User');

User控制器定义如下：

namespace appindexcontroller;
class User 
{
    public function getInfo()
    {
    }
    public function getPhone()
    {
    }
    public function postInfo()
    {
    }
    public function putInfo()
    {
    }	
    public function deleteInfo()
    {
    }
}	

我们可以通过下面的URL访问

get http://localhost/user/info
get http://localhost/user/phone
post http://localhost/user/info
put http://localhost/user/info
delete http://localhost/user/info

权限控制

Base.php，需要鉴权继承该类即可

<?php
namespace appindexcontroller;
use thinkController;
use thinkRequest;
class Base extends Controller
{
	//用来存放需要用户登录之后才能操作的方法的集合
	protected $is_check_login = [''];
	public function _initialize()
	{
		if (!$this->isLogin() && (in_array(Request::instance()->action(), $this->is_check_login)||$this->is_check_login[0]=='*')){
			return $this->error('请先登录系统！','index/Index/login');
		}
	}
	public function isLogin()
	{
		return session('?name');
	}
}

GoodsController,进行所有方法鉴权

<?php
namespace appindexcontroller;
use appindexcontrollerBase;
class Goods extends Base
{
	protected $is_check_login = ['*'];
	public function add()
	{
		echo '我想要购买商品';
	}
	public function edit()
	{
		echo '我想退货';
	}
	public function delete()
	{
		echo '我不想买了';
	}

}

CommentController,仅对Add方法路由鉴权

<?php
namespace appindexcontroller;
use appindexcontrollerBase;
class Comment extends Base
{
	protected $is_check_login = ['add'];
	public function add()
	{
		echo '我想发表评论';
	}
	public function edit()
	{
		echo '我想编辑一下自己的评论';
	}


}