diff --git a/language-snippets.ent b/language-snippets.ent index f664ef852a..2f30da99e2 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -762,14 +762,8 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ -リソース'> - -foreach'> - match'> -yield'> - コンテキスト についての説明は、 マニュアルの コンテキスト の節を参照ください。'> @@ -1640,22 +1634,32 @@ object手続き型のみ: date_crea が使えます。 '> DOM拡張モジュール は UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、mb_convert_encoding, UConverter::transcode, iconv を使ってください。'> + + + DOM拡張モジュールは、メソッドやプロパティで UTF-8 エンコーディングを使います。 + パースをおこなうメソッドは、エンコーディングを自動的に判別し、呼び出し側でエンコーディングを指定することもできます。 + +'> DOMDocument オブジェクトに対して json_encode を使うと、結果は空オブジェクトをエンコードしたものになります。'> - + + モダンな HTML をパースしたり処理したりするには、DOMDocument の代わりに + Dom\HTMLDocument を使ってください。 + + この関数は、HTML4 のパーサを使って入力をパースします。モダンなWebブラウザが採用している HTML5 のパースルールとは異なります。入力によっては、このことが原因で異なるDOM構造になるかもしれません。よって、この関数はHTMLを無害化する目的で安全に使えません。 - - + + HTML をパースする挙動は、利用している libxml のバージョンに依存します。 特にエッジケースやエラーハンドリングについてそれが当てはまります。 HTML5 に準拠したパースを行うには、PHP 8.4 で追加される Dom\HTMLDocument::createFromStringDom\HTMLDocument::createFromFile を使いましょう。 - - + + 例を挙げましょう。HTML要素によっては、暗黙のうちに親の要素を閉じるものがあります。親要素を自動で閉じるルールは、HTML4 と HTML5 で異なります。よって、DOMDocument が表す DOM 構造は Webブラウザ上のそれと異なる可能性があります。このことから、攻撃者がHTMLを壊す攻撃を許す可能性があります。 - + '> @@ -1800,9 +1804,15 @@ object手続き型のみ: date_crea エラー時に HaruException をスローします。'> -ODBC 接続 ID。詳細は +ODBC 接続オブジェクト。詳細は odbc_connect を参照ください。'> + + + + + + @@ -1813,6 +1823,39 @@ object手続き型のみ: date_crea + + 8.4.0 + + 引数 odbc は、Odbc\Connection クラスのインスタンスを期待するようになりました。 + これより前のバージョンでは、resource を期待していました。 + +'> + + + 8.4.0 + + この関数は Odbc\Connection クラスのインスタンスを返すようになりました。 + これより前のバージョンでは、resource を返していました。 + + '> + + + 8.4.0 + + 引数 statement は、Odbc\Result クラスのインスタンスを期待するようになりました。 + これより前のバージョンでは、resource を期待していました。 + +'> + + + 8.4.0 + + この関数は Odbc\Result クラスのインスタンスを返すようになりました。 + これより前のバージョンでは、resource を返していました。 + +'> + E_ERROR @@ -2052,6 +2095,10 @@ PECL 拡張モジュールのインストール という章にありま この拡張モジュールは &link.pecl; レポジトリに移動 されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP '> + + この拡張モジュールは、メンテナンスされていません +'> + PgSql\Connection クラスのインスタンス。'> @@ -2146,6 +2193,12 @@ PHP 8.1.0 以降は、ctype関数 に文字列でない引数を渡すことは GMP オブジェクトを返します。'> GMP オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。'> + + GMP オブジェクト、&integer;、 + あるいは数値として解釈可能な &string;。 + 文字列の場合、gmp_init で基数を自動検出するとき + (base に 0 を指定したとき) と同じ方法で解釈されます。 +'> result @@ -4931,17 +4984,21 @@ local: { '> + filter - 適用するフィルタの ID。 - に、利用できるフィルタの一覧があります。 + 適用するフィルタ。 + FILTER_VALIDATE_* 定数の一つを用いた検証フィルタ、 + FILTER_SANITIZE_* 定数の一つを用いた除去フィルタ、 + FILTER_UNSAFE_RAW、 + FILTER_CALLBACK を用いたカスタムフィルタのいずれかを指定できます。 - 省略した場合は FILTER_DEFAULT を使います。これは - FILTER_UNSAFE_RAW と同等です。 + デフォルトの値は FILTER_DEFAULT で、 + これは FILTER_UNSAFE_RAW のエイリアスです。 結果的に、デフォルトでは何もフィルタリングをしません。