ThinkPHP 5 结构与路径解析
结构:
入口文件:
所有的请求都必须经过 index.php 的处理。(index.php 在 public 文件夹下)有的时候我们会在 url 中隐藏 index.php,但是即使是这样,所有的请求还是会发送到 index.php 中。下面,让我们简单的看一下 index.php 做了那些事情:
// 定义应用目录
define("APP_PATH", __DIR__ . "/../application/");
// 加载 thinkphp 文件夹下的框架引导文件
requrie __DIR__ . "/../thinkphp/start.php";
应用:
一个应用可以有多个入口文件,应用在 tp5 中大概有两个概念,第一个是包含许多模块的目录,第二个抽象的概念是 tp5 中管理系统架构以及声明周期的对象。(开发业务时只需要了解前者即可)
模块:
多模块是 tp5 的特性,即 application 中的 index 文件夹就是一个模块。
模块中就包含着 mvc。一个模块下可以包含多个控制器,每个控制器下面又会有多个 action。控制器不应该负责过多的业务,业务应该交给 model 曾来实现。
图示
Snipaste_2018-08-18_15-43-03.pngURL 路径格式
tp5定义的 url 路径格式:
http://serverName/index.php/module/controller/action/[param/value...]
示例:
http://localhost/zerg/public/index.php/index/index/index
其中:localhost/zerg/public
对应着serverName
,index.php
为入口文件,后面的三个 index 分别指 index 模块下的名为 index 的控制器的 index 方法。(index是 tp5 的保留字,可以省略,会自动补全,即等同于 localhost/zerg/public/
)
重点记住 module/controller/action
,因为这三个是根据不同的接口变化的。
这种路径格式被 tp5 官方称为 PATH_INFO
【注意】url 不区分大小写,如果要设置为区分大小写,可以在 config.php 中找到 "url_convert",设置为 false 即可,但是不推荐做这种设置,最好保持大小写不敏感。
有时浏览器不兼容上面说的 PATH_INFO。于是,tp5 还定义了一种兼容模式:
http://serverName/index.php?s=module/controller/action/p/v...
唯一的区别是在入口文件之后,module/controller/action 被当作入口文件的值。
在写接口的时候,不管 PATH_INFO 还是兼容模式,其实都是不会使用的。。。因为有以下缺点:
- 长
- 暴露了服务器文件结构
- 不够灵活,导致不能很好支持 URL 语义化,表意不明。
既然有这些缺点我们用什么解决呢?答案是路由~
另一种 URL 路径格式是混合模式,但这里的混合模式指的是不同的方法可以用 PATH_INFO 也可以用路由来实现访问,而不是同一个方法,对于同一个方法来说,一旦使用了路由,PATH_INFO 就无法使用。
还有一种是 强制使用路由模式,字面上也很好理解。
接下来我们看一下这三种 URL 格式在哪里配置:
在 application 文件夹下有一个 config.php
文件:
首先是 'url_route_on'
官方的解释是是否开启路由。默认是 true,即默认是混合模式。如果这里设置为 false 之后,就变成了 PATH_INFO 模式。
那么强制使用路由模式呢?'url_route_must'
默认情况是 false。
那么这三者如何来选取呢?建议在编写 API 时开启强制路由模式,因为保证一致性是非常重要的,最好只支持一种模式。