cvs: phpdoc /ja/chapters config.xml install.xml security.xml /ja/functions array.xml fdf.xml info.xml mail.xml msql.xml oci8.xml pgsql.xml posix.xml
regex.xml /ja/language control-structures.xml

hirokawa Fri Oct 13 08:30:57 2000 EDT Modified files: /phpdoc/ja/chapters config.xml install.xml security.xml /phpdoc/ja/functions array.xml fdf.xml info.xml mail.xml msql.xml oci8.xml pgsql.xml posix.xml regex.xml /phpdoc/ja/language control-structures.xml Log: update translations aand some cosmetic changes. Index: phpdoc/ja/chapters/config.xml diff -u phpdoc/ja/chapters/config.xml:1.6 phpdoc/ja/chapters/config.xml:1.7 --- phpdoc/ja/chapters/config.xml:1.6 Sat Aug 26 18:43:06 2000 +++ phpdoc/ja/chapters/config.xml Fri Oct 13 08:30:56 2000 @@ -77,19 +77,47 @@ (Adminの意味は上記のオプションと同じです。)</para> </listitem> </varlistentry> - </variablelist></para> - + </variablelist> + </para> <simpara> - <function>phpinfo</function> の出力を見ることにより、 - 設定値を確認することができます。 - 各設定の値は、<function>get_cfg_var</function> により - 得ることができます。</simpara> + <function>phpinfo</function> の出力を見ることにより、設定値を確認 + することができます。各設定の値は、<function>get_cfg_var</function> + により得ることができます。 + </simpara> <sect2 id="ini.sect.general"> <title>一般的な設定用の命令</title> <para> <variablelist> - + + <varlistentry id="ini.allow-url-fopen"> + <term> + <parameter>allow_url_fopen</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + このオプションは、ファイルのようなURLオブジェクトをアクセスす + ることを可能にするURL対応のfopenラッパーを利用可能にします。 + デフォルトのラッパーは、ftp または http プロトコルを使用して + <link linkend="features.remote-files">リモートファイル</link>をア + クセスする用途に対応しており、zlib のようないくつかの拡張によ + り追加のラッパを登録可能です。 + </para> + + <note> + <para> + このオプションは、バージョン 4.0.3 のリリース直後に導入され + ました。4.0.3 までのバージョンでは、この機能を設定スイッチ + <link linkend="install.configure.disable-url-fopen-wrapper"> + <parameter>--disable-url-fopen-wrapper</parameter></link> + を使用してコンパイル時にのみ無効にすることが可能です。 + </para> + </note> + + </listitem> + </varlistentry> + <varlistentry id="ini.asp-tags"> <term> <parameter>asp_tags</parameter> @@ -586,7 +614,7 @@ </term> <listitem> <para> - PHP ファイルがユーザーのホームディレクトリとして使用する + PHP ファイルがユーザーのホームディレクトリとãã¦ä½¿ç”¨ã™ã‚‹ ディレクトリの名前。 例えば、<literal>public_html</literal> となります。</para> </listitem> Index: phpdoc/ja/chapters/install.xml diff -u phpdoc/ja/chapters/install.xml:1.13 phpdoc/ja/chapters/install.xml:1.14 --- phpdoc/ja/chapters/install.xml:1.13 Fri Sep 15 18:27:36 2000 +++ phpdoc/ja/chapters/install.xml Fri Oct 13 08:30:56 2000 @@ -668,7 +668,7 @@ class="directory">/usr/local/Hughes</filename>です。このデフォ ルト値は、mSQL 2.0 のデフォルトディレクトリです。 <command>configure</command> は、自動的に実行中のmSQLのバージョ - ンを検出ã—ます。PHP は、1.0 と 2.0 の両方をサポートします。し + ンを検出?~す。PHP は、1.0 と 2.0 の両方をサポートします。し かし、PHP を mSQL 1.0 でコンパイルした場合には、mSQL 1.0 デー タベースのみにアクセスすることが可能です。逆の場合も同様です。 </para> @@ -2192,6 +2192,14 @@ PHP 3, PHP 4: httpまたはftpによりファイルをアクセス可能なURL対 応のfopenラッパーを無効にします </para> + <warning> + <para> + このスイッチはPHP 4.0.3 まででのみ利用可能です。より新しいバー + ジョンでは、コンパイル時にこの機能を決定する代わりに、 + <parameter>allow_url_fopen</parameter> という名前のパラメータ + を指定可能です。 + </para> + </warning> </listitem> </varlistentry> @@ -2760,7 +2768,7 @@ '%WINDOWS%' ディレクトリは、通常、次のようになります。 <simplelist> <member>Windows 95/98 では、c:\windows</member> - <member>NT サーバーでは、c:\winnt または c:\winnt40</member> + <member>NT サーバーでは、c:\winnt ¾ãŸã¯ c:\winnt40</member> </simplelist> </para> </listitem> @@ -2956,6 +2964,12 @@ Regedit を終了して下さい。 </simpara> </listitem> + <listitem> + <simpara> + Windows で PWS を使用した場合、レジストリを再ロードするために + リブートして下さい。 + </simpara> + </listitem> </itemizedlist> </para> <simpara> @@ -3236,7 +3250,7 @@ 幾つかの問題が、その他の問題よりもより一般的に生じています。 最も一般的な問題は、PHP FAQ に記載されています。 PHP FAQ は、<ulink url="&url.php.faq;">&url.php.faq;</ulink> - にあります。 + にありま™ã€‚ </simpara> </sect2> @@ -3267,7 +3281,7 @@ </simpara> <simpara> メーリングリストにおいて質問をしたい場合は、正確さを心がけ、 - 解答に必要な使用環境に関するè³ç´°äº‹é …(オペレーティングシステムの種類、 + 解答に必要な使用環境に関する賧԰事項(オペレーティングシステムの種類、 PHP のバージョン、Webサーバーの種類、PHP を CGI として使用しているのか サーバーモジュールとして使用しているのか、等)を 明らかにするようにして下さい。 Index: phpdoc/ja/chapters/security.xml diff -u phpdoc/ja/chapters/security.xml:1.3 phpdoc/ja/chapters/security.xml:1.4 --- phpdoc/ja/chapters/security.xml:1.3 Wed Oct 4 07:36:35 2000 +++ phpdoc/ja/chapters/security.xml Fri Oct 13 08:30:56 2000 @@ -9,20 +9,34 @@ トでは、これらの機能を実行した場合、Webサーバー上でセキュリティ上の 問題を生じる可能性があります。PHP は、特に CGI プログラムを書く場合、 Perl や C より安全な言語となるように設計されています。コンパイル時 - または実行時の設定オプションを正しく選ぶことにより、必要な自由度と - セキュリティの組み合わせを確実に提供することができます。 + または実行時の設定オプションを正しく選び、適切なコードを書くことに + より、必要な自由度とセキュリティの組み合わせを確実に提供することが + できます。 </simpara> <simpara> PHP の使用法に多くの異なった手段があるように、PHP の動作を制御する 多くの設定オプションがあります。オプションの選択肢が広いため、PHP を様々な用途に使用することができます。しかし、このことは、これらの オプションとサーバー設定の組み合わせによっては、安全でない設定とな - ることを意味します。本章は、異なった設定オプションの組み合わせと安 - 全に使用可能な状況について説明します。 + ることを意味します。 </simpara> + <simpara> + PHPの設定の自由度はそのコードの柔軟さにほぼ匹敵します。PHPは、シェ + ルユーザコマンドを全て実行可能な完全なサーバーアプリケーションや + 厳しく制御された環境で低リスクの簡単なサーバーサイドインクルードを + 使用できるようなアプリケーションを構築する場合に使用することが可能 + です。そうした環境の構築方法、セキュリティのレベルはPHPの開発者に大 + きく依存しています。 + </simpara> + <simpara> + 本章は、安全に使用可能な異なった設定と条件の組み合わせについての説 + 明から始めます。続いて、複数のセキュリティレベルのコーディングにお + ける複数の考慮事項について説明し、最後にいくつかの一般的なセキュリ + ティ上のアドバイスを行います。 + </simpara> <sect1 id="security.cgi"> - <title>CGI バイナリ</title> + <title>CGI バイナリとしてインストール</title> <sect2> <title>有りうる攻撃</title> @@ -245,7 +259,7 @@ </sect1> <sect1 id="security.apache"> - <title>Apache モジュール</title> + <title>Apache モジュールとしてインストール</title> <simpara> PHP が Apache モジュールとして使用された場合、PHP は、Apache ユー ザーの許可属性(通常はユーザー "nobody" の許可属性)を継承します。 @@ -261,7 +275,7 @@ リプトの一部としてそのコードをインクルードすることも可能です。 </simpara> <simpara> - しばしば、PHPユーザ(この場合は、Apacheユーザ)に関するセキュリティ + しばしば、PHPユーザ(この場合は、Apacheユーザ)に関するセキュªãƒ†ã‚£ 上のリスクが非常に小さいという観点で一旦セキュリティが確立されると、 PHPは、ユーザディレクトリにウイルスファイルを書き込んだり、非公開の データベースにアクセスしたり変更したりといったことが出来なくなりま @@ -273,7 +287,7 @@ <simpara> Apacheユーザの権限をルートに昇格させることは非常に危険であり、シ ステム全体を危険にさらす可能性があります。よって、sudoやchrootの実 - 行、ルート¨©é™ã§å®Ÿè¡Œã‚’行う他の手段は、セキュリティに精通した人以外 + 行、ルートȩ限で実行を行う他の手段は、セキュリティに精通した人以外 は、考慮するべきではありません。 </simpara> </sect1> @@ -301,7 +315,7 @@ </simpara> <para> <example> - <title>ファイルシステムへの攻撃</title> + <title>甘い変数の確認から生じるリスク</title> <programlisting role="php"> &lt;?php // ユーザのホームディレクトリからファイルを削除する @@ -315,7 +329,59 @@ </example> usernameはユーザフォームから投稿可能であるため、usernameを投稿し、 他の誰かが所有するファイルを指定、削除することが可能です。この場合、 - 他の何らかの形式の認証を使用するべきです。 + 他の何らかの形式の認証を使用するべきです。投稿された変数が、 + "../etc/" と "passwd " であった場合について考えてみましょう。簡単 + なコードを以下に示します。 + <example> + <title>... ファイルシステムへの攻撃</title> + <programlisting role="php"> +&lt;?php +// 外部からPHPユーザがアクセス可能なハードドライブを削除します。PHPが +// ルートのアクセス権限を有している場合、 +$username = "../etc/"; +$homedir = "/home/../etc/"; +$file_to_delete = "passwd"; +unlink ("/home/../etc/passwd"); +echo "/home/../etc/passwd" has been deleted!"; +?> + </programlisting> + </example> + こうした問題を防止するための適切なチェック手段として以下の2種類が + あります。 + <itemizedlist> + <listitem> + <simpara> + PHP Webユーザバイナリに制限された権限のみを許可する。 + </simpara> + </listitem> + <listitem> + <simpara> + ファイルに関連する投稿された全ての変数を確認する。 + </simpara> + </listitem> + </itemizedlist> + 以下に改良されたスクリプトを示します。 + <example> + <title>より安全なファイル名の確認</title> + <programlisting role="php"> +&lt;?php +// PHPユーザがアクセス可能なハードドライブからファイルを削除する。 +$username = $HTTP_REMOTE_USER; // 認証機構を使用する + +$homedir = "/home/$username"; + +$file_to_delete = basename("$userfile"); // パスを取り除く +unlink ($homedir/$file_to_delete); + +$fp = fopen("/home/logging/filedelete.log","+a"); // 削除の記録 +$logstring = "$HTTP_REMOTE_USER $homedir $file_to_delete"; +fputs ($fp, $logstring); +fclose($fp); + +echo "$file_to_delete has been deleted!"; +?> + </programlisting> + </example> </para> </sect1> @@ -335,7 +401,7 @@ unlink ($evil_var); // 彼らのアクセスのログを書き込む.. または違うかも? -fputs ($evil_var); +fputs ($fp, $evil_var); // 何かちょっとしたことを実行.. または rm -rf *? system ($evil_var); @@ -377,10 +443,52 @@ </itemizedlist> スクリプトを書いた後ではなく、書いている時にこれらの質問を適宜行う ことにより、セキュリティ改善のために不幸にして書き直しが必要になる - ということを避けることができます。 + ということを避けることができます。こうした考慮をまず行うことにより、 + システムのセキュリティを保証できるわけではありませんが、改善の一助 + にはなりえます。 </para> </sect1> + <sect1 id="security.general"> + <title>一般的な考慮事項</title> + <simpara> + 完全に安全なシステムは理想の産物でしかないため、セキュリティ業界で + しばしば使用される手法は、リスクと利便性のバランスのとれた手法です。 + 変数がユーザから投稿される度に(網膜スキャンと指紋のような)2種類の + 生体認証が必要だとしたら、極端に高いレベルの説明義務を生じます。ま + た、かなり複雑なフォームを埋めるために30分もかかるとすれば、ユーザ + がセキュリティをバイパスする手段を探す気分にさせる傾向があります。 + 最善のセキュリティは、通常、ユーザによる業務の達成を防たげずに要求 + を十分に達成できる程度にさしでがましくないものです。むしろ、いくつ + かのセキュリティ攻撃は、単純にこの種の多げさに構築されたセキュリティ + を狙うものです。 + </simpara> + <simpara> + 記憶するに値する言葉として次のようなものがあります。「システムは鎖 + の最も弱い輪と同程度に優れている」全てのトランザクションが時間、場 + 所、トランザクションの型等に基づき大量に記録されているが、ユーザは + 一つのクッキーのみにより認証されている場合、ユーザとそのトランザク + ションログの結び付きの確実性はかなり弱くなります。 + </simpara> + <simpara> + テストの際に、最も簡単なページに関してでさえ、全ての可能性をテスト + することは不可能であるということを頭に入れておいて下さい。期待する + 入力は、不機嫌な社員、経験のあるクラッカー、キーボードの上を歩く家 + の猫による入力とは全く無関係でしょう。これが、想定外のデータが入力 + される可能性がある場所を見分けるために論理的な視点からコードを見て、 + その後、修正、減少、または詳細に調べるというのが、最善であるという + 理由です。 + </simpara> + <simpara> + インターネットにはあなたのコードを壊したり、システムを破壊したり、 + 不適切な内容を投稿したり、その他あなたの一日を不快にするようなこと + により自分の名を馳せたいと思う人がたくさんいます。サイトの規模の大 + 小によらず、単にオンラインであり、接続できるサーバを有しているだけ + で攻撃目標となりえます。多くのクラック用プログラムはサイトの大きさ + を考慮せず、犠牲者を探しつつ大きなIPブロックで網を張っています。 + </simpara> + </sect1> + </chapter> <!-- Keep this comment at the end of the file Index: phpdoc/ja/functions/array.xml diff -u phpdoc/ja/functions/array.xml:1.12 phpdoc/ja/functions/array.xml:1.13 --- phpdoc/ja/functions/array.xml:1.12 Sat Sep 9 22:15:10 2000 +++ phpdoc/ja/functions/array.xml Fri Oct 13 08:30:56 2000 @@ -12,6 +12,11 @@ いくつかのデータベース処理関数は、データベースのクエリから配列を返 しますし、複数の関数は、配列を返します。 </simpara> + <para> + <function>is_array</function>, <function>explode</function>, + <function>implode</function>, <function>split</function>, + <function>join</function>も参照下さい。 + </para> </partintro> <refentry id="function.array"> @@ -473,7 +478,7 @@ </funcsynopsis> <para> <function>array_pad</function>は、<parameter>pad_size</parameter> - で指定した長さだけ値<parameter>pad_value</parameter>をうめて + で指定した長ã•ã ã‘値<parameter>pad_value</parameter>をうめて <parameter>input</parameter>のコピーを返します。 <parameter>pad_size</parameter>が正の場合、配列の右側が埋められます。 負の場合、配列の左側が埋められます。 @@ -918,7 +923,7 @@ <refentry id="function.array-unshift"> <refnamediv> <refname>array_unshift</refname> - <refpurpose>一つ以上の要素を配列の最初に加える</refpurpose> + <refpurpose>一つ以上の要素をéåˆ—の最初に加える</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -2368,7 +2373,7 @@ <para> 比較関数は、最初の引数が二番目の引数より小さいか等しいか大きい場合に それぞれゼロ未満、ゼロに等しい、ゼロより大きい整数を返します。二つの - メンバーの¯”較結果が等しいとなった場合、ソートされた配列の順番は定義 + メンバーのϔ較結果が等しいとなった場合、ソートされた配列の順番は定義 されません。 <example> <title><function>usort</function>の例</title> @@ -2405,7 +2410,7 @@ <note> <para> もちろん、このような簡単な例では<function>rsort</function>関数 - の方がより適しています。 + の方がより適し¦ã„ます。 </para> </note> <para> Index: phpdoc/ja/functions/fdf.xml diff -u phpdoc/ja/functions/fdf.xml:1.4 phpdoc/ja/functions/fdf.xml:1.5 --- phpdoc/ja/functions/fdf.xml:1.4 Sat Aug 26 18:43:06 2000 +++ phpdoc/ja/functions/fdf.xml Fri Oct 13 08:30:56 2000 @@ -140,17 +140,17 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_close</function></funcdef> + <funcdef>boolean <function>fdf_close</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>fdf_close</function> 関数はFDFドキュメントを - 閉じます。</para> - + 閉じます。 + </para> <para> - <function>fdf_open</function> も参照下さい。</para> - + <function>fdf_open</function> も参照下さい。 + </para> </refsect1> </refentry> @@ -263,7 +263,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_value</function></funcdef> + <funcdef>boolean <function>fdf_set_value</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>fieldname</parameter></paramdef> <paramdef>string <parameter>value</parameter></paramdef> @@ -318,7 +318,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_ap</function></funcdef> + <funcdef>boolean <function>fdf_set_ap</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>field_name</parameter></paramdef> <paramdef>int <parameter>face</parameter></paramdef> @@ -345,7 +345,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_status</function></funcdef> + <funcdef>boolean <function>fdf_set_status</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>status</parameter></paramdef> </funcprototype> @@ -390,7 +390,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_file</function></funcdef> + <funcdef>boolean <function>fdf_set_file</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> @@ -438,7 +438,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_flags</function></funcdef> + <funcdef>boolean <function>fdf_set_flags</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>fieldname</parameter></paramdef> <paramdef>int <parameter>whichFlags</parameter></paramdef> @@ -464,7 +464,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_opt</function></funcdef> + <funcdef>boolean <function>fdf_set_opt</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>fieldname</parameter></paramdef> <paramdef>int <parameter>element</parameter></paramdef> @@ -491,7 +491,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_submit_form_action</function></funcdef> + <funcdef>boolean <function>fdf_set_submit_form_action</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>fieldname</parameter></paramdef> <paramdef>int <parameter>trigger</parameter></paramdef> @@ -519,7 +519,7 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>void <function>fdf_set_javascript_action</function></funcdef> + <funcdef>boolean <function>fdf_set_javascript_action</function></funcdef> <paramdef>int <parameter>fdf_document</parameter></paramdef> <paramdef>string <parameter>fieldname</parameter></paramdef> <paramdef>int <parameter>trigger</parameter></paramdef> Index: phpdoc/ja/functions/info.xml diff -u phpdoc/ja/functions/info.xml:1.17 phpdoc/ja/functions/info.xml:1.18 --- phpdoc/ja/functions/info.xml:1.17 Fri Sep 29 19:01:27 2000 +++ phpdoc/ja/functions/info.xml Fri Oct 13 08:30:56 2000 @@ -466,7 +466,8 @@ echo $dat["ru_utime.tv_usec"]; # 使用するユーザー時間 (マイクロ秒) </programlisting> </example> - 更に詳細な情報は、システムのmanページを参照下さい。 + 更に詳細な情報は、getrusage(2)に関するシステムのmanページを参照下 + さい。 </para> </refsect1> </refentry> @@ -474,7 +475,7 @@ <refentry id="function.ini-alter"> <refnamediv> <refname>ini_alter</refname> - <refpurpose>設定オプションの値ゥĉ更する</refpurpose> + <refpurpose>設定オプションの値を変更する</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -709,7 +710,9 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>phpinfo</function></funcdef> - <paramdef>void</paramdef> + <paramdef>int + <parameter><optional>what</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para> @@ -717,10 +720,31 @@ 情報には、PHPコンパイルオプションと拡張機能、PHPのバージョン、 サーバ情報と環境（モジュールとしてコンパイルされた場合）、 PHP の環境、OS バージョン情報、パス、構成オプションのマスター - およびローカルの値、HTTP ヘッダ、GNU Public Licenseなどが + およびローカルの値、HTTP ヘッダ、PHP Licenseなどが あります。 </para> <para> + オプションのパラメータ <parameter>what</parameter> に以下の値を一 + つまたは複数指定することにより出力をカスタマイズすることが可能です。 + <itemizedlist> + <listitem><simpara>INFO_GENERAL</simpara></listitem> + <listitem><simpara>INFO_CREDITS</simpara></listitem> + <listitem><simpara>INFO_CONFIGURATION</simpara></listitem> + <listitem><simpara>INFO_MODULES</simpara></listitem> + <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem> + <listitem><simpara>INFO_VARIABLES</simpara></listitem> + <listitem><simpara>INFO_LICENSE</simpara></listitem> + <listitem><simpara>INFO_ALL</simpara></listitem> + <listitem><simpara>CREDITS_GROUP</simpara></listitem> + <listitem><simpara>CREDITS_GENERAL</simpara></listitem> + <listitem><simpara>CREDITS_SAPI</simpara></listitem> + <listitem><simpara>CREDITS_MODULES</simpara></listitem> + <listitem><simpara>CREDITS_DOCS</simpara></listitem> + <listitem><simpara>CREDITS_FULLPAGE</simpara></listitem> + <listitem><simpara>CREDITS_ALL</simpara></listitem> + </itemizedlist> + </para> + <para> <function>phpversion</function>,<function>phpcredits</function>, <function>php_logo_guid</function>も参照下さい。 </para> @@ -1068,7 +1092,7 @@ </funcprototype> </funcsynopsis> <para> - この関数は、<function>require_once</function>によりスクリプƒˆã«ãƒ­ãƒ¼ + この関数は、<function>require_once</function>によりスクリプÈにロー ドされた全てのファイルの名前を連想配列として返します。 <function>require_once</function>で使用した際と同様に拡張子 &quot;.php&quot;を除いたファイル名が配列の添字となります。 Index: phpdoc/ja/functions/mail.xml diff -u phpdoc/ja/functions/mail.xml:1.5 phpdoc/ja/functions/mail.xml:1.6 --- phpdoc/ja/functions/mail.xml:1.5 Fri Jun 30 20:19:00 2000 +++ phpdoc/ja/functions/mail.xml Fri Oct 13 08:30:56 2000 @@ -52,6 +52,46 @@ "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/" . phpversion()); </programlisting> </example> + 複雑なemailメッセージを作成する際に単純な文字列結合を使用すること + も可能です。 + <example> + <title>複雑なemailを送信する</title> + <programlisting role="php"> +/* recipients */ +$recipient .= "Mary &lt;mary@u.college.edu>" . ", " ; //コンマで区切る +$recipient .= "Kelly &lt;kelly@u.college.edu> . ", "; +$recipient .= "ronabop@php.net"; + +/* 題名 */ +$subject = "Birthday Reminders for August"; + +/* メッセージ */ +$message .= "The following email includes a formatted ASCII table\n"; +$message .= "Day \t\tMonth \t\tYear\n"; +$message .= "3rd \t\tAug \t\t1970\n"; +$message .= "17rd\t\tAug \t\t1973\n"; + +/* 保存されたsigunatureを追加できます */ +$message .= "--\r\n"; // signatureの区切り +$message .= "Birthday reminder copylefted by public domain"; + +/* エラー用、From、cc、bcc、等の追加ヘッダ */ + +$headers .= "From: Birthday Reminder &lt;birthday@php.net>\n"; +$headers .= "X-Sender: &lt;birthday@php.net>\n"; +$headers .= "X-Mailer: PHP\n"; // メイラー +$headers .= "X-Priority: 1\n"; // 緊急メッセージ! +$headers .= "Return-Path: &lt;birthday@php.net>\n"; // エラー時の返信先 + +$headers .= "Content-Type: text/html; charset=iso-8859-1\n" // MIME型 + +$headers .= "cc:birthdayarchive@php.net\n"; // CCの宛先 +$headers .= "bcc:birthdaycheck@php.net, birthdaygifts@php.net\n"; // BCCの宛先 + +/* ここでメールを送信する */ +mail($recipent, $subject, $message, $headers); + </programlisting> + </example> </para> </refsect1> </refentry> Index: phpdoc/ja/functions/msql.xml diff -u phpdoc/ja/functions/msql.xml:1.6 phpdoc/ja/functions/msql.xml:1.7 --- phpdoc/ja/functions/msql.xml:1.6 Sat Aug 5 06:12:59 2000 +++ phpdoc/ja/functions/msql.xml Fri Oct 13 08:30:56 2000 @@ -5,7 +5,7 @@ <partintro> <simpara> これらの関数により mSQLデータベースサーバーにアクセスすることが可 - 能になりあmす。これらの関数を利用可能とするには、 + 能になります。これらの関数を利用可能とするには、 <option role="configure">--with-msql[=dir]</option>オプションによ り msql サポートを付けてphpをコンパイルする必要があります。 デフォルトの位置は、/usr/local/Hughes です。 @@ -292,7 +292,9 @@ <refentry id="function.msql-error"> <refnamediv> <refname>msql_error</refname> - <refpurpose>最後の msql コールに関してエラーメッセージを返す。</refpurpose> + <refpurpose> + 最後の msql コールに関してエラーメッセージを返す + </refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -331,8 +333,8 @@ もう行が残っていない場合にはfalseを返します。 </para> <para> - <function>msql_fetch_array</function>は、<function>msql_fetch_row - </function> の拡張版です。 + <function>msql_fetch_array</function>は、 + <function>msql_fetch_row</function> の拡張版です。 データを結果配列の数値インデックスに保存するのに加えて、 フィールド名をキーとしてデータを連想インデックスにも保存します。 </para> @@ -571,10 +573,11 @@ </funcprototype> </funcsynopsis> <para> - msql_fieldtype() は、<function>msql_fieldname</function> 関数に - 似ています。引数は同じですが、フィールドの型が返されます。 - "int"、 "string" 、 "real" のどれかが返されます。</para> - + <function>msql_fieldtype</function> は、 + <function>msql_fieldname</function> 関数に似ています。引数は同じ + ですが、フィールドの型が返されます。"int"、 "char" 、 "real" のど + れかが返されます。 + </para> </refsect1> </refentry> @@ -594,9 +597,9 @@ </funcsynopsis> <para> <function>msql_fieldflags</function>は、指定されたフィールドの - フィールドフラグを返します。 - 現在、このフラグは、"not null"、"primary key"、この二つの組み合わせ - または "" (空文字列) のどれかです。 + フィールドフラグを返します。現在、このフラグは、"not null"、 + "primary key"、この二つの組み合わせまたは "" (空文字列) のどれか + です。 </para> </refsect1> </refentry> Index: phpdoc/ja/functions/oci8.xml diff -u phpdoc/ja/functions/oci8.xml:1.8 phpdoc/ja/functions/oci8.xml:1.9 --- phpdoc/ja/functions/oci8.xml:1.8 Sun Oct 1 08:36:45 2000 +++ phpdoc/ja/functions/oci8.xml Fri Oct 13 08:30:56 2000 @@ -293,7 +293,19 @@ OCIFreeStatement($stmt); OCILogoff($conn); -?></programlisting></example> +?> + </programlisting> + </example> + <warning> + <para> + magic quote と<function>OciBindByName</function>を同時に使用する + ことは良いアイデアではありません。これは、引用符を付加された変数 + に引用符を付加する必要はなく、また、magic quote により付加された + 引用符は、<function>OciBindByName</function> が magic quote によ + り付加された引用符を意図的に付加されたものと区別できないため、そ + のままデータベースに書き込まれるためです。 + </para> + </warning> </refsect1> </refentry> @@ -483,7 +495,7 @@ インスタンス)または TWO_TASK (tnsnames.ora) を使用します。 </para> <para> - <function>OCINLogon</function> は強å¶çš„に新規接続を作成します。 + <function>OCINLogon</function> は強嶧ڄに新規接続を作成します。 一連のトランザクションを独立して実行する必要がある場合にこの関数を 使用する必要があります。デフォルトでは、接続は、 <function>OCILogon</function> を使用した場合はページレベルで共有され、 Index: phpdoc/ja/functions/pgsql.xml diff -u phpdoc/ja/functions/pgsql.xml:1.16 phpdoc/ja/functions/pgsql.xml:1.17 --- phpdoc/ja/functions/pgsql.xml:1.16 Fri Sep 15 18:27:36 2000 +++ phpdoc/ja/functions/pgsql.xml Fri Oct 13 08:30:56 2000 @@ -661,9 +661,9 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_fieldsize</function>は、指定したPostgreSQLの結果においã¦ã€ - 指定したフィールド番号の内部記憶領域のサイズを(バイト数で)返します。 - フィールド番号は0から始まります。 + <function>pg_fieldsize</function>は、指定したPostgreSQLの結果にお + いて指定したフィールド番号の内部記憶領域のサイズを(バイト数で)返 + します。フィールド番号は0から始まります。 フィールドサイズが-1の場合、その項目は可変長フィールドであることを 示します。この関数は、エラーの場合はfalseを返します。 </para> @@ -819,13 +819,9 @@ <funcsynopsis> <funcprototype> <funcdef>bool <function>pg_loexport</function></funcdef> + <paramdef>int <parameter>oid</parameter></paramdef> + <paramdef>int <parameter>file</parameter></paramdef> <paramdef>int - <parameter>oid</parameter> - </paramdef> - <paramdef>int - <parameter>file</parameter> - </paramdef> - <paramdef>int <parameter><optional>connection_id</optional></parameter> </paramdef> </funcprototype> @@ -1024,7 +1020,7 @@ </funcsynopsis> <para> <function>pg_numrows</function>はPostgreSQLの結果における行数を返します。 - 引数は、<function>pg_Exec</function>で返された有効な結果IDです。 + 引数は、<function>pg_exec</function>で返された有効な結果IDです。 この関数は、エラーの際に-1を返します。 </para> </refsect1> Index: phpdoc/ja/functions/posix.xml diff -u phpdoc/ja/functions/posix.xml:1.4 phpdoc/ja/functions/posix.xml:1.5 --- phpdoc/ja/functions/posix.xml:1.4 Fri Sep 29 19:01:27 2000 +++ phpdoc/ja/functions/posix.xml Fri Oct 13 08:30:56 2000 @@ -409,11 +409,18 @@ <listitem><simpara> machine - システムアーキテクチャ (例 i586) </simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> <para> - POSIXでは、値のフォーマットに関して何の仮定も設けないことを規定しています。 - 例えば、バージョン番号が3桁であることや、この関数により返される - その他のものに依存してはいけません。</para> + domainname は、GNU の拡張機能で POSIX.1 には含まれていません。こ + のため、このフィールドはGNUシステム上またはGNU libc を使用してい + る場合にのみ使用可能です。 + </para> + <para> + POSIXでは、値のフォーマットに関して何の仮定も設けないことを規定し + ています。例えば、バージョン番号が3桁であることや、この関数により + 返されるその他のものに依存してはいけません。 + </para> </refsect1> </refentry> Index: phpdoc/ja/functions/regex.xml diff -u phpdoc/ja/functions/regex.xml:1.7 phpdoc/ja/functions/regex.xml:1.8 --- phpdoc/ja/functions/regex.xml:1.7 Fri Sep 15 18:27:36 2000 +++ phpdoc/ja/functions/regex.xml Fri Oct 13 08:30:56 2000 @@ -297,8 +297,9 @@ </funcprototype> </funcsynopsis> <para> - 文字列の配列を返します。配列の各要素は正規表現<parameter>pattern</parameter> - により区切られた<parameter>string</parameter>中の部分文字列です。 + 文字列の配列を返します。配列の各要素は正規表現 + <parameter>pattern</parameter>により区切られた + <parameter>string</parameter>中の部分文字列です。 <parameter>limit</parameter>が指定された場合、返される配列には 最大<parameter>limit</parameter>の要素が含まれます。この場合、 最後の要素には<parameter>string</parameter>の残りの部分が全て @@ -306,7 +307,7 @@ falseを返します。 </para> <para> - <filename>/etc/passwd</filename>の行の先頭から5つのフィールド + <filename>/etc/passwd</filename>の行から最初の4つのフィールド を取り出すには、以下のようにします。 <example> <title><function>split</function>の例</title> Index: phpdoc/ja/language/control-structures.xml diff -u phpdoc/ja/language/control-structures.xml:1.11 phpdoc/ja/language/control-structures.xml:1.12 --- phpdoc/ja/language/control-structures.xml:1.11 Fri Sep 29 19:01:27 2000 +++ phpdoc/ja/language/control-structures.xml Fri Oct 13 08:30:56 2000 @@ -1101,7 +1101,7 @@ if (PHPVERSION == 4) { print_r($var); } else { - dump_var($var); + var_dump($var); } }