diff --git a/appendices/migration70/incompatible/error-handling.xml b/appendices/migration70/incompatible/error-handling.xml index 5fdb147d1e..aa79a05284 100644 --- a/appendices/migration70/incompatible/error-handling.xml +++ b/appendices/migration70/incompatible/error-handling.xml @@ -104,39 +104,39 @@ function handler(Throwable $e) { /* ... */ } - Indexing by a resource + リソースによる添字アクセス E_NOTICE - Abstract static methods + 抽象 static メソッド 通知は削除され、エラーにはならない - "Redefining" a constructor + コンストラクタの「再定義」 通知は削除され、エラーにはならない - Signature mismatch during inheritance + 継承時のシグネチャの不一致 E_WARNING - Same (compatible) property in two used traits + use している2つのトレイトにある同一 (互換性のある) プロパティ 通知は削除され、エラーにはならない - Accessing static property non-statically + static プロパティへの非 static なアクセス E_NOTICE - Only variables should be assigned by reference + 変数以外を参照によって代入する場合 E_NOTICE - Only variables should be passed by reference + 変数以外を参照渡しで渡す場合 E_NOTICE - Calling non-static methods statically + non-static メソッドを static に呼び出す場合 E_DEPRECATED diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 23abac15d7..77b15e5da5 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -554,7 +554,7 @@ $array["key"]; - private メソッドに final 修正子を指定した場合、 + private メソッドに final 修飾子を指定した場合、 そのメソッドがコンストラクタでない限り、警告が発生するようになります。 @@ -1156,7 +1156,7 @@ $array["key"]; mb_ereg_replace 関数の - e 修正子が削除されました。 + e 修飾子が削除されました。 mb_ereg_replace_callback 関数を代わりに使って下さい。 @@ -1288,7 +1288,7 @@ $array["key"]; 不正なエスケープシーケンスを渡した場合、 もはやリテラルと解釈されなくなりました。 - リテラルと解釈する振る舞いは X 修正子で必須でしたが、 + リテラルと解釈する振る舞いは X 修飾子で必須でしたが、 無視されるようになっています。 diff --git a/appendices/migration83/incompatible.xml b/appendices/migration83/incompatible.xml index f28c519826..5c95006dca 100644 --- a/appendices/migration83/incompatible.xml +++ b/appendices/migration83/incompatible.xml @@ -44,16 +44,16 @@ - クラス定数のアクセス権 + クラス定数のアクセス権の変性チェック - クラス定数のアクセス権が、インターフェイスから継承した場合でも正しくチェックされるようになりました。 + クラス定数のアクセス権の変性が、インターフェイスから継承した場合でも正しくチェックされるようになりました。 キーが自分自身を参照している WeakMap のエントリ - WeakMap のエントリには、(おそらく推移的に) キーが自分自身を参照しているものがあります。そのキーが到達できない場合に、循環参照のコレクタがそれを削除できるようになりました。但し、WeakMap をループしている場合を除きます (ループ経由で到達できることは、weak と見なされるためです)。これより前のバージョンでは、こうしたエントリは自動で決して削除されませんでした。 + WeakMap のエントリには、(場合によっては推移的に) キーが自分自身を参照しているものがあります。そのキーが、WeakMap をループする以外の方法では到達できない場合 (ループ経由での到達は、weak と見なされます)、循環参照の収集時にそれを削除できるようになりました。これより前のバージョンでは、こうしたエントリは自動で決して削除されませんでした。 @@ -62,7 +62,7 @@ Date - 日付・時刻の拡張モジュールでは、DateError と DateException の階層に、拡張モジュール特有の例外とエラーを追加しました。これは、エラー時に警告や汎用の例外を発生させていた動作を置き換えるものです。これらによって、エラーや例外をチェックする必要がなくなり、エラーハンドリングが改善できます。 + 日付・時刻の拡張モジュールでは、DateError と DateException の階層に、拡張モジュール特有の例外とエラーを追加しました。これは、エラー時に警告や汎用の例外を発生させていた動作を置き換えるものです。これによって、エラーハンドリングが改善されますが、その代わりにエラーや例外をチェックする必要があります。 @@ -82,7 +82,7 @@ - 以前のバージョンでは、DOMDocument::createAttributeNS は、prefix が既に異なる URI で使われている場合に DOM_NAMESPACE_ERRNAMESPACE_ERR DOMException をスローしていました。 + 以前のバージョンでは、DOMDocument::createAttributeNS は、prefix が既に異なる URI で使われている場合に誤って DOM_NAMESPACE_ERRNAMESPACE_ERR DOMException をスローしていました。 このバージョンからは、prefix の名前が衝突していた場合でも、異なる prefix を正しく選べるようになりました。 @@ -111,7 +111,7 @@ Phar - Phar クラスの定数が、型宣言するようになりました。 + Phar クラスの定数の型が、宣言されるようになりました。 @@ -123,14 +123,14 @@ オブジェクトやリソース、配列を境界の値として渡すと、TypeError がスローされるようになりました。 step に 0 を渡すと、よりわかりやすい ValueError がスローされるようになりました。 - 範囲が増加しているのに、step に負の値を渡すと、ValueError がスローされるようになりました。 + 増加する範囲に対して step に負の値を渡すと、ValueError がスローされるようになりました。 step が整数型として解釈できる float の場合、整数型として解釈するようになりました。 引数のいずれかが無限大または NAN の場合、ValueError がスローされるようになりました。 start や end が空文字列の場合、E_WARNING が発生するようになりました。値そのものが 0 にキャストされる動作は変更されていません。 start や end が1バイトより長い場合、E_WARNING が発生するようになりました。但し、それが数値形式の文字列でない場合に限ります。 - start や end が整数型にキャストした値の場合、E_WARNING が発生するようになりました。なぜなら、他の境界の入力値は数値だからです。(例: range(5, 'z');) - step が float の場合で、ある範囲の文字を生成しようとした場合、E_WARNING が発生するようになりました。但し、境界の値がともに数値形式の文字列の場合を除きます。(例: range('5', '9', 0.5); のようなコードは、警告が発生しません) - range 関数は、境界の値の一方が数字の場合、もう片方の境界の値を整数にキャストせず、文字のリストを生成するようになりました。(例: range('9', 'A');). + start や end が整数型にキャストされる場合、E_WARNING が発生するようになりました。なぜなら、他の境界の入力値は数値だからです。(例: range(5, 'z');) + ある範囲の文字を生成しようとした際に step が float だった場合、E_WARNING が発生するようになりました。但し、境界の値がともに数値形式の文字列の場合を除きます。(例: range('5', '9', 0.5); のようなコードは、警告が発生しません) + range 関数は、境界の値の一方が数字の場合、もう片方の境界の値を整数にキャストせず、文字のリストを生成するようになりました。(例: range('9', 'A');) @@ -146,16 +146,15 @@ range('9', 'A'); // PHP 8.3.0 より前は、[9, 8, 7, 6, 5, 4, 3, 2, 1, 0] - number_format は、負の - decimals の値を小数点以下 - num 桁から abs($decimals) - 桁に丸めるようになりました。 + number_format は、decimals + に負の値を指定した場合、num を小数点より前の + abs($decimals) 桁に丸めることで対応するようになりました。 これより前のバージョンでは、負の decimals は黙って無視されていました。 - file 関数の flags パラメータは、すべての不正な値をチェックするようになりました。注意すべきなのは、これより前のバージョンでは FILE_APPEND を黙って受け入れていましたが、このバージョンから受け入れなくなったことです。 + file 関数の flags パラメータのエラーチェックが、すべての不正なフラグを検出するようになりました。注意すべきなのは、これより前のバージョンでは FILE_APPEND を黙って受け入れていましたが、このバージョンから受け入れなくなったことです。 @@ -163,7 +162,7 @@ range('9', 'A'); // PHP 8.3.0 より前は、[9, 8, 7, 6, 5, 4, 3, 2, 1, 0] SNMP - SNMP クラスの定数が、型宣言するようになりました。 + SNMP クラスの定数の型が、宣言されるようになりました。 diff --git a/appendices/migration83/new-features.xml b/appendices/migration83/new-features.xml index 4e0e15050a..abb825d5d0 100644 --- a/appendices/migration83/new-features.xml +++ b/appendices/migration83/new-features.xml @@ -102,7 +102,7 @@ echo $user_ini['listen']; // localhost:9000 CLI - 複数のファイルの文法チェックを、一度にできるようになりました。 + 複数のファイルの構文チェックを、一度にできるようになりました。 @@ -146,11 +146,11 @@ echo $user_ini['listen']; // localhost:9000 - posix_isatty は、通常のパラメータ解釈のセマンティクス(ZPP) に従い、整数値に対して警告を発生させるようになりました。 + posix_isatty は、通常のパラメータ解釈のセマンティクス(ZPP) に従い、整数値に対して型のエラーに関する警告を発生させるようになりました。 - posix_ttyname は、通常のパラメータ解釈のセマンティクス(ZPP) に従い、整数値に対して警告を発生させるようになりました。さらに、無効なファイルディスクリプタの整数値に対しても、警告を発生させるようになっています。 + posix_ttyname は、通常のパラメータ解釈のセマンティクス(ZPP) に従い、整数値に対して型のエラーに関する警告を発生させるようになりました。さらに、無効なファイルディスクリプタの整数値に対しては、値のエラーに関する警告を発生させるようになっています。 diff --git a/appendices/migration83/other-changes.xml b/appendices/migration83/other-changes.xml index f7fe3e6eeb..d75721321d 100644 --- a/appendices/migration83/other-changes.xml +++ b/appendices/migration83/other-changes.xml @@ -19,7 +19,7 @@ FPM - ソケットのパスの長さが OS がサポートする長さ以上の場合、FPM CLI のテストが失敗するようになりました。 + ソケットのパスの長さが OS がサポートする長さを超える場合、FPM CLI のテストが失敗するようになりました。 @@ -27,7 +27,7 @@ Opcache - CLI SAPI と phpdbg SAPI では、opcache.preload_user ディレクティブを設定しなくても root として事前ロードを実行できるようになりました。これら以外の SAPI では、root として事前ロードを実行する際に このディレクティブの設定が未だ必須です。なぜなら、SAPI が特権を持っていないユーザに移行する前に事前ロードが実行されるからです。 + CLI SAPI と phpdbg SAPI では、opcache.preload_user ディレクティブを設定しなくても root として事前ロードを実行できるようになりました。これら以外の SAPI では、root として事前ロードを実行する際に このディレクティブの設定が未だ必須です。なぜなら、SAPI が特権を持っていないユーザーに移行する前に事前ロードが実行されるからです。 @@ -35,7 +35,7 @@ Streams - ソケット接続をブロックする fread 関数は、バッファリングされているデータが存在した場合、追加のデータを待つのではなく、すぐに値を返すようになりました。 + ソケット接続に対するブロッキングモードの fread 関数は、バッファリングされているデータが存在した場合、追加のデータを待つのではなく、すぐに値を返すようになりました。 @@ -74,10 +74,10 @@ "protected" => bool "full" => bool "buffer_size" => int - "application_time" => float: gc の合計の実行時間を秒単位で示します(collector_time を含みます) - "collector_time" => float: 循環参照を回収するのに使った時間を秒単位で示します(dessructor_time と free_time を含みます) + "application_time" => float: アプリケーション全体の実行時間を秒単位で示します(collector_time を含みます) + "collector_time" => float: 循環参照を回収するのに使った時間を秒単位で示します(destructor_time と free_time を含みます) "destructor_time" => float: 循環参照を回収している間に、デストラクタを実行した時間を秒単位で示します - "free_time" => float: 循環参照を回収している間に、メモリを開放するのにかかった時間を秒単位で示します + "free_time" => float: 循環参照を回収している間に、メモリを解放するのにかかった時間を秒単位で示します @@ -172,11 +172,11 @@ - mb_encode_mimeheader は、入力文字列が Qprint エンコーディングの場合に、NUL(ゼロ)バイトを削除しなくなりました。これより前のバージョンでは、あるテキストエンコーディングの場合(特に UTF-16 と UTF-32) に NUL バイトが削除され、mb_encode_mimeheader の結果が壊れる場合がありました。 + mb_encode_mimeheader は、入力文字列を QPrint エンコーディングする際に、NUL(ゼロ)バイトを削除しなくなりました。これより前のバージョンでは、あるテキストエンコーディングの場合(特に UTF-16 と UTF-32) に NUL バイトが削除され、mb_encode_mimeheader の結果が壊れる場合がありました。 - mb_detect_encoding の "$strict に true を指定しない" モードが、ドキュメントの通りに振る舞うようになりました。これより前のバージョンでは、入力文字列と同一のバイト(たとえば、最初のバイト) が、候補となるエンコーディングのリスト全てに対して不正と判定された場合でも、&false; を返していました。もっと一般化すると、不正なバイトが見つかった時点で、候補となるエンコーディングから削除してしまっていました。そして、入力と同一のバイトを削除した場合に、残りのエンコーディングをすべて候補として考慮すべき場合でも、&false; を返していました。一方で、候補となるエンコーディングが削除されて残りがひとつだけになった場合、文字列中で後にどれくらいエンコーディングのエラーが見つかるのかを考慮することなく、その残ったエンコーディングを返していました。この振る舞いは、ドキュメントの以下の説明と一致しません: "strict が false の場合、 もっとも近いと判定された文字エンコーディングが返されます" + mb_detect_encoding の "$strict に true を指定しない" モードが、ドキュメントの通りに振る舞うようになりました。これより前のバージョンでは、入力文字列中の同じバイト(たとえば、最初のバイト) が、候補となるエンコーディングのリスト全てに対して不正と判定された場合に、&false; を返していました。もっと一般化すると、不正なバイトが見つかった時点で、候補となるエンコーディングを検討対象から削除してしまっていました。そして、同じ入力バイトによって検討中の残りのエンコーディングがすべて削除された場合には、&false; を返していました。一方で、候補となるエンコーディングが削除されて残りがひとつだけになった場合、文字列中で後にどれくらいエンコーディングのエラーが見つかるのかを考慮することなく、その残ったエンコーディングを返していました。この振る舞いは、ドキュメントの以下の説明と一致しません: "strict が false の場合、 もっとも近いと判定された文字エンコーディングが返されます" @@ -200,7 +200,7 @@ ODBC - odbc_autocommitは、enable パラメータで &null; を受け入れるようになりました。&null; を渡すと、パラメータをひとつ渡した場合と同じ振る舞いをします。つまり、自動コミットが有効かどうかだけを示す動きをします。 + odbc_autocommitは、enable パラメータで &null; を受け入れるようになりました。&null; を渡すと、引数をひとつだけ渡した場合と同じ振る舞いをします。つまり、自動コミットが有効かどうかだけを示す動きをします。 @@ -216,7 +216,7 @@ - pg_insert と pg_convert は、フィールドの値/タイプ が PostgreSQL の型と一致しない場合に、E_WARNING ではなく ValueError または TypeError を発生させるようになりました。 + pg_insert と pg_convert は、フィールドの値や型が PostgreSQL の型と一致しない場合に、E_WARNING ではなく ValueError または TypeError を発生させるようになりました。 @@ -255,7 +255,7 @@ - array_pad は、配列が持つことができる最大の要素数だけを制限するようになりました。これより前のバージョンでは、一度に追加できる最大の要素数が 1048576 になっていました。 + array_pad は、配列が持つことができる最大の要素数によってのみ制限されるようになりました。これより前のバージョンでは、一度に追加できる最大の要素数が 1048576 になっていました。 @@ -263,7 +263,7 @@ - password_hash は、ソルトの生成が失敗した場合に、ValueError の previous (直前にスローされた例外) として、既に存在する Random\RandomException をチェインさせるようになりました。 + password_hash は、ソルトの生成が失敗した場合に、ValueError の previous Exception (直前にスローされた例外) として、既に存在する Random\RandomException をチェインさせるようになりました。 @@ -271,7 +271,7 @@ - proc_open の command に配列を指定する場合、かつそれが不正なコマンドの場合に、後に警告が発生するリソースではなく &false; を返すようになりました。Windows では既にそのように動作していましたが、posix_spawn を使っている場合(ほとんどのプラットフォーム Linux, BSD, MacOS) でも同様の振る舞いをするようになりました。ただ、posix_spawn をサポートしていないために、以前の振る舞いが変更されていない古いプラットフォームもまだ残っています。 + proc_open の command に配列を指定する場合、かつそれが不正なコマンドの場合に、後に警告が発生するリソースではなく &false; を返すようになりました。Windows では既にそのように動作していましたが、posix_spawn を使っている場合(ほとんどの Linux, BSD, MacOS プラットフォーム) でも同様の振る舞いをするようになりました。ただ、posix_spawn をサポートしていないために、以前の振る舞いが変更されていない古いプラットフォームもまだ残っています。 @@ -288,7 +288,7 @@ - str_getcsv と fgetcsv は、最後のフィールドに終端されていないクォートだけが含まれている場合、null バイトの文字列をひとつ返すのではなく、空文字列を返すようになりました。 + str_getcsv と fgetcsv は、最後のフィールドが、閉じられていないフィールド囲み文字だけの場合、null バイト 1 つの文字列ではなく、空文字列を返すようになりました。 @@ -329,7 +329,7 @@ - SQLite のエラーコードは、エラーメッセージに含められるのではなく、例外に渡されるようになりました。 + SQLite のエラーコードは、エラーメッセージに含められるのではなく、例外のエラーコードとして渡されるようになりました。 @@ -355,7 +355,7 @@ - zend.max_allowed_stack_size は、許可される最大のスタックサイズの値を設定するための、新しい INI ディレクティブです。設定できる値は、0 (プロセスやスレッドの、スタックサイズの最大値を用います)、-1 (無制限)、そしてバイト単位の正の数値です。デフォルトは 0 です。プロセスやスレッドのスタックサイズの最大値がわからない場合、既知のシステムのデフォルト値を使います。この値に大き過ぎる値を設定すると、スタックサイズの制限を無効にすることと同じ効果があります。ファイバーは 許可される最大のスタックサイズとして fiber.stack_size の値を使います。プロセスのコールスタックが zend.max_allowed_stack_size-zend.reserved_stack_size バイトを超えると、スタックオーバーフローが引き起こすセグメンテーションフォルトを防ぐため、Error がスローされます。これは、デバッグを容易にすることが目的です。スタックサイズは、制御されていない再帰処理によって増加します。増加する範囲は、内部関数やマジックメソッド __toString(), __clone(), __sleep(), __destruct() 内も含みます。この機能はスタックバッファのオーバーフローとは無関係ですし、セキュリティのための機能でもありません。 + zend.max_allowed_stack_size は、許可される最大のスタックサイズの値を設定するための、新しい INI ディレクティブです。設定できる値は、0 (プロセスやスレッドの、スタックサイズの最大値を用います)、-1 (無制限)、そしてバイト単位の正の数値です。デフォルトは 0 です。プロセスやスレッドのスタックサイズの最大値がわからない場合、既知のシステムのデフォルト値を使います。この値に大き過ぎる値を設定すると、スタックサイズの制限を無効にすることと同じ効果があります。ファイバーは 許可される最大のスタックサイズとして fiber.stack_size の値を使います。プロセスのコールスタックが zend.max_allowed_stack_size-zend.reserved_stack_size バイトを超えると、スタックオーバーフローが引き起こすセグメンテーションフォルトを防ぐため、Error がスローされます。これは、デバッグを容易にすることが目的です。スタックサイズは、内部関数やマジックメソッド __toString(), __clone(), __sleep(), __destruct() が関わる制御されていない再帰処理によって増加します。この機能はスタックバッファのオーバーフローとは無関係ですし、セキュリティのための機能でもありません。 diff --git a/appendices/migration85/deprecated.xml b/appendices/migration85/deprecated.xml index 554d3f3285..f1a64ad429 100644 --- a/appendices/migration85/deprecated.xml +++ b/appendices/migration85/deprecated.xml @@ -96,7 +96,7 @@ 同じ定数を再宣言することは、推奨されなくなりました。 これについては既に警告は発生しており、 - (警告の種類が変わるだけで)それが続くことに注意してください。 + それが続くことに注意してください。 @@ -132,7 +132,7 @@ soft-deprecated 扱いになりました。 代わりに、__serialize() と __unserialize() を使ってください。 - PHP 7 との互換性が必要な場合は、両方を同時に使ってください。 + PHP 7 との互換性が必要な場合は、__sleep() や __wakeup() と併用してください。 @@ -151,11 +151,11 @@ - 数値でない文字列をインクリメント + 数値形式でない文字列をインクリメント - 数値でない文字列をインクリメントすることは、推奨されなくなりました。 + 数値形式でない文字列をインクリメントすることは、推奨されなくなりました。 str_increment を代わりに使ってください。 @@ -185,14 +185,14 @@ curl_close 関数は、推奨されなくなりました。 CurlHandle オブジェクトが、 - 自動でリソースを開放するためです。 + 自動で解放されるためです。 curl_share_close 関数は、推奨されなくなりました。 CurlShareHandle オブジェクトが、 - 自動でリソースを開放するためです。 + 自動で解放されるためです。 @@ -218,7 +218,7 @@ finfo_close 関数は、推奨されなくなりました。 finfo オブジェクトが、 - 自動でリソースを開放するためです。 + 自動で解放されるためです。 @@ -237,7 +237,7 @@ imagedestroy 関数は、推奨されなくなりました。 GdImage オブジェクトが、 - 自動でリソースを開放するためです。 + 自動で解放されるためです。 @@ -330,7 +330,7 @@ - PDO クラスのドライバ特有の定数は、推奨されなくなりました。 + PDO クラスのドライバ固有の定数は、推奨されなくなりました。 影響を受ける定数と、代替は以下のとおりです: @@ -381,7 +381,7 @@ - PDO クラスのドライバ特有のメソッドは、推奨されなくなりました。 + PDO クラスのドライバ固有のメソッドは、推奨されなくなりました。 影響を受けるメソッドと、代替は以下のとおりです: @@ -456,7 +456,7 @@ spl_autoload_unregister のコールバック引数に渡すことで、 すべての autoload の登録を解除することは、推奨されなくなりました。 - 代わりに、spl_autoload_functions + 代わりに、これが必要な場合は、spl_autoload_functions の戻り値を反復処理し、 それぞれの値に対して spl_autoload_unregister をコールする必要があります。 @@ -476,9 +476,8 @@ - オブジェクトと一緒に ArrayObject と - ArrayIterator を使うことは、 + ArrayIterator をオブジェクトに対して使うことは、 推奨されなくなりました。 @@ -537,7 +536,7 @@ xml_parser_free 関数は、推奨されなくなりました。 XMLParser オブジェクトが、 - 自動でリソースを開放するためです。 + 自動で解放されるためです。 diff --git a/appendices/migration85/incompatible.xml b/appendices/migration85/incompatible.xml index aadd7ab51a..12f6caf6c9 100644 --- a/appendices/migration85/incompatible.xml +++ b/appendices/migration85/incompatible.xml @@ -42,7 +42,7 @@ gc_collect_cycles の戻り値には、 - 間接的に収集されたリソースや文字列が含まれなくなりました。 + 循環を介して間接的に収集されたリソースや文字列が含まれなくなりました。 @@ -53,7 +53,7 @@ final を指定したサブクラスにおける、 メソッドの戻り値 static は、 - self または具象クラスに置き換えられるようになりました。 + self または具象クラス名に置き換えることができるようになりました。 @@ -133,7 +133,7 @@ さまざまな PHP エンジンの想定を壊してしまうため、 disable_classes - INI ディレティブは削除されました。 + INI ディレクティブは削除されました。 @@ -199,7 +199,7 @@ Dom\HTMLCollection, Dom\DtdNamedNodeMap を clone すると、 失敗するようになりました。 - この変更で、動作しているオブジェクトが実際に失敗することはありません。 + これによって実際に動作するオブジェクトが生成されたことは、これまで一度もありませんでした。 よって、実際の影響はゼロのはずです。 @@ -350,7 +350,7 @@ PCRE - semi-deprecated 扱いになっていた、 + この拡張モジュールは、semi-deprecated 扱いになっていた コンパイルオプション PCRE2_EXTRA_ALLOW_LOOKAROUND_BSK 抜きでビルドされるようになりました。 @@ -371,7 +371,7 @@ 値渡し引数の自動ラップが廃止され、 通常の E_WARNING が発生するようになりました。 コンストラクタ引数に変数をリファレンス渡しするには、 - 配列の値にリファレンスの値を代入します: $ctor_args = [&$valByRef] + 配列の値にリファレンスを代入します: $ctor_args = [&$valByRef] @@ -448,20 +448,20 @@ posix_kill は、 process_id 引数がプラットフォームがサポートする範囲 - (符号付きまたは long）より小さいか大きい場合に + (符号付き整数または long の範囲)より小さいか大きい場合に ValueError をスローするようになりました。 posix_setpgid は、 process_id または process_group_id が 0 未満、 またはプラットフォームがサポートする範囲より大きい場合に - ValueError をスローするようになりました。 + ValueError をスローするようになりました。 posix_setrlimit は、 hard_limit または soft_limit 引数が -1 より小さい場合、 または soft_limit が hard_limit より大きい場合に - ValueError をスローします。 + ValueError をスローするようになりました。 @@ -470,11 +470,11 @@ Reflection - 無効なターゲットにアトリビュートが適用された場合、 + 無効なターゲットにアトリビュートが適用され、かつ + #[\DelayedTargetValidation] アトリビュートによって + エラーがコンパイル時から実行時に遅延された場合、 ReflectionAttribute::newInstance は、 - 内部的なアトリビュート向けに例外をスローするようになりました。 - #[\DelayedTargetValidation] を使うと、 - 発生するエラーがコンパイル時から実行時に遅延されます。 + 内部的なアトリビュートに対してエラーをスローするようになりました。 @@ -524,7 +524,7 @@ snmp2_get, snmp2_set, snmp3_get, - snmp3_set + snmp3_set、および SNMP::__construct は、 ValueError をスローするようになりました。 スローされるのは、ホスト名が長すぎたり、 @@ -544,7 +544,7 @@ パラメータが新しく追加されました。 これは、文字列と &null; を受け入れます。 &null; を渡すと、オリジナルの parse_url - ベースのメソッドになります。 + ベースの方式になります。 Uri\Rfc3986\Uri や Uri\WhatWg\Url を渡すと、 新しいバックエンドを使います。 @@ -594,9 +594,9 @@ - ArrayObject は 列挙型を受け入れなくなりました。 + ArrayObject は列挙型を受け入れなくなりました。 列挙型の $name や $value - プロパティが、PHP エンジンの想定を壊す可能性があるからです。 + プロパティを変更すると、PHP エンジンの想定を壊す可能性があるからです。 diff --git a/appendices/migration85/new-features.xml b/appendices/migration85/new-features.xml index cbccf783a3..7c03f151a5 100644 --- a/appendices/migration85/new-features.xml +++ b/appendices/migration85/new-features.xml @@ -152,7 +152,7 @@ $results = concat("a", "b"); - Fatal Error 発生時のバックトレース + 致命的なエラー発生時のバックトレース (Maximum execution time exceeded のような) 致命的なエラーにも、 @@ -163,22 +163,22 @@ $results = concat("a", "b"); - final プロパティと、コンストラクタのプロモーション + final プロパティに対するコンストラクタのプロモーション - final なプロパティも、 + final なプロパティにも、 - コンストラクタでプロパティに昇格 させることができるようになりました。 + コンストラクタのプロモーション を使えるようになりました。 - 定数式をキャスト + 定数式でのキャスト - 定数式をキャストできるようになりました。 + 定数式でキャストできるようになりました。 @@ -194,14 +194,13 @@ print T1 . PHP_EOL; // Prints "0" - Clone キーワードへの変更 + clone 関数 - clone キーワード - は、関数のように振る舞うようになりました。 - そして、読み取り専用プロパティに clone して値を再代入する際に、 - 新しく $withProperties - パラメータが使えるようになりました + clone 言語構造 + は、関数になりました。 + そして、新しい $withProperties パラメータにより、 + clone の際に (読み取り専用) プロパティへ値を再代入できるようになりました。 @@ -214,7 +213,7 @@ print T1 . PHP_EOL; // Prints "0" cURL - 複数のリクエストにまたがって持続する + 複数の PHP リクエストにまたがって持続する CurlSharePersistentHandle のサポートが追加されました。 これを使うと、より効率的な接続の再利用が安全にできるようになります。 @@ -238,8 +237,8 @@ print T1 . PHP_EOL; // Prints "0" CURLINFO_HTTPAUTH_USED と CURLINFO_PROXYAUTH_USED は、 - 直近の転送で HTTP および、プロキシ経由の認証メソッドを示す情報を、 - ビットマスクで返します。利用可能な値は、 + 直近のリクエストで使われた HTTP 認証方法とプロキシ認証方法を示す + ビットマスクを返します。利用可能な値は、 CURLAUTH_* を参照ください。 @@ -248,7 +247,7 @@ print T1 . PHP_EOL; // Prints "0" CURLOPT_INFILESIZE を安全に置き換えられる、 CURLOPT_INFILESIZE_LARGE が追加されました。 特定のシステムでは、たとえ 64bit システムであっても、 - CURLOPT_INFILESIZE は 32bit の符号付き整数(2.0 Gib) + CURLOPT_INFILESIZE は、ファイルサイズとして 32bit の符号付き整数(2.0 GiB) しか受け入れない場合があります。 CURLOPT_INFILESIZE_LARGE は、 システムが扱える整数の最大値を受け入れます。 @@ -323,7 +322,7 @@ print T1 . PHP_EOL; // Prints "0" EXIF - OffsetTime* Exif タグが追加されました。 + OffsetTime* Exif タグのサポートが追加されました。 @@ -367,14 +366,14 @@ print T1 . PHP_EOL; // Prints "0" IntlListFormatter クラスが追加されました。 - これは、指定されたロケールで項目のリストをフォーマット、順序付け、 - 句読点を付ける操作を行うためのものです。 + これは、指定されたロケールで項目のリストのフォーマット、順序付け、 + 句読点の付与を行うためのものです。 クラス定数として、IntlListFormatter::TYPE_AND, IntlListFormatter::TYPE_OR, - IntlListFormatter::TYPE_UNITS 演算子と、 + IntlListFormatter::TYPE_UNITS オペランドと、 IntlListFormatter::WIDTH_WIDE, IntlListFormatter::WIDTH_SHORT, - IntlListFormatter::WIDTH_NARROW があります。 + IntlListFormatter::WIDTH_NARROW 幅があります。 このクラスは ICU 67 以降でサポートされます。 @@ -398,7 +397,7 @@ print T1 . PHP_EOL; // Prints "0" 接続する際の属性として、 - Pdo\Sqlite::ATTR_TRANSACTION_MODE を追加しました。 + Pdo\Sqlite::ATTR_TRANSACTION_MODE が追加されました。 これに指定可能な値は、 Pdo\Sqlite::TRANSACTION_MODE_DEFERRED, Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE, @@ -470,17 +469,18 @@ print T1 . PHP_EOL; // Prints "0" getimagesize が返す配列に、 - 2つエントリが追加されました: "width_unit" と + 2つのエントリが追加されました: "width_unit" と "height_unit" です。 これらは、寸法がどの単位で表現されているかを示します。 これらの単位は px がデフォルトですが、 必ずしも同じ単位であるとは限りません - (一例を挙げると、片方が cm で、もう片方が px である場合があります) + (一例を挙げると、片方が cm で、もう片方が px である場合があります)。 setcookie と setrawcookie 関数が、"partitioned" キーをサポートしました。 + @@ -490,7 +490,7 @@ print T1 . PHP_EOL; // Prints "0" RFC 3986 と WHATWG URL に従い、 - URI と URL を処理するのに使える拡張モジュールが追加されました。 + URI と URL を処理するのに使える uri 拡張モジュールが追加されました。 これは、常に有効になっています。 @@ -505,10 +505,11 @@ print T1 . PHP_EOL; // Prints "0" XSLTProcessor::setParameter, XSLTProcessor::removeParameter の namespace 引数は、 - 空でなくても動作するようになりました。 + 空として扱われるのではなく、実際に動作するようになりました。 動作するのは、name 引数が Clark 記法でなく、かつ - QName 形式でもない場合です。 - これらの場合は、名前空間が href または prefix からそれぞれ取得されるためです。 + QName 形式でもない場合だけです。 + Clark 記法または QName 形式の場合は、名前空間が href または prefix から + それぞれ取得されるためです。 diff --git a/appendices/migration85/other-changes.xml b/appendices/migration85/other-changes.xml index 3fc3c55b72..65f8932791 100644 --- a/appendices/migration85/other-changes.xml +++ b/appendices/migration85/other-changes.xml @@ -433,9 +433,9 @@ - 起動時にのみ有効な、max_memory_limit INI ディレクティブが追加されました。 + 起動時にのみ設定可能な、max_memory_limit INI ディレクティブが追加されました。 これは、起動時または実行時に設定可能な memory_limit の最大値を制御するためのものです。 - この値を超えると、-1 を設定しない限り警告が発生し、 + この値を超えると、max_memory_limit が -1 に設定されていない限り警告が発生し、 memory_limit の値が、超過した値の代わりに現在の max_memory_limit の値に設定されます。 diff --git a/appendices/migration85/windows-support.xml b/appendices/migration85/windows-support.xml index f0b757865c..d7125f4ab9 100644 --- a/appendices/migration85/windows-support.xml +++ b/appendices/migration85/windows-support.xml @@ -11,13 +11,13 @@ PHP_VERSION, PHP_MINOR_VERSION, PHP_RELEASE_VERSION の設定値は、常に数値になりました。 - これより前のバージョンでは、buildconf のビルド設定用の文字列でした。 + これより前のバージョンでは、buildconf を使ったビルドでは文字列でした。 phpize ビルドは、 - (in-tree ビルドで既に動作していたかのように) - build dir 内のソースツリーを反映するようになりました。 + ソースツリーを build dir 内に反映するようになりました + (in-tree ビルドでは、これまでも同様でした)。 拡張モジュールによっては、 (特に Makefile.frag.w32 を使う場合) 調整が必要かもしれません。 @@ -27,7 +27,7 @@ MSVC ビルド向けに、 がサポートされるようになりました。 - これによって、ASan とデバッグのアサーションが有効になります。 + これによって、ASan とデバッグ用のアサーションが有効になります。 このオプションは MSVC 16.10 と Windows 10 以降でサポートされます。 @@ -35,7 +35,7 @@ clang ビルド向けの 設定オプションは、サポートされなくなりました。 - CFLAGS 経由で警告を抑制してください。 + 代わりに、抑制したい警告を CFLAGS 経由で選択してください。 @@ -48,7 +48,7 @@ デフォルトで共有ライブラリとしてビルドされるようになりました。 これより前のバージョンでは、 デフォルトで static な拡張モジュールとしてビルドされていましたが、 - 公式の Windows 用バイナリは、共有ライブラリとしてビルドされていました。 + 公式の Windows 用バイナリでは、この拡張モジュールが共有ライブラリとしてビルドされていました。 @@ -69,14 +69,14 @@ Streams - パイプストリームが read - 配列のみに存在し、かつ write と + read 配列に含まれるのがパイプストリームのみで、 + かつ write と except 配列が空の場合、 stream_select は、 POSIX システムと似た振る舞いをするようになりました。 つまり、少なくとも1つのパイプが読み取り可能になった場合、 またはタイムアウトした後にのみ、関数から戻ります。 - これより前のバージョンでは、この関数は直ちに返り、 + これより前のバージョンでは、stream_select は直ちに返り、 すべてのストリームが読み取り可能であると報告していました。 diff --git a/appendices/reserved.constants.core.xml b/appendices/reserved.constants.core.xml index eaf7c871df..f71c3ade06 100644 --- a/appendices/reserved.constants.core.xml +++ b/appendices/reserved.constants.core.xml @@ -653,7 +653,7 @@ Windows の - + CTRL C @@ -670,7 +670,7 @@ Windows の - + CTRL BREAK diff --git a/chapters/intro.xml b/chapters/intro.xml index 80c40ad4c2..f25f5f650c 100644 --- a/chapters/intro.xml +++ b/chapters/intro.xml @@ -148,8 +148,8 @@ を使う CouchDB のような例もあります。 - PHP は、IMAP、SNMP、NNTP、POP3、HTTP、COM (Windowsのみ) やその他 - 数え切れない程多くのプロトコルを用いる他のサービスの状態を追跡する + PHP は、LDAP、IMAP、SNMP、NNTP、POP3、HTTP、COM (Windowsのみ) やその他 + 数え切れない程多くのプロトコルを用いて他のサービスと通信を行う 機能もサポートしています。低レベルのネットワークソケットをオープンし、 他のプロトコルを用いて通信を行うことも可能です。 diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 7f21d61f36..f5f471d230 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -143,6 +143,7 @@ php -S localhost:8000 xlink:href="&url.phpeditorlist;">PHP エディタのリスト で整理されています。あるエディタを推薦したい場合、上記のページを訪れ、 ページの管理者にそのエディタをリストに加えてくれないかとたずねてみてください。 + シンタックスハイライト機能を備えたエディタを使うと便利でしょう。 diff --git a/install/fpm/configuration.xml b/install/fpm/configuration.xml index a5ee013f36..9efa9991c5 100644 --- a/install/fpm/configuration.xml +++ b/install/fpm/configuration.xml @@ -396,9 +396,9 @@ static - 子プロセスの数は固定 (pm.max_children) です。 - ondemand - プロセスを必要に応じて立ち上げます。 - dynamic とは対照的に、リクエストされると - pm.start_servers で指定しただけサービスを開始します。 + ondemand - プロセスを必要に応じて (リクエストされたときに) 立ち上げます。 + サービス起動時に pm.start_servers 個のプロセスを起動する + dynamic とは対照的です。 dynamic - 子プロセスの数は、 diff --git a/install/unix/apache2.xml b/install/unix/apache2.xml index e36342edf9..deb1b33f09 100644 --- a/install/unix/apache2.xml +++ b/install/unix/apache2.xml @@ -176,7 +176,7 @@ cp php.ini-development /usr/local/lib/php.ini - php.ini-developmentent ではなく、php.ini-production を使用する場合は、PHP の + php.ini-development ではなく、php.ini-production を使用する場合は、PHP の 動作が変化しますので、ファイル中に記載されている変更点の一覧を確認する ようにしてください。 @@ -297,8 +297,8 @@ FallbackResource /index.php - mod_rewrite を使うと、.php ファイルに名前を変えたりコピーしたりしなくても - 任意の .phps ファイルを構文ハイライトつきのソースコードとして表示させることができます。 + mod_rewrite を使うと、.phps ファイルに名前を変えたりコピーしたりしなくても + 任意の .php ファイルを構文ハイライトつきのソースコードとして表示させることができます。 diff --git a/install/windows/index.xml b/install/windows/index.xml index d2d85c7d82..2bed5e9973 100644 --- a/install/windows/index.xml +++ b/install/windows/index.xml @@ -5,7 +5,7 @@ Windows システムへのインストール - Windows 版の PHP の公式リリースは、実運用環境でも使えるものです。 + Windows 版の PHP の公式リリースは、実運用環境での使用が推奨されています。 しかし、PHP を ソースコードからビルド することもできます。 @@ -14,8 +14,8 @@ PHP は Azure App Services - (aka Microsoft Azure, Windows Azure, (Windows) Azure Web Apps) - 上でもインストールできます。 + (Microsoft Azure、Windows Azure、あるいは (Windows) Azure Web Apps とも呼ばれます) + にもインストールできます。 diff --git a/language-snippets.ent b/language-snippets.ent index 51e9a52c51..69dafd7d29 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1372,7 +1372,7 @@ $font = 'SomeFont'; 内部文字エンコーディングを使用します。'> 信頼できない入力に対しては、 -絶対に e 修正子を使用してはいけません。 +絶対に e 修飾子を使用してはいけません。 (preg_replace と同様、) 自動的なエスケープは行いません。 このことを忘れていると、自分の書いたアプリケーションにリモートコード実行の脆弱性を作りこんでしまうことになります。'> diff --git a/language/constants.xml b/language/constants.xml index 48aefcb400..f535834bd0 100644 --- a/language/constants.xml +++ b/language/constants.xml @@ -224,13 +224,6 @@ echo ANIMALS_DEF[1] . "\n"; // 出力は "cat" - - - PHP 8.0.0 より前のバージョンでは、define 関数を使って定義された定数は、 - 大文字小文字を区別しません。 - - - &reftitle.seealso; diff --git a/language/control-structures/continue.xml b/language/control-structures/continue.xml index 041d526459..4d0113d13e 100644 --- a/language/control-structures/continue.xml +++ b/language/control-structures/continue.xml @@ -9,7 +9,7 @@ continue は、ループ構造において現在の繰り返しループ の残りの処理をスキップし、条件式を評価した後に - 次の繰り返しの最初から実行を続けるために使用されます、 + 次の繰り返しの最初から実行を続けるために使用されます。 diff --git a/language/control-structures/declare.xml b/language/control-structures/declare.xml index a6c977a76e..eb19cd8907 100644 --- a/language/control-structures/declare.xml +++ b/language/control-structures/declare.xml @@ -55,8 +55,8 @@ declare(ticks=TICK_VALUE); ディレクティブ に何が指定されたかに依存します。 - declare 文はグローバルスコープとしても使用され、 - それはそれ以降のコード上の全てにおいて影響します + declare 文はグローバルスコープでも使用でき、 + それ以降のコード全てに影響します (しかし、declare を含むファイルがインクルードされた場合は、 親ファイルにはその影響は及びません)。 @@ -84,12 +84,12 @@ declare(ticks=1); N個の低レベル tick 可能な文を実行するごとに 発生するイベントのことです。Nの値は declareブロックのディレクティブの箇所で - ticks=Nのように + ticks=Nのように 指定します。 すべての文が tick 可能なわけではありません。 - たとえば条件式や引数式などは tick できません。 + 通常、条件式や引数式などは tick できません。 tickごとに発生させるイベントはregister_tick_function diff --git a/language/control-structures/else.xml b/language/control-structures/else.xml index 74ecd5a2ff..864f7eda54 100644 --- a/language/control-structures/else.xml +++ b/language/control-structures/else.xml @@ -15,7 +15,7 @@ 実行するようにif文を拡張します。 例えば、次のコードは、$aが $bよりも大きい場合に - aはbより大きいと表示し、 + aはbよりも大きいと表示し、 そうでない場合に、 aはbよりも大きくないと表示します。 diff --git a/language/control-structures/elseif.xml b/language/control-structures/elseif.xml index 1ebc44b1b5..3314ca73e3 100644 --- a/language/control-structures/elseif.xml +++ b/language/control-structures/elseif.xml @@ -14,8 +14,8 @@ しかし、elseとは異なり、elseif式が &true;の場合にのみ代わりの式を実行します。 例えば、次のコードは、aはbより大きい、 - aはbに等しい、 - aはbより小さいを出力します。 + aはbと等しい、 + aはbより小さいのいずれかを出力します。 各繰り返しの開始時に、式2が評価されます。 - その式の値が&true;が場合、ループは継続され、括弧 + その式の値が&true;の場合、ループは継続され、括弧 内の文が実行されます。値が&false;の場合、ループの 実行は終了します。 @@ -122,7 +122,6 @@ for ($i = 1, $j = 0; $i <= 10; $j += $i, print $i . " ", $i++); PHPは、forループ用に"コロン構文"もサポートします。 - for loops. 以下のように、list - を埋めるだけの十分な要素数が配列にない場合、警告が発生します: + を埋めるだけの十分な要素数が配列にない場合、notice が発生します: - What's the worse thing that could happen if you use goto? + goto を使うと起こりうる最悪の事態とは？ diff --git a/language/control-structures/if.xml b/language/control-structures/if.xml index f961f895d8..53ab4c9d94 100644 --- a/language/control-structures/if.xml +++ b/language/control-structures/if.xml @@ -57,7 +57,7 @@ aはbより大きい 代わりに、複数の文をグループ化することができます。 例えば、このコードは、$a が $b よりも大きい場合に - aはbよりも大きいを表示し、 + aはbより大きいを表示し、 $a の値を $b に 代入します。 diff --git a/language/control-structures/include.xml b/language/control-structures/include.xml index 26ed5f938c..c95a1f614b 100644 --- a/language/control-structures/include.xml +++ b/language/control-structures/include.xml @@ -126,7 +126,9 @@ echo "A $color $fruit"; // A green "URL include ラッパー"が 有効になっている場合、ローカルなパス名 - の代わりにURL(HTTP経由)を用いて読み込むファイルを指定することが可能です。 + の代わりにURL(HTTP、またはその他サポートされているラッパー経由。 + プロトコルの一覧はを参照ください)を用いて + 読み込むファイルを指定することが可能です。 URLで指定されたサーバーがファイルをPHPコードとして解釈することが 出来る場合には、HTTP GETを使用してURLリクエストに引数を指定することが 出来ます。これはファイルの読み込み云々やスコープの継承とは関係なく、 diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml index 692542b6ec..14ab5b3eab 100644 --- a/language/control-structures/match.xml +++ b/language/control-structures/match.xml @@ -30,7 +30,7 @@ $return_value = match (制約式) { - 基本式な <literal>match</literal> 式の使い方 + 基本的な <literal>match</literal> 式の使い方 switch 文のように、 match 式はマッチさせる分岐をひとつひとつ実行します。 はじめは、コードは何も実行されません。 - 以前のすべての条件式が、制約式とマッチしなかった場合に条件式が実行されます。 - 条件式に一致する式が評価された場合に、返却式が評価されます。 + 以前のすべての条件式が、制約式とマッチしなかった場合にのみ、条件式が評価されます。 + マッチした条件式に対応する返却式のみが評価されます。 たとえば、以下のようになります: diff --git a/language/control-structures/switch.xml b/language/control-structures/switch.xml index c7561b95bf..8bf90d5372 100644 --- a/language/control-structures/switch.xml +++ b/language/control-structures/switch.xml @@ -31,7 +31,7 @@ - 次の二つの例は、同じことを二つの異なった方法で書いたものです。 + 以下の例では、それぞれのコードブロックが等価です。 一つは、if と elseif文を、 もう一つはswitch文を使っています。 どちらも、出力は同じです。 @@ -191,7 +191,7 @@ iは0,1,2に等しくない - 複数の default を置くと、 + 複数の default を置くと、 E_COMPILE_ERROR エラーが発生します。 @@ -200,7 +200,7 @@ iは0,1,2に等しくない 技術的には、 default は switch 文の中のどの位置でも置くことができます。 - default は他の case にマッチしなかった場合に使われるものです。 + default は他の case にマッチしなかった場合に使われるものです。 しかし、規約上は最後に置くのが一番です。 @@ -223,6 +223,7 @@ iは0,1,2に等しくない diff --git a/language/control-structures/while.xml b/language/control-structures/while.xml index 1c076d993c..f6ad51e158 100644 --- a/language/control-structures/while.xml +++ b/language/control-structures/while.xml @@ -23,7 +23,7 @@ while (式) while文は、式の値が&true;である間、 入れ子の文を繰り返し実行することをPHPに指示します。 式の値は各反復処理の開始時にチェックされるので、ループ内の文の実行により - この値が変わった場合でもループ実行は各ループを終るまで終わりません。 + この値が変わった場合でもループの実行はその反復が終わるまで停止しません。 (PHPによるループ内の文の実行が1回分の反復に相当します) while式の値がはじめから&false;の 場合は、内部の文は一回も実行されません。 diff --git a/language/enumerations.xml b/language/enumerations.xml index 5155d784ef..9bed585c83 100644 --- a/language/enumerations.xml +++ b/language/enumerations.xml @@ -19,7 +19,7 @@ 様々な異なる機能があります。 PHP では、列挙型は特別な種類のオブジェクトです。 列挙型そのものはクラスですし、そこで定義される case は全て、 - そのクラスのインスタンスです。 + そのクラスのシングルトンオブジェクトです。 これは、列挙型で定義される case は有効なオブジェクトであり、 型チェックを含む、オブジェクトが使えるあらゆる場所で使えるということです。 @@ -102,7 +102,7 @@ pick_a_card('Spades'); 列挙型は、0個以上の case を定義できます。 - case を定義する数に上限はありません。 + case を定義する数に上限はありません。 case が0個の列挙型も文法的には有効ですが、役に立ちません。 @@ -151,9 +151,9 @@ if ($a !== 'Spades') { - このことは、列挙型の値は決して + このことは、列挙型の値同士が決して < や > - で比較できないことも意味しています。 + の関係にならないことも意味しています。 なぜなら、それらの比較をオブジェクトで行っても無意味だからです。 列挙型の値を使ってこれらの比較を行っても、常に &false; を返します。 @@ -211,7 +211,7 @@ print Suit::Spades->name; 値に依存した列挙型(Backed Enum) - デフォルトでは、列挙型はスカラー値の情報を持っていません。 + デフォルトでは、列挙型の case はスカラー値の情報を持っていません。 単なるシングルトンオブジェクトです。 しかし、列挙型の case をデータベースや、 類似のデータストアで読み書きする必要があるケースが多くあります。 @@ -246,7 +246,7 @@ enum Suit: string - Backed Enum は、整数、または文字列の値を持つことができます。 + Backed Enum は、int、または string の値を持つことができます。 そして、単一の列挙型が一度に持つことの出来る型はひとつだけです (つまり、int|string のような union 型はサポートしていないということです)。 @@ -267,8 +267,8 @@ enum Suit: string PHP 8.2.0 より前のバージョンでは、 スカラー値はリテラルか、リテラルを表す式でなければいけませんでした。 これは、定数や定数式はサポートされていなかったことを意味します。 - つまり、1 + 1 は許されますが、 - 1 + SOME_CONST は許されていませんでした。 + つまり、1 + 1 は許されていましたが、 + 1 + SOME_CONST は許されていませんでした。 @@ -325,7 +325,7 @@ $ref = &$suit->value; Backed Enum は内部的に BackedEnum インターフェイスを実装しています。 - このメソッドは、以下の2つのメソッドを公開しています: + このインターフェイスは、以下の2つの追加のメソッドを公開しています: @@ -353,10 +353,10 @@ $ref = &$suit->value; from() と tryFrom() メソッドは、標準の 弱い/強い 型付けのルールに従います。 弱い型付けのルールでは、整数または文字列を受け入れ、 - システムは値をそれに従って自動変換します。 - 厳密な型付けモードの場合、文字列型の Backed Enum に整数値を渡す + システムは値をそれに従って自動変換します。float を渡した場合も同様に動作し、変換されます。 + 厳密な型付けモードの場合、文字列型の Backed Enum の from() に整数値を渡す (またはその逆をする) と、TypeError が発生します。 - float についても、全ての場合に同じ型付けのルールに従います。 + float についても、あらゆる場合に同様に TypeError になります。 それ以外の型については、どちらのモードでも TypeError が発生します。 @@ -463,7 +463,7 @@ print Suit::Diamonds->shape(); // "Rectangle" と表示 全てふたつのメソッド color() と shape() を持ちます。 コードの呼び出しと型チェックに限れば、 - これらのメソッドは他のオブジェクトのインスタンスと全く同じ振る舞いをします。 + これらのインスタンスは他のオブジェクトのインスタンスと全く同じ振る舞いをします。 @@ -658,7 +658,7 @@ var_dump(Size::Huge); 列挙型におけるトレイトは、クラスにおけるそれと同じ振る舞いをします。 注意すべきことは、列挙型で use されるトレイトには、プロパティが含まれていてはいけないという点です。 - use されるトレイトには、 + そのトレイトには、 メソッドと static メソッドと、定数だけを含めることができます。 プロパティを持つトレイトの場合、致命的なエラーが発生します。 @@ -716,15 +716,15 @@ var_dump($suit->shape()); つまり、プロパティのデフォルト値や、 static 変数のデフォルト値、パラメータのデフォルト値、 グローバル定数やクラス定数の値として使えます。 - 列挙型の case 以外の値は使えませんが、 + 他の列挙型の case の値としては使えませんが、 通常の定数は、列挙型の case を参照できます。 - しかしながら、列挙型の中で ArrayAccess - のような暗黙のマジックメソッドの呼び出しを行うことは、 + しかしながら、列挙型に対する ArrayAccess + のような暗黙のマジックメソッドの呼び出しは、 定数や static な定義では許されません。 - なぜなら、結果の値が保証できなくなりますし、 + なぜなら、結果の値が決定的であることを保証できませんし、 副作用がまったくないことも保証できないからです。 関数コールやメソッドコール、そしてプロパティへのアクセスは、 引き続き定数式では不正な操作として扱われます。 @@ -766,7 +766,7 @@ class Foo // これは、許されています。 const DOWN = Direction::Down; - // これは、許可されません。結果の値が保証できない可能性があります。 + // これは、許可されません。結果の値が決定的でない可能性があるからです。 const UP = Direction::Up['short']; // Fatal error: Cannot use [] on enums in constant expression } @@ -835,7 +835,7 @@ $foo = new Foo(); 任意の名前空間を含んだ型の名前として評価されます。 これはオブジェクトと全く同じです。 case インスタンスにおける ::class も、 - 列挙型として評価されます。これは、その型のインスタンスの場合と同じです。 + 列挙型として評価されます。case インスタンスは、その列挙型のインスタンスだからです。 @@ -911,8 +911,8 @@ var_dump(SuitBacked::cases()); 列挙型は、オブジェクトとは違う形でシリアライズされます。 - 特別に、列挙型には case 名を指定する新しいシリアライズコード - "E" が付与されています。 + 具体的には、列挙型には case 名を指定する新しいシリアライズコード + "E" が付与されています。 アンシリアライズのルーチンはそれを使って、 既存のシングルトンの値を変数に設定できます。 これにより、以下のようなコードが動作することが保証されます: @@ -1045,7 +1045,7 @@ enum ErrorCode function quux(ErrorCode $errorCode) { - // 以下のようなコードを書くと、全ての case をカバーします + // このコードを書いた時点では、全ての case をカバーしているように見えます match ($errorCode) { ErrorCode::SOMETHING_BROKE => true, }; @@ -1091,7 +1091,7 @@ fot(MoreErrorCode::PEBKAC); 上のコードの問題点は、 quux() 関数の &match; 式が全ての case をカバーしてはいないということです。 なぜなら、MoreErrorCode::PEBKAC - がカバーされていないので、&match; 式が例外をスローするからです。 + がカバーされていないので、match 式が例外をスローするからです。 @@ -1181,7 +1181,7 @@ var_dump($status->label()); これら4つの値は、それぞれ label() メソッドを持ちます。 これは、人間が読みやすい文字列を返します。 - この文字列は、"マシン上の" スカラー値とは別のものです。 + この文字列は、"機械向けの名前" にあたるスカラー値とは別のものです。 このスカラー値は、データベースのフィールドや、 HTML の select ボックスで使うことができます。 diff --git a/language/exceptions.xml b/language/exceptions.xml index 61cbc973ed..78d9703735 100644 --- a/language/exceptions.xml +++ b/language/exceptions.xml @@ -334,6 +334,8 @@ string(11) "MyException" 関数は、function キーワードと関数の名前、 - カンマ(,) で区切ったパラメーターのリスト + カンマ(,) で区切ったパラメータのリスト （空であっても構いません）を括弧で囲み、 関数の本体を波括弧で囲んだものを続けて定義します。 たとえば、以下のようになります: @@ -31,7 +31,7 @@ function foo($arg_1, $arg_2, /* ..., */ $arg_n) PHP 8.0.0 以降では、 - パラメーターのリストの末尾に、カンマを付加できるようになっています: + パラメータのリストの末尾に、カンマを付加できるようになっています: - 関数のパラメーターと引数 + 関数のパラメータと引数 - 関数のパラメーターは、関数のシグネチャの中で宣言します。 + 関数のパラメータは、関数のシグネチャの中で宣言します。 引数のリストにより関数へ情報を渡すことができます。 このリストは、カンマで区切られた式のリストです。 引数の評価は、関数が実際にコールされる前に、 左から右の順番で行われ、 - 評価された結果が関数のパラメーターに代入されます + 評価された結果が関数のパラメータに代入されます (先行評価)。 @@ -235,13 +235,13 @@ $v = foo( - PHP 8.0.0 以降では、関数のパラメーターリストの最後にカンマをつけることができます。 + PHP 8.0.0 以降では、関数のパラメータリストの最後にカンマをつけることができます。 このカンマは無視されます。 これは、パラメータリストや変数名が長かったりした場合に、 パラメータを縦に並べるのに便利です。 - 関数のパラメーターリストの最後にカンマを付ける + 関数のパラメータリストの最後にカンマを付ける 関数の引数を常にリファレンス渡しとしたい場合には、関数定義において - アンパサンド(&) をパラメーター名の前に付加することができます。 + アンパサンド(&) をパラメータ名の前に付加することができます。 @@ -295,12 +295,12 @@ echo $str; // 出力は 'This is a string, and something extra.' となりま - デフォルトのパラメーター値 + デフォルトのパラメータ値 関数は、変数に代入する記法に似たやり方で、 - デフォルト値をパラメーターに定義することができます。 - デフォルト値はパラメーターに引数が指定されなかった場合に使われますが、 + デフォルト値をパラメータに定義することができます。 + デフォルト値はパラメータに引数が指定されなかった場合に使われますが、 &null; を渡した場合はデフォルト値を代入 しない ことに特に注意して下さい。 @@ -351,6 +351,13 @@ echo makecoffee(); echo makecoffee(array("cappuccino", "lavazza"), "teapot"); ]]> + &example.outputs; + + + @@ -361,12 +368,12 @@ echo makecoffee(array("cappuccino", "lavazza"), "teapot"); + &example.outputs; + + + @@ -392,7 +406,7 @@ echo makecoffee(new FancyCoffeeMaker); - 関数のパラメーターのデフォルト値の 間違った使用法 + 関数のパラメータのデフォルト値の 間違った使用法 - 関数のパラメーターのデフォルト値の 正しい使用法 + 関数のパラメータのデフォルト値の 正しい使用法 PHP 8.0.0 以降では、 - デフォルト値を指定したパラメーターの後に、 - 必須のパラメーターを宣言することは 推奨されません。 + デフォルト値を指定したパラメータの後に、 + 必須のパラメータを宣言することは 非推奨です。 なぜなら、そのデフォルト値は絶対に使われないからです。 これは、デフォルト値を削除することで解決できます。 このルールの唯一の例外は、 - Type $param = null と書かれたパラメーターです。 + Type $param = null と書かれたパラメータです。 &null; をデフォルトにすることは、 型が暗黙のうちに nullable であることを示しています。 この使い方はPHP 8.4.0で非推奨となり、代わりに明示的な nullable 型 を使用する必要があります。 - デフォルト値を指定したパラメーターは、必須のパラメーターの後に宣言する + デフォルト値を指定したパラメータは、必須のパラメータの後に宣言する - リファレンス渡しのパラメーターにもデフォルト値を指定できます。 + リファレンス渡しのパラメータにもデフォルト値を指定できます。 @@ -524,7 +538,7 @@ function bar(?A $a, $b) {} // 推奨される書き方です。 - パラメーターリストに + パラメータリストに ... トークンを含めることで、 その関数が可変長の引数を受け取ることを示せます。 引数は、指定した変数に配列として渡されます: @@ -583,7 +597,7 @@ echo add(...$a); - 通常のパラメーターを、... の前に指定することもできます。 + 通常のパラメータを、... の前に指定することもできます。 この場合は、通常の引数リストにマッチしなかったのこりの引数が ... による配列に追加されます。 diff --git a/language/generators.xml b/language/generators.xml index 8956934cbf..3738926252 100644 --- a/language/generators.xml +++ b/language/generators.xml @@ -354,7 +354,7 @@ foreach (gen_reference() as &$number) { iterator_to_array を使う場合に問題になることがよくあります。 - この関数はデフォルトで数値添字配列を返すので、予期せぬ結果を引き起こす可能性があります。 + この関数はデフォルトでキーを保持した配列を返すので、予期せぬ結果を引き起こす可能性があります。 iterator_to_array には二番目のパラメータ preserve_keys があり、これを &false; にすれば、Generator が返すキーを無視してすべての値を取得できます。 diff --git a/language/namespaces.xml b/language/namespaces.xml index 9f3b4ef9d8..e3448dc525 100644 --- a/language/namespaces.xml +++ b/language/namespaces.xml @@ -41,7 +41,9 @@ - 最初の問題を解決するためには、Extra_Long_Names のような長い名前をつけなければならない + 最初の問題を緩和するために用意された Extra_Long_Names のような長い名前を、 + エイリアスで参照する (または短縮する) ことで、 + ソースコードの可読性を向上させること @@ -1383,11 +1385,11 @@ print strlen('hi') . "\n"; // "foo\strlen" が存在しないので、グロー $arr = array(1,3,2); $b = sort($arr); // "foo\sort" 関数をコールします var_dump($b); -foo(); // calls function "foo\foo" - import is not applied +foo(); // "foo\foo" 関数をコールします - インポートは適用されません -$a = FOO; // sets $a to value of constant "foo\FOO" - import is not applied +$a = FOO; // 定数 "foo\FOO" の値を $a に設定します - インポートは適用されません print $a; -$b = INI_ALL; // sets $b to value of global constant "INI_ALL" +$b = INI_ALL; // グローバル定数 "INI_ALL" の値を $b に設定します print $b; ]]> diff --git a/language/oop5/abstract.xml b/language/oop5/abstract.xml index 218eda12f8..a6892a1f3f 100644 --- a/language/oop5/abstract.xml +++ b/language/oop5/abstract.xml @@ -45,7 +45,7 @@ abstract class AbstractClass abstract protected function getValue(); abstract protected function prefixValue($prefix); - // Common method + // 共通のメソッド public function printOut() { print $this->getValue() . "\n"; diff --git a/language/oop5/basic.xml b/language/oop5/basic.xml index 9e1d3e7c54..15c4f7b26c 100644 --- a/language/oop5/basic.xml +++ b/language/oop5/basic.xml @@ -141,8 +141,8 @@ Stack trace: 宣言されている全ての プロパティに対して readonly を指定した ことになり、 かつ 動的なプロパティ の作成を禁止したことになります。 さらに、AllowDynamicProperties - アトリビュートを指定しても動的なプロパティを作成できなくなります。 - 動的なプロパティを作成しようとすると、コンパイル時にエラーが発生します。 + アトリビュートを使って動的なプロパティのサポートを追加することもできません。 + このアトリビュートを指定しようとすると、コンパイル時にエラーが発生します。 @@ -739,7 +739,7 @@ NS\ClassName ::class によるクラス名の解決は、コンパイル時の変換です。 つまり、クラス名を作るタイミングでは、まだオートロードが行われていないということです。 - 結果的に、クラスがまだ存在しない時点でクラス名が展開されることになります。 + 結果的に、クラスが存在しない場合でもクラス名が展開されることになります。 この場合にはエラーは発生しません。 diff --git a/language/oop5/constants.xml b/language/oop5/constants.xml index ec0a493249..956e4d6eca 100644 --- a/language/oop5/constants.xml +++ b/language/oop5/constants.xml @@ -126,7 +126,7 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in … - PHP 8.3.0 以降で行われる、クラス定数のアクセス権の関係チェック + PHP 8.3.0 以降で行われる、クラス定数のアクセス権の変性チェック - PHP 8.3.0 以降では、アクセス権の関係がより厳密にチェックされるようになりました。 + PHP 8.3.0 以降では、アクセス権の変性がより厳密にチェックされるようになりました。 これより前のバージョンでは、 - クラス定数のアクセス権は、インターフェイスを実装した側の定数のそれと異なっていても問題ありませんでした。 + クラス定数のアクセス権は、実装しているインターフェイス側の定数のそれと異なっていても問題ありませんでした。 diff --git a/language/oop5/interfaces.xml b/language/oop5/interfaces.xml index e39c5a5577..c9e4a2dcc5 100644 --- a/language/oop5/interfaces.xml +++ b/language/oop5/interfaces.xml @@ -48,7 +48,7 @@ インターフェイスは、 マジックメソッド - を宣言しても問題ありません。 + を定義できます。定義すると、実装するクラスにそれらのメソッドの実装を要求できます。 @@ -97,7 +97,7 @@ シグネチャの互換性に関するルール を守った形で、インターフェイス内の全てのメソッドを宣言しなければいけません。 クラスは、同じ名前のメソッドを定義した複数のインターフェイスを実装することが出来ます。 - この場合、実装されるメソッドは全て、 + この場合、その実装は全てのインターフェイスについて シグネチャの互換性に関するルール に従わなければいけません。 そうすることで、共変性と反変性 @@ -295,7 +295,7 @@ class D implements B - 共変性を保った形で、複数のインターフェイスを実装する + 複数のインターフェイスにおける変性の互換性 - クラスのプロパティを宣言する代替の方法として、 - var キーワードを使う方法があります。 + クラスのプロパティを宣言する古い方法として、 + アクセス権などのキーワードの代わりに var キーワードを使う書き方があります。 @@ -230,7 +230,7 @@ $test = new Test("foobar"); // 正しいプロパティの読み取り var_dump($test->prop); // string(6) "foobar" -// 不正な再代入です。同じ値を代入することは問題ありません。 +// 不正な再代入です。代入する値が同じであっても関係ありません。 $test->prop = "foobar"; // Error: Cannot modify readonly property Test::$prop ?> diff --git a/language/oop5/visibility.xml b/language/oop5/visibility.xml index d7ab551e7e..1dc057e9c8 100644 --- a/language/oop5/visibility.xml +++ b/language/oop5/visibility.xml @@ -47,8 +47,8 @@ class MyClass $obj = new MyClass(); echo $obj->public; // 動作します -echo $obj->protected; // Fatal エラー -echo $obj->private; // Fatal エラー +echo $obj->protected; // 致命的なエラー +echo $obj->private; // 致命的なエラー $obj->printHello(); // Public、Protected そして Private を表示します @@ -72,7 +72,7 @@ class MyClass2 extends MyClass $obj2 = new MyClass2(); echo $obj2->public; // 動作します -echo $obj2->protected; // Fatal エラー +echo $obj2->protected; // 致命的なエラー echo $obj2->private; // 未定義です $obj2->printHello(); // Public2, Protected2, Undefined を表示します @@ -115,8 +115,8 @@ class SpecialBook extends Book $b = new Book('How to PHP', 'Peter H. Peterson', 2024); -echo $b->title; // OK -echo $b->author; // OK +echo $b->title; // 動作します +echo $b->author; // 動作します echo $b->pubYear; // 致命的なエラー $b->title = 'How not to PHP'; // 致命的なエラー @@ -132,7 +132,7 @@ $b->pubYear = 2023; // 致命的なエラー はクラスの static プロパティにも適用できるようになりました。 - Asymmetric Static Property Visibility + static プロパティの非対称可視性 doAThing(); // Works -echo Manager::$calls; // Works -Manager::$calls = 5; // Fatal error +$m->doAThing(); // 動作します +echo Manager::$calls; // 動作します +Manager::$calls = 5; // 致命的なエラー ?> ]]> @@ -289,8 +289,8 @@ class MyClass $myclass = new MyClass; $myclass->MyPublic(); // 動作します -$myclass->MyProtected(); // Fatal エラー -$myclass->MyPrivate(); // Fatal エラー +$myclass->MyProtected(); // 致命的なエラー +$myclass->MyPrivate(); // 致命的なエラー $myclass->Foo(); // Public、Protected および Private が動作します @@ -304,7 +304,7 @@ class MyClass2 extends MyClass { $this->MyPublic(); $this->MyProtected(); - $this->MyPrivate(); // Fatal エラー + $this->MyPrivate(); // 致命的なエラー } } @@ -384,8 +384,8 @@ class MyClass $myclass = new MyClass(); MyClass::MY_PUBLIC; // 動作します -MyClass::MY_PROTECTED; // Fatal エラー -MyClass::MY_PRIVATE; // Fatal エラー +MyClass::MY_PROTECTED; // 致命的なエラー +MyClass::MY_PRIVATE; // 致命的なエラー $myclass->foo(); // Public, Protected, Private のいずれでも動作します @@ -399,7 +399,7 @@ class MyClass2 extends MyClass { echo self::MY_PUBLIC; echo self::MY_PROTECTED; - echo self::MY_PRIVATE; // Fatal エラー + echo self::MY_PRIVATE; // 致命的なエラー } } diff --git a/language/operators/precedence.xml b/language/operators/precedence.xml index c28dc31dfe..542431fae6 100644 --- a/language/operators/precedence.xml +++ b/language/operators/precedence.xml @@ -14,8 +14,8 @@ (1 + 5) * 3 とします。 - 演算子の優先順位が等しい場合は、その結合性によって評価順 - (右から評価するのか、あるいは左から評価するのか) が決まります。 + 演算子の優先順位が等しい場合は、その結合性によって + グループ分けが決まります。 たとえば "-" は左結合なので、 1 - 2 - 3 は (1 - 2) - 3 とグループ分けされて、 評価結果は -4 になります。 @@ -45,13 +45,13 @@ 次の表では、優先順位が高い順に演算子を挙げています。 同じ行にある演算子は優先順位が等しくなります。そのような場合は、 - 結合時の評価にしたがってグループ分けが決まります。 + 結合性にしたがってグループ分けが決まります。 演算子の優先順位 - 結合時の評価 + 結合性 演算子 追加情報 @@ -320,7 +320,7 @@ - 結合時の評価 + 結合性 - PHP 8 より前のバージョンでは、 <literal>+</literal>, <literal>-</literal> and <literal>.</literal> の優先順位は同じ + PHP 8 より前のバージョンでは、<literal>+</literal>、<literal>-</literal>、<literal>.</literal> の優先順位は同じ - = は他のほとんどの演算子よりも優先順位が低いはずなのにもかかわらず、 + = は他のほとんどの演算子よりも優先順位が低いにもかかわらず、 PHP は依然として if (!$a = foo()) のような式も許します。この場合は foo() の戻り値が $a に代入されます。 @@ -463,8 +463,8 @@ x minus one equals 3, or so I hope の優先順位は、 算術演算子の加算/減算 (+ および -) - と ビットシフト演算子 - (<< および >>); + とビットシフト演算子 + (<< および >>) よりも低くなりました。 これより前のバージョンでは、文字列の連結は + と - @@ -477,27 +477,27 @@ x minus one equals 3, or so I hope 8.0.0 三項演算子 (? :) は、 - どの演算とも結合しなくなりました。 + 結合しない演算子になりました。 これより前のバージョンでは、左結合でした。 7.4.0 - 三項演算子(? :) が左結合であることに依存すること、 - つまり、括弧で囲わずに三項演算子をネストすることは推奨されなくなりました。 + 文字列の連結 (.) 演算の、 + 算術演算子の加算/減算 + (+ および -) + とビットシフト演算子 + (<< および >>) + に対する優先順位に依存するコードは、推奨されなくなりました。 + つまり、これらを括弧を使わずに一緒に使うことは推奨されなくなりました。 7.4.0 - 文字列の連結 (.) 演算と、 - 算術演算子の加算/減算 - (+ および -) - と ビットシフト演算子 - (<< および >>); - の優先順位に依存するコードは、推奨されなくなりました。 - つまり、これらを括弧を使わずに一緒に使うことは推奨されなくなりました。 + 三項演算子(? :) が左結合であることに依存すること、 + つまり、括弧で囲わずに三項演算子をネストすることは推奨されなくなりました。 diff --git a/language/predefined/attributes/returntypewillchange.xml b/language/predefined/attributes/returntypewillchange.xml index 0c5505bb14..ad458a3f79 100644 --- a/language/predefined/attributes/returntypewillchange.xml +++ b/language/predefined/attributes/returntypewillchange.xml @@ -29,10 +29,10 @@ PHP のバージョン間の互換性を保ちたいがために、 - 戻り値の型を宣言できない場合や、 + オーバーライドするメソッドの戻り値の型を宣言できない場合や、 オーバーライドするメソッドが互換性のない戻り値の型を宣言している場合は、 アトリビュート #[\ReturnTypeWillChange] - を追加することで警告を抑止できます。 + を追加することで推奨されない警告を抑止できます。 @@ -45,7 +45,7 @@ ReturnTypeWillChange アトリビュートが推奨されない警告を抑止するのは、 - 暫定的な戻り値の型のフェーズの間だけです。 + 仮の戻り値の型のフェーズの間だけです。 厳密な型チェックが強制されるようになると、このアトリビュートは機能しなくなり、 内部クラスのメソッドをオーバーライドする際にシグネチャの互換性がないと、 致命的なエラーが発生するようになります。 diff --git a/language/predefined/error/construct.xml b/language/predefined/error/construct.xml index 9d08f77b84..976acb6b03 100644 --- a/language/predefined/error/construct.xml +++ b/language/predefined/error/construct.xml @@ -18,7 +18,7 @@ Throwablenullprevious&null; - エラーを生成する。 + エラーを生成します。 diff --git a/language/predefined/error/getmessage.xml b/language/predefined/error/getmessage.xml index 67a92fbd5a..cc7c79560e 100644 --- a/language/predefined/error/getmessage.xml +++ b/language/predefined/error/getmessage.xml @@ -14,7 +14,7 @@ - エラーメッセージを返す。 + エラーメッセージを返します。 @@ -26,7 +26,7 @@ &reftitle.returnvalues; - エラーメッセージを文字列で返す。 + エラーメッセージを文字列で返します。 diff --git a/language/predefined/error/getprevious.xml b/language/predefined/error/getprevious.xml index 6650dd2957..1744a31a82 100644 --- a/language/predefined/error/getprevious.xml +++ b/language/predefined/error/getprevious.xml @@ -14,7 +14,7 @@ - 直前の Throwable（Error::__construct の3番目の引数）を返す。 + 直前の Throwable（Error::__construct の第三パラメータ）を返します。 @@ -26,8 +26,8 @@ &reftitle.returnvalues; - 直前の Throwable が利用可能であればそれを返し、 - そうでなければ &null; を返す。 + 直前の Throwable が存在すればそれを返し、 + そうでなければ &null; を返します。 @@ -37,7 +37,7 @@ <methodname>Error::getPrevious</methodname> の例 - エラートレースをループし、出力する。 + エラートレースをループし、出力します。 - 前に発生した Throwable (Exception::__construct に渡された 3 番目の引数) + 前に発生した Throwable (Exception::__construct に渡された第三パラメータ) を返します。 diff --git a/language/predefined/generator/send.xml b/language/predefined/generator/send.xml index 090409b7e0..006070713f 100644 --- a/language/predefined/generator/send.xml +++ b/language/predefined/generator/send.xml @@ -20,8 +20,8 @@ ジェネレータが &yield; 式を指していないときにこのメソッドが呼ばれると、 まずは最初の &yield; 式まで進めてから値を送信します。そのため、 - 最初のジェネレータを指すためにわざわざ - Generator::next を呼ぶ必要はありません (Python と同じです)。 + PHP のジェネレータでは、(Python で行われているような) + Generator::next の呼び出しで「呼び水を与える」必要はありません。 diff --git a/language/references.xml b/language/references.xml index 9a391235d7..385e64eeea 100644 --- a/language/references.xml +++ b/language/references.xml @@ -190,7 +190,7 @@ var_dump($b); しかし、配列の内部のリファレンスは危険もあるということに気をつけましょう。 通常の (リファレンスではない) 代入の右辺にリファレンスを使っても 左辺がリファレンスに変わることはありませんが、配列の内部のリファレンスは通常の代入においても維持されます。 - これは、関数をコールする際に配列をリファレンスで渡すときも同じです。 + これは、関数をコールする際に配列を値渡しするときも同じです。 たとえば、次のようになります。 @@ -443,10 +443,11 @@ echo $myValue; // $obj->value の新しい値である 2 を表 以下のような形式で関数からリファレンスを返そうとした場合、 - return ($this->value); これは、あなたが望んでいるように - 式 の結果を返してくれることはありません。 - 可能なことは、値へのリファレンスを返すことができるということだけで、 - それ以外の何物でもありません。 + return ($this->value); これは、あなたが望んでいるようには + 動作しません。変数ではなく + 式 の結果をリファレンスで返そうとしているからです。 + 関数からリファレンスで返せるのは変数だけであり、 + それ以外は返せません。 diff --git a/language/types/array.xml b/language/types/array.xml index 44d246767c..fe2b8d4a8d 100644 --- a/language/types/array.xml +++ b/language/types/array.xml @@ -296,8 +296,8 @@ $array = array( '1' => 'b', // 値 "a" は "b" で上書きされます。 1.5 => 'c', // 値 "b" は "c" で上書きされます。 -1 => 'd', - '01' => 'e', // この値は数値形式の文字列ではないので、キー1を上書きしません - '1.5' => 'f', // この値は数値形式の文字列ではないので、キー1を上書きしません + '01' => 'e', // これは整数形式の文字列ではないので、キー1を上書きしません + '1.5' => 'f', // これは整数形式の文字列ではないので、キー1を上書きしません true => 'g', // 値 "c" は "g" で上書きされます。 false => 'h', '' => 'i', @@ -564,8 +564,8 @@ var_dump($arr); 次のキー生成において、オフセットとして使われる整数値 (添字の最大値) に対応するエントリーが、 必ずしも配列内に存在するわけではないことに注意してください。 - しかし、その値は、多くの場合、 - 配列にある整数のキー値の最大値と等しいはずです。以下に例を示します。 + その値は、配列のインデックスが最後に再構築されて以降のいずれかの時点で、 + 配列に存在していれば十分です。以下に例を示します。 @@ -698,8 +698,8 @@ echo $baz; // "baz" を出力します。 PHP 7.1.0 以降では、 連想配列も分解できるようになりました。 - 数値をキーとした配列の右側の要素を、 - インデックスを明示的に指定することで簡単に選択できるようになっています。 + 数値をキーとした配列でも、インデックスを明示的に指定できるので、 + 目的の要素を簡単に選択できるようになっています。 @@ -781,11 +781,11 @@ echo $b, PHP_EOL; // 1 を出力します。 unset関数は配列のキーを削除することが出来ます。 - ただし、これによってインデックスの再構築が行われるわけではないことに + ただし、これによってインデックスの再構築が行われるわけではないことに 注意してください。 - "通常の整数添字" (0 から始まり、1 つずつ増加) のみを使用している場合、 + 本当に "削除して前に詰める" 挙動が必要な場合は、 array_values - を用いてインデックスを再構築することができます。 + 関数を用いてインデックスを再構築することができます。 @@ -854,11 +854,11 @@ echo $foo[bar]; - 生の文字列を未定義の定数として扱う振る舞いは、 + 未定義の定数を生の文字列として扱うフォールバックでは、 E_NOTICE - レベルの警告が発生します。 + レベルのエラーが発生します。 この振る舞いは PHP 7.2.0 以降は推奨されなくなり、 - E_WARNING レベルの警告が発生します。 + E_WARNING レベルのエラーが発生します。 PHP 8.0.0 以降は、この振る舞いは削除され、 Error 例外がスローされるようになっています。 diff --git a/language/types/declarations.xml b/language/types/declarations.xml index 34f09595f3..c9af6992c6 100644 --- a/language/types/declarations.xml +++ b/language/types/declarations.xml @@ -288,10 +288,10 @@ Stack trace: PHP 8.2.0 より前のバージョンでは、 - &false; と null 型は + false と null 型は 独立した型として使えず、 union 型でそれらだけを指定することも許されませんでした。 - つまり、&false;, false|null, + つまり、false, false|null, ?false のような型はいずれも許されませんでした。 diff --git a/language/types/integer.xml b/language/types/integer.xml index 9d000eca7e..71af9bec2a 100644 --- a/language/types/integer.xml +++ b/language/types/integer.xml @@ -26,7 +26,8 @@ 整数 (integer) は、10 進数(基数 10)、16 進数 (基数 16)、8 進数 (基数 8) あるいは 2 進数 (基数 2) - 表記で指定可能です。オプションで、符号(-または+)を前に付けることが可能です。 + 表記で指定可能です。 + 負の int を表すには、負にする演算子が使えます。 @@ -272,10 +273,8 @@ echo (int) ( (0.1+0.7) * 10 ); // 7が出力されます! 整数への変換の動作は、他の型については定義されません。 - 現在の動作は、その値がまず - 論理値に変換された - 場合と同じです。しかし、この動作は予告なく変更されることがありえるので、 - これを前提にしてはいけません。 + 観測された動作は予告なく変更されることがありえるので、 + これを前提にしてはいけません。 diff --git a/language/types/numeric-strings.xml b/language/types/numeric-strings.xml index b091a0a868..8eaba2d780 100644 --- a/language/types/numeric-strings.xml +++ b/language/types/numeric-strings.xml @@ -63,7 +63,7 @@ var_dump("2E1" == "020"); // true, "2E1" は 2 * (10 ^ 1), または 20 - 文字列が数値の場合、かつそれが + 文字列が数値の場合、その文字列が整数の数値形式の文字列であり、かつ int 型の範囲 (PHP_INT_MAX で定義されています) に含まれる場合、int に解決されます。 @@ -73,9 +73,9 @@ var_dump("2E1" == "020"); // true, "2E1" は 2 * (10 ^ 1), または 20 文脈が 先頭から始まる数値形式の文字列を許す場合、 - かつ値が文字列の場合は、次のように解決されます: + かつその文字列がそれに該当する場合は、次のように解決されます: - 文字列の先頭部分が数値形式の文字列、かつそれが + 文字列の先頭部分が整数の数値形式の文字列であり、かつそれが int 型の範囲 (PHP_INT_MAX で定義されています) に含まれる場合、int に解決されます。 diff --git a/language/types/string.xml b/language/types/string.xml index bb8972ec17..c6f3c6671f 100644 --- a/language/types/string.xml +++ b/language/types/string.xml @@ -1178,7 +1178,7 @@ string(1) "b" 文字列は、'.' (ドット) 結合演算子で結合することが可能です。'+' - (加算) 演算子はこの例では出てこないことに注意してください。詳細については + (加算) 演算子はこの用途には使えないことに注意してください。詳細については 文字列演算子 を参照ください。 diff --git a/language/variables.xml b/language/variables.xml index a496b49a63..23ee840059 100644 --- a/language/variables.xml +++ b/language/variables.xml @@ -260,6 +260,7 @@ var_dump($unset_array); 可変変数 + 関数やクラスメソッドの内部では、 可変変数として スーパーグローバルを使うことはできません。 @@ -301,9 +302,9 @@ include 'b.inc'; // 変数 $a は b.inc で利用できます。 しかし、アロー関数 は親のスコープの変数を内部で利用できるようにするために、 変数をバインドします。 - ファイルの include が呼び出し側のファイルで発生した場合、 + 呼び出し側のファイルの関数の内部で include が発生した場合、 呼び出されたファイルに含まれる変数は、 - 関数を呼び出す内部で定義されたかのように利用できます。 + 呼び出し元の関数の内部で定義されたかのように利用できます。 ローカル変数のスコープ @@ -626,7 +627,7 @@ var_dump(Bar::counter()); // int(4), PHP 8.1.0 より前のバージョンでは PHP は、 リファレンス - 変数の修正子として + 変数の修飾子として static および global を実装しています。 diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml index b1de49a31e..c51577a461 100644 --- a/reference/array/functions/array-filter.xml +++ b/reference/array/functions/array-filter.xml @@ -26,8 +26,8 @@ array の現在の値が結果の配列に入ります。 - 配列のキーは保存されます。 - array にインデックスが振られていた場合、結果が異なる場合があります。 + 配列のキーは保存されるため、 + array が連番のインデックスを持つ配列だった場合は、キーに歯抜けが生じることがあります。 結果の &array; のインデックスは、 array_values 関数を使って振り直すことができます。 diff --git a/reference/array/functions/array-merge.xml b/reference/array/functions/array-merge.xml index c7543c3b2a..7dd3373706 100644 --- a/reference/array/functions/array-merge.xml +++ b/reference/array/functions/array-merge.xml @@ -14,13 +14,13 @@ arrayarrays - 前の配列の後ろに配列を追加することにより、 + 前の配列の最後にもう一つの配列の値を追加することにより、 ひとつまたは複数の配列の要素をマージし、得られた配列を返します。 - 入力配列が同じキー文字列を有していた場合、そのキーに関する後に指定された値が、 - 前の値を上書きします。しかし、配列が同じ添字番号を有していても - 値は追記されるため、このようなことは起きません。 + 入力配列が同じ文字列のキーを有していた場合、そのキーに関する後に指定された値が、 + 前の値を上書きします。しかし、配列が数値添字を有している場合、 + 後に指定された値は元の値を上書きせず、追加されます。 入力配列の中にある数値添字要素の添字の数値は、 diff --git a/reference/array/functions/array-search.xml b/reference/array/functions/array-search.xml index 4ab005a091..d83703be7c 100644 --- a/reference/array/functions/array-search.xml +++ b/reference/array/functions/array-search.xml @@ -50,10 +50,10 @@ オプションの3番目のパラメータ strict に &true; が指定された場合、 - array_search は identical 要素を haystack から探します。 + array_search は 同一の要素を haystack から探します。 つまり、haystack の中で needle の厳密な型比較を実行します。 - およびオブジェクトが同一のインスタンスであるかどうかも確認します。 + また、オブジェクトが同一のインスタンスであるかどうかも確認します。 @@ -67,8 +67,8 @@ それ以外の場合に &false; を返します。 - もし haystack に 1 つ以上の - needle に見つかった場合、 + もし haystack の中で + needle が複数回見つかった場合、 最初にマッチしたキーが返されます。全てのマッチした値に対するキーを返すためには、代わりに array_keys にパラメータ filter_value を付けて使用してください。 &return.falseproblem; diff --git a/reference/array/functions/array-splice.xml b/reference/array/functions/array-splice.xml index b512a085f3..e4b6a18347 100644 --- a/reference/array/functions/array-splice.xml +++ b/reference/array/functions/array-splice.xml @@ -71,7 +71,7 @@ offset から配列の最後までが全て削除されます。 - length が指定され、正の場合、複数の要素が削除されます。 + length が指定され、正の場合、その個数ぶんの要素が削除されます。 負の length が指定された場合、削除される部分の末尾の位置は配列の末尾を基準にして計算されます。 @@ -83,8 +83,7 @@ replacement も指定した場合に offset から配列の最後まで全てを削除するには、 - length を求めるために count($input) - を使用してください。 + length を求めるために count($input) を使用してください。 @@ -103,7 +102,7 @@ - 置換される配列のキーは保存されないことに注意してください。 + replacement 配列のキーは保存されないことに注意してください。 diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml index a353754c05..eaf237176a 100644 --- a/reference/curl/constants.xml +++ b/reference/curl/constants.xml @@ -1330,7 +1330,7 @@ - エラーが発生した場合、ワイルドカードマッチのコールバック関数を返します。 + エラーが発生した場合、ワイルドカードマッチのコールバック関数が返す値です。 cURL 7.21.0 以降で利用可能です。 @@ -1343,7 +1343,7 @@ 文字列にパターンがマッチした場合、 - ワイルドカードマッチのコールバック関数を返します。 + ワイルドカードマッチのコールバック関数が返す値です。 cURL 7.21.0 以降で利用可能です。 @@ -1356,7 +1356,7 @@ 文字列にパターンがマッチしない場合、 - ワイルドカードマッチのコールバック関数を返します。 + ワイルドカードマッチのコールバック関数が返す値です。 cURL 7.21.0 以降で利用可能です。 @@ -2165,7 +2165,7 @@ - IPv6-enabled. + IPv6 をサポートします。 @@ -2211,7 +2211,7 @@ - libz features are present. + libz の機能をサポートします。 diff --git a/reference/curl/constants_curl_getinfo.xml b/reference/curl/constants_curl_getinfo.xml index 47cef2e37e..5b94d09cd0 100644 --- a/reference/curl/constants_curl_getinfo.xml +++ b/reference/curl/constants_curl_getinfo.xml @@ -115,7 +115,7 @@ ダウンロードしたコンテンツのサイズ。 - Content-Length: サイズから読み取ります。 + Content-Length: ヘッダーから読み取ります。 cURL 7.55.0 以降は非推奨となっています。 代わりに CURLINFO_CONTENT_LENGTH_DOWNLOAD_T を使用してください。 @@ -129,7 +129,7 @@ ダウンロードしたコンテンツのサイズ。 - Content-Length: サイズから読み取った値ですが、 + Content-Length: ヘッダーから読み取った値ですが、 サイズが不明な場合は -1 になります。 PHP 7.3.0 以降 および cURL 7.55.0 以降で利用可能です。 @@ -379,7 +379,7 @@ - 処理開始から、名前解決が開始されるまでの経過時間(秒単位)。 + 処理開始から名前解決が完了するまでの経過時間(マイクロ秒単位)。 PHP 7.3.0 以降 および cURL 7.61.0 以降で利用可能です。 @@ -460,7 +460,7 @@ curl_setopt の - CURLOPT_PRIVATE をオプションを以前に設定した場合に、 + CURLOPT_PRIVATE オプションを以前に設定した場合に、 この cURL ハンドルに関連付けられたプライベートデータ。 @@ -748,7 +748,7 @@ - アップロードした合計バイト数 + アップロードした合計バイト数。 PHP 7.3.0 以降 および cURL 7.50.0 以降で利用可能です。 diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 49ec5f0968..339a1afe6f 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -2015,7 +2015,7 @@ ピン留めされた (ピンニングされた) 公開鍵を string で指定します。 この string には、PEM または DER 形式のピン留めされた公開鍵のファイル名を指定できます。 - また、先頭に sha256// を付けて ; で区切った + また、この string には、先頭に sha256// を付けて ; で区切った 任意の数の base64 エンコードされた sha256 ハッシュも指定できます。 PHP 7.0.7 以降かつ cURL 7.39.0 以降で利用可能です。 @@ -2511,8 +2511,9 @@ HTTPS プロキシ用のピン留めされた (ピンニングされた) 公開鍵を指定します。 - この string には、PEM または DER 形式のピン留めされた公開鍵のファイル名を指定できます。 - また、先頭に sha256// を付けて ; で区切った + この string には、PEM または + DER 形式のピン留めされた公開鍵のファイル名を指定できます。 + また、この string には、先頭に sha256// を付けて ; で区切った 任意の数の base64 エンコードされた sha256 ハッシュも指定できます。 PHP 7.3.0 以降かつ cURL 7.52.0 以降で利用可能です。 diff --git a/reference/curl/functions/curl-init.xml b/reference/curl/functions/curl-init.xml index 135149ba8e..f3efa9c406 100644 --- a/reference/curl/functions/curl-init.xml +++ b/reference/curl/functions/curl-init.xml @@ -114,7 +114,6 @@ curl_exec($ch); &reftitle.seealso; - curl_close curl_multi_init diff --git a/reference/datetime/dateperiod/construct.xml b/reference/datetime/dateperiod/construct.xml index bd276e94ea..e04245bf4a 100644 --- a/reference/datetime/dateperiod/construct.xml +++ b/reference/datetime/dateperiod/construct.xml @@ -47,16 +47,15 @@ DatePeriod オブジェクトは、 たくさんの DateTimeImmutable や DateTime を生成するイテレータとして使えます。 - パラメータ start, - interval, - end, および recurrences - の数を指定できます。 + パラメータ start、 + interval に加えて、 + end または recurrences + (繰り返し回数) のいずれかを指定します。 - 返されるオブジェクトのクラスは、 - start の祖先になるオブジェクトで、 - DateTimeImmutable や - DateTime に等しくなります。 + 返されるオブジェクトのクラスは、start + オブジェクトの祖先クラスである DateTimeImmutable + または DateTime と同じになります。 @@ -109,7 +108,7 @@ xlink:href="&url.iso-8601.repeating_intervals;">ISO 8601 repeating interval specification のサブセットを指定します。 - PHP がサポートしていない、サブセットの機能の例を以下に示します: + PHP がサポートしていない ISO 8601 期間指定の機能の例を以下に示します: @@ -130,7 +129,7 @@ options - 開始日と終了日に関する振る舞いを制御するビットフィールド + 開始日と終了日に関する振る舞いを制御するビットフィールド。 DatePeriod::EXCLUDE_START_DATE diff --git a/reference/datetime/datetimeinterface/diff.xml b/reference/datetime/datetimeinterface/diff.xml index 4d6f55553a..96330caf3b 100644 --- a/reference/datetime/datetimeinterface/diff.xml +++ b/reference/datetime/datetimeinterface/diff.xml @@ -38,7 +38,7 @@ boolabsolute&false; - ふたつの DateTime オブジェクトの差を返します。 + ふたつの DateTimeInterface オブジェクトの差を返します。 @@ -150,7 +150,7 @@ echo $interval->format("%H:%I:%S (Full days: %a)"), "\n"; - <methodname>DateTimeInterface::diff</methodname> range + <methodname>DateTimeInterface::diff</methodname> が返す範囲 このメソッドが返す値は、 $this から $targetObject diff --git a/reference/datetime/datetimeinterface/format.xml b/reference/datetime/datetimeinterface/format.xml index 94c6c3930b..c51f53aa4a 100644 --- a/reference/datetime/datetimeinterface/format.xml +++ b/reference/datetime/datetimeinterface/format.xml @@ -227,12 +227,12 @@ h - 時。数字。12 時間単位。 + 時。12 時間単位。先頭にゼロをつける。 01 から 12 H - 時。数字。24 時間単位。 + 時。24 時間単位。先頭にゼロをつける。 00 から 23 diff --git a/reference/datetime/functions/date.xml b/reference/datetime/functions/date.xml index a2baea2454..8670946629 100644 --- a/reference/datetime/functions/date.xml +++ b/reference/datetime/functions/date.xml @@ -46,8 +46,8 @@ date 関数は、マイクロ秒については常に 000000 を生成します。 - というのも、この関数が受け取るパラメータは int 型だからです。 - 一方 DateTimeInterface 型のオブジェクトをマイクロ秒つきで作成した場合は、 + というのも、この関数が受け取るパラメータは int 型だからです。 + 一方 DateTimeInterface 型のオブジェクトをマイクロ秒つきで作成した場合は、 DateTimeInterface::format はマイクロ秒にも対応しています。 @@ -129,8 +129,8 @@ echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); 前にバックスラッシュを付けてエスケープすることにより、 フォーマット文字列として認識される文字が展開されることを防止することができます。 - バックスラッシュ付きの文字は既に特別なシーケンスであり、 - バックスラッシュもエスケープすることが必要となる可能性があります。 + バックスラッシュ付きの文字が既に特殊なシーケンスの場合は、 + バックスラッシュもエスケープする必要があるでしょう。 <function>date</function> の文字をエスケープする diff --git a/reference/datetime/functions/gmmktime.xml b/reference/datetime/functions/gmmktime.xml index bcd28d35dc..36d2d6e157 100644 --- a/reference/datetime/functions/gmmktime.xml +++ b/reference/datetime/functions/gmmktime.xml @@ -56,8 +56,8 @@ hour 時 0 分から数えた「分」。 - 負の値は、その前の時刻を表します。 - 59 より大きい値は、その次の時間以降の該当する時間を表します。 + 負の値は、その前の時間の該当する分を表します。 + 59 より大きい値は、その次の時間以降の該当する分を表します。 @@ -66,8 +66,8 @@ minute 分 0 秒から数えた「秒」。 - 負の値は、その前の時刻を表します。 - 59 より大きい値は、その次の分以降の該当する時間を表します。 + 負の値は、その前の分の該当する秒を表します。 + 59 より大きい値は、その次の分以降の該当する秒を表します。 diff --git a/reference/datetime/functions/mktime.xml b/reference/datetime/functions/mktime.xml index eb7588210f..87abca4644 100644 --- a/reference/datetime/functions/mktime.xml +++ b/reference/datetime/functions/mktime.xml @@ -63,8 +63,8 @@ hour 時 0 分から数えた「分」。 - 負の値は、その前の時刻を表します。 - 59 より大きい値は、その次の時間以降の該当する時間を表します。 + 負の値は、その前の時間の該当する分を表します。 + 59 より大きい値は、その次の時間以降の該当する分を表します。 @@ -73,8 +73,8 @@ minute 分 0 秒から数えた「秒」。 - 負の値は、その前の時刻を表します。 - 59 より大きい値は、その次の分以降の該当する時間を表します。 + 負の値は、その前の分の該当する秒を表します。 + 59 より大きい値は、その次の分以降の該当する秒を表します。 diff --git a/reference/datetime/functions/strtotime.xml b/reference/datetime/functions/strtotime.xml index 83967e5ee3..7e8d662f24 100644 --- a/reference/datetime/functions/strtotime.xml +++ b/reference/datetime/functions/strtotime.xml @@ -54,7 +54,7 @@ baseTimestamp - 返される値を計算するために使用されるタイムスタンプ。 + 相対的な日付を計算する際の基準として使用されるタイムスタンプ。 diff --git a/reference/dom/dom/dom-document.xml b/reference/dom/dom/dom-document.xml index 431fdf53f5..0bb9c6ed51 100644 --- a/reference/dom/dom/dom-document.xml +++ b/reference/dom/dom/dom-document.xml @@ -224,8 +224,8 @@ title - HTML や SVG の title - 要素に設定されるドキュメントのタイトル。 + HTML の title 要素、あるいは SVG の + title 要素に設定されるドキュメントのタイトル。 タイトルがない場合、空文字列に評価されます。 diff --git a/reference/errorfunc/functions/set-error-handler.xml b/reference/errorfunc/functions/set-error-handler.xml index b98688dc6b..b5d4ee2cb9 100644 --- a/reference/errorfunc/functions/set-error-handler.xml +++ b/reference/errorfunc/functions/set-error-handler.xml @@ -128,7 +128,7 @@ このパラメータは PHP 7.2.0 以降では 推奨されなくなり、 PHP 8.0.0 で 削除されました。 - この引数をデフォルト値以外に設定すると、 + 関数がこのパラメータをデフォルト値なしで定義していると、 ハンドラが呼び出された時に "too few arguments" エラーが発生します。 diff --git a/reference/errorfunc/ini.xml b/reference/errorfunc/ini.xml index cd4cf68f16..cfb5cfbf3d 100644 --- a/reference/errorfunc/ini.xml +++ b/reference/errorfunc/ini.xml @@ -159,8 +159,10 @@
&ini.php.constants; + + &ini.descriptions.title; + - 以下に設定ディレクティブの簡単な説明を示します。 @@ -183,10 +185,10 @@ PHP 8.0.0 より前のバージョンでは、 - E_ALL & + E_ALL & ~E_NOTICE & ~E_STRICT & - ~E_DEPRECATED でした。 + ~E_DEPRECATED でした。 これは、E_NOTICE、 E_STRICT、 そして E_DEPRECATED @@ -318,7 +320,7 @@ log_errorsの最大長をバイト単位で設定します。 error_log には、 - この設定で情報が追加されます。デフォルトは 1024 で、0 を指定すると + 発生元の情報が追加されます。デフォルトは 1024 で、0 を指定すると 最大長の制限は全く適用されなくなります。 この長さはエラーログへの記録や エラーの表示、そして @@ -339,10 +341,10 @@ - 繰り返されるメッセージを記録しません。エラーの繰り返しは、 + 繰り返されるメッセージを記録しません。 ignore_repeated_sourceが - trueに設定されるまで同じファイルの同じ行で発生します。 + true に設定されていない限り、エラーの繰り返しは同じファイルの同じ行で発生する必要があります。 @@ -401,8 +403,8 @@ 有効にすると、エラーメッセージにHTMLタグが含まれるようになります。 - HTML形式のエラーメッセージでは、ユーザーがエラーまたはエラーを発生した関数を説明するページ - に導くようクリック可能なメッセージを出力します。これらのリファレ + HTML形式のエラーメッセージでは、ユーザーをエラーやエラーの原因となった関数を説明するページ + に導く、クリック可能なメッセージを出力します。これらのリファレ ンスは、docref_root およ び docref_extの設定に依存 します。 @@ -445,13 +447,13 @@ 新しいエラーフォーマットはエラーやエラーの原因となった関数に関するマニュアル - のページの情報を含んでいます。マニュアルのページによっては母国語でダウンロードが - 可能であり、このiniディレクティブをマニュアルのローカルコピーのURLにセット + のページの情報を含んでいます。マニュアルのページの場合は、自分の言語のマニュアルを + ダウンロードし、このiniディレクティブをマニュアルのローカルコピーのURLにセット することができます。 マニュアルのローカルコピーが "/manual/" でアクセスできるとすると、単に docref_root=/manual/とするだけです。 - ローカルコピーのファイルの拡張子はdocref_ext=.html - で指定できます。拡張リファレンスを使用することもできます。例えば + さらに、ローカルコピーのファイルの拡張子に合わせて + docref_ext=.html のように docref_ext を設定する必要があります。外部のリファレンスを使用することもできます。例えば docref_root=http://manual/en/または docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon&url=http%3A%2F%2Fwww.php.net%2F"が使用できます。 @@ -459,6 +461,13 @@ ほとんどの場合 docref_root の値の最後を "/" にしようと思うでしょう。 しかし上の二つ目の例を見ると、その必要はありません。 + + + 関数の説明を簡単に参照できるようにする、開発をサポートするための機能です。 + しかし、本番のシステム (インターネットに接続されたシステムなど) では + 決して使用すべきではありません。 + + @@ -588,8 +597,8 @@ - この設定は、error_log を "syslog" に設定し、 - syslog をコールした場合にのみ影響します。 + この設定は、error_log を "syslog" に設定した場合の + ロギングと、syslog の呼び出しに影響します。 diff --git a/reference/ev/evchild.xml b/reference/ev/evchild.xml index 9dc9ca2e86..999b31b936 100644 --- a/reference/ev/evchild.xml +++ b/reference/ev/evchild.xml @@ -2,7 +2,7 @@ - The EvChild class + EvChild クラス EvChild diff --git a/reference/exec/functions/escapeshellarg.xml b/reference/exec/functions/escapeshellarg.xml index 7432ee402c..39af6b40d7 100644 --- a/reference/exec/functions/escapeshellarg.xml +++ b/reference/exec/functions/escapeshellarg.xml @@ -30,7 +30,7 @@ Windows では、escapeshellarg は、パーセント記号と感嘆符 (遅延環境変数の展開) とダブルクォートをスペースに置き換えます。 そして、文字列をダブルクォートで囲みます。 - さらに、連続するバックスラッシュ(\) は、もうひとつバックスラッシュを追加すればエスケープできます。 + さらに、連続するバックスラッシュ (\) の並びは、それぞれバックスラッシュを1つ追加してエスケープされます。 diff --git a/reference/exec/functions/exec.xml b/reference/exec/functions/exec.xml index 217c874669..ad518d4a40 100644 --- a/reference/exec/functions/exec.xml +++ b/reference/exec/functions/exec.xml @@ -41,11 +41,11 @@ 引数 output が存在する場合、指定した配列は、 コマンドからの出力の各行で埋められます。 - \n のような後に続く空白は、この配列には含まれません。 + \n のような行末の空白は、この配列には含まれません。 配列に既に何らかの要素が - 含まれる場合は、exec は配列の最後に追加される + 含まれる場合は、exec は配列の最後に追加する ことに注意してください。関数が要素を追加することを望まないのなら、 - それが exec に渡される前に、配列の + それが exec に渡される前に、配列に対して unset を呼び出してください。 @@ -56,7 +56,7 @@ 引数result_codeが、引数 output と共に存在する場合、実行したコマンドの - ステータスがこの変数に書かれます。 + 返すステータスがこの変数に書かれます。 diff --git a/reference/exec/functions/shell-exec.xml b/reference/exec/functions/shell-exec.xml index 0a40286a76..b0ba846060 100644 --- a/reference/exec/functions/shell-exec.xml +++ b/reference/exec/functions/shell-exec.xml @@ -22,8 +22,8 @@ - Windows では、パイプがテキストモードでオープンされるため、 - この出力を使ったバイナリの出力が失敗する可能性があります。 + Windows では、内部で使われるパイプがテキストモードでオープンされるため、 + この関数はバイナリの出力に失敗する可能性があります。 このような場合は、popen の利用を検討してください。 diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml index 24e19efb43..10748fa180 100644 --- a/reference/filesystem/functions/file-get-contents.xml +++ b/reference/filesystem/functions/file-get-contents.xml @@ -87,7 +87,7 @@ リモートファイルに対するシーク (offset 指定) はサポートしていません。 オフセットが小さい場合はリモートファイルでのシークがうまくいくこともありますが、 - これはバッファリングされたストリーム上で動作しているだけのことです。 + これはバッファリングされたストリーム上で動作するためであり、結果は予測できません。 diff --git a/reference/filesystem/functions/fopen.xml b/reference/filesystem/functions/fopen.xml index 47ee9b94ee..ddb11caf62 100644 --- a/reference/filesystem/functions/fopen.xml +++ b/reference/filesystem/functions/fopen.xml @@ -57,7 +57,7 @@ サポートされているプロトコルのリストは にあります。 - いくつかのプロトコル (wrappersにも関連する) は + いくつかのプロトコル (wrappers ともいいます) は context かつ/または &php.ini; のオプションをサポートします。 使用するプロトコルについてセットされるオプションのリストについては、 それぞれのページを見てください (例えば、 &php.ini; 上の @@ -156,8 +156,6 @@ $handle = fopen("c:\\folder\\resource.txt", "r"); ファイルが存在しない場合には新規作成を試みます。 これは open(2) システムコールにおける O_EXCL|O_CREAT フラグの指定と等価です。 - このオプションはPHP4.3.2以降でサポートされ、また、 - ローカルファイルに対してのみ有効です。 @@ -228,9 +226,10 @@ $handle = fopen("c:\\folder\\resource.txt", "r"); デフォルトの変換モードは 'b' です。 - plain-text ファイルを使用する場合には 't' モードを指定できますし、 - 改行に \n を使用すると、 - 古いバージョンのメモ帳のようなアプリケーションで読めることを期待できます。 + plain-text ファイルを扱っていて、スクリプト内では改行の区切りに + \n を使うものの、古いバージョンのメモ帳のような + アプリケーションでも読めるようにしたい場合には、 + 't' モードを使えます。 それ以外のケースでは 'b' を使うべきです。 diff --git a/reference/filesystem/functions/fread.xml b/reference/filesystem/functions/fread.xml index 7ebc6f610f..8548cd167c 100644 --- a/reference/filesystem/functions/fread.xml +++ b/reference/filesystem/functions/fread.xml @@ -40,8 +40,8 @@ - バッファつきで読み込まれた、プレーンなファイルでないストリームの場合に、 - 一回の読み込みバイト数がチャンクサイズ (通常は 8192) に達した。 + ストリームが read バッファつきで、かつプレーンなファイルを表していない場合に、 + チャンクサイズ (通常は 8192) を上限とするバイト数の読み込みが最大一回だけ行われた。 それまでにバッファされていたデータの内容によって、返されるデータのサイズはチャンクサイズより大きくなることがあります。 diff --git a/reference/filter/book.xml b/reference/filter/book.xml index 99dc7e0797..106f454f13 100644 --- a/reference/filter/book.xml +++ b/reference/filter/book.xml @@ -49,7 +49,7 @@ たとえば、検証フィルタ FILTER_VALIDATE_URL と一緒に FILTER_FLAG_PATH_REQUIRED を使うと、URL に特定のパス - (http://example.org/foo における + (https://example.org/foo における /foo など) を必須とすることができます。 diff --git a/reference/filter/constants.xml b/reference/filter/constants.xml index 167d70007f..24faf45451 100644 --- a/reference/filter/constants.xml +++ b/reference/filter/constants.xml @@ -685,7 +685,7 @@ RFC 822 - の addr-spec syntax に照らして検証は行われます。 + の addr-spec 構文に照らして検証は行われます。 しかし、コメントやホワイトスペースのフォールディング、 ドットなしのドメイン名はサポートされていません。 よってこれらは拒否されます。 @@ -979,7 +979,7 @@ - 以下のHTMLエンコードおよび、ASCII 値が32より小さい値をフィルタします。 + このフィルタは、 ' " @@ -987,6 +987,7 @@ > & + および ASCII 値が32より小さい文字をHTMLエンコードします。 FILTER_SANITIZE_FULL_SPECIAL_CHARS と異なり、 FILTER_SANITIZE_SPECIAL_CHARS @@ -1059,7 +1060,7 @@ ラテン文字 ([a-zA-Z]), 数字 ([0-9]), そして特殊文字 - $-_.+!*'(),{}|\\^~[]`<>#%";/?:@&=. + $-_.+!*'(),{}|\\^~[]`<>#%";/?:@&= 以外の文字を全て除去します。 @@ -1071,8 +1072,8 @@ - ([0-9]), (+), - (-) 以外の文字を全て除去し余す。 + 数字 ([0-9]), プラス記号 (+), + マイナス記号 (-) 以外の文字を全て除去します。 @@ -1083,8 +1084,8 @@ - ([0-9]), (+), - (-) 以外の文字を全て除去し余す。 + 数字 ([0-9]), プラス記号 (+), + マイナス記号 (-) 以外の文字を全て除去します。 @@ -1097,7 +1098,7 @@ ドット文字 (.) を許可します。 - これは通常、整数部分と少数部分の区切りを表します。 + これは通常、整数部分と小数部分の区切りを表します。 diff --git a/reference/filter/functions/filter-var-array.xml b/reference/filter/functions/filter-var-array.xml index 390dc36f68..f478f5429b 100644 --- a/reference/filter/functions/filter-var-array.xml +++ b/reference/filter/functions/filter-var-array.xml @@ -39,7 +39,7 @@ options - オプション、またはエントリごとに適用するフィルタの連想配列。 + オプションの連想配列、または、エントリごとに適用するフィルタ。 フィルタは検証フィルタ FILTER_VALIDATE_* または除去フィルタ @@ -47,11 +47,11 @@ が使えます。 - オプションの値は、 - array に存在するキーをキーとして、 - そのエントリに適用するフィルタを値とする連想配列、 + オプションの配列は、 + array に存在するキーをキーとして持つ連想配列で、 + キーに対応する値には、そのエントリに適用するフィルタ、 または、そのエントリにどのフィルタを、 - どのように適用するかを記述した連想配列です。 + どのように適用するかを記述した連想配列のいずれかを指定します。 どのようにフィルタを適用するかを連想配列に記述する場合、 diff --git a/reference/filter/functions/filter-var.xml b/reference/filter/functions/filter-var.xml index 3bfc7305b5..b26714be17 100644 --- a/reference/filter/functions/filter-var.xml +++ b/reference/filter/functions/filter-var.xml @@ -35,7 +35,7 @@ - スカラー地は、値をフィルタリングする前に、 + スカラー値は、値をフィルタリングする前に、 内部的に 文字列への変換 が行われることに注意しましょう。 diff --git a/reference/ftp/functions/ftp-pasv.xml b/reference/ftp/functions/ftp-pasv.xml index c9a44237bb..8a54c4f760 100644 --- a/reference/ftp/functions/ftp-pasv.xml +++ b/reference/ftp/functions/ftp-pasv.xml @@ -16,8 +16,8 @@ ftp_pasv はパッシブモードをオンまたはオフにします。 - パッシブモードでは、データ接続はサーバーではなくクライアントにより - 初期化されます。クライアントがファイアウォールの向こうにある場合に + パッシブモードでは、データ接続はサーバーからではなくクライアントから + 開始されます。クライアントがファイアウォールの向こうにある場合に 必要となるでしょう。 @@ -40,7 +40,7 @@ enable - &true;, の場合はパッシブモードをオンに、そうでない場合はオフにします。 + &true; の場合はパッシブモードをオンに、そうでない場合はオフにします。 diff --git a/reference/iconv/constants.xml b/reference/iconv/constants.xml index d407572c09..77c811b40b 100644 --- a/reference/iconv/constants.xml +++ b/reference/iconv/constants.xml @@ -19,12 +19,18 @@ - ICONV_IMPL + + ICONV_IMPL + (string) + string 実装の名前 - ICONV_VERSION + + ICONV_VERSION + (string) + string 実装のバージョン @@ -51,12 +57,18 @@ - ICONV_MIME_DECODE_STRICT + + ICONV_MIME_DECODE_STRICT + (int) + int iconv_mime_decodeで使用されるビットマスク - ICONV_MIME_DECODE_CONTINUE_ON_ERROR + + ICONV_MIME_DECODE_CONTINUE_ON_ERROR + (int) + int iconv_mime_decodeで使用されるビットマスク diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml index 690a4e0986..dca5cd9c28 100644 --- a/reference/image/functions/getimagesize.xml +++ b/reference/image/functions/getimagesize.xml @@ -84,7 +84,7 @@ 現在、この変数にはJPGファイルについて 異なった複数のAPPマーカーが連想配列として返されます。いくつかのプログラムは、 これらのAPPマーカーを画像の中の埋込テキストの情報として使用します。 - 最も一般的な例は、マーカーAPPl3に埋込IPTC + 最も一般的な例は、マーカーAPP13に埋込IPTC &url.iptc;情報が返されることです。 バイナリ形式のマーカーAPP13を読むことができるよう処理するために iptcparse 関数を使用することができます。 diff --git a/reference/image/functions/imagecopyresampled.xml b/reference/image/functions/imagecopyresampled.xml index 2ae2206f1a..4274aa7ef2 100644 --- a/reference/image/functions/imagecopyresampled.xml +++ b/reference/image/functions/imagecopyresampled.xml @@ -266,8 +266,9 @@ imagejpeg($image_p, null, 100); 必要となります。再サンプルするピクセルとその色を計算するために ある種の近似計算が使用されます。パレットに新しい色を割り当てよう として失敗すると、(理論的に)最も近い色が選択されます。 - それは必ずしも常に可視色とは限りません。そのため、 - 空白(あるいは不可視な)といった不可思議な結果がもたらされます。 + ただし、それが視覚的に最も近い色であるとは限りません。そのため、 + 空白の(あるいは見た目上空白の)画像になるといった + 奇妙な結果が生じることがあります。 この問題を回避するには、imagecreatetruecolorで 生成されるようなTrueカラーイメージを目的のイメージとして 使用してください。 diff --git a/reference/image/functions/imagettftext.xml b/reference/image/functions/imagettftext.xml index 9f4829c877..1de57204f4 100644 --- a/reference/image/functions/imagettftext.xml +++ b/reference/image/functions/imagettftext.xml @@ -66,7 +66,7 @@ で与えられた座標は、最初の文字のベースポイント (ほぼ文字の左下角) を定義します。 この仕様は、x と y - で最初の文字の右上角を定義する + で最初の文字の左上角を定義する imagestring と異なっています。 例えば、左上は 0, 0 となります。 diff --git a/reference/imagick/imagick/distortimage.xml b/reference/imagick/imagick/distortimage.xml index 3f65ce81d3..058c23752b 100644 --- a/reference/imagick/imagick/distortimage.xml +++ b/reference/imagick/imagick/distortimage.xml @@ -18,7 +18,7 @@ さまざまな方式で画像を歪めます。 これは、元画像の色を新たな画像の色に対応させることで行います。 - 新たな画像は、'bestfit' を true に設定しない限りは元画像と同じ大きさになります。 + 新たな画像は、'bestfit' を &true; に設定しない限りは元画像と同じ大きさになります。 'bestfit' を有効にし、使用する歪め方式がサイズ変更を許可していた場合は、 diff --git a/reference/imagick/imagick/sigmoidalcontrastimage.xml b/reference/imagick/imagick/sigmoidalcontrastimage.xml index b6a25b3daa..da0b7976ad 100644 --- a/reference/imagick/imagick/sigmoidalcontrastimage.xml +++ b/reference/imagick/imagick/sigmoidalcontrastimage.xml @@ -41,7 +41,7 @@ sharpen - If true increase the contrast, if false decrease the contrast. + true の場合はコントラストを上げ、false の場合はコントラストを下げます。 @@ -49,7 +49,7 @@ alpha - The amount of contrast to apply. 1 is very little, 5 is a significant amount, 20 is extreme. + 適用するコントラストの量。1 はごくわずか、5 はかなりの量、20 は極端です。 @@ -57,7 +57,7 @@ beta - Where the midpoint of the gradient will be. This value should be in the range 0 to 1 - multiplied by the quantum value for ImageMagick. + グラデーションの中間点の位置。この値は、0 から 1 の範囲の値に ImageMagick の quantum 値を掛けたものにする必要があります。 @@ -65,7 +65,7 @@ channel - Which color channels the contrast will be applied to. + コントラストを適用する対象のカラーチャンネル。 diff --git a/reference/imagick/imagickdraw/affine.xml b/reference/imagick/imagickdraw/affine.xml index 88b4bfef28..54982efc81 100644 --- a/reference/imagick/imagickdraw/affine.xml +++ b/reference/imagick/imagickdraw/affine.xml @@ -66,20 +66,20 @@ function affine($strokeColor, $fillColor, $backgroundColor) { $PI = 3.141592653589794; $angle = 60 * $PI / 360; - //Scale the drawing co-ordinates. + //描画座標を拡大縮小します $affineScale = array("sx" => 1.75, "sy" => 1.75, "rx" => 0, "ry" => 0, "tx" => 0, "ty" => 0); - //Shear the drawing co-ordinates. + //描画座標をせん断します $affineShear = array("sx" => 1, "sy" => 1, "rx" => sin($angle), "ry" => -sin($angle), "tx" => 0, "ty" => 0); - //Rotate the drawing co-ordinates. The shear affine matrix - //produces incorrectly scaled drawings. + //描画座標を回転します。せん断のアフィン行列では + //正しくない縮尺の描画になります $affineRotate = array("sx" => cos($angle), "sy" => cos($angle), "rx" => sin($angle), "ry" => -sin($angle), "tx" => 0, "ty" => 0,); - //Translate (offset) the drawing + //描画を平行移動(オフセット)します $affineTranslate = array("sx" => 1, "sy" => 1, "rx" => 0, "ry" => 0, "tx" => 30, "ty" => 30); - //The identity affine matrix + //単位アフィン行列 $affineIdentity = array("sx" => 1, "sy" => 1, "rx" => 0, "ry" => 0, "tx" => 0, "ty" => 0); $examples = [$affineScale, $affineShear, $affineRotate, $affineTranslate, $affineIdentity,]; @@ -96,16 +96,16 @@ function affine($strokeColor, $fillColor, $backgroundColor) { $count++; } - //Create an image object which the draw commands can be rendered into + //描画コマンドを描き込む画像オブジェクトを作成します $image = new \Imagick(); $image->newImage(500, 750, $backgroundColor); $image->setImageFormat("png"); - //Render the draw commands in the ImagickDraw object - //into the image. + //ImagickDraw オブジェクト内の描画コマンドを + //画像へレンダリングします $image->drawImage($draw); - //Send the image to the browser + //画像をブラウザへ送信します header("Content-Type: image/png"); echo $image->getImageBlob(); } diff --git a/reference/imagick/imagickdrawexception.xml b/reference/imagick/imagickdrawexception.xml index dbb26a5cc2..63914b9b81 100644 --- a/reference/imagick/imagickdrawexception.xml +++ b/reference/imagick/imagickdrawexception.xml @@ -2,7 +2,7 @@ - The ImagickDrawException class + ImagickDrawException クラス ImagickDrawException diff --git a/reference/imagick/imagickexception.xml b/reference/imagick/imagickexception.xml index 725cffcb84..792ddfa8e2 100644 --- a/reference/imagick/imagickexception.xml +++ b/reference/imagick/imagickexception.xml @@ -2,7 +2,7 @@ - The ImagickException class + ImagickException クラス ImagickException diff --git a/reference/imagick/imagickkernelexception.xml b/reference/imagick/imagickkernelexception.xml index 98c9543ada..2e98ea9770 100644 --- a/reference/imagick/imagickkernelexception.xml +++ b/reference/imagick/imagickkernelexception.xml @@ -4,7 +4,7 @@ - The ImagickKernelException class + ImagickKernelException クラス ImagickKernelException diff --git a/reference/imagick/imagickpixelexception.xml b/reference/imagick/imagickpixelexception.xml index 987d84bb98..0ee64c34f4 100644 --- a/reference/imagick/imagickpixelexception.xml +++ b/reference/imagick/imagickpixelexception.xml @@ -2,7 +2,7 @@ - The ImagickPixelException class + ImagickPixelException クラス ImagickPixelException diff --git a/reference/imagick/imagickpixeliterator/resetiterator.xml b/reference/imagick/imagickpixeliterator/resetiterator.xml index 8c3dd53268..a05d5e392b 100644 --- a/reference/imagick/imagickpixeliterator/resetiterator.xml +++ b/reference/imagick/imagickpixeliterator/resetiterator.xml @@ -44,34 +44,34 @@ function resetIterator($imagePath) { $imageIterator = $imagick->getPixelIterator(); - /* Loop through pixel rows */ + /* ピクセルの行をループします */ foreach ($imageIterator as $pixels) { - /* Loop through the pixels in the row (columns) */ + /* 行内のピクセル(列)をループします */ foreach ($pixels as $column => $pixel) { /** @var $pixel \ImagickPixel */ if ($column % 2) { - /* Make every second pixel 25% red*/ + /* 1つおきのピクセルを25%赤くします*/ $pixel->setColorValue(\Imagick::COLOR_RED, 64); } } - /* Sync the iterator, this is important to do on each iteration */ + /* イテレータを同期します。各イテレーションで行うことが重要です */ $imageIterator->syncIterator(); } $imageIterator->resetiterator(); - /* Loop through pixel rows */ + /* ピクセルの行をループします */ foreach ($imageIterator as $pixels) { - /* Loop through the pixels in the row (columns) */ + /* 行内のピクセル(列)をループします */ foreach ($pixels as $column => $pixel) { /** @var $pixel \ImagickPixel */ if ($column % 3) { - $pixel->setColorValue(\Imagick::COLOR_BLUE, 64); /* Make every second pixel a little blue*/ - //$pixel->setColor("rgba(0, 0, 128, 0)"); /* Paint every second pixel black*/ + $pixel->setColorValue(\Imagick::COLOR_BLUE, 64); /* 1つおきのピクセルを少し青くします*/ + //$pixel->setColor("rgba(0, 0, 128, 0)"); /* 1つおきのピクセルを黒く塗ります*/ } } - $imageIterator->syncIterator(); /* Sync the iterator, this is important to do on each iteration */ + $imageIterator->syncIterator(); /* イテレータを同期します。各イテレーションで行うことが重要です */ } $imageIterator->clear(); diff --git a/reference/imagick/imagickpixeliteratorexception.xml b/reference/imagick/imagickpixeliteratorexception.xml index a4fe670ac0..d032b46a0f 100644 --- a/reference/imagick/imagickpixeliteratorexception.xml +++ b/reference/imagick/imagickpixeliteratorexception.xml @@ -2,7 +2,7 @@ - The ImagickPixelIteratorException class + ImagickPixelIteratorException クラス ImagickPixelIteratorException diff --git a/reference/imap/functions/imap-delete.xml b/reference/imap/functions/imap-delete.xml index 1f70cf2b0a..87f1834d00 100644 --- a/reference/imap/functions/imap-delete.xml +++ b/reference/imap/functions/imap-delete.xml @@ -42,9 +42,9 @@ flags - FT_UID を指定すると、 + FT_UID を指定すると、 引数 message_nums を - UID として処理することを関数に指示できます。 + UID として処理することを関数に指示できます。 @@ -129,7 +129,7 @@ imap_close($mbox); &reftitle.notes; - IMAP メールボックスは、コネクション間で保存可能なメッセージフラグを持っていません。 + IMAP メールボックスでは、コネクション間でメッセージフラグが保存されない場合があります。 そのため、削除マークをつけたメッセージが本当に削除されたことを保証するためには、 同一の接続内で imap_expunge をコールする必要があります。 diff --git a/reference/imap/functions/imap-open.xml b/reference/imap/functions/imap-open.xml index ca2b2b1ba4..2dbbef6cbb 100644 --- a/reference/imap/functions/imap-open.xml +++ b/reference/imap/functions/imap-open.xml @@ -211,7 +211,7 @@ CL_EXPUNGE - メールボックスを閉じる際に、 - 自動的にメールボックスを削除します（imap_delete + 削除マークがついたメッセージを自動的に削除 (expunge) します（imap_delete および imap_expunge も参照ください）。 diff --git a/reference/info/functions/phpversion.xml b/reference/info/functions/phpversion.xml index a18d590ea5..cb47e362c7 100644 --- a/reference/info/functions/phpversion.xml +++ b/reference/info/functions/phpversion.xml @@ -108,7 +108,7 @@ echo phpversion('zip'); * version_compare() を使う必要がなくなります。 * * たとえば、PHP 5.2.7 より前のバージョンには存在しない定数 - * PHP_VERSION_* を、次のように定義することができます。 + * PHP_*_VERSION を、次のように定義することができます。 */ if (PHP_VERSION_ID < 50207) { diff --git a/reference/intl/book.xml b/reference/intl/book.xml index 5c2cfd4f16..fd17e4f3c4 100644 --- a/reference/intl/book.xml +++ b/reference/intl/book.xml @@ -83,6 +83,11 @@ また、文字列を日付や時刻としてパースすることもできます。 + + + Transliterator: さまざまな言語の文字列をラテン文字表記に変換する機能を提供します。 + + diff --git a/reference/intl/intlbreakiterator/getpartsiterator.xml b/reference/intl/intlbreakiterator/getpartsiterator.xml index 19697786b9..2e02d01b31 100644 --- a/reference/intl/intlbreakiterator/getpartsiterator.xml +++ b/reference/intl/intlbreakiterator/getpartsiterator.xml @@ -5,7 +5,7 @@ IntlBreakIterator::getPartsIterator - 境界と境界の間の navigating fragments 用にイテレータを作る + 境界と境界の間のフラグメントを走査するイテレータを作る diff --git a/reference/json/functions/json-decode.xml b/reference/json/functions/json-decode.xml index aa1808e57d..09d21d0b0c 100644 --- a/reference/json/functions/json-decode.xml +++ b/reference/json/functions/json-decode.xml @@ -43,11 +43,11 @@ associative - &true; の場合、返されるオブジェクトは連想配列形式になります。 - &false; の場合、返されるオブジェクトは &object; になります。 - &null; の場合、返されるオブジェクトは flags に + &true; の場合、JSON のオブジェクトは連想配列として返されます。 + &false; の場合は &object; として返されます。 + &null; の場合は、flags に JSON_OBJECT_AS_ARRAY が設定されているかどうかによって、 - 連想配列形式か &object; かが変化します。 + 連想配列と &object; のいずれかで返されます。 diff --git a/reference/json/functions/json-encode.xml b/reference/json/functions/json-encode.xml index a59e7a66a7..211e618a30 100644 --- a/reference/json/functions/json-encode.xml +++ b/reference/json/functions/json-encode.xml @@ -210,8 +210,8 @@ Tags: ["\u003Cfoo\u003E","'bar'","\"baz\"","&blong&","\u00e9"] Apos: ["","\u0027bar\u0027","\"baz\"","&blong&","\u00e9"] Quot: ["","'bar'","\u0022baz\u0022","&blong&","\u00e9"] Amp: ["","'bar'","\"baz\"","\u0026blong\u0026","\u00e9"] -Unicode: ["","'bar'","\"baz\"","&blong&","e"] -All: ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026","e"] +Unicode: ["","'bar'","\"baz\"","&blong&","é"] +All: ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026","é"] Empty array output as array: [] Empty array output as object: {} @@ -383,8 +383,8 @@ string(2) "12" float そして bool を入力として渡したときに json_encode が生成する JSON はシンプルな値 (オブジェクトでもないし配列でもないもの) となります。 - 大半のエンコーダーはこういった値を妥当な JSON として扱いますが、中にはそうでないものもあります。 - そのため、現時点ではこの仕様は不明瞭です。 + 大半のデコーダーはこういった値を妥当な JSON として受け付けますが、 + この点について仕様が曖昧なため、受け付けないものもあります。 要するに、json_encode で生成した JSON diff --git a/reference/ldap/functions/ldap-bind.xml b/reference/ldap/functions/ldap-bind.xml index 18d1b6579a..673c765980 100644 --- a/reference/ldap/functions/ldap-bind.xml +++ b/reference/ldap/functions/ldap-bind.xml @@ -94,7 +94,7 @@ $ldaprdn = 'uname'; // ldap rdn あるいは dn $ldappass = 'password'; // パスワード // ldap サーバーに接続する -$ldapconn = ldap_connect("ldap.example.com") +$ldapconn = ldap_connect("ldap://ldap.example.com") or die("Could not connect to LDAP server."); if ($ldapconn) { @@ -124,7 +124,7 @@ if ($ldapconn) { // ldap 匿名バインドを使用する // ldap サーバーに接続する -$ldapconn = ldap_connect("ldap.example.com") +$ldapconn = ldap_connect("ldap://ldap.example.com") or die("Could not connect to LDAP server."); if ($ldapconn) { @@ -151,6 +151,7 @@ if ($ldapconn) { &reftitle.seealso; + ldap_bind_ext ldap_unbind diff --git a/reference/mail/functions/mail.xml b/reference/mail/functions/mail.xml index 23c00a1846..cd5a748a7d 100644 --- a/reference/mail/functions/mail.xml +++ b/reference/mail/functions/mail.xml @@ -71,8 +71,8 @@ - （Windows のみ）PHP が SMTP サーバーと直接通信をする際、ピリオドから - 始まる行は無視されます。これを防ぐには、行頭のピリオドを + （Windows のみ）PHP が SMTP サーバーと直接通信をする際、行頭に + ピリオドがある場合、そのピリオドは除去されます。これを防ぐには、行頭のピリオドを ピリオド 2 つに置き換えてください。 getMessage(), PHP_EOL; } -try +try { intdiv(1, 0); } catch (Error $e) { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; diff --git a/reference/math/functions/max.xml b/reference/math/functions/max.xml index e7caaffb42..aae227bbe8 100644 --- a/reference/math/functions/max.xml +++ b/reference/math/functions/max.xml @@ -21,7 +21,7 @@ パラメータとして配列をひとつだけ渡した場合は、max - は配列の中で最も大きい数値を返します。 + は配列の中で最も大きい値を返します。 ふたつ以上のパラメータを指定した場合は、max はそれらの中で最も大きいものを返します。 diff --git a/reference/math/functions/round.xml b/reference/math/functions/round.xml index 86b01ecea3..ba691921bc 100644 --- a/reference/math/functions/round.xml +++ b/reference/math/functions/round.xml @@ -121,7 +121,7 @@ - ただし、新規に追加されたいくつかのモードは RoundingMode にのみ存在します。 + ただし、新規に追加されたいくつかのモードは RoundingMode にのみ存在します。 diff --git a/reference/mbstring/functions/mb-strtolower.xml b/reference/mbstring/functions/mb-strtolower.xml index b0d4482d7f..bc1d46e59c 100644 --- a/reference/mbstring/functions/mb-strtolower.xml +++ b/reference/mbstring/functions/mb-strtolower.xml @@ -107,18 +107,18 @@ echo $str; // 結果は τάχιστη αλώπηξ βαφής ψημένη γη - &reftitle.unicode; - - Unicode 文字属性についての詳細は &url.unicode.reports; - を参照ください。 - + &reftitle.notes; strtolower と違い、アルファベットであるかどうかは Unicode 文字属性をもとに決定されます。したがって、この関数の挙動は ロケールの設定に影響されず、すべてのアルファベット、 例えば A ウムラウト (Ä) を変換することができます。 + + Unicode 文字属性についての詳細は &url.unicode.reports; + を参照ください。 + diff --git a/reference/mbstring/functions/mb-trim.xml b/reference/mbstring/functions/mb-trim.xml index 5e1731c09f..21be69c7db 100644 --- a/reference/mbstring/functions/mb-trim.xml +++ b/reference/mbstring/functions/mb-trim.xml @@ -6,7 +6,7 @@ mb_trim - 文字列の先頭および末尾にあるホワイトスペースを取り除く + 文字列の先頭および末尾にあるホワイトスペース (もしくはその他の文字) を取り除く diff --git a/reference/misc/functions/eval.xml b/reference/misc/functions/eval.xml index d13efad7cc..0387bf1f85 100644 --- a/reference/misc/functions/eval.xml +++ b/reference/misc/functions/eval.xml @@ -50,8 +50,7 @@ 有効な PHP コード。これを評価します。 - PHP - 開始タグを含めてはいけません。つまり、 + コードを PHP の開始タグと終了タグで囲んではいけません。つまり、 '<?php echo "Hi!"; ?>' ではなく 'echo "Hi!";' を渡さなければならないということです。 適切に PHP タグを使えば、PHP モードからいったん抜けてもう一度 PHP モードに戻るということも可能です。 @@ -87,8 +86,8 @@ PHP 7 以降、評価されるコードの中でパースエラーが発生した場合は、 eval は ParseError 例外をスローします。 PHP 7 より前のバージョンでは、この場合に - eval は &false; を返していました。 - それ以降のコードは通常通り実行されます。 + eval は &false; を返し、 + それ以降のコードは通常通り実行されていました。 eval の中でのパースエラーを set_error_handler で捕捉することはできません。 diff --git a/reference/misc/functions/exit.xml b/reference/misc/functions/exit.xml index b75fa96b65..902bd0c5ff 100644 --- a/reference/misc/functions/exit.xml +++ b/reference/misc/functions/exit.xml @@ -51,7 +51,7 @@ status が int の場合は、 - この関数は終了直前に status を表示します。 + PHP によって返される終了コードは status になります。 終了コードは 0 から 254 の範囲でなければならず、 diff --git a/reference/mysqli/configure.xml b/reference/mysqli/configure.xml index 470a684389..91e6d2ec50 100644 --- a/reference/mysqli/configure.xml +++ b/reference/mysqli/configure.xml @@ -105,7 +105,7 @@ - その他の PHP 拡張モジュール (php_mysqli.dll など) + PHP 拡張モジュール (php_mysqli.dll など) を有効にするときと同様、PHP のディレクティブ extension_dir を設定して PHP 拡張モジュールのある場所を指定する必要があります。 diff --git a/reference/mysqli/ini.xml b/reference/mysqli/ini.xml index ee053e35a0..659e7e6b5a 100644 --- a/reference/mysqli/ini.xml +++ b/reference/mysqli/ini.xml @@ -221,7 +221,7 @@ - mysqli.default_password + mysqli.default_pw string @@ -257,7 +257,7 @@ - このオプションを有効にすると、接続を閉じて時持続的接続プールに接続を戻す前に、 + このオプションを有効にすると、接続を閉じる時、持続的接続プールに接続を戻す前に、 この接続で保留中だったあらゆるトランザクションがロールバックされます。 このオプションが無効だった場合、接続が再利用されるとき、または実際に閉じられるときだけ、 保留中のトランザクションがロールバックされます。 @@ -272,7 +272,7 @@ API コールや実行時の設定で指定することはできません。 もしそんなことができてしまうと、libmysqlclient とストリームで MYSQL_OPT_READ_TIMEOUT - の値の解釈する方法が違ってしまう可能性があることに注意しましょう。 + の値を解釈する方法が違ってしまう可能性があることに注意しましょう。 diff --git a/reference/mysqli/mysqli/poll.xml b/reference/mysqli/mysqli/poll.xml index 9b246f2579..eceb4ea520 100644 --- a/reference/mysqli/mysqli/poll.xml +++ b/reference/mysqli/mysqli/poll.xml @@ -49,7 +49,7 @@ read - 読み込める結果が残っている接続のリスト。 + 読み込み可能な結果が残っていないかどうかを確認するための接続のリスト。 diff --git a/reference/mysqli/summary.xml b/reference/mysqli/summary.xml index 771929337c..a4cecb8d20 100644 --- a/reference/mysqli/summary.xml +++ b/reference/mysqli/summary.xml @@ -421,7 +421,7 @@ mysqli_stmt::attr_get mysqli_stmt_attr_get N/A - ステートメントアトリビュートの現在の値を取得する + ステートメントの属性の現在の値を取得する mysqli_stmt::attr_set diff --git a/reference/mysqlinfo/set.xml b/reference/mysqlinfo/set.xml index 8e2aa93be1..6906265018 100644 --- a/reference/mysqlinfo/set.xml +++ b/reference/mysqlinfo/set.xml @@ -123,7 +123,7 @@ 人によっては、コネクタとドライバを混同して使うこともあって、混乱の元となります。 MySQL 関連のドキュメントでは、 - コネクタ という用語はデータベース固有の機能を提供するソフトウェアという意味で + ドライバ という用語はコネクタパッケージのうち、データベース固有の部分を提供するソフトウェアという意味で 予約されています。 diff --git a/reference/network/functions/dns-get-record.xml b/reference/network/functions/dns-get-record.xml index a23135371c..be62e066bc 100644 --- a/reference/network/functions/dns-get-record.xml +++ b/reference/network/functions/dns-get-record.xml @@ -135,9 +135,9 @@ ttl - このレコードの"有効期限 (Time To Live)"。レコードの本来の ttl と一致するとは - 限りません。むしろ、 - ネームサーバーへのクエリにかかった時間をそこから引いたものに一致します。 + このレコードの残り"有効期限 (Time To Live)"。レコード本来の ttl とは一致 + せず、本来の ttl から、 + 権威ネームサーバーに問い合わせてから経過した時間を引いた値になります。 diff --git a/reference/network/functions/fsockopen.xml b/reference/network/functions/fsockopen.xml index d569845bb4..1cc56ea2d9 100644 --- a/reference/network/functions/fsockopen.xml +++ b/reference/network/functions/fsockopen.xml @@ -29,7 +29,7 @@ ソケットはデフォルトでブロックモードで開かれます。 - socket_set_blocking を使用して、 + stream_set_blocking を使用して、 非ブロックモードに切換えることができます。 @@ -102,7 +102,7 @@ ソケット経由でデータを読み書きする際のタイムアウトを設定する必要がある場合、 fsockopen の timeout パラメータは、 ソケットに接続する間にだけ適用されるため、 - socket_set_timeout を使用してください。 + stream_set_timeout を使用してください。 diff --git a/reference/network/functions/header.xml b/reference/network/functions/header.xml index fc3a8f181e..e6631547ca 100644 --- a/reference/network/functions/header.xml +++ b/reference/network/functions/header.xml @@ -76,7 +76,7 @@ exit; // この例は、"HTTP/" から始まる特別な場合を示しています。 // これより良い、典型的な使い方として、以下があげられます: // 1. header($_SERVER["SERVER_PROTOCOL"] . " 404 Not Found"); -// (HTTP/1.0 を使いながら、httpステータスメッセージを上書きする) +// (まだ HTTP/1.0 を使っているクライアント向けに http ステータスメッセージを上書きする) // 2. http_response_code(404); (デフォルトのメッセージを使う) header("HTTP/1.1 404 Not Found"); ?> @@ -267,8 +267,8 @@ header('Set-Cookie: name=value; Secure; Path=/; SameSite=None; Partitioned;'); どうかにかかわらず、HTTP ステータスヘッダ行は クライアントに対し常に最初に送信されます。 HTTP ヘッダが既に送信されていない限り、 - header をコールすることでステータスは - 常に上書きされます。 + 新しいステータス行を指定して header を + コールすることで、いつでもステータスを上書きできます。 diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml index aa31ccafdd..b86894d83e 100644 --- a/reference/network/functions/setcookie.xml +++ b/reference/network/functions/setcookie.xml @@ -262,8 +262,8 @@ &reftitle.examples; - The effects of the following examples can be observed using the browser - developer tools cookie list (usually in the Storage or Application tab). + 以下の例の効果は、ブラウザの開発者ツールのクッキー一覧 + (通常は Storage タブまたは Application タブ) で確認できます。 <function>setcookie</function> でクッキーを送信する例 diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index 0b94cc1bb2..8f9a4f9753 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -306,7 +306,7 @@ 通常は、入力されたメッセージは CR および LF を行端として使用した - 「正規化」された形式に変換されます。こらは、S/MIME の規格に + 「正規化」された形式に変換されます。これは、S/MIME の規格に 基づくものです。このオプションが指定された場合、変換は行われません。 この機能は、MIME 形式でないバイナリデータを処理する際に 便利です。 @@ -474,9 +474,9 @@ (int) - 暗号化済み/署名済み のメッセージに対して text/plain のヘッダを追加します。 - 復号化 または 検証する際に、これらのヘッダは出力から削除されます - - もし 複号化済み/検証済み メッセージの MIMEタイプ が text/plain + 暗号化済み/署名済み のメッセージに対して text/plain の content type ヘッダを追加します。 + 復号化 または 検証する際に、これらのヘッダは出力から削除されます。 + もし 復号化済み/検証済み メッセージの MIMEタイプ が text/plain でない場合、エラーが発生します。 @@ -488,8 +488,8 @@ 通常、入力されるメッセージは 行末を CR と LF として用いる - "canonical" フォーマットに変換されます: - これは、CMS の仕様です。 + 「正規化」された形式に変換されます。 + これは、CMS の仕様に基づくものです。 このオプションが指定されると、変換は行われません。 これは、 CMS フォーマットではない可能性があるバイナリデータを扱うのに便利です。 diff --git a/reference/outcontrol/functions/ob-start.xml b/reference/outcontrol/functions/ob-start.xml index 911dc9060a..fe7454ec73 100644 --- a/reference/outcontrol/functions/ob-start.xml +++ b/reference/outcontrol/functions/ob-start.xml @@ -18,38 +18,24 @@ この関数は出力のバッファリングをオンにします。 - 出力のバッファリングを有効にすると、 - (ヘッダ以外の) スクリプトからの出力は実際には行われず、 + 出力のバッファリングが有効な間は、スクリプトからの出力は送信されず、 代わりに内部バッファに保存されます。 + どの出力が影響を受けるのかについては + + を参照ください。 - この内部バッファの内容は、ob_get_contents - を用いて文字列変数にコピーされます。 - 内部バッファの内容を出力するには - ob_end_flush を使用します。 - ob_end_clean - は、バッファの内容を出力せずに消去します。 + 出力バッファはスタッカブルです。つまり、他のバッファがアクティブな間に + ob_start をコールできます。 + 複数の出力バッファがアクティブの場合、 + 出力はネストした順番でそれぞれのバッファを通して逐次フィルタ処理されます。 + 詳細は + を参照ください。 - - - web サーバーによっては (例: Apache)、コールバック関数からコールされた際に、 - スクリプトの実行ディレクトリを変更するものがあります。 - コールバック関数の内部で chdir(dirname($_SERVER['SCRIPT_FILENAME'])) - などと指定することで、これをもとに戻すことが可能です。 - - - 出力バッファはスタッカブルであり、このため、他の - ob_start がアクティブの間に - ob_start をコールすることが可能です。この場合、 - ob_end_flush を適切な回数コールするようにしてください。 - 複数の出力コールバック関数がアクティブの場合、 - ネストした順番で逐次連続的に出力がフィルタ処理されます。 - - - スクリプトが終了した際に、 - 出力バッファリングがまだアクティブな場合、 - PHP はバッファリングされた内容を自動的に出力します。 + 出力バッファの詳細な説明は + + を参照ください。 @@ -61,20 +47,17 @@ callback - オプションの引数 callback - 関数を指定することが可能です。この関数は、パラメータとして文字列をとり、 - 文字列を返します。このコールバック関数は、 - 出力バッファがフラッシュ (送信) あるいは消去 - (ob_flush, ob_clean - あるいは同等の関数で) された場合、 - またはリクエストの最後にブラウザに出力をフラッシュする際にコールされます。 - callback がコールされた際に、 - この関数は出力バッファの内容をパラメータとして受け取ります。このコールバック関数は、 - 新規の出力バッファを実際に出力される結果として返す必要があり、 - この結果はブラウザに送信されます。 - callback がコール可能な関数ではない場合は - &false; を返します。 - コールバックのシグネチャは、次のとおりです。 + オプションの callback として、 + callable を指定できます。 + &null; を渡すことでバイパスすることもできます。 + + + callback は、出力バッファがフラッシュ (送信) + または消去されたとき、あるいはスクリプトの最後に出力バッファが + フラッシュされる際にコールされます。 + + + callback のシグネチャは、次のとおりです。 @@ -95,9 +78,12 @@ phase - PHP_OUTPUT_HANDLER_* - 定数 のビットマスク + + PHP_OUTPUT_HANDLER_* + 定数 + のビットマスク。 + 詳細は + を参照ください。 @@ -105,33 +91,26 @@ callback が &false; - を返すと、元の入力がそのままブラウザに送信されます。 - - - callback パラメータに &null; 値を渡すと、 - これをバイパスすることができます。 + を返すと、バッファの内容が返されます。 + 詳細は + を参照ください。 + + + 出力ハンドラの内部から次の関数をコールすると、 + 致命的なエラー (fatal error) となります。 + ob_clean, ob_end_clean, + ob_end_flush, ob_flush, + ob_get_clean, ob_get_flush, + ob_start。 + + - ob_end_clean、 - ob_end_flush、ob_clean、 - ob_flush および ob_start - をコールバック関数の内部からコールすることはできません。 - 実際にコールした際の挙動は未定義です。バッファの内容を消去したい際には、 - コールバック関数から "" (空文字列) を返してください。 - 同じく、print_r($expression, true) や - highlight_file($filename, true) のような - 出力バッファリング関数も、 - コールバック関数の内部からコールすることはできません。 + callback (出力ハンドラ) の詳細は + および + + を参照ください。 - - - Web ページの圧縮をサポートする圧縮 gz エンコード - されたデータの Web ブラウザへの送信を容易にするために - ob_gzhandler が存在します。 - ob_gzhandler は、ブラウザが受け入れる content - encoding の型を調べ、それに基づいて出力を返します。 - - @@ -139,10 +118,11 @@ オプションのパラメータ chunk_size が渡された場合、 - バッファの長さが chunk_size バイトを超えるたびに、 - 出力の後でバッファがフラッシュされます。 - デフォルト値は 0 で、これは出力関数がコールされるのが - 出力バッファが閉じたときだけであることを意味します。 + バッファの長さが chunk_size バイト以上になる出力があった後で、 + バッファがフラッシュされます。 + デフォルト値は 0 で、これはバッファがオフになるまで + すべての出力がバッファリングされることを意味します。 + 詳細は を参照ください。 @@ -179,7 +159,6 @@ PHP_OUTPUT_HANDLER_FLUSHABLE - ob_end_flush ob_flush diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml index c5ee22ab5e..c7899eae7b 100644 --- a/reference/password/functions/password-hash.xml +++ b/reference/password/functions/password-hash.xml @@ -105,7 +105,7 @@ memory_cost (int) - Argon2 ハッシュを計算するのに - 使われるメモリの最大値(キロバイト単位)。 + 使われるメモリの最大値(キビバイト単位)。 デフォルトは PASSWORD_ARGON2_DEFAULT_MEMORY_COST です。 @@ -165,9 +165,6 @@ &password.parameter.options; - - 省略した場合は、ランダムな salt を生成してデフォルトのコストを使います。 - @@ -205,6 +202,17 @@ 10 から 12 に引き上げられました。 + + 8.3.0 + + password_hash は、 + salt の生成に失敗して + ValueError がスローされる場合、 + 根本原因の + Random\RandomException を + Exception::$previous の例外として設定するようになりました。 + + 8.0.0 diff --git a/reference/pcntl/functions/pcntl-signal.xml b/reference/pcntl/functions/pcntl-signal.xml index d12cc9eca9..09c2143400 100644 --- a/reference/pcntl/functions/pcntl-signal.xml +++ b/reference/pcntl/functions/pcntl-signal.xml @@ -84,7 +84,8 @@ restart_syscalls - 再起動のシステムコールに対応するかどうかを設定します。 + このシグナルが到着したときに、システムコールの再スタート (restart) + を行うかどうかを指定します。 diff --git a/reference/pcntl/functions/pcntl-waitpid.xml b/reference/pcntl/functions/pcntl-waitpid.xml index 2049af4380..47429f80b7 100644 --- a/reference/pcntl/functions/pcntl-waitpid.xml +++ b/reference/pcntl/functions/pcntl-waitpid.xml @@ -56,7 +56,7 @@ -1 - 全ての子プロセスを待ちます。これは、 + いずれかの子プロセスを待ちます。これは、 pcntl_wait 関数の動作と同じです。 @@ -123,8 +123,8 @@ WUNTRACED - 停止した子プロセスの場合に処理を返します。そして、ステータス - は報告されません。 + 停止していて、かつステータスがまだ報告されていない + 子プロセスの場合にも処理を返します。 diff --git a/reference/pcre/functions/preg-match-all.xml b/reference/pcre/functions/preg-match-all.xml index 9e902ebb34..44f795984c 100644 --- a/reference/pcre/functions/preg-match-all.xml +++ b/reference/pcre/functions/preg-match-all.xml @@ -64,7 +64,7 @@ flags - flags を指定しない場合は、 + 順序を指定するフラグを指定しない場合は、 PREG_PATTERN_ORDER が指定されたことになります。 @@ -341,9 +341,9 @@ preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", bold textclick me"; preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $matches, PREG_SET_ORDER); diff --git a/reference/pcre/functions/preg-match.xml b/reference/pcre/functions/preg-match.xml index db899a5252..4c240e8ff2 100644 --- a/reference/pcre/functions/preg-match.xml +++ b/reference/pcre/functions/preg-match.xml @@ -234,7 +234,7 @@ Array substr 関数を利用しない別の方法として、 ^ アンカーではなく、 言明 \G または - A 修正子を使う方法があります。 + A 修飾子を使う方法があります。 これらは両方とも offset パラメータとともに動作します。 @@ -338,12 +338,12 @@ if (preg_match("/\bweb\b/i", "PHP is the website scripting language of choice.") diff --git a/reference/pcre/functions/preg-replace.xml b/reference/pcre/functions/preg-replace.xml index deb49bf5af..0de0abd709 100644 --- a/reference/pcre/functions/preg-replace.xml +++ b/reference/pcre/functions/preg-replace.xml @@ -71,7 +71,7 @@ \0 または $0 は パターン全体にマッチするテキストを参照します。キャプチャ用サブパターンの番号 については、その左括弧が左から右に（1から）カウントされます。 - &string; に含まれるバックスラッシュリテラルは、エスケープが必須であることに注意して下さい。 + &string; リテラル内のバックスラッシュは、エスケープが必要になる場合があることに注意してください。 後方参照の直後に他の数字が続くような置換 (replacement) パターンを @@ -316,8 +316,8 @@ xp***to のペアの適用結果に対して行われます。 オリジナルの文字列に対しては行われません。 ふたつの値の交換のような、置換の操作を並列で行わせたい場合は、 - 中間のプレースホルダー内で一方のパターンを置換した後に、 - そのプレースホルダーに対して望んだ置換を行うようにしましょう。 + 一方のパターンをいったん中間プレースホルダーに置換しておき、 + 後のペアでそのプレースホルダーを望みの置換文字列に置換するようにしましょう。 diff --git a/reference/pcre/pattern.modifiers.xml b/reference/pcre/pattern.modifiers.xml index 4012fa101c..b73dc28a2e 100644 --- a/reference/pcre/pattern.modifiers.xml +++ b/reference/pcre/pattern.modifiers.xml @@ -92,7 +92,8 @@ この修飾子を設定すると、パターン内のドルメタ文字は、検索対象文字列の 終わりにのみマッチします。この修飾子を設定しない場合、ドル記号は、 - 検索対象文字列の最後の文字が改行文字であれば、その直前にもマッチします。 + 検索対象文字列の最後の文字が改行文字であれば、その直前にもマッチします + （ただし、それ以外の改行の前にはマッチしません）。 この修飾子は、m を設定している場合に無視されます。 Perl には、この修飾子に等価なものはありません。 @@ -105,8 +106,8 @@ あるパターンを複数回使用する場合は、マッチングにかかる時間を 高速化することを目的として、パターンの分析に幾分か時間をかけても 良いでしょう。この修飾子を設定すると、追加のパターン分析が - 行われます。現在、パターン分析は、最初の文字が単一ではなく、 - かつ固定でないパターンに対してのみ有用です。 + 行われます。現在、パターン分析は、アンカー (anchored) されていない + パターンで、かつ開始文字が単一の固定文字に定まらないものに対してのみ有用です。 このフラグは、PHP 7.3.0 以降は設定しても何も起こりません。 @@ -137,7 +138,7 @@ X (PCRE_EXTRA) - この修正子は、Perl 非互換な PCRE の機能を有効にします。 + この修飾子は、Perl 非互換な PCRE の機能を有効にします。 パターン内で後ろに文字が続くバックスラッシュで特別な意味がないものは、 将来的な拡張の際の互換性の維持のため、エラーになります。 デフォルトでは、Perl のように文字が後ろに続くバックスラッシュ @@ -160,7 +161,7 @@ u (PCRE_UTF8) - この修正子は、Perl 非互換な PCRE の機能を有効にします。パターンと対象文字列は、 + この修飾子は、Perl 非互換な PCRE の機能を有効にします。パターンと対象文字列は、 UTF-8 として処理されます。 無効な対象文字列を preg_* 関数に渡しても、何もマッチしません。 無効なパターンを渡すと、E_WARNING レベルのエラーが発生します。 @@ -172,11 +173,11 @@ n (PCRE_NO_AUTO_CAPTURE) - この修正子を使うと、単純な (xyz) 形式でのグループ化ではキャプチャを行いません。 + この修飾子を使うと、単純な (xyz) 形式でのグループ化ではキャプチャを行いません。 (?<name>xyz) のような、名前付きのグループ化を使う場合にのみ、キャプチャを行うようになります。 これによって影響を受けるのは、どのグループがキャプチャされるかだけです。 番号付きのサブパターンによる参照もまだ使えますし、 - その場合マッチ結果が格納される配列には数値が含まれています。 + マッチ結果が格納される配列にも引き続き番号付きの結果が含まれます。 PHP 8.2.0 以降で利用可能です。 diff --git a/reference/pcre/pattern.syntax.xml b/reference/pcre/pattern.syntax.xml index 5376575acf..c2650bd66a 100644 --- a/reference/pcre/pattern.syntax.xml +++ b/reference/pcre/pattern.syntax.xml @@ -658,7 +658,7 @@ これらは、デリミタの動作を変更しないことに注意して下さい。 たとえば、#\Q#\E#$ は無効なパターンです。 なぜなら、# がパターンの終端としてマークされ、 - \E# が無効な修正子と解釈されるからです。 + \E# が無効な修飾子と解釈されるからです。 diff --git a/reference/pdo/constants.xml b/reference/pdo/constants.xml index 291445e466..d3f2fd66f8 100644 --- a/reference/pdo/constants.xml +++ b/reference/pdo/constants.xml @@ -765,7 +765,7 @@ PDO::sqliteCreateFunction で作られる関数が決定論的であることを指定します。 つまり、同じ入力が与えられると、 - 単一のSQLステートメントの範疇では同じ結果が常に返されます。 + 単一のSQLステートメントの範囲では同じ結果が常に返されます。 (PHP 7.1.4 以降で使用可能です) diff --git a/reference/pdo/error-handling.xml b/reference/pdo/error-handling.xml index 32a3768eb5..8420693b7c 100644 --- a/reference/pdo/error-handling.xml +++ b/reference/pdo/error-handling.xml @@ -73,7 +73,7 @@ ネイティブのコードを適切な SQLSTATE コードに変換するのは、個々の PDO ドライバの仕事となります。 PDO::errorCode メソッドは SQLSTATE コードを返します。 - エラーについての詳細な銃尾法が知りたい場合、PDO では + エラーについての詳細な情報が知りたい場合、PDO では PDO::errorInfo メソッドも提供しており、 これは SQLSTATE コード、ドライバ固有のエラーコードおよびドライバ固有の エラーメッセージを含む配列を返します。 diff --git a/reference/pdo/pdo/getattribute.xml b/reference/pdo/pdo/getattribute.xml index ddaf4e45e5..4e2a658413 100644 --- a/reference/pdo/pdo/getattribute.xml +++ b/reference/pdo/pdo/getattribute.xml @@ -23,8 +23,8 @@ - いくつかのデータベースもしくはドライバは、 - データベース接続の属性の全てのをサポートしていないかも知れないことに + データベースとドライバの組み合わせによっては、 + データベース接続の属性のすべてをサポートしていないかも知れないことに 注意してください。 @@ -38,7 +38,7 @@ attribute - PDO_ATTR_* 定数の 1 つを指定します。 + PDO::ATTR_* 定数の 1 つを指定します。 データベース接続に適用される一般的な属性は以下の通りです。 PDO::ATTR_AUTOCOMMIT diff --git a/reference/pdo/pdo/prepare.xml b/reference/pdo/pdo/prepare.xml index 997278a59c..cb78ef9f27 100644 --- a/reference/pdo/pdo/prepare.xml +++ b/reference/pdo/pdo/prepare.xml @@ -69,8 +69,9 @@ これによって、バックスラッシュのすぐ後にクォートで終了するクエリは そのままの形では認識されず、間違ったパラメータとして認識され、 実行されたときにプリペアドステートメントが失敗してしまいます。 - 回避策は、プリペアドステートメントのエミュレートをこの手のSQLクエリでは使わないようにしつつ、 - ドライバによってサポートされているパラメータの書き換えを避けることです。 + 回避策は、プリペアドステートメントのエミュレートをこの手のSQLクエリでは使わないようにし、 + かつ、ドライバがネイティブにサポートしているパラメータ形式を使うことで、 + パラメータの書き換えを避けることです。 diff --git a/reference/pdo/pdorow.xml b/reference/pdo/pdorow.xml index 591c4becf1..f96c89338d 100644 --- a/reference/pdo/pdorow.xml +++ b/reference/pdo/pdorow.xml @@ -30,9 +30,11 @@ つまり、返されるデータはオブジェクトのプロパティのようにアクセスできますし、 カラム名やカラムのオフセット番号でインデックスされた配列としてもアクセスできます。 - - プロパティが未定義の場合は、警告を発生させることなく &null; を返します。 - + + + プロパティが未定義の場合は、警告を発生させることなく &null; を返します。 + + diff --git a/reference/pdo/pdostatement/execute.xml b/reference/pdo/pdostatement/execute.xml index f971fe39a1..42cd8f74db 100644 --- a/reference/pdo/pdostatement/execute.xml +++ b/reference/pdo/pdostatement/execute.xml @@ -21,8 +21,8 @@ パラメータマーカに PHP 変数や値を(それぞれ)バインドするため PDOStatement::bindParam や PDOStatement::bindValue をコールする。 - 関連づけされたパラメータマーカがあれば、バインドされた変数は入力値を渡す - もしくは出力値を受け取ります。 + バインドされた変数は、関連づけされたパラメータマーカに対して + 入力として値を渡し、出力値があればそれを受け取ります。 あるいは、入力専用のパラメータ値の配列を渡す diff --git a/reference/pdo/pdostatement/fetch.xml b/reference/pdo/pdostatement/fetch.xml index 48b4ba5879..b9c47aa115 100644 --- a/reference/pdo/pdostatement/fetch.xml +++ b/reference/pdo/pdostatement/fetch.xml @@ -121,8 +121,8 @@ PDOStatement に対してスクロール可能なカーソルを要求するためには、 PDO::prepare を用いて SQL ステートメントを 準備する際、 - PDO::CURSOR_SCROLL に - PDO::ATTR_CURSOR 属性を設定する必要があります。 + PDO::ATTR_CURSOR 属性に + PDO::CURSOR_SCROLL を設定する必要があります。 @@ -187,13 +187,13 @@ print "\n"; print "PDO::FETCH_LAZY: "; print "Return next row as a PDORow object with column names as properties\n"; $result = $sth->fetch(PDO::FETCH_LAZY); -print $result->name; +print_r($result); print "\n"; print "PDO::FETCH_OBJ: "; print "Return next row as an anonymous object with column names as properties\n"; $result = $sth->fetch(PDO::FETCH_OBJ); -print $result->NAME; +print $result->name; print "\n"; ?> ]]> diff --git a/reference/pdo/prepared-statements.xml b/reference/pdo/prepared-statements.xml index 04f5832ace..cd23489365 100644 --- a/reference/pdo/prepared-statements.xml +++ b/reference/pdo/prepared-statements.xml @@ -33,7 +33,7 @@ プリペアドステートメントに渡すパラメータは、引用符で括る必要は ありません。それはドライバが自動的に行います。 - アプリケーションで明示的にプリペアドステートメントを使用するように + アプリケーションでプリペアドステートメントだけを使用するように すれば、SQL インジェクションは決して発生しません (しかし、もし信頼できない入力をもとにクエリの他の部分を構築している のならば、その部分に対するリスクを負うことになります)。 diff --git a/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml b/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml index 323575fbac..89cb588667 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml @@ -20,8 +20,8 @@ rows 配列からデータをテーブル - tableName にコピーします。その際、separator を - フィールドのデリミタ、そして fields のリストを使います。 + tableName にコピーします。その際、フィールドのデリミタとして + separator を、フィールドの一覧として fields を使用します。 diff --git a/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml b/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml index ddfd2c61c4..e4ebf81da0 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml @@ -20,8 +20,8 @@ filename で指定されたファイルからデータを - テーブル tableName にコピーします。その際、 - separator をフィールドのデリミタ、そして fields のリストを使います。 + テーブル tableName にコピーします。その際、フィールドのデリミタとして + separator を、フィールドの一覧として fields を使用します。 diff --git a/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml b/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml index c2d8237c2a..8dda0e6e81 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml @@ -5,7 +5,7 @@ Pdo\Pgsql::copyToArray - データベーステーブルからのデータをPHPの配列にコピーする + データベーステーブルのデータをPHPの配列にコピーする @@ -18,7 +18,7 @@ stringnullfields&null; - tableName のデータを配列にコピーします。その際、separator をフィールドのデリミタ、そして fields のリストを使います。 + tableName のデータを配列にコピーします。その際、フィールドのデリミタとして separator を、フィールドの一覧として fields を使用します。 @@ -42,7 +42,7 @@ &reftitle.returnvalues; - 行の配列を返します。&return.falseforfailure; + 行の配列を返します。&return.falseforfailure;。 diff --git a/reference/pdo_pgsql/pdo/pgsql/copytofile.xml b/reference/pdo_pgsql/pdo/pgsql/copytofile.xml index 37519cdfca..7319f7f6cb 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copytofile.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copytofile.xml @@ -20,8 +20,8 @@ filename で指定されたファイルに、テーブルからデータをコピーします。 - その際、separator をフィールドのデリミタ、そして - fields のリストを使います。 + その際、フィールドのデリミタとして separator を、フィールドの一覧として + fields を使用します。 @@ -33,7 +33,7 @@ filename - エキスポートするファイル名 + エクスポートするファイル名 diff --git a/reference/pdo_pgsql/pdo/pgsql/getnotify.xml b/reference/pdo_pgsql/pdo/pgsql/getnotify.xml index c7089a558d..f952867292 100644 --- a/reference/pdo_pgsql/pdo/pgsql/getnotify.xml +++ b/reference/pdo_pgsql/pdo/pgsql/getnotify.xml @@ -5,7 +5,7 @@ Pdo\Pgsql::getNotify - 非同期に通知を取得する + 非同期な通知を取得する diff --git a/reference/pdo_pgsql/pdo/pgsql/getpid.xml b/reference/pdo_pgsql/pdo/pgsql/getpid.xml index 9636d4ab53..03e7537412 100644 --- a/reference/pdo_pgsql/pdo/pgsql/getpid.xml +++ b/reference/pdo_pgsql/pdo/pgsql/getpid.xml @@ -29,7 +29,7 @@ &reftitle.returnvalues; - サーバーのPIDを int として返します。 + PIDを int として返します。 diff --git a/reference/pdo_pgsql/reference.xml b/reference/pdo_pgsql/reference.xml index 7a2607ccd9..f426dca50f 100644 --- a/reference/pdo_pgsql/reference.xml +++ b/reference/pdo_pgsql/reference.xml @@ -30,7 +30,7 @@ &reference.pdo-pgsql.constants;
- General notes + 一般的な注意事項 bytea カラムはストリームリソースとして返されます。 @@ -148,8 +148,8 @@ pgsql:host=localhost;port=5432;dbname=testdb;user=bruce;password=mypass - 以下の例は、unix ソケット経由で PostgreSQL データベースに接続するための PDO_PGSQL DSN - を示します: + 以下の例は、unix ソケット /tmp/.s.PGSQL.5432 経由で PostgreSQL + データベースに接続するための PDO_PGSQL DSN を示します: - The PgSql\Lob class + PgSql\Lob クラス PgSql\Lob diff --git a/reference/pgsql/pgsql.result.xml b/reference/pgsql/pgsql.result.xml index 236f20793f..93dcdff86b 100644 --- a/reference/pgsql/pgsql.result.xml +++ b/reference/pgsql/pgsql.result.xml @@ -2,7 +2,7 @@ - The PgSql\Result class + PgSql\Result クラス PgSql\Result diff --git a/reference/phar/Phar/construct.xml b/reference/phar/Phar/construct.xml index 74f26d57d7..2e39d87d2d 100644 --- a/reference/phar/Phar/construct.xml +++ b/reference/phar/Phar/construct.xml @@ -25,7 +25,7 @@ 既存の Phar アーカイブ、あるいは作成したいアーカイブへのパス。 - ファイル名の拡張子は .phar にする必要があります。 + ファイル名の拡張子には .phar が含まれている必要があります。 @@ -42,8 +42,8 @@ alias - ストリーム機能をコールする場合に Phar - アーカイブが参照するエイリアス。 + ストリーム機能をコールする際に、この Phar + アーカイブを参照するために使うエイリアス。 diff --git a/reference/reflection/reflectionfunctionabstract/hastentativereturntype.xml b/reference/reflection/reflectionfunctionabstract/hastentativereturntype.xml index 644d12600e..9d77f0b434 100644 --- a/reference/reflection/reflectionfunctionabstract/hastentativereturntype.xml +++ b/reference/reflection/reflectionfunctionabstract/hastentativereturntype.xml @@ -4,7 +4,7 @@ ReflectionFunctionAbstract::hasTentativeReturnType - 戻り値の型を仮で宣言しているかを返す + 仮の戻り値の型を宣言しているかを返す diff --git a/reference/session/examples.xml b/reference/session/examples.xml index 8ccd764c9e..3b8b85a29c 100644 --- a/reference/session/examples.xml +++ b/reference/session/examples.xml @@ -77,7 +77,7 @@ unset($_SESSION['count']); unset($_SESSION)によって - 全ての$_SESSIONを初期化してはいけません。 + $_SESSIONを完全に unset してはいけません。 $_SESSIONスーパーグローバル変数を用いた セッション変数の登録ができなくなってしまうからです。 @@ -126,12 +126,11 @@ unset($_SESSION['count']); sessionモジュールは、両方の方法をサポートします。 - Cookieは最適ですが、(クライアントがCookieを受け入れない可能性が - あるため)信頼性がなく、これに依存することができません。2番目の方 - 法は、セッションIDを直接URLに埋め込みます。 + Cookieは最適ですが、必ずしも利用できるとは限らないため、代替の方法も用意しています。 + 2番目の方法は、セッションIDを直接URLに埋め込みます。 - PHPには、透過的にリンクを変換する機能を有しています。 + PHPには、透過的にリンクを変換する機能があります。 この実行時オプション session.use_trans_sidが有効な場合、 相対URIは自動的にセッションIDを含むように変換されます。 @@ -228,8 +227,8 @@ if (empty($_SESSION['count'])) { セッションが開始するときに、PHP は内部的に open ハンドラをコールします。 - それに続けて read コールバックを実行し、 - このコールバックがエンコードされた文字列を返します。これは最初にセッションストレージに渡されたものと同じ形式になります。 + それに続けて read コールバックを実行します。 + このコールバックは、保存のために最初に渡されたものとまったく同じ、エンコードされた文字列を返す必要があります。 read コールバックがエンコードした文字列を返したら、 PHP がそれをデコードしてデコード後の配列をスーパーグローバル $_SESSION に格納します。 diff --git a/reference/session/functions/session-decode.xml b/reference/session/functions/session-decode.xml index 746308188e..82f898abae 100644 --- a/reference/session/functions/session-decode.xml +++ b/reference/session/functions/session-decode.xml @@ -15,7 +15,7 @@ session_decode は、 - data のセッションデータをデコードし、 + data のシリアライズされたセッションデータをデコードし、 スーパーグローバル $_SESSION にその結果を格納します。 @@ -34,7 +34,7 @@ data - エンコードされたデータ。 + 格納するエンコードされたデータ。 diff --git a/reference/session/functions/session-regenerate-id.xml b/reference/session/functions/session-regenerate-id.xml index a077b9a6de..601d8f9d56 100644 --- a/reference/session/functions/session-regenerate-id.xml +++ b/reference/session/functions/session-regenerate-id.xml @@ -32,9 +32,9 @@ そのため、 session_regenerate_id を 呼ぶと、セッションが消失する恐れがあります。 - すぐに古いセッションデータを破棄すべきではありませんが、 - 古いセッションID のタイムスタンプと、 - アクセス制御は破棄すべきでしょう。 + 古いセッションデータをすぐに破棄すべきではありません。 + 破棄した時刻のタイムスタンプを使って、 + 古いセッションIDへのアクセスを制御すべきです。 さもないと、ページへの同時アクセスによって、 状態の不整合が発生したり、セッションが失われたり、 クライアント(ブラウザ) 側のレースコンディションが発生したり、 diff --git a/reference/session/functions/session-start.xml b/reference/session/functions/session-start.xml index 9f8ebf6760..abda97c54c 100644 --- a/reference/session/functions/session-start.xml +++ b/reference/session/functions/session-start.xml @@ -42,8 +42,8 @@ ユーザーが ob_start と共に ob_gzhandler または類似のものを使用している場合、 出力ハンドラの順番は正しく出力を行うために重要です。例えば、 - セッション開始時にユーザーは ob_gzhandler - を登録する必要があります。 + セッションを開始する前に ob_gzhandler + を登録しておく必要があります。 diff --git a/reference/session/ini.xml b/reference/session/ini.xml index 9cdd182c3c..0579a6e6e7 100644 --- a/reference/session/ini.xml +++ b/reference/session/ini.xml @@ -94,7 +94,7 @@ session.cookie_httponly "0" INI_ALL - PHP 7.2.0 より前のバージョンでは、デフォルト値は "" でした。"" + PHP 7.2.0 より前のバージョンでは、デフォルト値は "" でした。 session.cookie_samesite @@ -409,7 +409,7 @@ session.gc_divisorと session.gc_probabilityの組み合わせで - すべてのセッションの初期化過程でgc（ガーベッジコネクション）プロセス + すべてのセッションの初期化過程でgc（ガーベッジコレクション）プロセス も始動する確率を制御します。確率は gc_probability/gc_divisor で計算されます。例えば、1/100は各リクエスト毎に1%の確率でGCプロセスが 始動します。 @@ -655,11 +655,14 @@ - クッキーはセキュアな接続を通じてのみ送信すべきものです。 + session.cookie_secure は、 + クッキーをセキュアな接続を通じてのみ送信すべきかどうかを指定します。 このオプションを on にすると、 セッションは HTTPS 接続の場合にのみ動作します。 off の場合には、HTTP と HTTPS 接続の両方で動作します。 デフォルトは off です。 + session_get_cookie_params および + session_set_cookie_params も参照ください。 @@ -815,7 +818,7 @@ session.trans_sid_hosts は、 - は、透過的セッションIDのサポートが有効な場合にどのホストをセッションIDつきにリライトするかを指定します。 + 透過的セッションIDのサポートが有効な場合にどのホストをセッションIDつきにリライトするかを指定します。 デフォルトは $_SERVER['HTTP_HOST'] です。 複数のホストを指定する場合は "," で区切ってつなぎます。 ホストとホストの間にスペースを入れることはできません。つまり、たとえば @@ -921,9 +924,9 @@ hash_algos 関数で取得できます。 - + この設定は、PHP 7.1.0 で削除されました。 - + @@ -942,9 +945,9 @@ '6' (0-9, a-z, A-Z, "-", ",") です。 - + この設定は、PHP 7.1.0 で削除されました。 - + diff --git a/reference/session/sessionhandler/read.xml b/reference/session/sessionhandler/read.xml index cdf694ee5d..a8609480ab 100644 --- a/reference/session/sessionhandler/read.xml +++ b/reference/session/sessionhandler/read.xml @@ -18,7 +18,8 @@ セッションのデータをセッションストレージから読み込み、その結果を PHP の内部処理用に返します。 このメソッドは PHP がセッションを自動的に開始したとき、あるいは session_start - を実行したときにコールされ、内部的に SessionHandler::open で処理されます。 + を実行したときにコールされます。このメソッドがコールされる前に、内部的に + SessionHandler::open がコールされます。 このメソッドは、このハンドラが session_set_save_handler @@ -57,7 +58,7 @@ &reftitle.returnvalues; - 読み込んだデータを常に文字列で返します。何も読まなかった場合は &false; を返さなければなりません。 + 読み込んだデータをエンコードした文字列で返します。何も読まなかった場合は &false; を返さなければなりません。 この値は、PHP の内部で処理されるものであることに注意しましょう。 diff --git a/reference/simplexml/examples.xml b/reference/simplexml/examples.xml index 00210aaab9..93a76ae2d1 100644 --- a/reference/simplexml/examples.xml +++ b/reference/simplexml/examples.xml @@ -60,7 +60,7 @@ XML; SimpleXML の容易さが最も明確に現われるのは、 簡単な XML ドキュメントから文字列または数字を展開する時です。 - Getting <literal><plot></literal> + <literal><plot></literal> を取得する 値を設定する - SimpleXMLの中のデータは、定数とすることができません。 + SimpleXMLの中のデータは、不変である必要はありません。 オブジェクトは、その全ての要素について変更が可能です。 @@ -438,9 +438,7 @@ echo $movies->movie->attributes("xml", true)["id"] . "\n"; // 名前空間付きの属性は attributes() でアクセスできます。 echo $movies->movie->attributes("a", true)["link"] . "\n"; -// Using namespace URI allows document to use any namespace alias. - -// 名前空間URI を使うと、ドキュメントを任意の名前空間のエイリアスとして使えます +// 名前空間 URI を使えば、ドキュメントがどんな名前空間エイリアスを使っていてもアクセスできます echo $movies->movie->attributes("http://a")["link"] . "\n"; // 子要素は children() を使ってアクセスできます diff --git a/reference/simplexml/functions/simplexml-load-string.xml b/reference/simplexml/functions/simplexml-load-string.xml index 454fa4d360..1e1ed49d57 100644 --- a/reference/simplexml/functions/simplexml-load-string.xml +++ b/reference/simplexml/functions/simplexml-load-string.xml @@ -41,7 +41,7 @@ このオプションのパラメータを使用して、 - simplexml_load_file + simplexml_load_string が指定されたクラスのオブジェクトを返すようにします。 このクラスは、SimpleXMLElement クラスを継承していなければなりません。 diff --git a/reference/snmp/functions/snmp2-getnext.xml b/reference/snmp/functions/snmp2-getnext.xml index 2556e834c6..b6117c4ead 100644 --- a/reference/snmp/functions/snmp2-getnext.xml +++ b/reference/snmp/functions/snmp2-getnext.xml @@ -48,7 +48,7 @@ object_id - 前にある SNMP オブジェクトの ID。 + 取得したいオブジェクトの一つ前にある SNMP オブジェクト ID。 diff --git a/reference/snmp/functions/snmp2-real-walk.xml b/reference/snmp/functions/snmp2-real-walk.xml index 7b2f71aa7e..7da5e4f433 100644 --- a/reference/snmp/functions/snmp2-real-walk.xml +++ b/reference/snmp/functions/snmp2-real-walk.xml @@ -48,7 +48,7 @@ object_id - 前にある SNMP オブジェクト ID。 + 取得したいオブジェクトの一つ前にある SNMP オブジェクト ID。 diff --git a/reference/snmp/functions/snmp2-walk.xml b/reference/snmp/functions/snmp2-walk.xml index e542498818..273a2efb8b 100644 --- a/reference/snmp/functions/snmp2-walk.xml +++ b/reference/snmp/functions/snmp2-walk.xml @@ -90,7 +90,7 @@ &reftitle.examples; - <function>snmp2_pwalk</function> の例 + <function>snmp2_walk</function> の例 object_id - 前にある SNMP オブジェクトの ID。 + 取得したいオブジェクトの一つ前にある SNMP オブジェクト ID。 timeout diff --git a/reference/snmp/functions/snmprealwalk.xml b/reference/snmp/functions/snmprealwalk.xml index a8e1c2b0dc..5732e179cf 100644 --- a/reference/snmp/functions/snmprealwalk.xml +++ b/reference/snmp/functions/snmprealwalk.xml @@ -39,7 +39,7 @@ object_id - 前にある SNMP オブジェクト ID。 + 取得したいオブジェクトの一つ前にある SNMP オブジェクト ID。 timeout diff --git a/reference/soap/soapclient/getlastrequest.xml b/reference/soap/soapclient/getlastrequest.xml index 5798d65d20..ae0adf855d 100644 --- a/reference/soap/soapclient/getlastrequest.xml +++ b/reference/soap/soapclient/getlastrequest.xml @@ -20,8 +20,8 @@ - このメソッドは、オプション trace を指定して - SoapClient が作成されている場合のみ使用可能です。 + このメソッドは、SoapClient オブジェクトが trace + オプションに &true; を設定して作成された場合にのみ動作します。 diff --git a/reference/soap/soapclient/getlastrequestheaders.xml b/reference/soap/soapclient/getlastrequestheaders.xml index 51badef943..5b32999db6 100644 --- a/reference/soap/soapclient/getlastrequestheaders.xml +++ b/reference/soap/soapclient/getlastrequestheaders.xml @@ -20,8 +20,8 @@ - このメソッドは、オプション trace を指定して - SoapClient が作成されている場合のみ使用可能です。 + このメソッドは、SoapClient オブジェクトが trace + オプションに &true; を設定して作成された場合にのみ動作します。 diff --git a/reference/soap/soapclient/getlastresponse.xml b/reference/soap/soapclient/getlastresponse.xml index 79f21fa68b..6ec155a6ea 100644 --- a/reference/soap/soapclient/getlastresponse.xml +++ b/reference/soap/soapclient/getlastresponse.xml @@ -20,8 +20,8 @@ - このメソッドは、オプション trace を指定して - SoapClient が作成されている場合のみ使用可能です。 + このメソッドは、SoapClient オブジェクトが trace + オプションに &true; を設定して作成された場合にのみ動作します。 diff --git a/reference/soap/soapclient/getlastresponseheaders.xml b/reference/soap/soapclient/getlastresponseheaders.xml index de5d80dc9b..12217c11af 100644 --- a/reference/soap/soapclient/getlastresponseheaders.xml +++ b/reference/soap/soapclient/getlastresponseheaders.xml @@ -20,8 +20,8 @@ - このメソッドは、オプション trace を指定して - SoapClient が作成されている場合のみ使用可能です。 + このメソッドは、SoapClient オブジェクトが trace + オプションに &true; を設定して作成された場合にのみ動作します。 diff --git a/reference/soap/soapserver/getlastresponse.xml b/reference/soap/soapserver/getlastresponse.xml index 217a9734dc..4270ef748f 100644 --- a/reference/soap/soapserver/getlastresponse.xml +++ b/reference/soap/soapserver/getlastresponse.xml @@ -6,7 +6,7 @@ SoapServer::__getLastResponse - 最新のSOAPレスポンスを返す + 直近の SOAP レスポンスを返す @@ -16,7 +16,7 @@ - 最新のSOAPレスポンスで送信されたXMLを返します。 + 直近の SOAP レスポンスで送信された XML を返します。 @@ -34,14 +34,14 @@ &reftitle.returnvalues; - 最新のSOAPレスポンス (XML文字列形式) + 直近の SOAP レスポンスを XML 文字列で返します。 &reftitle.examples; - SoapServer::__getLastResponse() example + SoapServer::__getLastResponse() の例 address で指定した名前を socket で指定したソケットにバインドします。 これは、socket_connect あるいは - socket_listen を使用して接続が確立される前に行われます。 + socket_listen を使用して接続を確立する前に行っておく必要があります。 diff --git a/reference/sockets/functions/socket-create.xml b/reference/sockets/functions/socket-create.xml index 935a72944d..59da0cf93f 100644 --- a/reference/sockets/functions/socket-create.xml +++ b/reference/sockets/functions/socket-create.xml @@ -101,7 +101,7 @@ SOCK_DGRAM このタイプでは、データグラム(非接続型で、信頼性の高くない - 固定バイト長のメッセージ) がサポートされます。 + 最大長が固定のメッセージ) がサポートされます。 UDP プロトコルは、このソケットタイプに基づきます。 @@ -109,7 +109,7 @@ SOCK_SEQPACKET このタイプでは、時系列的な、信頼性のある、 - 双方向の接続指向型の固定長データグラム転送が利用できます。 + 双方向の接続指向型の、最大長が固定のデータグラム転送が利用できます。 パケットを消費する側は、一つのパケット全部を一度の read コールで読み込む必要があります。 diff --git a/reference/sockets/functions/socket-recv.xml b/reference/sockets/functions/socket-recv.xml index 11e23822e1..5f060ae18e 100644 --- a/reference/sockets/functions/socket-recv.xml +++ b/reference/sockets/functions/socket-recv.xml @@ -110,7 +110,7 @@ MSG_DONTWAIT - このフラグを設定すると、正常にブロックされている状態でも関数が結果を返します。 + このフラグを設定すると、通常ならブロックするような場面でも、関数はブロックせずに制御を返します。 diff --git a/reference/spl/arrayiterator.xml b/reference/spl/arrayiterator.xml index 7307f49f69..813738bd33 100644 --- a/reference/spl/arrayiterator.xml +++ b/reference/spl/arrayiterator.xml @@ -17,10 +17,11 @@ 同じ配列を何度も反復処理したい場合は、 - ArrayObject のインスタンスとそれを参照する - ArrayIterator のインスタンスを作成し、 - &foreach; を使用するか ArrayObject::getIterator - メソッドを手動でコールします。 + ArrayObject をインスタンス化し、 + 内部に保持された配列を &foreach; で反復する際に暗黙に作られる + ArrayIterator のインスタンスを使うか、 + ArrayObject::getIterator + メソッドを手動でコールして作成することを推奨します。
diff --git a/reference/spl/arrayobject.xml b/reference/spl/arrayobject.xml index 0fa65a1c06..eae2a5ab52 100644 --- a/reference/spl/arrayobject.xml +++ b/reference/spl/arrayobject.xml @@ -15,7 +15,7 @@ - このクラスをオブジェクトにラップして使うことは、基本的に間違いです。 + このクラスでオブジェクトをラップして使うことは、基本的に間違いです。 そのため、オブジェクトと一緒に使うべきではありません。 @@ -87,7 +87,7 @@ オブジェクトのエントリはプロパティとしてアクセスできます(読み書き可)。 - ArrayObject クラスはオブジェクトにアクセスするのに独自のロジックを使います。よって、動的なプロパティを読み書きしようとしても警告やエラーは発生しません。 + ArrayObject クラスはプロパティにアクセスするのに独自のロジックを使います。よって、動的なプロパティを読み書きしようとしても警告やエラーは発生しません。 diff --git a/reference/stream/constants.xml b/reference/stream/constants.xml index e82d914d9f..69ea5f805b 100644 --- a/reference/stream/constants.xml +++ b/reference/stream/constants.xml @@ -20,7 +20,7 @@ - 非同期的にソケットを開きます。このオプションは、 + 非同期的にクライアントソケットを開きます。このオプションは、 STREAM_CLIENT_CONNECT フラグとともに使用する 必要があります。 @@ -45,7 +45,7 @@ - クライアントソケットが、セッションをまたいでも保持されるよう + クライアントソケットは、ページの読み込みをまたいでも保持され続ける必要があります。 @@ -65,7 +65,7 @@ ストリームが特定のターゲットに関連付けられることを示します。 - サーバーソケットには常にこのフラグが与えられているはずです。 + サーバーソケットは常にこのフラグを含んでいる必要があります。 @@ -79,9 +79,9 @@ STREAM_SERVER_BIND によってターゲットに 関連付けられたストリームに、ソケットに対して接続待ちを開始するよう 指示します。 - 接続指向の転送（TCP のような）はこのフラグを使用する必要があります。 + TCP のような接続指向のトランスポートは、このフラグを使用する必要があります。 それ以外の場合はサーバーソケットが有効になりません。 - このフラグを非接続指向の転送（UDP のような）に使用するとエラーになります。 + このフラグを UDP のような非接続指向のトランスポートに使用するとエラーになります。 @@ -129,12 +129,11 @@ - ストリームソケットの送信フラグ + ストリームソケットの転送フラグ stream_socket_recvfrom と stream_socket_sendto の flags に指定するために使われる定数です。 - のfunctions. @@ -210,9 +209,7 @@ - この定数は右の値と等価です: - STREAM_FILTER_READ | - STREAM_FILTER_WRITE + STREAM_FILTER_READ | STREAM_FILTER_WRITE と同等です。 @@ -264,7 +261,7 @@ - TLS 1.0, 1.1 or 1.2 のクライアントストリーム + TLS 1.0, 1.1 または 1.2 のクライアントストリーム @@ -363,7 +360,7 @@ - TLS 1.0, 1.1, 1.2 のサーバーストリーム + TLS 1.0, 1.1 または 1.2 のサーバーストリーム @@ -374,7 +371,7 @@ - あらゆる TLS バージョンのサーバートリーム + あらゆる TLS バージョンのサーバーストリーム @@ -385,7 +382,7 @@ - TLS 1.0 のサーバートリーム + TLS 1.0 のサーバーストリーム @@ -396,7 +393,7 @@ - TLS 1.1 のサーバートリーム + TLS 1.1 のサーバーストリーム @@ -407,7 +404,7 @@ - TLS 1.2 のサーバートリーム + TLS 1.2 のサーバーストリーム @@ -418,7 +415,7 @@ - TLS 1.3 のサーバートリーム + TLS 1.3 のサーバーストリーム @@ -491,8 +488,8 @@ - ストリームがシークできることを示します。 - これは、ストリームのコピーが生成されている可能性があります。 + ストリームがシーク可能であることを保証します。 + この結果、ストリームのコピーが生成される可能性があります。 @@ -583,7 +580,7 @@ raw ソケットを提供します。これは内部のネットワークプロトコルや インターフェイスへのアクセス機能を提供します。通常、この形式の - ソケットは root ユーザーが使用します。 + ソケットは root ユーザーのみが使用できます。 @@ -616,7 +613,7 @@ - 帯域外データを転送するための、シーケンシャルで双方向の + 帯域外データを転送する機構を備えた、シーケンシャルで双方向の バイトストリーム（例: TCP）を提供します。 @@ -789,8 +786,8 @@ ストリームにおける転送の進捗が、 - bytes_transferred または、場合によっては - bytes_max に現れていることを示します。 + bytes_transferred と、場合によっては + bytes_max にも現れていることを示します。 @@ -902,7 +899,7 @@ <methodname>streamWrapper::stream_cast</methodname> - <parameter>cast_as</parameter> に指定できる値 + の <parameter>cast_as</parameter> に指定できる値 @@ -1042,8 +1039,8 @@ - リソースの位置を指定する include path - に相対パスを指定すべきことを示します + 相対パスの場合、リソースの位置を特定するために include_path + を使うべきことを示すフラグです @@ -1201,7 +1198,7 @@ <methodname>php_user_filter::filter</methodname> - の有効な返り値 + の有効な戻り値 diff --git a/reference/stream/functions/stream-filter-append.xml b/reference/stream/functions/stream-filter-append.xml index dbb39e0106..a4c13927d6 100644 --- a/reference/stream/functions/stream-filter-append.xml +++ b/reference/stream/functions/stream-filter-append.xml @@ -145,7 +145,7 @@ Guvf vf n grfg ストリームデータは（ローカルおよびリモートの）リソースからチャンク単位で - 読み込まれ、内部バッファに保持されます。新しいフィルタがストリームに + 読み込まれ、未消費のデータは内部バッファに保持されます。新しいフィルタがストリームに 追加されると、内部バッファのデータがその時点でフィルタリングされます。 これは stream_filter_prepend の挙動とは違います。 diff --git a/reference/stream/functions/stream-select.xml b/reference/stream/functions/stream-select.xml index 79ee130711..4662193ccc 100644 --- a/reference/stream/functions/stream-select.xml +++ b/reference/stream/functions/stream-select.xml @@ -242,7 +242,7 @@ if (false === stream_select($r, $w, $e, 0)) { Windows では、proc_open が返すファイルディスクリプタに 対して stream_select を使用すると - 失敗して &false; を返すことがあります。 + 失敗して &false; を返します。 あらゆる 入力イベントが利用可能になるとすぐに、 diff --git a/reference/stream/functions/stream-socket-client.xml b/reference/stream/functions/stream-socket-client.xml index 73809799b0..cb37e27f13 100644 --- a/reference/stream/functions/stream-socket-client.xml +++ b/reference/stream/functions/stream-socket-client.xml @@ -124,6 +124,7 @@ fgets, fgetss, fwrite, fclose, feof といった、ファイル関数と共に使うことのできるストリームリソースを返します。 + &return.falseforfailure; @@ -231,7 +232,7 @@ if (!$fp) { 環境により、Unix ドメインや接続タイムアウトが利用できない場合があります。 有効なトランスポートのリストは、stream_get_transports - で取得できます。組み込むのポートの一覧については、 + で取得できます。組み込みのトランスポートの一覧については、 を参照ください。 diff --git a/reference/strings/functions/explode.xml b/reference/strings/functions/explode.xml index 64d79802cf..ec473d864a 100644 --- a/reference/strings/functions/explode.xml +++ b/reference/strings/functions/explode.xml @@ -89,7 +89,7 @@ 引数 string を含む配列を返します。 separator の値が string の最初か最後に現れた場合、その位置に応じて、 - 返される配列の最初か最後に空の配列が追加されます。 + 返される配列の最初か最後に空文字列の要素が追加されます。 diff --git a/reference/strings/functions/localeconv.xml b/reference/strings/functions/localeconv.xml index 27e715b30d..225c616a33 100644 --- a/reference/strings/functions/localeconv.xml +++ b/reference/strings/functions/localeconv.xml @@ -142,7 +142,7 @@ - n_sign_posn や n_sign_posn + p_sign_posn や n_sign_posn は、フォーマッタオプションの文字列を含みます。それぞれの数字は 上に一覧されている条件の 1 つを表します。 diff --git a/reference/strings/functions/sprintf.xml b/reference/strings/functions/sprintf.xml index 925b1ef43c..2f0f2e76a9 100644 --- a/reference/strings/functions/sprintf.xml +++ b/reference/strings/functions/sprintf.xml @@ -107,8 +107,8 @@ echo sprintf($format, $num, $location); ここで、問題が発生します。フォーマット文字列における置換指示子の順番は、 コードにおける引数の順番と一致していません。 - だからといってコードを変更するのではなく、 - むしろ置換指示子が参照するフォーマット文字列のほうで指示を行う方が望ましいでしょう。 + コードはそのままにして、各置換指示子がどの引数を参照するのかを + フォーマット文字列の側で指定するのが望ましいでしょう。 フォーマット文字列を次のように書き換えてみましょう。 diff --git a/reference/strings/functions/substr.xml b/reference/strings/functions/substr.xml index daf17489b6..4ea5c0d103 100644 --- a/reference/strings/functions/substr.xml +++ b/reference/strings/functions/substr.xml @@ -38,7 +38,7 @@ offset - offset が正の場合、返される文字列は、 + offset が 0 以上の場合、返される文字列は、 string の 0 から数えて offset番目から始まる文字列となります。 例えば、文字列'abcdef'において位置 @@ -76,19 +76,19 @@ echo substr("abcdef", -3, 1), PHP_EOL; // "d" を返す length が指定され、かつ正である場合、 - 返される文字列は offset - (string の長さに依存します) - から数えてlength文字数分となります。 + 返される文字列は offset から始まる + 最大 length 文字分となります + (string の長さによってはそれより短くなります)。 length が指定され、かつ負である場合、 string の終端からその文字数分の文字が省略されます。 - もし offset が切り出し位置を超える場合、 + もし offset がこの切り捨て位置、またはそれ以降を指す場合、 空の文字列が返されます。 length が指定され、かつ - 0 であれば、空の文字が返されます。 + 0 であれば、空の文字列が返されます。 length を省略した場合、または &null; の場合は、 diff --git a/reference/strings/functions/trim.xml b/reference/strings/functions/trim.xml index 50b91d47f8..8ecbb69a49 100644 --- a/reference/strings/functions/trim.xml +++ b/reference/strings/functions/trim.xml @@ -7,7 +7,7 @@ trim - 文字列の先頭および末尾にあるホワイトスペースを取り除く + 文字列の先頭および末尾にあるホワイトスペース (もしくはその他の文字) を取り除く diff --git a/reference/tidy/tidy/parsestring.xml b/reference/tidy/tidy/parsestring.xml index 1014553d3b..d83f541dc1 100644 --- a/reference/tidy/tidy/parsestring.xml +++ b/reference/tidy/tidy/parsestring.xml @@ -75,9 +75,10 @@ &reftitle.returnvalues; - 新しい tidy インスタンスを返します。 - tidy_parse_string は、成功時に新しい tidy インスタンスを返します。 - これらのメソッド、関数は、失敗時に &false; を返します。 + tidy::parseString は成功時に &true; を返します。 + tidy_parse_string は、成功時に新しい + tidy インスタンスを返します。 + これらのメソッド、関数は、ともに失敗時に &false; を返します。 diff --git a/reference/var/functions/debug-zval-dump.xml b/reference/var/functions/debug-zval-dump.xml index 903a876c8d..2965de6c7f 100644 --- a/reference/var/functions/debug-zval-dump.xml +++ b/reference/var/functions/debug-zval-dump.xml @@ -110,14 +110,14 @@ string(11) "Hello World" refcount(3) 値が同じ複数の値を保持する複数の変数を、メモリ上の同じコピーを指すようにします。 この場合、変数の値が変更された時に、 その変数は新しいメモリ上のコピーの値を指すようになります。 - そして、その変数のリファレンスカウントは1になります。 + そして、元の値のリファレンスカウントがひとつ減ります。 - リファレンス渡しされたり、リファレンスが代入されている値( + リファレンス渡しされたり、リファレンスが代入されている変数( リファレンスの説明 も参照ください) を追跡する用途にも使います。 - この用途のリファレンスカウントは、 - 現在の値を指しているものとは別の、リファレンス用の zval に保存されています。 + この用途のリファレンスカウントは、現在の値の zval を指す、 + 別個のリファレンス用 zval に保存されています。 この追加の zval は、現状 debug_zval_dump では見えません。 @@ -127,11 +127,11 @@ string(11) "Hello World" refcount(3) debug_zval_dump は、値渡しされた通常の引数を入力として受け取るので、 コピーオンライトのテクニックを使います: つまり、データをコピーせず、 関数呼び出しが行われている間、リファレンスカウントをひとつ増やします。 - 関数が受け取った引数を変更すると、データのコピーが行われます。 - コピーを行わないと、呼び出しスコープの中でリファレンスカウントがひとつ増えてしまうからです。 + もし関数が引数を受け取った後にそれを変更するのであれば、コピーが作成されていたことでしょう。 + 実際には変更しないので、呼び出し元のスコープよりもひとつ高いリファレンスカウントが表示されます。 - 渡す引数によっては、debug_zval_dump + また、この引数の渡し方が原因で、debug_zval_dump はリファレンスが割り当てられている変数を表示しません。 この動きを示すために、上の例をちょっと変更した例を考えてみましょう: @@ -160,7 +160,7 @@ string(11) "Hello World" refcount(2) $var1, $var2, $var3 はリファレンスで結びついていますが、 値 だけが debug_zval_dump に渡されます。 - この値は、リファレンスの設定に一度使われ、 + この値は、リファレンスの集合によって一度使われ、 debug_zval_dump の中で一度使われます。 よって、リファレンスカウントは2になります。 @@ -171,7 +171,7 @@ string(11) "Hello World" refcount(2) リファレンスカウントを全く表示しません。 別の場合、このリファレンスカウントの値は、 内部的に使われる追加のコピーの値を表示する場合もあります。 - たとえば、文字列リテラルや配列が、命令セットの一部として保存されているような場合です。 + たとえば、文字列リテラルや配列が、コードの命令の一部として保存されているような場合です。 diff --git a/reference/var/functions/is-callable.xml b/reference/var/functions/is-callable.xml index 9dff78bddd..88f48499e8 100644 --- a/reference/var/functions/is-callable.xml +++ b/reference/var/functions/is-callable.xml @@ -184,8 +184,8 @@ bool(true) オブジェクトは、 __invoke() - を実装していれば常にコール可能ですし、 - そのメソッドは現在のスコープからアクセス可能です。 + を実装しており、かつそのメソッドが現在のスコープからアクセス可能である場合、 + 常にコール可能です。 __callStatic() diff --git a/reference/win32service/setup.xml b/reference/win32service/setup.xml index 8b79e025f6..c630ca46ec 100644 --- a/reference/win32service/setup.xml +++ b/reference/win32service/setup.xml @@ -27,13 +27,6 @@ - -
- &reftitle.runtime; - &no.config; -
- -
セキュリティの考慮 diff --git a/reference/win32service/win32serviceexception.xml b/reference/win32service/win32serviceexception.xml index 3d01631652..230fca399b 100644 --- a/reference/win32service/win32serviceexception.xml +++ b/reference/win32service/win32serviceexception.xml @@ -7,7 +7,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns="http://docbook.org/ns/docbook"> - The Win32ServiceException class + Win32ServiceException クラス Win32ServiceException diff --git a/reference/win32service/win32servicerightinfo.xml b/reference/win32service/win32servicerightinfo.xml index ca7a4f66c5..5d91a5ccdf 100644 --- a/reference/win32service/win32servicerightinfo.xml +++ b/reference/win32service/win32servicerightinfo.xml @@ -6,7 +6,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns="http://docbook.org/ns/docbook"> - The Win32Service\RightInfo class + Win32Service\RightInfo クラス Win32Service\RightInfo diff --git a/reference/xml/functions/xml-parse.xml b/reference/xml/functions/xml-parse.xml index 8534808e69..23805bada1 100644 --- a/reference/xml/functions/xml-parse.xml +++ b/reference/xml/functions/xml-parse.xml @@ -38,11 +38,10 @@ data - 処理するデータ。ドキュメントは、 - is_final パラメータが設定され、 - 最後のデータが処理され &true; になるまで、新規のデータに関して - 複数回 xml_parse をコールすることにより、 - 部分毎で処理することが可能です。 + 処理するデータ。最後のデータを処理する際に + is_final パラメータを設定して &true; にする限り、 + 新しいデータを渡して複数回 xml_parse + をコールすることにより、ドキュメントを分割して処理することが可能です。 @@ -75,7 +74,7 @@ - エンティティのエラーが報告されるのは、ドキュメントの最後で行われます。 + 一部のエラー（エンティティのエラーなど）は、データの最後で報告されます。 つまり is_final が &true; に設定されている場合だけです。 diff --git a/reference/xml/functions/xml-parser-create.xml b/reference/xml/functions/xml-parser-create.xml index 68d1577012..f6045d89e1 100644 --- a/reference/xml/functions/xml-parser-create.xml +++ b/reference/xml/functions/xml-parser-create.xml @@ -33,7 +33,7 @@ 出力のエンコーディングのみを指定することになります。 もし空の文字列が渡された場合、先頭の 3 あるいは 4 バイトの内容をもとに パーサーがエンコーディングの判別を試みます。 - ではデフォルトの出力文字セットは UTF-8 です。 + デフォルトの出力文字セットは UTF-8 です。 サポートされるエンコーディングは ISO-8859-1、UTF-8 および US-ASCII です。 diff --git a/reference/yaz/setup.xml b/reference/yaz/setup.xml index 170d298aa4..470cf1dbf0 100644 --- a/reference/yaz/setup.xml +++ b/reference/yaz/setup.xml @@ -23,13 +23,6 @@ &reference.yaz.configure; - -
- &reftitle.runtime; - &no.config; -
- -