cvs: phpdoc-ja /reference/var/functions import-request-variables.xml

takagi Sun Jun 17 21:57:09 2007 UTC Modified files: /phpdoc-ja/reference/var/functions import-request-variables.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/var/functions/import-request-variables.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ja/reference/var/functions/import-request-variables.xml diff -u phpdoc-ja/reference/var/functions/import-request-variables.xml:1.6 phpdoc-ja/reference/var/functions/import-request-variables.xml:1.7 --- phpdoc-ja/reference/var/functions/import-request-variables.xml:1.6 Mon Sep 26 06:29:58 2005 +++ phpdoc-ja/reference/var/functions/import-request-variables.xml Sun Jun 17 21:57:09 2007 @@ -1,80 +1,121 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./ja/functions/var.xml, last change in rev 1.34 --> -<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.13 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> - <refentry id="function.import-request-variables"> - <refnamediv> - <refname>import_request_variables</refname> - <refpurpose> - GET/POST/Cookie 変数をグローバルスコープにインポートする - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>import_request_variables</methodname> - <methodparam><type>string</type><parameter>types</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>prefix</parameter></methodparam> - </methodsynopsis> - <simpara> - GET/POST/Cookie 変数をグローバルスコープにインポートします。 - この関数は、<link linkend="ini.register-globals">register_globals</link> - を無効としているが、いくつかの変数をグローバルスコープで参照したいと - いった場合に有用です。 - </simpara> - <simpara> - <parameter>types</parameter> パラメータを使用すると、インポートする - リクエスト変数の種類を指定可能です。文字 'G'、'P'、'C' がそれぞれ - GET、POST、Cookie を表します。これらは大文字小文字を区別しないため、 - 'g'、'p'、'c' の組み合せも使用することが可能です。 - POST には、アップロードされたファイルに関する情報も含まれます。 - 文字の順番には注意してください。"gp" とすると、POST 変数は同名の GET - 変数を上書きします。GPC 以外の文字は無視されます。 - </simpara> - <simpara> - 引数 <parameter>prefix</parameter> は変数名の接頭辞として使用され、 - グローバルスコープにインポートされる全ての変数名の前に付加されます。 - このため、"userid" という名前の GET 値があり、接頭辞 "pref_" を - 指定した場合、$pref_userid という名前のグローバル変数が作成されます。 - </simpara> - <simpara> - SERVER のような他の変数をグローバルスコープへインポートすることを - 考えている場合には、<function>extract</function> の使用を検討して - ください。 - </simpara> - <note> - <para> - <parameter>prefix</parameter> パラメータはオプションですが、 - 接頭辞を指定しないか接頭辞として空の文字列を指定した場合、 - <link linkend="internal.e-notice">E_NOTICE</link> レベルのエラーが - 発生します。これは、セキュリティ上の問題を発生する可能性があります。 - NOTICE レベルのエラーは、デフォルトの - <link linkend="ini.error-reporting">error reporting</link> - レベルでは表示されません。 - </para> - </note> - <informalexample> - <programlisting role="php"> +<refentry id="function.import-request-variables"> + <refnamediv> + <refname>import_request_variables</refname> + <refpurpose>GET/POST/Cookie 変数をグローバルスコープにインポートする</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>import_request_variables</methodname> + <methodparam><type>string</type><parameter>types</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>prefix</parameter></methodparam> + </methodsynopsis> + <para> + GET/POST/Cookie 変数をグローバルスコープにインポートします。 + この関数は、<link linkend="ini.register-globals">register_globals</link> + を無効としているが、いくつかの変数をグローバルスコープで参照したいといった場合に有用です。 + </para> + <para> + SERVER のような他の変数をグローバルスコープへインポートすることを考えている場合には、 + <function>extract</function> の使用を検討してください。 + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>types</parameter></term> + <listitem> + <para> + <parameter>types</parameter> パラメータを使用すると、インポートする + リクエスト変数の種類を指定可能です。文字 'G'、'P'、'C' がそれぞれ + GET、POST、Cookie を表します。これらは大文字小文字を区別しないため、 + 'g'、'p'、'c' の組み合せも使用することが可能です。 + POST には、アップロードされたファイルに関する情報も含まれます。 + </para> + <note> + <para> + 文字の順番には注意してください。"gp" とすると、POST 変数は同名の GET + 変数を上書きします。GPC 以外の文字は無視されます。 + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>prefix</parameter></term> + <listitem> + <para> + 変数名の接頭辞として使用され、 + グローバルスコープにインポートされる全ての変数名の前に付加されます。 + このため、"userid" という名前の GET 値があり、 + 接頭辞 "pref_" を指定した場合、 + <varname>$pref_userid</varname> という名前のグローバル変数が作成されます。 + </para> + <note> + <para> + <parameter>prefix</parameter> パラメータはオプションですが、 + 接頭辞を指定しないか接頭辞として空の文字列を指定した場合、 + <link linkend="errorfunc.constants.errorlevels.e-notice">E_NOTICE</link> + レベルのエラーが発生します。 + これは、セキュリティ上の問題を発生する可能性があります。 + NOTICE レベルのエラーは、デフォルトの + <link linkend="ini.error-reporting">error reporting</link> + レベルでは表示されません。 + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>import_request_variables</function> の例</title> + <programlisting role="php"> <![CDATA[ <?php -// GETおよびPOST変数を接頭辞"rvar_"を付けて +// GET および POST 変数を、接頭辞 "rvar_" を付けて // インポートします -import_request_variables("gP", "rvar_"); +import_request_variables("gp", "rvar_"); echo $rvar_foo; ?> ]]> - </programlisting> - </informalexample> - <simpara> - <link linkend="reserved.variables.request">$_REQUEST</link>、 - <link linkend="ini.register-globals">register_globals</link>、 - <link linkend="language.variables.predefined">定義済みの変数</link> - および <function>extract</function> も参照ください。 - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><link linkend="reserved.variables.request">$_REQUEST</link></member> + <member><link linkend="ini.register-globals">register_globals</link></member> + <member><link linkend="language.variables.predefined">定義済みの変数</link></member> + <member><function>extract</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: