20.3 ThinkPHP的配置

20.3 ThinkPHP的配置

视频讲解：光盘TMlx20ThinkPHP的配置．exe

配置文件是ThinkPHP框架程序得以运行的基础条件，框架的很多功能都需要在配置文件中配置之后才可以生效，包括URL路由功能、页面伪静态和静态化等。ThinkPHP提供了灵活的全局配置功能，采用最有效率的PHP返回数组方式定义，支持惯例配置、项目配置、调试配置和模块配置，并且会自动生成配置缓存文件，无须重复解析。

ThinkPHP在项目配置上创造了自己独有的分层配置模式，其配置层次如图20.10所示。

图20.10 分层配置模式的顺序

以上是配置文件的加载顺序，但是因为后面的配置会覆盖之前的配置（在没有生效的前提下），所以优先顺序从右到左。系统的配置参数是通过静态变量全局存取的，存取方式非常简单高效。

20.3.1 配置格式

ThinkPHP框架中所有配置文件的定义格式均采用返回PHP数组的方式，格式为：

<?php return array( 'APP_DEBUG' => true, 'URL_MODEL' => 2, …//更多的配置参数 ); ?>

说明

配置参数不区分大小写（因为无论使用大小写定义，都会转换成小写），但是习惯上保持大写定义的原则。另外，还可以在配置文件中使用二维数组来配置更多的信息。例如：

<?php return array( 'APP_DEBUG' => true, 'USER_CONFIG' => array( 'USER_AUTH' => true, 'USER_TYPE' => 2, ), ); ?>

系统目前最多支持二维数组的配置级别，每个项目配置文件除了定义ThinkPHP所需要的配置参数之外，开发人员可以在里面添加项目需要的一些配置参数，用于自己的应用。项目配置文件默认存储于项目的Conf目录。例如，在例20.2中，连接数据库的配置文件存储于项目的2Confconfig.php文件中。

技巧

项目配置指的是项目的全局配置，因为一个项目除了可以定义项目配置文件之外，还可以定义模块配置文件用于针对某个特定的模块进行特殊的配置。它们的定义格式都是一致的，区别只是配置文件命名的不同。系统会自动在不同的阶段读取配置文件。

这里使用．html作为模板文件的后缀，因为HTML网页在互联网中更容易被搜索引擎搜索到。

20.3.2 调试配置

如果启用调试模式，那么会导入框架默认的调试配置文件。默认的调试配置文件位于ThinkCommondebug.php，如果没有检测到项目的调试配置文件，就会直接使用默认的调试配置参数。如果项目定义自身的调试配置文件，则会和默认的调试配置文件合并，也就是说，项目配置文件也只需要配置和默认调试配置不同的参数或者新增的参数。

调试配置文件也位于项目配置目录下，文件名是debug.php。通常情况下，调试配置文件中可以进行一些开发模式所需要的配置。例如，配置额外的数据库连接用于调试，开启日志写入便于查找错误信息，开启页面Trace输出更多的调试信息等。系统默认的调试配置文件中设置如下内容：

开启日志记录

关闭模板缓存

记录SQL日志

关闭字段缓存

开启运行时间详细显示（包括内存、缓存情况）

开启页面Trace信息显示

严格检查文件大小写（即使是Windows平台）