[prev in list] [next in list] [prev in thread] [next in thread]
List: pear-doc
Subject: [PEAR-DOC] cvs: peardoc /ja/package/configuration/config/config-container createitem.xml getchild.xm
From: "TAKAGI Masahiro" <takagi () php ! net>
Date: 2006-10-31 7:12:48
Message-ID: cvstakagi1162278768 () cvsserver
[Download RAW message or body]
takagi Tue Oct 31 07:12:48 2006 UTC
Added files:
/peardoc/ja/package/configuration/config/config-container
writedatasrc.xml
updateattributes.xml
tostring.xml
toarray.xml
setdirective.xml
setattributes.xml
searchpath.xml
getitemposition.xml
getitemindex.xml
getchild.xml
createitem.xml
Log:
initial translation.
["takagi-20061031071248.txt" (text/plain)]
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/writedatasrc.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/writedatasrc.xml
+++ peardoc/ja/package/configuration/config/config-container/writedatasrc.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.writedatasrc">
<refnamediv>
<refname><function>Config_Container::writeDatasrc</function></refname>
<refpurpose>ファイルに書き出す</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>boolean <function>Config_Container::writeDatasrc</function></funcdef>
<paramdef>mixed <parameter>$datasrc</parameter></paramdef>
<paramdef>string <parameter>$configType</parameter></paramdef>
<paramdef>array <parameter><optional>$options = \
array()</optional></parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.writedatasrc.desc">
&title.desc;
<para>
デフォルトでは、このメソッドは
<link linkend="package.configuration.config.config-container.tostring">
<function>toString</function></link> \
が出力する文字列をファイルに書き出します。 \
指定した設定型で <function>writeDatasrc</function>
メソッドが存在する \
合、その代わりにこのメソッドがコールされます。
これにより、あなた自身で独自の保存ハンドラを追 \
しやすくなります。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.writedatasrc.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.mixed;
<parameter>$datasrc</parameter>
</term>
<listitem>
<para>
データソースに関する情 \
。たとえば設定ファイルへのパスや dsn など。 </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.string;
<parameter>$configType</parameter>
</term>
<listitem>
<para>
設定の型。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.array;
<parameter>$options</parameter>
</term>
<listitem>
<para>
ライター用のオプション。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.writedatasrc.return">
&title.returns;
<para>
成功した 合に &true; を返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.writedatasrc.throws">
&title.throws;
<para>
<table>
<title>&title.throws.errortable;</title>
<tgroup cols="4">
<thead>
<row>
<entry>エラーコード</entry>
<entry>エラーの値</entry>
<entry>意味</entry>
<entry>対応</entry>
</row>
</thead>
<tbody>
<row>
<entry></entry>
<entry><quote></quote></entry>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.writedatasrc.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/updateattributes.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/updateattributes.xml
+++ peardoc/ja/package/configuration/config/config-container/updateattributes.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.updateattributes">
<refnamediv>
<refname><function>Config_Container::updateAttributes</function></refname>
<refpurpose> 目の属性を更新する</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef><replaceable>void</replaceable> \
<function>Config_Container::updateAttributes</function></funcdef> <paramdef>array \
<parameter>$attributes</parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.updateattributes.desc">
&title.desc;
<para>
指定された属性が既に設定されている \
合、それは上書きされ、
新しい内容が設定されます。パラメータで指定した配列に含まれない属性は
そのまま残ります。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.updateattributes.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.array;
<parameter>$attributes</parameter>
</term>
<listitem>
<para>
属性の配列。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1
id="package.configuration.config.config-container.updateattributes.throws">
&title.throws;
<para>
<table>
<title>&title.throws.errortable;</title>
<tgroup cols="4">
<thead>
<row>
<entry>エラーコード</entry>
<entry>エラーの値</entry>
<entry>意味</entry>
<entry>対応</entry>
</row>
</thead>
<tbody>
<row>
<entry></entry>
<entry><quote></quote></entry>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
<refsect1
id="package.configuration.config.config-container.updateattributes.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/tostring.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/tostring.xml
+++ peardoc/ja/package/configuration/config/config-container/tostring.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.tostring">
<refnamediv>
<refname><function>Config_Container::toString</function></refname>
<refpurpose>文字列表現を返す</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>string <function>Config_Container::toString</function></funcdef>
<paramdef>string <parameter>$configType</parameter></paramdef>
<paramdef>array <parameter><optional>$options = \
array()</optional></parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.tostring.desc">
&title.desc;
<para>
このメソッドは、指定した設定型の
<function>toString</function> メソッドをコールします。
<classname>Config_Container</classname>
およびその子要 を文字列形式で返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.tostring.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$configType</parameter>
</term>
<listitem>
<para>
文字列を作成するために使用する設定型。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.array;
<parameter>$options</parameter>
</term>
<listitem>
<para>
パーサが使用する特別なオプションを指定します。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.tostring.return">
&title.returns;
<para>
出来上がった文字列を返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.tostring.throws">
&title.throws;
<para>
<table>
<title>&title.throws.errortable;</title>
<tgroup cols="4">
<thead>
<row>
<entry>エラーコード</entry>
<entry>エラーの値</entry>
<entry>意味</entry>
<entry>対応</entry>
</row>
</thead>
<tbody>
<row>
<entry></entry>
<entry><quote></quote></entry>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.tostring.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/toarray.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/toarray.xml
+++ peardoc/ja/package/configuration/config/config-container/toarray.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.toarray">
<refnamediv>
<refname><function>Config_Container::toArray</function></refname>
<refpurpose>コンテナとその子要 \
を、キー/値のペアによる配列で返す</refpurpose> </refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>array <function>Config_Container::toArray</function></funcdef>
<void />
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.toarray.desc">
&title.desc;
<para>
このメソッドは、Config \
ツリーを配列形式で返します。その書式は <programlisting \
role="php"> $section[directive][index] = value
</programlisting>
となります。コンテナが属性を保持している \
合は、属性のキーに <parameter>'@'</parameter>、属性の値に
<parameter>'#'</parameter> を使用します。
インデックスがここにある理由は、
同名のディレクティブやセクションが複数存在する可能性があるためです。
<function>toArray</function> メソッドは、そのような \
合も想定しています。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.toarray.return">
&title.returns;
<para>
<classname>Config_Container</classname> \
ツリーを配列形式で返します。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.toarray.note">
&title.note;
¬e.notstatic;
</refsect1>
<refsect1 id="package.configuration.config.config-container.toarray.example">
&title.example;
<example>
<title><function>toArray()</function> の使用例</title>
<programlisting role="php">
<![CDATA[
$attributes = array('id' => 'db', 'language' => 'en');
$section =& new Config_Container('section', 'main', null, $attributes);
$section->createDirective('authentication', 'one', array('type' => 'mysql'));
$section->createDirective('authentication', 'two', array('type' => 'oracle'));
$section->createDirective('permission', 'group');
var_dump($section->toArray());
]]>
</programlisting>
</example>
<example>
<title>同名の属性やディレクティブが含まれる結果の配列</title>
<programlisting>
<![CDATA[
array(1) {
["main"]=>
array(3) {
["@"]=>
array(2) {
["id"]=>
string(2) "db"
["language"]=>
string(2) "en"
}
["authentication"]=>
array(2) {
[0]=>
array(2) {
["#"]=>
string(3) "one"
["@"]=>
array(1) {
["type"]=>
string(5) "mysql"
}
}
[1]=>
array(2) {
["#"]=>
string(3) "two"
["@"]=>
array(1) {
["type"]=>
string(6) "oracle"
}
}
}
["permission"]=>
string(5) "group"
}
}
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/setdirective.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/setdirective.xml
+++ peardoc/ja/package/configuration/config/config-container/setdirective.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.setdirective">
<refnamediv>
<refname><function>Config_Container::setDirective</function></refname>
<refpurpose>
子ディレクティブの内容を設定するか、
あるいは新しいディレクティブを作成する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>void <function>Config_Container::setDirective</function></funcdef>
<paramdef>string <parameter>$name</parameter></paramdef>
<paramdef>mixed <parameter>$content</parameter></paramdef>
<paramdef>int <parameter><optional>$index = \
-1</optional></parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.setdirective.desc">
&title.desc;
<para>
これはヘルパーメソッドです。まず最初に
<link linkend="package.configuration.config.config-container.getitem">
<function>getItem</function></link> を使用して既存の \
目を探します。 見つかった 合は、その 目の
<link linkend="package.configuration.config.config-container.setcontent">
<function>setContent</function></link> メソッドをコールします。
見つからなかった 合は、最下部に指定した名前と内容で
新しいディレクティブを作成します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.setdirective.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$name</parameter>
</term>
<listitem>
<para>
探したいディレクティブの名前。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.mixed;
<parameter>$content</parameter>
</term>
<listitem>
<para>
新しい内容。通常は文字列。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.int;
<parameter>$index</parameter>
</term>
<listitem>
<para>
設定するディレクティブのインデックス。
同じ名前のディレクティブが複数ある \
合に指定します。 </para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.setdirective.return">
&title.returns;
<para>
新しく設定されたディレクティブを返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.setdirective.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/setattributes.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/setattributes.xml
+++ peardoc/ja/package/configuration/config/config-container/setattributes.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.setattributes">
<refnamediv>
<refname><function>Config_Container::setAttributes</function></refname>
<refpurpose> 目の属性を設定する</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef><replaceable>void</replaceable> \
<function>Config_Container::setAttributes</function></funcdef> <paramdef>array \
<parameter>$attributes</parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.setattributes.desc">
&title.desc;
<para>
属性は配列形式で指定します。これは PHP 配列、XML、Apache
コンテナで使用されます。IniFile コンテナや IniCommented
コンテナでは属性は使用されません。
<link linkend="package.configuration.config.config-container.getattributes">
<function>getAttributes</function></link>
メソッドの例を見ると、属性がどのように出力されるのかがわかります。
このメソッドは、既存の属性を上書きします。
既存の属性のうちの一部 けを変更したい 合は
<link linkend="package.configuration.config.config-container.updateattributes">
<function>updateAttributes</function></link> を使用してく さい。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.setattributes.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.array;
<parameter>$attributes</parameter>
</term>
<listitem>
<para>
属性の配列。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.setattributes.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/searchpath.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/searchpath.xml
+++ peardoc/ja/package/configuration/config/config-container/searchpath.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.searchpath">
<refnamediv>
<refname><function>Config_Container::searchPath</function></refname>
<refpurpose>XPATH \
風のフォーマットを使用してノードを探す</refpurpose> </refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>mixed <function>Config_Container::searchPath</function></funcdef>
<paramdef>mixed <parameter>$args</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.searchpath.desc">
&title.desc;
<para>
このメソッドは、与えられたパスを使用して
現在のコンテナから 目を探します。
</para>
<para>
このメソッドは、型が <parameter>'section'</parameter>
であるオブジェクトに対してのみコール可能です。
ルートはセクション型であることに注意しましょう。
このメソッドは再帰的に働きます。
</para>
<para>
このメソッドは、必要な数のパラメータによって定義されるパスから \
目を探します。 その書式は array (item1, item2, ..., itemN) \
となります。
配列の要 には文字列か配列が指定できます。文字列は \
目の <parameter>name</parameter> として扱われ、
配列の 合は 目の <parameter>'name'</parameter>
や <parameter>'attributes'</parameter> の値として扱われます。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.searchpath.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.mixed;
<parameter>$args</parameter>
</term>
<listitem>
<para>
一致する \
目を探す対象となる文字列あるいは配列。カンマ区切りで指定します。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.searchpath.return">
&title.returns;
<para>
見つかった 目への参照、あるいは見つからなかった \
合に &false; を返します。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.searchpath.note">
&title.note;
¬e.notstatic;
</refsect1>
<refsect1 id="package.configuration.config.config-container.searchpath.example">
&title.example;
<example>
<title><function>searchPath</function> の使用例</title>
<programlisting role="php">
<![CDATA[
// 次のような XML 設定ファイルがあるとします
// <config>
// <db>
// <user>root</user>
// <password>pass</user>
// <host>localhost</host>
// </db>
// </config>
$config = new Config();
$root =& $menuObj->parseConfig('db.xml', 'xml');
// これは、db セクションの password ディレクティブを返します
$passObj =& $root->searchPath(array('config', 'db', 'password'));
]]>
</programlisting>
</example>
<example>
<title>属性を使用した、<function>searchPath</function> \
のより複雑な例</title> <programlisting role="php">
<![CDATA[
// 次のような XML 設定ファイルがあるとします
// <menu>
// <group id="company">
// <page id="news"/>
// <page id="jobs"/>
// </group>
// <group id="projects">
// <page id="project1"/>
// <page id="project2"/>
// </group>
// </menu>
$menuObj = new Config();
$root =& $menuObj->parseConfig('menu.xml', 'xml');
// これは、メニュー内のコンテナで 'id' が 'projects' \
であるものを返します $section =& $root->searchPath(array('menu', \
array('group', array('id' => 'projects'))));
// ページを取得するためにはこのようにもできます
$page =& $root->searchPath(array('menu',
array('group', array('id' => 'projects')),
array('page', array('id' => 'project2'))));
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/getitemposition.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/getitemposition.xml
+++ peardoc/ja/package/configuration/config/config-container/getitemposition.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.getitemposition">
<refnamediv>
<refname><function>Config_Container::getItemPosition</function></refname>
<refpurpose>親が持つ子要 の配列における、 \
目の階層を返す</refpurpose> </refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>Config_Container::getItemPosition</function></funcdef>
<void />
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.getitemposition.desc">
&title.desc;
<para>
親が持つ子要 の配列における 目の階層を、
同じ型と名前の 目に応じて返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getitemposition.return">
&title.returns;
<para>
整数値、あるいはルートオブジェクトである 合に &null; \
を返します。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getitemposition.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/getitemindex.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/getitemindex.xml
+++ peardoc/ja/package/configuration/config/config-container/getitemindex.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.getitemindex">
<refnamediv>
<refname><function>Config_Container::getItemIndex</function></refname>
<refpurpose>親要 が持つ子の配列における \
目のインデックスを返す</refpurpose> </refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>mixed <function>Config_Container::getItemIndex</function></funcdef>
<void />
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.getitemindex.desc">
&title.desc;
<para>
子 <classname>Config_Container</classname> \
オブジェクトは配列として 納されます。
このメソッドは、この 目の、親要 \
の配列内におけるインデックスを返します </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getitemindex.return">
&title.returns;
<para>
整数値、あるいはルートオブジェクトである 合に &null; \
を返します。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getitemindex.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/getchild.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/getchild.xml
+++ peardoc/ja/package/configuration/config/config-container/getchild.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.getchild">
<refnamediv>
<refname><function>Config_Container::getChild</function></refname>
<refpurpose>指定したインデックスの子要 を返す</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>mixed <function>Config_Container::getChild</function></funcdef>
<paramdef>int <parameter>$index</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.getchild.desc">
&title.desc;
<para>
子要 は配列として \
納されます。このメソッドは、指定したインデックスの
<classname>Config_Container</classname> オブジェクトを返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getchild.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.int;
<parameter>$index</parameter>
</term>
<listitem>
<para>
子要 のインデックス。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getchild.return">
&title.returns;
<para>
子要 への参照、あるいは子要 が存在しない 合には \
&false; を返します。 </para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.getchild.note">
&title.note;
¬e.notstatic;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/viewvc.cgi/peardoc/ja/package/configuration/config/config-container/createitem.xml?view=markup&rev=1.1
Index: peardoc/ja/package/configuration/config/config-container/createitem.xml
+++ peardoc/ja/package/configuration/config/config-container/createitem.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready -->
<refentry id="package.configuration.config.config-container.createitem">
<refnamediv>
<refname><function>Config_Container::createItem</function></refname>
<refpurpose>セクション 目に新しい子を作成する</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
require_once 'Config/Container.php';
</funcsynopsisinfo>
<funcprototype>
<funcdef>object \
&<function>Config_Container::createItem</function></funcdef> <paramdef>string \
<parameter>$type</parameter></paramdef> <paramdef>mixed \
<parameter>$item</parameter></paramdef> <paramdef>string \
<parameter>$content</parameter></paramdef>
<paramdef>array <parameter><optional>$attributes = \
&null;</optional></parameter></paramdef>
<paramdef>string <parameter><optional>$where = \
'bottom'</optional></parameter></paramdef>
<paramdef>object <parameter><optional>$target = \
&null;</optional></parameter></paramdef> </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="package.configuration.config.config-container.createitem.desc">
&title.desc;
<para>
このメソッドはセクションに対してコールしなければならず、
作成される \
目の型は任意です。これは、新しい子を現在の 目に追 \
します。
位置を指定した 合は、その 所に子が作成されます。
このメソッドを直接コールするのではなく、ヘルパメソッドを使用することを推奨します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.createitem.param">
&title.param;
<para>
<variablelist>
<varlistentry>
<term>
&type.string;
<parameter>$type</parameter>
</term>
<listitem>
<para>
目の型。<parameter>directive</parameter>、
<parameter>section</parameter>、<parameter>comment</parameter>、
<parameter>blank</parameter>...
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.mixed;
<parameter>$item</parameter>
</term>
<listitem>
<para>
目名。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.string;
<parameter>$content</parameter>
</term>
<listitem>
<para>
目の内容。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.array;
<parameter>$attributes</parameter>
</term>
<listitem>
<para>
目の属性。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.string;
<parameter>$where</parameter>
</term>
<listitem>
<para>
所を選択します。<parameter>'bottom'</parameter>、
<parameter>'top'</parameter>、<parameter>'after'</parameter>、
<parameter>'before'</parameter>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
&type.object;
<parameter>$target</parameter>
</term>
<listitem>
<para>
<parameter>'before'</parameter> あるいは
<parameter>'after'</parameter> を
<parameter>$where</parameter> で選ん 合に必要です。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.createitem.return">
&title.returns;
<para>
新しい 目への参照を返します。
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.createitem.throws">
&title.throws;
<para>
<table>
<title>&title.throws.errortable;</title>
<tgroup cols="4">
<thead>
<row>
<entry>エラーコード</entry>
<entry>エラーの値</entry>
<entry>意味</entry>
<entry>対応</entry>
</row>
</thead>
<tbody>
<row>
<entry></entry>
<entry><quote></quote></entry>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
<refsect1 id="package.configuration.config.config-container.createitem.note">
&title.note;
¬e.notstatic;
</refsect1>
<refsect1 id="package.configuration.config.config-container.createitem.example">
&title.example;
<example>
<title><function>createItem</function> による新規 目の作成</title>
<programlisting role="php">
<![CDATA[
$section =& new Config_Container('section', 'conf');
$section->createItem('directive', 'user', 'root');
$section->createItem('directive', 'pass', 'root');
$header =& $section->createItem('comment', null, 'Database Configuration', 'top');
$section->createItem('blank', null, null, 'after', $header);
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--
PEAR Documentation List Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic