入口文件是应用的单一入口,对应用的所有请求都定向到应用入口文件,系统会从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`
- 序言
- 基础
- 获取ThinkPHP
- 环境要求
- 目录结构
- 入口文件
- 自动生成
- 模块
- 控制器
- 开发规范
- 配置
- 配置格式
- 配置加载
- 读取配置
- 动态配置
- 扩展配置
- 批量配置
- 架构
- 模块化设计
- URL模式
- 多层MVC
- CBD模式
- 命名空间
- 自动加载
- 应用模式
- 项目编译
- 系统流程
- 路由
- 路由定义
- 规则路由
- 正则路由
- 静态路由
- 闭包支持
- 实例说明
- 控制器
- 控制器定义
- 前置和后置操作
- Action参数绑定
- 伪静态
- URL大小写
- URL生成
- AJAX返回
- 跳转和重定向
- 输入变量
- 请求类型
- 空操作
- 空控制器
- 插件控制器
- 操作绑定到类
- 模型
- 模型定义
- 模型实例化
- 字段定义
- 连接数据库
- 切换数据库
- 分布式数据库支持
- 连贯操作
- WHERE
- TABLE
- ALIAS
- DATA
- FIELD
- ORDER
- LIMIT
- PAGE
- GROUP
- HAVING
- JOIN
- UNION
- DISTINCT
- LOCK
- CACHE
- COMMENT
- RELATION
- USING
- fetchSql
- TOKEN
- STRICT
- INDEX
- 命名范围
- CURD操作
- 数据创建
- 数据写入
- 数据读取
- 数据更新
- 数据删除
- ActiveRecord
- 字段映射
- 查询语言
- 查询方式
- 表达式查询
- 快捷查询
- 区间查询
- 组合查询
- 统计查询
- SQL查询
- 动态查询
- 子查询
- 自动验证
- 自动完成
- 参数绑定
- 虚拟模型
- 模型分层
- 视图模型
- 关联模型
- 高级模型
- Mongo模型
- 视图
- 模板定义
- 模板主题
- 模板赋值
- 模板渲染
- 获取模板地址
- 获取内容
- 模板引擎
- 模板
- 变量输出
- 系统变量
- 使用函数
- 默认值输出
- 使用运算符
- 标签库
- 模板继承
- 修改定界符
- 三元运算
- 包含文件
- 内置标签
- Volist标签
- Foreach标签
- For标签
- Switch标签
- 比较标签
- 范围判断标签
- IF标签
- Present标签
- Empty标签
- Defined标签
- Assign标签
- Define标签
- 标签嵌套
- import标签
- 使用PHP代码
- 原样输出
- 模板注释
- 模板布局
- 模板替换
- 调试
- 调试模式
- 异常处理
- 日志记录
- 页面Trace
- Trace方法
- 变量调试
- 性能调试
- 错误调试
- 模型调试
- 缓存
- 数据缓存
- 快速缓存
- 查询缓存
- 静态缓存
- 安全
- 输入过滤
- 表单合法性检测
- 表单令牌
- 防止SQL注入
- 目录安全文件
- 保护模板文件
- 上传安全
- 防止XSS攻击
- 其他安全建议
- 扩展
- 类库扩展
- 驱动扩展
- 缓存驱动
- 数据库驱动
- 日志驱动
- Session驱动
- 存储驱动
- 模板引擎驱动
- 标签库驱动
- 行为扩展
- 标签扩展
- Widget扩展
- 应用模式
- 部署
- PATH_INFO支持
- URL重写
- 模块部署
- 域名部署
- 入口绑定
- 替换入口
- 专题
- SESSION支持
- Cookie支持
- 多语言支持
- 数据分页
- 文件上传
- 验证码
- 图像处理
- RESTFul
- RPC
- SAE
- IP获取和定位
- 附录
- 常量参考
- 配置参考
- 升级指导
- 鸣谢
- CoverPage