PHP Manual
Yaf
The Yaf_Config_Ini class

The Yaf_Config_Ini class

(Yaf >=1.0.0)

简介

Yaf_Config_Ini允许开发者通过嵌套的对象属性语法在应用程序中用熟悉的INI格式存储和读取配置数据。 INI格式在提供拥有配置数据键的等级结构和配置数据节之间的继承能力方面具有专长。配置数据等级结构通过用点或者句号(.)分离键值。一个节可以扩展或者通过在节的名称之后带一个冒号(:)和被继承的配置数据的节的名称来从另一个节继承。

Note:

Yaf_Config_Ini利用PHP的函数parse_ini_file()来解析配置文件的。请仔细查看这个函数的文档，注意它的一些特殊用途。以及它传递给Yaf_Config_Ini的一些比如 "TRUE", "FALSE","yes", "no", 和"NULL"的特殊值的处理方式

类摘要

Yaf_Config_Ini extends Yaf_Config_Abstract implements Iterator , Traversable , ArrayAccess , Countable {

/* 属性 */

/* 方法 */

public __construct ( string $config_file [, string $section ] )

public count ( void ) : void

public current ( void ) : void

public __get ([ string $name ] ) : void

public __isset ( string $name ) : void

public key ( void ) : void

public next ( void ) : void

public offsetExists ( string $name ) : void

public offsetGet ( string $name ) : void

public offsetSet ( string $name , string $value ) : void

public offsetUnset ( string $name ) : void

public readonly ( void ) : void

public rewind ( void ) : void

public __set ( string $name , mixed $value ) : void

public toArray ( void ) : void

public valid ( void ) : void

/* 继承的方法 */

abstract public Yaf_Config_Abstract::get ( string $name , mixed $value ) : mixed

abstract public Yaf_Config_Abstract::readonly ( void ) : bool

abstract public Yaf_Config_Abstract::set ( void ) : Yaf_Config_Abstract

abstract public Yaf_Config_Abstract::toArray ( void ) : array

}

属性

_config
_readonly

范例

Example #1 Yaf_Config_Ini()example

这个例子说明了使用Yaf_Config_Ini从一个INI配置文件中获取配置数据的基本用法。这个例子中既有生产环境的配置方法也有演示环境的配置方法。因为演示环境的配置跟生产环境的非常类似，所以演示环境的配置继承了生产环境的配置。在复杂的情况下，决定是任意的，也可以写成相反的。在更复杂的情况下，生产环境继承自演示环境不是不可能的。假设，以下配置数据都包含在/path/to/config.ini中：

; Production site configuration data
[production]
webhost                  = www.example.com
database.adapter         = pdo_mysql
database.params.host     = db.example.com
database.params.username = dbuser
database.params.password = secret
database.params.dbname   = dbname
 
; Staging site configuration data inherits from production and
; overrides values as necessary
[staging : production]
database.params.host     = dev.example.com
database.params.username = devuser
database.params.password = devsecret

 <?php
$config = new Yaf_Config_Ini('/path/to/config.ini', 'staging');
 
var_dump($config->database->params->host); 
var_dump($config->database->params->dbname);
var_dump($config->get("database.params.username"));
?>

以上例程的输出类似于：

string(15) "dev.example.com"
string(6) "dbname"
string(7) "devuser

Yaf_Config_Ini::__construct — 构造函数
Yaf_Config_Ini::count — 返回配置的节数量
Yaf_Config_Ini::current — 返回当前节点
Yaf_Config_Ini::__get — 读取节点配置
Yaf_Config_Ini::__isset — 检查节点是否存在
Yaf_Config_Ini::key — 返回当前元素的键
Yaf_Config_Ini::next — 向前移动到下一个元素
Yaf_Config_Ini::offsetExists — 检查一个偏移位置是否存在
Yaf_Config_Ini::offsetGet — 获取一个偏移位置的值
Yaf_Config_Ini::offsetSet — 设置一个偏移位置的值
Yaf_Config_Ini::offsetUnset — 复位一个偏移位置的值
Yaf_Config_Ini::readonly — 检查配置是否只读
Yaf_Config_Ini::rewind — 检查当前位置是否有效
Yaf_Config_Ini::__set — The __set purpose
Yaf_Config_Ini::toArray — 转换为数组的格式
Yaf_Config_Ini::valid — 检查迭代器是否有效

The Yaf_Config_Ini class

简介

类摘要

属性

范例

Table of Contents