ThinkPHP - 《F10wers_13eiCheng笔记》

ThinkPHP3.2.3开发
目录结构
入口文件
- 入口文件定义
- 入口文件中的其他定义
控制器
URL模式
路由
- 启用路由
- 路由定义

ThinkPHP3.2.3开发

目录结构

www WEB部署目录

index.php 入口文件
README.md README文件
Application 应用文件
Public 资源文件目录
ThinkPHP 框架目录

Application和Public目录下面都是空的。

其中框架目录ThinkPHP的结构如下：

ThinkPHP框架系统目录

Common 核心公共函数目录
Conf 核心配置目录
Lang 核心语言包目录
Library 框架类目录
- Think 核心Think类库包目录
- Behavior 行为类库目录
- Org Org类库包目录
- Vendor 第三方类库目录
Mode 框架应用模式目录
Tpl 系统模板目录
LICENS.txt 协议文件
logo.png logo
ThinkPHP.php 框架入口文件

入口文件

ThinkPHP采用单一入口模式进行项目部署和访问，无论完成什么功能，一个应用都有一个统一（但不一定是唯一）的入口。

应该说，所有应用都是从入口文件开始的，并且不同应用的入口文件是类似的。

入口文件定义

入口文件主要完成：

定义框架路径、项目路径（可选）
定义调试模式和应用模式（可选）
定义系统相关常量（可选）
载入框架入口文件（必须）

默认情况下，框架已经自带了一个应用入口文件（以及默认的目录结构），内容如下：

define('APP_PATH','./Application/');
require './ThinkPHP/ThinkPHP.php';

如果你改变了项目目录（例如把Application更改为Apps），只需要在入口文件更改APP_PATH常量定义即可：

define('APP_PATH','./Apps/');
require './ThinkPHP/ThinkPHP.php';

注意：APP_PATH的定义支持相对路径和绝对路径，但必须以“/”结束

如果你调整了框架核心目录的位置或者目录名，只需要这样修改：

define('APP_PATH','./Application/');
require './Think/ThinkPHP.php';

也可以单独定义一个THINK_PATH常量用于引入：

define('APP_PATH','./Application/');
define('THINK_PATH',realpath('../Think').'/');
require THINK_PATH.'ThinkPHP.php';

和APP_PATH一样THINK_PATH路径定义也必须以“/”结尾。
给THINK_PATH和APP_PATH定义绝对路径会提高系统的加载效率。

入口文件中的其他定义

般不建议在入口文件中做过多的操作，但可以重新定义一些系统常量，入口文件中支持定义（建议）的一些系统常量包括：

常量	描述
THINK_PATH	框架目录
APP_PATH	应用目录
RUNTIME_PATH	应用运行时目录（可写）
APP_DEBUG	应用调试模式（默认为false）
STORAGE_TYPE	存储类型（默认为File）
APP_MODE	应用模式（默认为common）

注意：所有路径常量都必须以“/”结尾

例如，我们可以在入口文件中重新定义相关目录并且开启调试模式：

// 定义应用目录
define('APP_PATH','./Apps/');
// 定义运行时目录
define('RUNTIME_PATH','./Runtime/');
// 开启调试模式
define('APP_DEBUG',True);
// 更名框架目录名称，并载入框架入口文件
require './Think/ThinkPHP.php';

这样最终的应用目录结构如下：

www  WEB部署目录（或者子目录）
├─index.php       应用入口文件
├─Apps            应用目录
├─Public          资源文件目录
├─Runtime         运行时目录
└─Think           框架目录

控制器

我们可以在自动生成的Application/Home/Controller目录下面找到一个 IndexController.class.php 文件，这就是默认的Index控制器文件。

控制器类的命名方式是：控制器名（驼峰法，首字母大写）+Controller

控制器文件的命名方式是：类名+class.php（类文件后缀）

默认的欢迎页面其实就是访问的Home模块下面的Index控制器类的index操作方法我们修改默认的index操作方法如下：

namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
    public function index(){
        echo 'hello,world!';
    }
}

再次运行应用入口文件，浏览器会显示：hello,world!。

我们再来看下控制器类，IndexController控制器类的开头是命名空间定义：

namespace Home\Controller;

这是系统的规范要求，表示当前类是Home模块下的控制器类，命名空间和实际的控制器文件所在的路径是一致的，也就是说： Home\Controller\IndexController类对应的控制器文件位于应用目录下面的 Home/Controller/IndexController.class.php，如果你改变了当前的模块名，那么这个控制器类的命名空间也需要随之修改。

注意：命名空间定义必须写在所有的PHP代码之前声明，而且之前不能有任何输出，否则会出错

use Think\Controller;

表示引入 Think\Controller 类库便于直接使用。所以，

namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller

等同于使用：

namespace Home\Controller;
class IndexController extends \Think\Controller

URL模式

入口文件是应用的单一入口，对应用的所有请求都定向到应用入口文件，系统会从URL参数中解析当前请求的模块、控制器和操作：

http://serverName/index.php/模块/控制器/操作

这是3.2版本的标准URL格式。

可以通过设置模块绑定或者域名部署等方式简化URL地址中的模块及控制器名称。

URL大小写

ThinkPHP框架的URL是区分大小写（主要是针对模块、控制器和操作名，不包括应用参数）的，这一点非常关键，因为ThinkPHP的命名规范是采用驼峰法（首字母大写）的规则，而URL中的模块和控制器都是对应的文件，因此在Linux环境下面必然存在区分大小写的问题。

