International PHP Conference Berlin 2025

    The Yaf_Config_Ini class

    (Yaf >=1.0.0)

    Introduzione

    Yaf_Config_Ini enables developers to store configuration data in a familiar INI format and read them in the application by using nested object property syntax. The INI format is specialized to provide both the ability to have a hierarchy of configuration data keys and inheritance between configuration data sections. Configuration data hierarchies are supported by separating the keys with the dot or period character ("."). A section may extend or inherit from another section by following the section name with a colon character (":") and the name of the section from which data are to be inherited.

    Nota:

    Yaf_Config_Ini utilizes the » parse_ini_file() PHP function. Please review this documentation to be aware of its specific behaviors, which propagate to Yaf_Config_Ini, such as how the special values of "true", "false", "yes", "no", and "null" are handled.

    Sommario della classe

    class Yaf_Config_Ini extends Yaf_Config_Abstract implements Iterator, ArrayAccess, Countable {
    /* Proprietà */
    /* Metodi */
    public __construct(string $config_file, string $section = ?)
    public count(): void
    public current(): void
    public __get(string $name = ?): void
    public __isset(string $name): void
    public key(): void
    public next(): 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
    public rewind(): void
    public __set(string $name, mixed $value): void
    public toArray(): array
    public valid(): void
    /* Metodi ereditati */
    abstract public Yaf_Config_Abstract::get(string $name, mixed $value): mixed
    abstract public Yaf_Config_Abstract::readonly(): bool
    abstract public Yaf_Config_Abstract::set(): Yaf_Config_Abstract
    abstract public Yaf_Config_Abstract::toArray(): array
    }

    Proprietà

    _config

    _readonly

    Esempi

    Example #1 Yaf_Config_Ini()example

    This example illustrates a basic use of Yaf_Config_Ini for loading configuration data from an INI file. In this example there are configuration data for both a production system and for a staging system. Because the staging system configuration data are very similar to those for production, the staging section inherits from the production section. In this case, the decision is arbitrary and could have been written conversely, with the production section inheriting from the staging section, though this may not be the case for more complex situations. Suppose, then, that the following configuration data are contained in /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"));
    ?>

    Il precedente esempio visualizzerà qualcosa simile a:

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

    Indice dei contenuti

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    2
    lee dot howarth dot 90 at gmail dot com
    10 years ago
    @flowithwind

    var_dump($config -> toArray()[ 'type' ][ 18 ][ 'text' ]);

    string 'abc' (length=3)
    up
    1
    zzxiaoman at gmail dot com
    9 years ago
    when i use Yaf_Config_ini with these lines:

    type.18.text=abc
    type.8.text=ddf
    type.0.text=fjdsklf

    You can through this way

    $$configArr = $config->toArray();
    var_dump($configArr['type'][18]['text']);

    result:
    abc
    up
    1
    Mark
    9 years ago
    /conf/db.ini

    [product]
    database.params.host = localhost
    database.params.port = 5432
    database.params.dbname = postgres
    database.params.username = 'postgres'
    database.params.password = 123456

    <?php
    $config     = new Yaf_Config_ini('../conf/db.ini','product');
    $config = $config->toArray();
    $host = $config['database']['params']['host'];
    $port = $config['database']['params']['port'];
    $database = $config['database']['params']['dbname'];
    $username = $config['database']['params'['username'];
    $password = $config['database']['params']['password'];
    $pg_conn = pg_connect("host='$host' port='$port' dbname='$database' user='$username' password='$password' ");
    ?>
    ＋add a note
    To Top