0xx_PHP_TP框架
ThinkPHP框架
今日目标（每日任务）
1 能够安装ThinkPHP5框架并熟悉常用目录结构
2 能够使用ThinkPHP5框架的控制器
3 能够命令行创建模块目录和文件
4 能够使用ThinkPHP5框架的Request请求类
5 能够进行模板渲染
一、框架概述
1、什么是框架
框架就是一些代码类、方法（函数）、变量、常量的集合，这些代码是功能结构性的代码（并非业务代码）。业务代码其实就是具体的一些模块的增删改查逻辑代码。
使用框架开发项目，有便于代码重用、开发效率高、代码规范好、便于功能扩展等优点。
2、php中的主流框架
①Zend Framework 框架，PHP官方框架。
②YII框架，又叫易框架。
③Symfony 框架。
④Laravel框架，市场使用较多。
⑤Codelgniter框架，简称CI框架。
⑥ThinkPHP框架，简称TP框架，常用版本：3.2.3和 5.0.*版本。
ThinkPHP是国人自己开发的框架。有中文官网、中文帮助文档、中文社区，以及丰富的百度搜索资源。所以ThinkPHP很适合作为入门级的开发框架。
这些框架大多都基于MVC设计思想和面向对象的。
mvc：
M:模型model，处理业务数据，与数据库做交互。
V:视图view，显示html页面，用户能够看到并与之交互的页面。
C：控制器controller，接收请求，调用模型处理数据，调用视图显示页面。
整个网站应用，分为模型、视图、控制器三大部分组成。
二、ThinkPHP框架安装
1、下载并解压框架
下载后解压到工作目录
2、配置虚拟主机
①通过phpStudy的“站点域名管理”进行配置或者直接修改apache的虚拟主机配置文件，
将站点域名指向项目目录下的public目录
②域名解析，修改hosts文件
增加域名如下： 多个域名可以写在同一行，以空格隔开
127.0.0.1 tpshop.com www.tpshop.com
③重启apache，在浏览器访问配置的虚拟站点http://www.tpshop.com
看到以上界面，说明框架安装成功。
apache配置参考（不要照搬）：
<VirtualHost *:80>
DocumentRoot "E:\phpStudy\WWW\tpshop\public"
ServerName www.tpshop.com
ServerAlias tpshop.com
<Directory "E:\phpStudy\WWW\tpshop\public">
Options FollowSymLinks ExecCGI
AllowOverride All
Order allow,deny
Allow from all
Require all granted
</Directory>
</VirtualHost>
三、TP框架基础
1、目录结构（重点）
（见手册--基础--目录结构）
1.project 应用部署目录
2.├─application 应用目录（可设置）
3.│ ├─common 公共模块目录（可更改）
4.│ ├─index 模块目录(可更改)
5.│ │ ├─config.php 模块配置文件
6.│ │ ├─common.php 模块函数文件
7.│ │ ├─controller 控制器目录
8.│ │ ├─model 模型目录
9.│ │ ├─view 视图目录
10.│ │ └─ ... 更多类库目录
11.│ ├─command.php 命令行工具配置文件
12.│ ├─common.php 应用公共（函数）文件
13.│ ├─config.php 应用（公共）配置文件
14.│ ├─database.php 数据库配置文件
15.│ ├─tags.php 应用行为扩展定义文件
16.│ └─route.php 路由配置文件
17.├─extend 扩展类库目录（可定义）
18.├─public WEB 部署目录（对外访问目录）
19.│ ├─static 静态资源存放目录(css,js,image)
20.│ ├─index.php 应用入口文件
21.│ ├─router.php 快速测试文件
22.│ └─.htaccess 用于 apache 的重写
23.├─runtime 应用的运行时目录（可写，可设置）
24.├─vendor 第三方类库目录（Composer）
25.├─thinkphp 框架系统目录
26.│ ├─lang 语言包目录
27.│ ├─library 框架核心类库目录
28.│ │ ├─think Think 类库包目录
29.│ │ └─traits 系统 Traits 目录
30.│ ├─tpl 系统模板目录
31.│ ├─.htaccess 用于 apache 的重写
32.│ ├─.travis.yml CI 定义文件
33.│ ├─base.php 基础定义文件
34.│ ├─composer.json composer 定义文件
35.│ ├─console.php 控制台入口文件
36.│ ├─convention.php 惯例配置文件
37.│ ├─helper.php 助手函数文件（可选）
38.│ ├─LICENSE.txt 授权说明文件
39.│ ├─phpunit.xml 单元测试配置文件
40.│ ├─README.md README 文件
41.│ └─start.php 框架引导文件
42.├─build.php 自动生成定义文件（参考）
43.├─composer.json composer 定义文件
44.├─LICENSE.txt 授权说明文件
45.├─README.md README 文件
46.├─think 命令行入口文件
2、配置文件（重点）
（见手册--配置）
①三个层级的配置文件：
框架主配置文件（惯例配置文件） thinkphp/convention.php
应用公共配置文件 application/config.php， application/database.php 对整个应用生效
模块配置文件 application/模块目录/config.php 对当前模块生效
②其他说明：
配置文件格式 return array( 键值对 );
加载顺序： 框架主配置文件 》 应用公共配置文件 》 模块配置文件
配置文件生效顺序： 后加载的生效（后加载的配置项会覆盖之前配置项）
如果要手动进行配置，一般不要修改框架本身的主配置文件，
而是在应用或者模块配置文件中进行配置。
3、函数文件
框架助手函数文件 thinkphp/helper.php
应用公共函数文件 application/common.php
模块函数文件 application/模块目录/common.php
一般不建议直接修改thinkphp/helper.php
4、开发规范（了解）
TP框架编码规范：见手册--基础--开发规范
扩展：PSR代码规范：https://www.kancloud.cn/thinkphp/php-fig-psr/3139
5、请求的生命周期
框架的生命周期，也就是请求的执行流程：
四、TP框架中的控制器
1、控制器的后缀
打开配置文件application/config.php，有如下配置
'controller_suffix' => false,
表示默认情况下，控制器无特殊后缀。例如 Index控制器，文件名为Index.php
如果需要进行设置，可以设置为（我们不需要这么设置）
'controller_suffix' => 'Controller',
表示控制器以Controller为后缀。例如Index控制器，文件名为IndexController.php
2、控制器的定义
（见手册--控制器--控制器定义）
1）定义位置及命名规则
定义位置：application/模块目录/controller/目录下
命名规则：控制器名称（首字母大写） + (控制器后缀，默认没有) + .php
默认：Index控制器 Index.php
User控制器 User.php
Test控制器 Test.php
示例：
2）编写控制器
①声明命名空间 namespace app\模块目录名\controller
②引入控制器基类（可选） use think\Controller; think是命名空间 Controller是基类控制器
③定义当前控制器类，继承控制器基类（可选）
示例：定义测试控制器Test.php
3、框架中的命名空间
命名空间本身是PHP就有的，用来防止命名冲突问题的。
TP框架中的命名空间，通常和目录挂钩。
原因：TP中的自动加载机制，会将类的命名空间作为加载路径的一部分。
TP中命名空间使用：
①声明命名空间 使用namespace关键字
②引入指定的类 使用use关键字 命名空间\类名称
③完全限定式访问 在使用类时，\完整命名空间\类名称（继承和实例化）
如果一个类没有命名空间，使用 \类名
4、url访问
（见手册--架构--URL访问）
ThinkPHP5.0框架中，默认使用PATH_INFO方式的url进行访问。
示例：http://www.tpshop.com/index.php/Index/Test/index/page/10
格式：http://域名/入口文件/模块名/控制器名称/操作方法名称/参数名/参数值
隐藏入口文件写法：http://域名/模块名/控制器名称/操作方法名称/参数名/参数值
需要对apache进行设置（手册--架构--URL访问、手册--部署--URL重写）
使用PHPStudy需要将 public目录的.htaccess文件中，index.php后面加上?
使用Apapche的重写机制隐藏入口文件后，如果在整个url后面加上.html后缀, 让整个url看起来像是访问的静态页面。这叫做“伪静态”。
5、调试模式
（见手册--错误与调试--调试模式）
默认情况下，如果代码有误（比如控制器名拼写有误），会出现以下错误：
错误描述比较模糊，不方便进行错误调试。这种模式通常叫做“部署模式”（生产模式）。
开发阶段可以将框架设置为调试模式，便于进行错误调试：
修改 项目目录\application目录\config.php
开启调试模式后，报错信息格式如下：
会提示详细错误信息 和 错误位置（参考位置）。
相对于 线上环境（开发完成后的阶段），叫做 部署模式或者生产模式。
五、创建模块
1、创建前台和后台模块
一个典型的应用是由多个模块组成的（通常有前台网站模块和后台管理系统模块），这些模块通常都是应用目录下面的一个子目录，每个模块都有自己独立的配置文件、公共文件和类库文件。
我们给项目创建home（前台）和admin（后台）两个模块：
2、设置默认访问模块
打开配置文件application/config.php，有如下配置
'default_module' => 'index',
表示默认访问模块为index模块
可以更改默认模块为home模块
'default_module' => 'home',
六、命令行创建模块目录及文件
在 项目根目录 执行命令（think文件所在的目录）
1、命令行创建模块目录
（见手册 -- 命令行 -- 自动生成目录结构）
通常可以通过以下命令，自动生成模块目录
php think build --module 模块名
比如：创建test模块目录，执行命令 php think build --module test即可。（模块名小写）
2、命令行创建控制器
（见手册 -- 命令行 -- 创建类库文件）
通常可以通过以下命令，自动创建控制器
php think make:controller 模块名/控制器名
php think make:controller 模块名/控制器名 --plain
加上 --plain 参数 表示创建没有方法的空控制器类。否则控制器类中会自带一些方法。
比如：创建home模块Index控制器，执行命令 php think make:controller home/Index即可。
注意：控制器名首字母大写。
3、命令行创建模型
（见手册 -- 命令行 -- 创建类库文件）
通常可以通过以下命令，自动创建模型
php think make:model 模块名/模型名
比如：创建home模块User模型，执行命令 php think make:model home/User即可。
注意：模型名首字母大写。
七、Request请求类
1、获取输入变量
（见手册--请求--输入变量）
要获取当前的请求信息，可以使用\think\Request类
$request = \think\Request::instance();
或者使用助手函数
$request = request();
也可以单独获取get变量或者post变量
Request::instance()->get();
Request::instance()->post();
input('get.');
input('post.');
代码示例：
浏览器访问效果：
特殊说明：路由变量与get变量
http://www.tpshop.com/home/test/index/id/100?page=10
param方法 能够获取所有参数（id, page）
get方法 只能获取?后面的请求字符串的参数（page）
route方法 只能获取到?前面的路由中的参数（id）
2、参数绑定
（见手册--请求--参数绑定）
方法参数绑定是把URL地址（或者路由地址）中的变量作为操作方法的参数直接传入。
使用示例：home模块Test控制器read方法中，声明$id参数
访问url中，传递id参数 http://www.tpshop.com/home/test/read/id/100
效果：
3、依赖注入
（见手册--请求--依赖注入）
依赖注入：简单的说，要在一个类A中使用另一个依赖类B时，不直接在类A中实例化类B，而是先实例化类B后再以参数的形式传入类A.
框架中的使用：
原理分析：
补充说明：Request请求类中，封装了很多和请求相关的方法，详情见手册--请求（多看）
小结：
可以找到任何一种方法 接收请求参数
//1.获取请求对象
$request = request();
$request = \think\Request::instance();
$request = $this->request; //仅限于继承了底层控制器的情况下
public function save(Request $request) //依赖注入
//2. 接收请求参数 param方法
$params = $request->param();
$params = input();
$params = request()->param();
$id = $request->param('id');
$id = input('id');
public function edit($id)//参数绑定
八、ThinkPHP框架中的视图
1、视图的组成
View视图类（继承了自定义模板引擎，功能与Smarty类似）
HTML模板文件
2、模板的定义
（见手册--模板--模板定位）
为了对模板文件更加有效的管理，ThinkPHP对模板文件进行目录划分，默认的模板文件定义规则是：视图目录/控制器名（小写）/操作名（小写）+模板后缀
默认的视图目录是模块的view目录，框架的默认视图文件后缀是.html。
比如home模块 Index控制器index方法要调用的模板定义为view/index/index.html
3、模板渲染
（见手册--视图--模板渲染，手册--视图--模板赋值）
在控制器方法中，
第一种：使用assign方法进行模板赋值，使用fetch方法进行模板渲染。
第二种：使用助手函数view(), 进行模板渲染并赋值。
使用示例：
注：模板中输出变量值： {$模板变量名}
九、将后台模板与框架做结合
模板整合思路：
①确定页面的访问路径（模块、控制器、方法）
②新建对应的控制器方法，在方法中调用模板
③将模板页面移动到对应的视图目录下（创建子目录）
④将静态资源文件移动到public/static/admin目录下
⑤修改模板文件中静态资源路径
页面分布：
登录页 Login控制器login方法 login.html
首页 Index控制器index方法 index.html
商品列表 Goods控制器index方法 goods_list.html -> index.html
商品新增 Goods控制器create方法 goods_add.html -> create.html
商品修改 Goods控制器edit方法 goods_edit.html -> edit.html
管理员列表 Manager控制器index方法 manager_list.html -> index.html
管理员新增 Manager控制器create方法 manager_add.html -> create.html
管理员修改 Manager控制器edit方法 manager_edit.html ->edit.html
...
1、模板布局
（见手册--模板--模板布局）
使用模板布局，就是把多个模板页面都有的公共代码给抽取出来，放到一个公共位置开发维护
好处：相同的代码只维护一份，减少代码工作量
后台全局布局设置步骤：
①修改配置文件application/admin/config.php,加入以下设置
'template' => [
'layout_on' => true,//开启布局
'layout_name' => 'layout',//布局文件名称
]
②将静态资源文件移动到/public/static/admin目录下
③在application/admin/view目录下，新建layout.html
将后台页面公共的头部、底部代码提取到layout.html中，在中间位置放一个特殊字符串“{_CONTENT_}”，表示此位置，替换为原始要访问的页面内容。
layout.html文件中， 只保留所有页面公共 的css和js相关代码，修改静态资源路径
注： 一定不能 直接将所有css和js都放在layout.html中。
注：TP框架中，模板中的静态资源路径，不能使用相对路径./ ，必须使用以/开头的路径。
④临时关闭模板布局
全局布局设置，对所有页面全部生效。
特殊页面（不需要使用布局的页面），可以在控制器方法中，临时关闭模板布局。
$this->view->engine->layout(false);
比如登录页面，不需要使用布局，见 “3、后台登录页”
2、后台首页
①确定页面的访问路径（模块、控制器、方法）
admin模块Index控制器index方法
②新建对应的控制器方法，在方法中调用模板
<?php
namespace app\admin\controller;
use think\Controller;
class Index extends Controller
{
public function index()
{
return view();
}
}
③将模板页面移动到对应的视图目录下
index.html => application/admin/view/index/index.html
④修改模板文件
保留页面独有的静态资源文件，以及主体部分代码
修改模板文件中静态资源路径
注：如果页面显示效果不对，可以考虑先删除缓存 runtime目录
3、后台登录页
①确定页面的访问路径（模块、控制器、方法）
admin模块 login控制器 login方法
②新建对应的控制器方法，在方法中调用模板
注：后台的登录页面，不需要使用布局
③将模板页面移动到对应的视图目录下
将login.html 移动到 application/admin/view/login/目录下
⑤修改模板文件中静态资源路径
修改application/admin/view/login/login.html
注：也可以使用_STATIC_ 代替静态资源路径中的/static（手册--视图--输出替换）
4、其他页面
重复步骤①②③⑤
作业
整合以下模板
商品列表 Goods控制器index方法 goods_list.html -> index.html
商品新增 Goods控制器create方法 goods_add.html -> create.html
商品修改 Goods控制器edit方法 goods_edit.html -> edit.html
管理员列表 Manager控制器index方法 manager_list.html -> index.html
管理员新增 Manager控制器create方法 manager_add.html -> create.html
管理员修改 Manager控制器edit方法 manager_edit.html ->edit.html
总结：
1.安装部署框架，熟悉目录结构（application public）
2.控制器定义、控制器的访问（隐藏入口文件、Path_info格式url） 能够访问到指定的控制器方法
3.命令行操作（创建模块，创建控制器类）（环境变量等）
4.Request请求对象基本使用--接收参数（熟练使用一种写法）
5.模板整合（模板布局）
