TP5学习记录（Controller篇）

ThinkPHP5

ThinkPHP是一个免费开源的、快速简单的、面向对象的、轻量级PHP开发框架。

为什么选择ThinkPHP5？

• ThinkPHP5采用了全新的架构思想;
• 优化了核心是一个颠覆性的版本;
• 支持composer方式安装;
• 对API进行了大量的优化更符合了现代web开发的方式;

MVC定义：
MVC全名Model-View-Controller，是模型、视图、控制器的缩写，是一种软件设计典范，而不是一种设计模式。其特点：

• 耦合性低
• 重用行高
• 可维护性高
• 有利于软件的工程化

开发环境：
PHP >= 5.4.0
Mysql
Apache/Nginx

Mysql默认端口号3306，Apache/Nginx默认端口号80

三种安装方法：

• github上下载think, framework
• composer下载
• thinkphp官网下载

composer简介
composer是php的一个依赖管理工具
文档：http://docs.phpcomposer.com/
安装：

curl -sS https://getcomposer.org/installer | php        #下载composer安装工具
sudo mv composer.phar /usr/local/bin/composer            #将下载下来的composer.phar移动到系统的PATH目录，这样全局能够进行访问。

composer安装TP5
composer create-project --prefer-dist topthink/think proj_name

Apache设置根目录

/Applications/XAMPP/etc/httpd.conf文件为Apache的核心配置文件，打开后重新设置DocumentRoot的值，DocumentRoot为web的根目录，然后重启Apache服务器即可。

TP5目录讲解

tp5
|-application                    #应用目录
    |-index
        |-controller    #控制器
        |-view            #视图
        |-model            #模型
    |-command.php        #控制台的配置文件
    |-common.php        #项目全局的公共文件
    |-config.php        #应用的配置文件
    |-database.php        #数据库配置文件
    |-route.php            #路由文件
    |-tag.php            #应用行为扩展文件
|-extend                        #扩展类库目录
|-public                        #网站对外访问目录
    |-index.php            #应用入口文件，所有的请求都是通过index.php之后进行转发
    |-robots.text        #定义哪些文件能被搜索引擎爬取，哪些不能
    |-router.php        #框架快速启动的配置文件
    |-static            #存放网站的静态资源，如css,html,image等
|-runtime                        #运行时目录，包含项目运行时的缓存文件、编译文件、日志等
|-thinkphp                        #框架核心目录
    |-lang                #语言包目录
    |-library            #框架核心类库目录
    |-tpl                #系统模版文件
    |-base.php            #框架基础文件，常用于定义一些常量
    |-composer.json        #composer定义文件
    |-console.php        #控制台入口文件
    |-convention.php    #惯例配置文件
    |-helper.php        #助手函数文件
    |-phpunit.xml        #单元测试配置文件
    |-README.md            #README文件
    |-start.php            #框架引导文件
|-vendor                        #第三方类库目录
|-bulid.php                        #自动生成定义文件
|-composer.json                    #composer定义文件
|-LICENSE.text                    #授权说明文件
|-README.md                        #README文件
|-think                            #命令行工具入口

开发规范：

• 目录名使用小写+下划线的方式命名
• 类文件名采用大驼峰法，类文件中的类和类文件名一致，其他文件名均使用小写
• 方法名采用小驼峰法
• 属性名采用小驼峰法
• 以双下划线__开头的方法属于魔术方法
• 常量以大写字母和下划线命名
• 配置参数以小写字母和下划线命名
• 数据库表和字段采用小写+下划线的命名方式 不能以下划线开头
• 应用类库的命名空间统一为app（可以配置）

ThinkPHP5模块设计
5.0版本对模块的功能做了灵活设计，默认采用多模块的架构，并且支持单一模块设计，所有模块的命名空间均以app作为根命名空间（可配置更改，一般不进行更改）。
注意：application目录下创建的common文件夹，common会默认作为公共模块，里面的文件，不能通过url直接访问

设置命名空间：namespace app\index\controller;
设置别名：use app\common\controller\Index as commonIndex;

ThinkPHP5配置

• 惯例配置
  ThinkPHP框架下的默认配置，在think/convention.php文件中，一般不进行修改。

• 应用配置
  应用配置文件是应用初始化的时候首先加载的公共配置文件，默认位于application/config.php，作用域为整个应用项目。可以在入口文件public/index.php中定义CONF_PATH，然后新建文件夹，达到将应用配置放到该文件的目的，这样方便将配置进行统一管理。
  在config目录下创建config.php，添加应用配置或者对惯例配置进行修改（需要更改惯例配置时，一般不在原文件中直接更改，可以在创建的config.php中进行更改）
  在config目录下创建database.php，在里面配置数据库连接

  //定义配置文件目录
  define('CONF_PATH', __DIR__ . '/../application/config/');

• 扩展配置
  在上面应用配置config目录下添加名为extra的文件夹，然后添加配置文件，将会以数组形式作为元素添加到应用配置下。
• 场景配置
  在不同场景下设置不同的配置，可以利用设置数据库的连接参数
  home.php：家庭办公环境的配置项
  office.php：公司办公环境的配置项
• 模块配置
  模块配置文件是针对某个模块下的配置文件，一般位于application/模块名/config.php，可以在和application同级目录下创建文件路径config/index/config.php，然后在public/index.php中定义CONF_PATH为该路径，这种情况也分为应用配置config/config.php和模块配置config/index/config.php，但会忽略application路径下的配置。

