# 配置类
配置类用于获取配置参数,这些参数可以来自于默认的配置文件(application/config/config.php), 也可以来自你自定义的配置文件。
**注解**
该类由系统自动初始化,你无需手工加载。
# 使用配置类
# 配置文件剖析
CodeIgniter 默认有一个主要的配置文件,位于 application/config/config.php 。 如果你使用文本编辑器打开它的话,你会看到配置项都存储在一个叫做 $config 的数组中。
你可以往这个文件中添加你自己的配置项,或者你喜欢将你的配置项和系统的分开的话, 你也可以创建你自己的配置文件并保存到配置目录下。
**注解**
如果你要创建你自己的配置文件,使用和主配置文件相同的格式,将配置项保存到名为 $config 的数组中。 CodeIgniter 会智能的管理这些文件,所以就算数组名都一样也不会冲突(假设数组的索引没有相同的)。
# 加载配置文件
**注解**
CodeIgniter 会自动加载主配置文件(application/config/config.php),所以你只需要加载你自己 创建的配置文件就可以了。
有两种加载配置文件的方式:
# 手工加载
要加载你自定义的配置文件,你需要在 控制器 中使用下面的方法:
~~~
$this->config->load('filename');
~~~
其中,filename 是你的配置文件的名称,无需 .php 扩展名。
如果你需要加载多个配置文件,它们会被合并成一个大的 config 数组里。尽管你是在不同的配置文件中定义的, 但是,如果有两个数组索引名称一样的话还是会发生名称冲突。为了避免冲突,你可以将第二个参数设置为 TRUE , 这样每个配置文件中的配置会被存储到以该配置文件名为索引的数组中去。例如:
~~~
// Stored in an array with this prototype: $this->config['blog_settings'] = $config
$this->config->load('blog_settings', TRUE);
~~~
请阅读下面的 “获取配置项” 一节,学习如何获取通过这种方式加载的配置。
第三个参数用于抑制错误信息,当配置文件不存在时,不会报错:
~~~
$this->config->load('blog_settings', FALSE, TRUE);
~~~
# 自动加载
如果你发现有一个配置文件你需要在全局范围内使用,你可以让系统自动加载它。 要实现这点,打开位于 application/config/ 目录下的 autoload.php 文件, 将你的配置文件添加到自动加载数组中。
# 获取配置项
要从你的配置文件中获取某个配置项,使用如下方法:
~~~
$this->config->item('item_name');
~~~
其中 item_name 是你希望获取的 $config 数组的索引名,例如,要获取语言选项, 你可以这样:
~~~
$lang = $this->config->item('language');
~~~
如果你要获取的配置项不存在,方法返回 NULL 。
如果你在使用 $this->config->load 方法时使用了第二个参数,每个配置文件中的配置 被存储到以该配置文件名为索引的数组中,要获取该配置项,你可以将 $this->config->item() 方法的第二个参数设置为这个索引名(也就是配置文件名)。例如:
~~~
// Loads a config file named blog_settings.php and assigns it to an index named "blog_settings"
$this->config->load('blog_settings', TRUE);
// Retrieve a config item named site_name contained within the blog_settings array
$site_name = $this->config->item('site_name', 'blog_settings');
// An alternate way to specify the same item:
$blog_config = $this->config->item('blog_settings');
$site_name = $blog_config['site_name'];
~~~
# 设置配置项
如果你想动态的设置一个配置项,或修改某个已存在的配置项,你可以这样:
~~~
$this->config->set_item('item_name', 'item_value');
~~~
其中,item_name 是你希望修改的 $config 数组的索引名,item_value 为要设置的值。
# 多环境
你可以根据当前的环境来加载不同的配置文件,index.php 文件中定义了 ENVIRONMENT 常量,在 处理多环境 中有更详细的介绍。
要创建特定环境的配置文件,新建或复制一个配置文件到 application/config/{ENVIRONMENT}/{FILENAME}.php 。
例如,要新建一个生产环境的配置文件,你可以:
新建目录 application/config/production/
将已有的 config.php 文件拷贝到该目录
编辑 application/config/production/config.php 文件,使用生产环境下配置
当你将 ENVIRONMENT 常量设置为 'production' 时,你新建的生产环境下的 config.php 里的配置将会加载。
你可以放置以下配置文件到特定环境的目录下:
默认的 CodeIgniter 配置文件
你自己的配置文件
**注解**
CodeIgniter 总是先加载全局配置文件(例如,application/config/ 目录下的配置文件), 然后再去尝试加载当前环境的配置文件。这意味着你没必要将所有的配置文件都放到特定环境的配置目录下, 只需要放那些在每个环境下不一样的配置文件就可以了。另外,你也不用拷贝所有的配置文件内容到 特定环境的配置文件中,只需要将那些在每个环境下不一样的配置项拷进去就行了。定义在环境目录下的配置项, 会覆盖掉全局的配置。
# 类参考
**class CI_Config**
**$config**
所有已加载的配置项组成的数组。
* * * * *
**$is_loaded**
所有已加载的配置文件组成的数组。
* * * * *
**item**($item[, $index=''])
参数:
* $item (string) -- Config item name
* $index (string) -- Index name
返回: Config item value or NULL if not found
返回类型: mixed
获取某个配置项。
* * * * *
**set_item**($item, $value)
参数:
* $item (string) -- Config item name
* $value (string) -- Config item value
返回类型: void
设置某个配置项的值。
* * * * *
**slash_item**($item)
参数: $item (string) -- config item name
返回: Config item value with a trailing forward slash or NULL if not found
返回类型: mixed
这个方法和 item() 一样,只是在获取的配置项后面添加一个斜线,如果配置项不存在,返回 NULL 。
* * * * *
**load**([$file = ''[, $use_sections = FALSE[, $fail_gracefully = FALSE]]])
参数:
* $file (string) -- Configuration file name
* $use_sections (bool) -- Whether config values should be loaded into their own section (index of the main config array)
* $fail_gracefully (bool) -- Whether to return FALSE or to display an error message
返回: TRUE on success, FALSE on failure
返回类型: bool
加载配置文件。
* * * * *
**site_url**()
返回: Site URL
返回类型: string
该方法返回你的网站的 URL ,包括你在配置文件中设置的 "index" 值。
这个方法通常通过 URL 辅助函数 中函数来访问。
* * * * *
**base_url**()
返回: Base URL
返回类型: string
该方法返回你的网站的根 URL ,你可以在后面加上样式和图片的路径来访问它们。
这个方法通常通过 URL 辅助函数 中函数来访问。
* * * * *
**system_url**()
返回: URL pointing at your CI system/ directory
返回类型: string
该方法返回 CodeIgniter 的 system 目录的 URL 。
**注解**
该方法已经废弃,因为这是一个不安全的编码实践。你的 system/ 目录不应该被公开访问。
- 空白目录
- 欢迎使用 CodeIgniter
- 安装说明
- 下载CodeIgniter
- 安装说明
- 从老版本升级
- 疑难解答
- CodeIgniter 概览
- 开始
- CodeIgniter 是什么?
- 支持特性
- 应用程序流程图
- 模型-视图-控制器
- 架构目标
- 教程 - 内容提要
- 加载静态内容
- 读取新闻条目
- 创建新闻条目
- 结束语
- 向 CodeIgniter 贡献你的力量
- 编写 CodeIgniter 的文档
- Developer's Certificate of Origin 1.1
- 常规主题
- CodeIgniter URL
- 控制器
- 保留名称
- 视图
- 模型
- 辅助函数
- 使用 CodeIgniter 类库
- 创建类库
- 使用 CodeIgniter 驱动器
- 创建驱动器
- 创建核心系统类
- 创建附属类
- 钩子 - 扩展框架核心
- 自动加载资源
- 公共函数
- 兼容性函数
- URI 路由
- 错误处理
- 网页缓存
- 程序分析
- 以 CLI 方式运行
- 管理你的应用程序
- 处理多环境
- 在视图文件中使用 PHP 替代语法
- 安全
- PHP 开发规范
- 类库参考
- 基准测试类
- 缓存驱动器
- 日历类
- 购物车类
- 配置类
- Email 类
- 加密类
- 加密类(新版)
- 文件上传类
- 表单验证类
- FTP 类
- 图像处理类
- 输入类
- Javascript 类
- 语言类
- 加载器类