配置文件使用说明

DoitPHP项目的配置文件,默认的主配置文件为:application.php。负责DoitPHP框架所使用的参数的设置。注:DoitPHP项目的配置参数分为两种:一种DoitPHP框架中使用(内置)的配置参数,一种是应用程序中使用而DoitPHP框架中没有提及的。对于DoitPHP使用的“系统”级的配置参数,姑且称为:“DoitPHP内置参数”。对于DoitPHP内置参数均有默认值。也就意味着如果application.php文件即使不存在或内置参数没有在文件application.php设置,项目程序将使用默认值。

DoitPHP内置参数在主配置文件application.php中是一个二维数组,以'application'作为二维数组的第一个key,其内置参数名作为二维数组的第二个key。如:$config['application']['rewrite'] = true; rewrite则为内置参数的参数名。

在前面文章中(入门指南:设置)中,已经介绍了几个常用的配置参数。如:开启日志功能,开启调试debug功能,开启URL路由网址的重写功能,以及视图格式的设置。这里将 DoitPHP内置参数详细说明一下:

一、DoitPHP内置参数名列表:

1、basePath

设置项目应用目录的路径。注:路径后无须“/”。

2、cachePath

设置缓存目录的路径。注:路径后无须“/”。

3、logPath 设置日志目录的路径。

设置日志目录的路径

4、debug

设置是否开启调试模式。开启/关闭(true/false),默认:false。

5、log

设置是否开启日志写入功能。开启/关闭(true/false),默认:false。

6、rewrite

设置是否开启URL路由网址重写(Rewrite)功能。开启/关闭(true/false),默认:false。

7、urlFormat

设置路由网址格式(path:为url路由格式;get:为标准普通url格式)。
path格式: 如:/index.php/user/register,参数值:self::PATH_FORMAT
get格式: /index.php?router=user/register,参数值:self::GET_FORMAT

8、urlSegmentation

设置路由网址分割符。默认:"/"。

9、defaultController

设置默认Controller。默认:'Index'。

10、defaultAction

设置默认Action。默认:'index'。

11、defaultTimeZone

设置时区,默认时区为东八区(中国)时区(Asia/ShangHai)。

12、viewExt

设置视图文件的格式。php: self::PHP_VIEW_EXT; html: self::HTML_VIEW_EXT。默认值:self::PHP_VIEW_EXT。

二、主配置文件参数获取

在项目程序中可通过调用Configure::get()类方法来获取。
例如:调用内置配置参数值。
$rewriteStatus = Configure::get('application.rewrite');

三、自定义配置文件

除了项目主配置文件外,DoitPHP还支持自定义配置文件。自定义配置文件,存放于系统配置目录中(config),且后缀名为.php。文件内容其格式和主配置文件内容相类。

例如:SMTP Server连接参数。文件名为: smtp.php,配置文件内容如下:

$config['smtp'] = array(
	'host' => 'smtp.doitphp.com',
	'port' => '25',
	'user' => 'admin',
	'paword' => '123456',
);

这样在程序中就可以通过Configure::get('smtp')来获取SMTP Server连接参数值。