repo_zf1/documentation/manual/ja/module_specs/Zend_Config-Introduction.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect1 id="zend.config.introduction">
    <title>導入</title>

    <para>
        <classname>Zend_Config</classname> は、アプリケーションの設定データを
        簡単に使用できるようにするために設計されたものです。
        階層構造になったプロパティを使用して、設定データを簡単に
        アプリケーションに読み込めるようになっています。
        設定データは、階層構造のデータ保存をサポートしている
        さまざまな媒体から読み込むことができます。
        現時点で <classname>Zend_Config</classname> が提供している設定データアダプタは
        <link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link>
        と <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link>
        の二種類で、テキストファイルに格納された設定データを使用できるようになっています。.
    </para>

    <example id="zend.config.introduction.example.using">
        <title>Zend_Config の使用例</title>

        <para>
            通常は、<link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link>
            あるいは <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link>
            のようなアダプタクラスを使用することが想定されています。
            しかし、もし設定データが <acronym>PHP</acronym> の配列として存在するのなら、
            単にそれを <classname>Zend_Config</classname> のコンストラクタに渡すだけで、
            シンプルなオブジェクト指向のインターフェイスを使用できます。
        </para>

        <programlisting language="php"><![CDATA[
// 設定データは配列で渡されます
$configArray = array(
    'webhost'  => 'www.example.com',
    'database' => array(
        'adapter' => 'pdo_mysql',
        'params'  => array(
            'host'     => 'db.example.com',
            'username' => 'dbuser',
            'password' => 'secret',
            'dbname'   => 'mydatabase'
        )
    )
);

// 設定データに対するオブジェクト指向のラッパーを作成します
$config = new Zend_Config($configArray);

// 設定データを表示します (結果は 'www.example.com' となります)
echo $config->webhost;

// 設定データを使用してデータベースに接続します
$db = Zend_Db::factory($config->database->adapter,
                       $config->database->params->toArray());

// もうひとつの方法: 単に Zend_Config オブジェクトを渡します
// Zend_Db のファクトリは、その処理方法を知っています
$db = Zend_Db::factory($config->database);
]]></programlisting>
    </example>

    <para>
        上の例で説明したように、<classname>Zend_Config</classname> を使用すると、
        コンストラクタに渡されたデータについて、
        階層化されたプロパティの形式でアクセスできるようになります。
    </para>

    <para>
        このようにオブジェクト思考形式でデータの値にアクセスするだけでなく、
        <classname>Zend_Config</classname> では <code>get()</code> メソッドも用意しています。
        これは、指定した要素が存在しない場合にデフォルト値を返すように設定できます。
        たとえば次のように使用します。
    </para>

    <programlisting language="php"><![CDATA[
$host = $config->database->get('host', 'localhost');
]]></programlisting>

    <example id="zend.config.introduction.example.file.php">
        <title>Zend_Config における PHP 設定ファイルの使用法</title>

        <para>
            設定ファイルそのものを <acronym>PHP</acronym> で書きたいこともあるでしょう。
            以下のようにすると、簡単にそれを行うことができます。
        </para>

        <programlisting language="php"><![CDATA[
// config.php
return array(
    'webhost'  => 'www.example.com',
    'database' => array(
        'adapter' => 'pdo_mysql',
        'params'  => array(
            'host'     => 'db.example.com',
            'username' => 'dbuser',
            'password' => 'secret',
            'dbname'   => 'mydatabase'
        )
    )
);
]]></programlisting>

        <programlisting language="php"><![CDATA[
// 設定を読み込みます
$config = new Zend_Config(require 'config.php');

// 設定データを出力します (この結果は 'www.example.com' です)
echo $config->webhost;
]]></programlisting>

    </example>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->