<commit_before><!-- EN-Revision: 11090 -->
<sect1 id="zend.config.theory_of_operation">
    <title>動作原理</title>
    <para>
        <code>Zend_Config</code> のコンストラクタを通じて、
        設定データに連想配列形式でアクセスできるようになります。
        多次元の連想配列となる可能性もあり、
        これによって汎用的なデータから何かに固有のデータまで扱えるようになります。
        具象アダプタクラスの機能は、
        どこかに保存されているデータを読み込んでこの連想配列形式を作成し、
        し、<code>Zend_Config</code> のコンストラクタに渡すことです。
        スクリプト内で直接配列を作成し、それを
        <code>Zend_Config</code> のコンストラクタに渡すことも可能です。
        この場合はアダプタクラスは使用しません。
        場合によってはこのような方式のほうが適切なこともあるでしょう。
    </para>
    <para>
        設定データ配列の値が、それぞれ <code>Zend_Config</code>
        オブジェクトのプロパティとなります。配列のキーがプロパティ名となります。
        配列の値自身がまた配列であった場合、対応するプロパティの値は新しい
        <code>Zend_Config</code> オブジェクトとなります。この中に配列の内容が読み込まれます。
        この処理は再帰的に行われるので、
        階層構造になっている設定データは任意のレベルでこの構造が繰り返されることになります。
    </para>
    <para>
        <code>Zend_Config</code> は内部で <code>Countable</code>
        インターフェイスおよび <code>Iterator</code>
        インターフェイスを実装しており、
        これを使用して設定データに容易にアクセスできるようになっています。
        つまり、<code>Zend_Config</code> オブジェクトに対して
        <ulink url="http://php.net/count"><code>count()</code></ulink>
        関数や <ulink url="http://php.net/foreach"><code>foreach</code></ulink>
        などを使用できるということです。
    </para>
    <para>
        デフォルトでは、<code>Zend_Config</code>
        で利用できる設定データは読み込み専用です。代入
        (<code>$config->database->host = 'example.com'</code> など)
        を行おうとすると例外がスローされます。しかし、
        コンストラクタでこの振る舞いを変更し、データの変更を許可することも可能です。
        また、変更を許可した場合には、<code>Zend_Config</code>
        は値の設定の解除もサポートしています
        (<code>unset($config->database->host);</code> とします)。
        <note>
            <para>
                メモリ上で変更したデータを何らかのメディアに保存しようとする際に、
                ちょっと戸惑うかもしれません。
                作成したり変更したりした設定データをメディアに保存する機能は、今のところ
                Zend Framework の対象範囲外です。
                設定データを作成・編集してメディアに保存するには、
                サードパーティからオープンソースのソリューションが提供されています。
            </para>
        </note>
    </para>
    <para>
        <code>Zend_Config</code> クラスを継承したアダプタクラスが、
        それぞれの内容に応じて機能を拡張します。
    </para>
    <para>
        <code>Zend_Config</code> ファミリーのクラスを使用すると、
        設定データをセクション単位でまとめることができます。
        <code>Zend_Config</code> オブジェクトの特定のセクションだけを読み込んだり、
        複数のセクションを指定して読み込んだり、あるいは
        (何も指定しなければ) 全セクションを読み込んだりといったことが可能です。
    </para>
    <para>
        <code>Zend_Config</code> は単一継承モデルをサポートしており、
        設定データの特定のセクションを別のセクションに継承させることができます。
        この機能が提供されている理由は、
        さまざまな目的のために設定データを二重管理する必要をなくすためです。
        継承したセクションでは、親セクションから継承した値を上書きすることができます。
        PHP のクラス継承と同様に、あるセクションが親セクションを継承し、
        そのセクションがまた上位セクションを継承し、といったことが可能です。
        しかし多重継承 (例えば、セクション C がセクション A およびセクション B
        のふたつを直接継承するなど) はサポートされていません。
    </para>
    <para>
        ふたつの <code>Zend_Config</code> オブジェクトがある場合に、
        <code>merge()</code> 関数でそれをひとつにまとめることができます。
        たとえば、<code>$config</code> と <code>$localConfig</code>
        がある場合に <code>$localConfig</code> のデータを <code>$config</code>
        に統合するには <code>$config->merge($localConfig);</code> とします。
        <code>$localConfig</code> の中に <code>$config</code>
        と同名の項目がある場合は、もとの値は上書きされます。
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
--><commit_msg>sync Japanese document with r11501.<commit_after><!-- EN-Revision: 11501 -->
<sect1 id="zend.config.theory_of_operation">
    <title>動作原理</title>
    <para>
        <code>Zend_Config</code> のコンストラクタを通じて、
        設定データに連想配列形式でアクセスできるようになります。
        多次元の連想配列となる可能性もあり、
        これによって汎用的なデータから何かに固有のデータまで扱えるようになります。
        具象アダプタクラスの機能は、
        どこかに保存されているデータを読み込んでこの連想配列形式を作成し、
        し、<code>Zend_Config</code> のコンストラクタに渡すことです。
        スクリプト内で直接配列を作成し、それを
        <code>Zend_Config</code> のコンストラクタに渡すことも可能です。
        この場合はアダプタクラスは使用しません。
        場合によってはこのような方式のほうが適切なこともあるでしょう。
    </para>
    <para>
        設定データ配列の値が、それぞれ <code>Zend_Config</code>
        オブジェクトのプロパティとなります。配列のキーがプロパティ名となります。
        配列の値自身がまた配列であった場合、対応するプロパティの値は新しい
        <code>Zend_Config</code> オブジェクトとなります。この中に配列の内容が読み込まれます。
        この処理は再帰的に行われるので、
        階層構造になっている設定データは任意のレベルでこの構造が繰り返されることになります。
    </para>
    <para>
        <code>Zend_Config</code> は内部で <code>Countable</code>
        インターフェイスおよび <code>Iterator</code>
        インターフェイスを実装しており、
        これを使用して設定データに容易にアクセスできるようになっています。
        つまり、<code>Zend_Config</code> オブジェクトに対して
        <ulink url="http://php.net/count"><code>count()</code></ulink>
        関数や <ulink url="http://php.net/foreach"><code>foreach</code></ulink>
        などを使用できるということです。
    </para>
    <para>
        デフォルトでは、<code>Zend_Config</code>
        で利用できる設定データは読み込み専用です。代入
        (<code>$config->database->host = 'example.com'</code> など)
        を行おうとすると例外がスローされます。しかし、
        コンストラクタでこの振る舞いを変更し、データの変更を許可することも可能です。
        また、変更を許可した場合には、<code>Zend_Config</code>
        は値の設定の解除もサポートしています
        (<code>unset($config->database->host);</code> とします)。
        <code>readOnly()</code> メソッドを使用すると、
        指定した <code>Zend_Config</code> オブジェクトの変更が許可されているかどうかを取得することができます。
        また <code>setReadOnly()</code> メソッドを使用すると、
        変更を許可する設定だった <code>Zend_Config</code>
        オブジェクトに対してそれ以降の変更を禁じることができます。
        <note>
            <para>
                メモリ上で変更したデータを何らかのメディアに保存しようとする際に、
                ちょっと戸惑うかもしれません。
                作成したり変更したりした設定データをメディアに保存する機能は、今のところ
                Zend Framework の対象範囲外です。
                設定データを作成・編集してメディアに保存するには、
                サードパーティからオープンソースのソリューションが提供されています。
            </para>
        </note>
    </para>
    <para>
        <code>Zend_Config</code> クラスを継承したアダプタクラスが、
        それぞれの内容に応じて機能を拡張します。
    </para>
    <para>
        <code>Zend_Config</code> ファミリーのクラスを使用すると、
        設定データをセクション単位でまとめることができます。
        <code>Zend_Config</code> オブジェクトの特定のセクションだけを読み込んだり、
        複数のセクションを指定して読み込んだり、あるいは
        (何も指定しなければ) 全セクションを読み込んだりといったことが可能です。
    </para>
    <para>
        <code>Zend_Config</code> は単一継承モデルをサポートしており、
        設定データの特定のセクションを別のセクションに継承させることができます。
        この機能が提供されている理由は、
        さまざまな目的のために設定データを二重管理する必要をなくすためです。
        継承したセクションでは、親セクションから継承した値を上書きすることができます。
        PHP のクラス継承と同様に、あるセクションが親セクションを継承し、
        そのセクションがまた上位セクションを継承し、といったことが可能です。
        しかし多重継承 (例えば、セクション C がセクション A およびセクション B
        のふたつを直接継承するなど) はサポートされていません。
    </para>
    <para>
        ふたつの <code>Zend_Config</code> オブジェクトがある場合に、
        <code>merge()</code> 関数でそれをひとつにまとめることができます。
        たとえば、<code>$config</code> と <code>$localConfig</code>
        がある場合に <code>$localConfig</code> のデータを <code>$config</code>
        に統合するには <code>$config->merge($localConfig);</code> とします。
        <code>$localConfig</code> の中に <code>$config</code>
        と同名の項目がある場合は、もとの値は上書きされます。
        <note>
            <para>
                <code>Zend_Config</code> オブジェクトをまとめる場合は、
                変更を許可する設定で作成する必要があります。つまり、
                コンストラクタの 2 番目のパラメータに <code>true</code> を渡します。
                まとめが完了した後で <code>setReadOnly()</code>
                メソッドを使用すると、それ以降の変更を禁じることができます。
            </para>
        </note>
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->
{'fraction_non_alphanumeric': 0.11155378486055777, 'fraction_numerical': 0.003414911781445646, 'mean_word_length': 2.6704960835509137, 'pattern_counts': {'":': 0, '<': 193, '<?xml version=': 0, '>': 203, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6962104', 'n_tokens_mistral': 4376, 'n_tokens_neox': 4053, 'n_words': 300}