框架内置了一个配置参数用于解决URL大小写的问题，如下：

'URL_CASE_INSENSITIVE'  =>  true,

当URL_CASE_INSENSITIVE设置为true的时候表示URL地址不区分大小写，这个也是框架在部署模式下面的默认设置。

当开启调试模式的情况下，这个参数是false，因此你会发现在调试模式下面URL区分大小写的情况。

URL模式

如果我们直接访问入口文件的话，由于URL中没有模块、控制器和操作，因此系统会访问默认模块（Home）下面的默认控制器（Index）的默认操作（index），因此下面的访问是等效的：

http://serverName/index.php
http://serverName/index.php/Home/Index/index

这种URL模式就是系统默认的PATHINFO模式，不同的URL模式获取模块和操作的方法不同，ThinkPHP支持的URL模式有四种：普通模式、PATHINFO、REWRITE和兼容模式，可以设置URL_MODEL参数改变URL模式。

URL模式	URL_MODEL设置
普通模式	0
PATHINFO模式	1
REWRITE模式	2
兼容模式	3

如果你整个应用下面的模块都是采用统一的URL模式，就可以在应用配置文件中设置URL模式，如果不同的模块需要设置不同的URL模式，则可以在模块配置文件中设置。

普通模式

普通模式也就是传统的GET传参方式来指定当前访问的模块和操作，例如： http://localhost/?m=home&c=user&a=login&var=value

m参数表示模块，c参数表示控制器，a参数表示操作（当然这些参数都是可以配置的），后面的表示其他GET参数。

如果默认的变量设置和你的应用变量有冲突的话，你需要重新设置系统配置，例如改成下面的：

'VAR_MODULE'            =>  'module',     // 默认模块获取变量
'VAR_CONTROLLER'        =>  'controller',    // 默认控制器获取变量
'VAR_ACTION'            =>  'action',    // 默认操作获取变量

上面的访问地址则变成： http://localhost/?module=home&controller=user&action=login&var=value

注意，VAR_MODULE只能在应用配置文件中设置，其他参数可以则也可以在模块配置中设置

PATHINFO模式

PATHINFO模式是系统的默认URL模式，提供了最好的SEO支持，系统内部已经做了环境的兼容处理，所以能够支持大多数的主机环境。对应上面的URL模式，PATHINFO模式下面的URL访问地址是： http://localhost/index.php/home/user/login/var/value/

PATHINFO地址的前三个参数分别表示模块/控制器/操作。

不过，PATHINFO模式下面，依然可以采用普通URL模式的参数方式，例如： http://localhost/index.php/home/user/login?var=value 依然是有效的

PATHINFO模式下面，URL是可定制的，例如，通过下面的配置：

// 更改PATHINFO参数分隔符
'URL_PATHINFO_DEPR'=>'-',

我们还可以支持下面的URL访问： http://localhost/index.php/home-user-login-var-value

REWRITE模式

REWRITE模式是在PATHINFO模式的基础上添加了重写规则的支持，可以去掉URL地址里面的入口文件index.php，但是需要额外配置WEB服务器的重写规则。

如果是Apache则需要在入口文件的同级添加.htaccess文件，内容如下：

<IfModule mod_rewrite.c>
 RewriteEngine on
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

接下来，就可以用下面的URL地址访问了： http://localhost/home/user/login/var/value

更多环境的URL重写支持参考部署部分的URL重写。

兼容模式

兼容模式是用于不支持PATHINFO的特殊环境，URL地址是： http://localhost/?s=/home/user/login/var/value

可以更改兼容模式变量的名称定义，例如：

'VAR_PATHINFO'          =>  'path'

PATHINFO参数分隔符对兼容模式依然有效，例如：

// 更改PATHINFO参数分隔符
'URL_PATHINFO_DEPR'=>'-',

使用以上配置的话，URL访问地址可以变成： http://localhost/?path=/home-user-login-var-value

兼容模式配合Web服务器重写规则的定义，可以达到和REWRITE模式一样的URL效果。

例如，我们在Apache下面的话，.htaccess文件改成如下内容：

<IfModule mod_rewrite.c>
 RewriteEngine on
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]
</IfModule>

就可以和REWRITE模式一样访问下面的URL地址访问了： http://localhost/home/user/login/var/value

路由

启用路由

要使用路由功能，前提是你的URL支持PATH_INFO（或者兼容URL模式也可以，采用普通URL模式的情况下不支持路由功能），并且在应用（或者模块）配置文件中开启路由：

// 开启路由
'URL_ROUTER_ON'   => true,

路由功能可以针对模块，也可以针对全局，针对模块的路由则需要在模块配置文件中开启和设置路由，如果是针对全局的路由，则是在公共模块的配置文件中开启和设置（后面我们以模块路由定义为例）。

然后就是配置路由规则了，在模块的配置文件中使用URL_ROUTE_RULES参数进行配置，配置格式是一个数组，每个元素都代表一个路由规则，例如：

'URL_ROUTE_RULES'=>array(
    'news/:year/:month/:day' => array('News/archive', 'status=1'),
    'news/:id'               => 'News/read',
    'news/read/:id'          => '/news/:1',
),

系统会按定义的顺序依次匹配路由规则，一旦匹配到的话，就会定位到路由定义中的控制器和操作方法去执行（可以传入其他的参数），并且后面的规则不会继续匹配。

路由定义

路由规则的定义格式为： ‘路由表达式’=>’路由地址和传入参数’

或者：array(‘路由表达式’,’路由地址’,’传入参数’)