• 动态配置
  在具体的控制器或者方法里面进行动态配置，动态配置只在当前的控制器或者当前的方法中有效。比如在Index.php下设置如下代码，就可以为Index控制器动态的添加或修改配置。

  public function __construct()
  {
      config('before', 'beforeAction');
      Config::set('before', 'beforeAction');  //功能同上，动态配置
  }

Config类下的方法
目录：thinkphp/library/think/Config.php
range($range)：设定配置参数的作用域
parse($config, $type = '', $name = '', $range = '')：解析配置文件或内容
load($file, $name = '', $range = '')：加载配置文件（PHP格式）
has($name, $range = '')：检测配置是否存在
get($name = null, $range = '')：获取配置参数 为空则获取所有配置
set($name, $value = null, $range = '')：设置配置参数 name 为数组则为批量设置
reset($range = '')：重置配置参数

环境变量配置和使用

• 入口文件
  单入口文件：应用程序的所有http请求都由某一个文件接受并由这个文件转发到功能代码中。ThinkPHP符合这种功能规范，所有的http请求都由public/index.php文件接收并转发，根据不同的参数，转发到不同的控制器调用不同的方法，最终实现不同的功能。

• 隐藏入口文件

  public/.htaccess里面：
  
  # 将请求转发到index.php之后
  RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

• 入口文件绑定

  public/index.php中添加：
  
  define('BIND_MODULE', 'admin');           #绑定模块为admin，只能访问admin模块下的所有文件
  define('BIND_MODULE', 'admin/Index');  #绑定的模块为admin下的Index控制器，只能访问Index控制器下的所有方法

  可以在public目录下添加文件api.php，然后在文件下定义应用目录、加载框架引导文件等..，然后进行模块绑定，这样可以实现通过访问api.php下的模块实现让用户只能访问具体模块api下的文件，这样一个项目中可以进行多种开发（API开发等）。

  应用配置中：
  auto_bind_module：自动绑定模块
  其值设置为true之后
  入口文件api.php会自动绑定为api模块
  但入口文件index.php不会自动绑定为index模块

路由
将请求地址url和具体控制器中的具体方法绑定，通过路由来转发使其对应。

在conf/config.php中添加（也可以不添加，系统默认开启路由）：

'url_route_on'           => true

在index/Index控制器下有方法：

public function info($id = '')
{
    return "{$id}";
}

然后在config/route.php中添加：

return [
    //设置路由
    'info/:id' => 'index/Index/info'
];

这样就实现了通过访问localhost/info/5可以访问localhost/index/Index/info/5。

请求对象Request
ThinkPHP是一个单入口框架，所有的请求都通过index.php，可以通过index.php来接收所有的http请求，请求中的所有参数都可以通过Request对象来接收。

获取Request对象的三种方式：

public function index()
{
    //获取方式一：通过助手函数request()
    $request = request();
    
    //获取方式二：通过Request对象实例
    $request = Request::instance();
}

//获取方式三：通过注入对象的方式（常用）
public function index(Request $request)
{
    dump($request);
}

Request中常用方法：

#注意：Requset中所有的方法都在thinkphp/think/Request.php文件中，可查阅

public function index(Request $request)
{
    #url信息
    dump($request->domain());                  #域名
    dump($request->pathinfo());                #url的pathinfo信息（含URL后缀）
    dump($request->path());                    #url的pathinfo信息(不含URL后缀)
    dump($request->url());                     #url
    
    #请求方式 GET、POST
    dump($request->method());                  #请求方式
    dump($request->isGet());                   #是否为GET请求
    dump($request->isPost());                  #是否为POST请求
    dump($request->isAjax());                  #是否为AJAX请求
    
    #请求参数
    dump($request->get());                     #获取所有参数的数组
    dump($request->param());                   #获取所有参数的数组（包含get、post、pathinfo等）
    dump($request->get('name'));                  #获取name参数的值
    dump($request->get('age'));                #获取age参数的值
    dump($request->param('name'));             #获取name参数的值
    dump($request->param('age'));                 #获取age参数的值
    
    #获取模型 控制器 操作
    dump($request->module());                   #当前模块
    dump($request->controller());               #当前控制器
    dump($request->action());                   #当前方法
}

input助手函数

/*
 * function input($key = '', $default = null, $filter = ...)
 * $key：表示传入参数
 * $default：参数默认值
 * $filter：参数过滤函数
 * 获取输入数据 支持默认值和过滤
 * 
 * 其中$key支持'.'语法，支持如下：
 * ['get', 'post', 'put', 'patch', 'delete', 'route', 'param', 'request', 'session', 'cookie',   'server', 'env', 'path', 'file']
 *
 */
public function index(Request $request)
{
    $res_get = $request->get('name');
    $res_param_get = $request->param('name');
    $res_input_get = input('get.name');           #功能同上，获取get请求中参数name对应的数据
    $res_input_get1 = input('get.name', '张三');    #如果参数name对应的数据为null，设置默认值
    
    $res_post = $request->post('name');
    $res_param_get = $request->param('name');
    $res_input_post = input('post.name');            #功能同上，获取post请求中参数name对应的数据
}

响应对象Response

http对每个请求都有相应的响应。

public function getUserInfo()
{
    //动态配置返回数据类型
    //config('default_return_type', 'json');
    Config::set('default_return_type', 'json');  //功能同上

    $res = [
        'code'  => 200,
        'body'  => [
            'name'  =>  '张三',
            'age'   =>   22,
            'sex'   =>   '男'
        ],
        'msg'  => '请求成功'
    ];
    return $res;
}