diff --git a/appendices/migration85/incompatible.xml b/appendices/migration85/incompatible.xml index 9329ca7391..a351a5c9c5 100644 --- a/appendices/migration85/incompatible.xml +++ b/appendices/migration85/incompatible.xml @@ -1,6 +1,6 @@ - + 下位互換性のない変更点 @@ -375,9 +375,9 @@ - PDO::fetch, - PDO::fetchObject, - PDO::fetchAll の呼び出し中に、 + PDOStatement::fetch, + PDOStatement::fetchObject, + PDOStatement::fetchAll の呼び出し中に、 PDOStatement::setFetchMode を呼び出そうとすると、 Error がスローされるようになりました。 これはたとえば、 @@ -403,7 +403,7 @@ - PDO::fetchAll で、 + PDOStatement::fetchAll で、 PDO::FETCH_INTO をフェッチモードとして使おうとすると、 PDO::FETCH_LAZY と同様に ValueError がスローされるようになりました。 diff --git a/appendices/transports.xml b/appendices/transports.xml index 8b5df5212d..98690c4f05 100644 --- a/appendices/transports.xml +++ b/appendices/transports.xml @@ -1,6 +1,6 @@ - + サポートされるソケットトランスポートのリスト @@ -26,6 +26,13 @@ ssl://, tls://, sslv2:// & sslv3://. + + + sslv2:// および sslv3:// トランスポートは + 廃止されており、使うべきではありません。後方互換性のためにのみ + ドキュメントに記載されています。 + + @@ -42,8 +49,6 @@ tcp://www.example.com udp://www.example.com ssl://www.example.com - sslv2://www.example.com - sslv3://www.example.com tls://www.example.com @@ -80,11 +85,17 @@ - ssl:// は SSL V2 での接続を試みます。 - あるいはリモートホストの設定によっては SSL V3 での接続を試みます。 - sslv2:// および - sslv3:// は、SSL V2 と SSL V3 のどちらのプロトコルを - 使用するかを明示的に指定します。 + ssl:// は、クライアントとリモートホスト双方の機能と設定に + 応じて、安全な SSL/TLS 接続のネゴシエーションを試みます。実際に使用される + プロトコルは、OpenSSL の設定と stream_context_create + で指定するオプション（ssl.crypto_method など）によって + 決定されます。 + + + + SSLv2 および SSLv3 プロトコルは廃止されており、安全ではありません。 + これらの使用は強く推奨されず、PHP および OpenSSL の最近のバージョンでは + デフォルトで無効になっています。 diff --git a/features/commandline.xml b/features/commandline.xml index 7f4b80b5ad..c60c0eba29 100644 --- a/features/commandline.xml +++ b/features/commandline.xml @@ -1,6 +1,6 @@ - + PHP をコマンドラインから使用する @@ -1789,6 +1789,13 @@ php > この機能は Windows ではサポートされていません。 + + + PHP のコマンドラインの使い方やオプションについては、 + php --help または man php を実行してください。 + すべてのオプションがウェブサーバーの実行時に適用されるわけではありません。 + + この機能は 実験的なもの であり、 diff --git a/features/http-auth.xml b/features/http-auth.xml index 417c5fe826..86f5bf3ed5 100644 --- a/features/http-auth.xml +++ b/features/http-auth.xml @@ -1,6 +1,6 @@ - + PHP による HTTP 認証 @@ -14,7 +14,7 @@ パスワードを入力すると、PHP スクリプトを含むその URL は、次回以降、 定義済みの変数 PHP_AUTH_USER と、 PHP_AUTH_PW と、 - PHP_AUTH_TYPE にそれぞれユーザー名、 + AUTH_TYPE にそれぞれユーザー名、 パスワード、認証型が代入された状態で呼ばれます。 定義済みの変数は、配列 $_SERVER でアクセス可能です。 @@ -24,14 +24,16 @@ ページ上でクライアント認証を強制するスクリプトの例を以下に示します。 + + Basic HTTP 認証の例 - 互換性に関する注意 + 互換性 HTTPヘッダ行をコーディングする際には注意を要します。全てのクライアントへの 互換性を最大限に保証するために、キーワード "Basic" には、 大文字の"B"を使用して書くべきです。realm文字列は(一重引用符ではなく) - 二重引用符で括る必要があります。また、HTTP/1.0 401 + 二重引用符で括る必要があります。また、HTTP/1.1 401 ヘッダ行のコード 401 の前には、 1つだけ空白を置く必要があります。 認証パラメータは、 @@ -66,15 +68,8 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) { ユーザーを調べるといったことをすることになるでしょう。 - - バグのある Internet Explorer ブラウザには注意してください。このブラ - ウザは、ヘッダの順序に関してとてもうるさいようです。今のところ、 - HTTP/1.0 401 ヘッダの前に - WWW-Authenticate ヘッダを送るのが効果があるようです。 - - - 設定上の注意 + Apache の設定 PHP は、外部認証が動作しているかどうかの判定を AuthType ディレクティブの有無で行います。 @@ -86,62 +81,34 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) { にある認証を要するURLからパスワードを盗むことを防ぐわけではありませ ん。 - - サーバーからレスポンスコード 401 を受けた際に、Netscape Navigatorおよび - Internet Explorer は共にローカルブラウザのウインドウ上の認証キャッシュを - 消去します。この機能により、簡単にユーザーを"ログアウト"させ、強制的に - ユーザー名とパスワードを再入力させることができます。この機能は、 - "タイムアウト" 付きのログインや、"ログアウト" ボタンに適用されています。 - - - 新規に名前 / パスワードを入力させる HTTP 認証の例 - -Welcome: " . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "
"; - echo "Old: " . htmlspecialchars($_REQUEST['OldAuth']); - echo "
\n"; - echo "\n"; - echo "\n"; - echo "\n"; - echo "

\n"; -} -?> -]]> - - - - この動作は、HTTP Basic 認証の標準に基づいていません。よって、この機能に - 依存しないように注意する必要があります。Lynx によるテストの結果、 - Lynx は、認証証明書を 401 サーバー応答によりクリアしないことが明らかに - なっています。このため、back を押してから forward を再度押すことにより - 証明書の要件が変更されない限りリソースをオープンすることができます。 - しかし、ユーザーは '_' キーを押すことにより認証情報をクリアすることが可能です。 - - - IIS サーバーと CGI 版の PHP の組み合わせで HTTP 認証を使うには、 - IIS の設定の "ディレクトリセキュリティ" の "編集" ボタンを押して - "匿名アクセス" のみをオンにしてください。 - その他のフィールドはオフのままにしてください。 - - IIS に関する注意: + ブラウザの挙動 + + HTTP Basic 認証は非常に基本的なもので、ログアウトをサポートするようには + 設計されていません。HTTP はステートレスなプロトコルであるため、 + ほとんどのブラウザは 2xx ステータスコードを受け取ると + すぐに認証情報をキャッシュし、ブラウザを閉じるまですべてのリクエストで + その認証情報を送信し続けます。サーバーが認証情報の再入力を求める + プロンプトを要求するための標準的な方法は定義されていません。 + + 長年にわたり、この問題に対するさまざまな回避策がインターネット上で + 広まってきましたが、それらはすべて、異なるブラウザが未定義のエッジケース + （あるいは HTTP 標準の違反さえも）をどのように処理するかに依存しています。 + このような回避策は避け、Basic 認証を重要な用途に使用しないことが最善です。 + + + + + IIS の設定 - IIS上 で HTTP 認証を使用する場合、PHP の - cgi.rfc2616_headers - ディレクティブは0 (デフォルト値) にセットされて - いなければなりません。 + IIS サーバーと CGI 版の PHP の組み合わせで HTTP 認証を使うには、 + php.ini ディレクティブ cgi.rfc2616_headers + を 0 (デフォルト値) に設定し、IIS の設定の + "ディレクトリセキュリティ" を編集する必要があります。 + "編集" ボタンを押して + "匿名アクセス" のみをオンにしてください。 + その他のフィールドはオフのままにしてください。 diff --git a/language/predefined/attributes/nodiscard.xml b/language/predefined/attributes/nodiscard.xml index 9350cb8d34..28a37a8d16 100644 --- a/language/predefined/attributes/nodiscard.xml +++ b/language/predefined/attributes/nodiscard.xml @@ -1,6 +1,6 @@ - + NoDiscard アトリビュート NoDiscard @@ -36,6 +36,7 @@ + #[\Attribute] final NoDiscard diff --git a/reference/curl/functions/curl-close.xml b/reference/curl/functions/curl-close.xml index 73923fabac..f2c6eb224d 100644 --- a/reference/curl/functions/curl-close.xml +++ b/reference/curl/functions/curl-close.xml @@ -1,6 +1,6 @@ - + @@ -53,6 +53,18 @@ + + 8.5.0 + + この関数は推奨されなくなりました。 + + + + 8.0.0 + + この関数は何もしなくなりました(NOP)。 + + &curl.changelog.handle-param; diff --git a/reference/curl/functions/curl-share-close.xml b/reference/curl/functions/curl-share-close.xml index b347f8f11c..99893db3de 100644 --- a/reference/curl/functions/curl-share-close.xml +++ b/reference/curl/functions/curl-share-close.xml @@ -1,6 +1,6 @@ - + @@ -52,6 +52,18 @@ + + 8.5.0 + + この関数は推奨されなくなりました。 + + + + 8.0.0 + + この関数は何もしなくなりました(NOP)。 + + &curl.changelog.share-handle-param; diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml index ebc7f52656..0920651000 100644 --- a/reference/filesystem/functions/fgetcsv.xml +++ b/reference/filesystem/functions/fgetcsv.xml @@ -1,13 +1,13 @@ - + fgetcsv ファイルポインタから行を取得し、CSVフィールドを処理する - + &reftitle.description; @@ -92,18 +92,21 @@ シングルバイト文字 1 文字のみ、または空文字列でなければなりません。 空文字列("") を指定すると、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構が無効になります。 - + - enclosure の文字は、フィールド内で2回出力される - ことでエスケープされます。しかし、 - escape 文字はその代替として使えます。 - デフォルトのパラメータの値 - "" と \" は同じ意味を持ちます。 - enclosure の文字を - escape 文字でエスケープすることには、 - 特別な意味はありません。それ自身をエスケープする意味ですらありません。 + 入力ストリームにおいて、enclosure 文字は + クォートされた文字列の中で2回連続させることで常にエスケープでき、 + パース結果では単一の enclosure 文字になります。 + escape 文字の動作は異なります: + 入力中に escape と + enclosure 文字の並びが出現した場合、 + パース結果には両方の文字がそのまま残ります。 + よって、デフォルトのパラメータの場合、 + "a""b","c\"d" のような CSV の行は + それぞれ a"b と c\"d + にパースされます。 - + PHP 8.4.0 以降では、escape @@ -191,7 +194,6 @@ - &warning.csv.escape-parameter; diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml index 00fbe96deb..a759f8464b 100644 --- a/reference/image/functions/getimagesize.xml +++ b/reference/image/functions/getimagesize.xml @@ -1,6 +1,6 @@ - + @@ -188,6 +188,10 @@ if ($size && $fp) { getimagesize は E_NOTICE レベルのエラーを発生させます。 + + PHP 8.0.0 以降、filename が空の場合に + ValueError がスローされます。 + @@ -209,6 +213,14 @@ if ($size && $fp) { これより前のバージョンでは、幅と高さの情報は 0x0 として報告され、ビット数とチャンネル情報は全く報告されていませんでした。 + + 8.0.0 + + filename が空の場合に + ValueError がスローされるようになりました。 + これより前のバージョンでは、E_WARNING が発生し、関数は &false; を返していました。 + + 7.1.0 diff --git a/reference/imap/functions/imap-headerinfo.xml b/reference/imap/functions/imap-headerinfo.xml index 5e1e1e26e9..86ec56060e 100644 --- a/reference/imap/functions/imap-headerinfo.xml +++ b/reference/imap/functions/imap-headerinfo.xml @@ -1,6 +1,6 @@ - + @@ -51,13 +51,6 @@ - - defaulthost - - - - - diff --git a/reference/json/functions/json-last-error.xml b/reference/json/functions/json-last-error.xml index 744c38e02e..6a264c1466 100644 --- a/reference/json/functions/json-last-error.xml +++ b/reference/json/functions/json-last-error.xml @@ -1,6 +1,6 @@ - + @@ -101,6 +101,11 @@ おそらく正しくエンコードされていない、不正な UTF-16 文字 + + JSON_ERROR_NON_BACKED_ENUM + シリアライズできない、Backed Enum でない値が含まれています。PHP 8.1.0 以降で使用可能。 + + diff --git a/reference/math/functions/fmod.xml b/reference/math/functions/fmod.xml index d063ac357f..241f284c9d 100644 --- a/reference/math/functions/fmod.xml +++ b/reference/math/functions/fmod.xml @@ -1,6 +1,6 @@ - + @@ -49,7 +49,8 @@ &reftitle.returnvalues; - num1/num2 の剰余を返します。 + num1/num2 の浮動小数点の剰余を返します。 + 第二引数が 0 の場合は NAN (float) を返します。 diff --git a/reference/mbstring/functions/mb-decode-numericentity.xml b/reference/mbstring/functions/mb-decode-numericentity.xml index 195ba7b5b3..f7ab8fd077 100644 --- a/reference/mbstring/functions/mb-decode-numericentity.xml +++ b/reference/mbstring/functions/mb-decode-numericentity.xml @@ -1,6 +1,6 @@ - + @@ -50,14 +50,6 @@ &mbstring.encoding.parameter; - - is_hex - - - このパラメータは使われていません。 - - - diff --git a/reference/mysqli/mysqli/multi-query.xml b/reference/mysqli/mysqli/multi-query.xml index 31e992f9fc..bf6878ef7a 100644 --- a/reference/mysqli/mysqli/multi-query.xml +++ b/reference/mysqli/mysqli/multi-query.xml @@ -1,6 +1,6 @@ - + @@ -27,14 +27,11 @@ &mysqli.sqlinjection.warning; - ひとつの呼び出し中に、クエリはデータベースに非同期に送信されますが、 - データベースはそれらを順番に実行します。 + クエリはひとつの呼び出しでデータベースに送信され、順番に処理されます。 mysqli_multi_query は PHP に制御を戻す前に、最初のクエリの実行が完了するのを待ちます。 - MySQLサーバーはその後、次のクエリを順番に実行していきます。 - 次の結果セットの準備が出来ると、 - MySQL は PHP 側が mysqli_next_result - を実行するのを待ちます。 + その間、MySQL サーバーは PHP とは非同期に残りのクエリの処理を続け、 + 結果を取得できる状態にします。 複数のクエリを処理するために、 @@ -42,6 +39,7 @@ を使うことを推奨します。 全てのクエリの実行が完了し、結果を PHP が取得するまで、 接続はビジー状態になります。 + 全てのクエリが処理されるまで、同じ接続上では他のステートメントを実行できません。 次のクエリを順番に実行するには、 mysqli_next_result を使います。 次の結果セットの準備ができていない場合、 diff --git a/reference/mysqli/mysqli/options.xml b/reference/mysqli/mysqli/options.xml index aefcd88ff6..68529dfedc 100644 --- a/reference/mysqli/mysqli/options.xml +++ b/reference/mysqli/mysqli/options.xml @@ -1,6 +1,6 @@ - + @@ -70,6 +70,12 @@ MYSQLI_OPT_LOCAL_INFILE LOAD LOCAL INFILE の使用可/不可。 + + MYSQLI_OPT_LOAD_DATA_LOCAL_DIR + + LOAD DATA LOCAL INFILE で使用するディレクトリ。 + + MYSQLI_INIT_COMMAND MySQL サーバーへの接続後に実行するコマンド。 @@ -99,7 +105,6 @@ MYSQLI_SERVER_PUBLIC_KEY RSA 公開鍵ファイル。SHA-256 ベースの認証で使います。 - PHP 5.5.0 以降で利用可能です。 @@ -130,6 +135,18 @@ サーバーの証明書を検証するかしないかを指定します。 + + MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS + + クライアントが期限切れのパスワードを受け入れるかどうかを指定します。 + + + + 1 + + ネットワーク通信の圧縮を使用するかどうかを指定します。 + + diff --git a/reference/pdo_sqlite/pdo/sqlite/createfunction.xml b/reference/pdo_sqlite/pdo/sqlite/createfunction.xml index 8fcb32ffa6..54acb456d1 100644 --- a/reference/pdo_sqlite/pdo/sqlite/createfunction.xml +++ b/reference/pdo_sqlite/pdo/sqlite/createfunction.xml @@ -1,6 +1,6 @@ - + @@ -99,7 +99,7 @@ ビット単位のフラグの組み合わせ。 - 現在は、PDO::SQLITE_DETERMINISTIC だけがサポートされています。 + 現在は、Pdo\Sqlite::DETERMINISTIC だけがサポートされています。 これは、単一のSQLステートメント内では、 同じ入力に対して常に同じ結果を返すことを指定します。 @@ -138,7 +138,7 @@ function sha256_and_reverse($string) } $db = new Pdo\Sqlite('sqlite::sqlitedb'); -$db->sqliteCreateFunction('sha256rev', 'sha256_and_reverse', 1); +$db->createFunction('sha256rev', 'sha256_and_reverse', 1); $rows = $db->query('SELECT sha256rev(filename) FROM files')->fetchAll(); ?> ]]> diff --git a/reference/random/random/randomizer/getfloat.xml b/reference/random/random/randomizer/getfloat.xml index 12e3979929..fc943ae109 100644 --- a/reference/random/random/randomizer/getfloat.xml +++ b/reference/random/random/randomizer/getfloat.xml @@ -1,6 +1,6 @@ - + Random\Randomizer::getFloat @@ -348,6 +348,15 @@ Lat: +69.244304 Lng: -53.548951 に記されている γ-section アルゴリズムを実装しています。 + + + アンダーフローは、γ-section アルゴリズムでは意図的に処理されないままになっています。 + そのため、浮動小数点数の非正規化数の範囲にある境界を持つ区間、 + つまり絶対値がおよそ + 2-1020（約 8.9e-308）よりも小さい境界を持つ区間では、 + 不正な値が返される可能性があります。 + + diff --git a/reference/simplexml/simplexmlelement/addChild.xml b/reference/simplexml/simplexmlelement/addChild.xml index 091b4d7fe1..5d0f8507a5 100644 --- a/reference/simplexml/simplexmlelement/addChild.xml +++ b/reference/simplexml/simplexmlelement/addChild.xml @@ -1,6 +1,6 @@ - + SimpleXMLElement::addChild @@ -39,6 +39,10 @@ 指定されている場合は、子要素の値。 + + 特殊文字 < と > は自動的にエスケープされますが、 + & は手動でエスケープする必要があります。 + diff --git a/reference/soap/soapserver/addfunction.xml b/reference/soap/soapserver/addfunction.xml index 90c3fc73a1..339677a00b 100644 --- a/reference/soap/soapserver/addfunction.xml +++ b/reference/soap/soapserver/addfunction.xml @@ -1,6 +1,6 @@ - + @@ -35,10 +35,14 @@ いくつかの関数をエクスポートするには、関数名の配列を渡してください。 - 全ての関数をエクスポートする場合、特別な定数 - SOAP_FUNCTIONS_ALL - を渡してください。 + 全ての関数をエクスポートするには、関数名の配列を渡してください。 + + PHP 8.4.0 以降、int 値 + （SOAP_FUNCTIONS_ALL を含む）を渡すことは非推奨になりました。 + get_defined_functions を使って全ての関数を取得し、 + 配列として渡してください。 + functions は、全ての入力引数を @@ -61,6 +65,30 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + SoapServer::addFunction に + int を渡すこと + （SOAP_FUNCTIONS_ALL を含む）は非推奨になりました。 + + + + + + + &reftitle.examples; @@ -84,7 +112,8 @@ function echoTwoStrings($inputString1, $inputString2) } $server->addFunction(array("echoString", "echoTwoStrings")); -$server->addFunction(SOAP_FUNCTIONS_ALL); +$functions = array_merge(...get_defined_functions()); +$server->addFunction($functions); ?> ]]> diff --git a/reference/spl/splfileobject/fgetcsv.xml b/reference/spl/splfileobject/fgetcsv.xml index da16b8c73a..b67802c762 100644 --- a/reference/spl/splfileobject/fgetcsv.xml +++ b/reference/spl/splfileobject/fgetcsv.xml @@ -1,6 +1,6 @@ - + @@ -57,18 +57,7 @@ SplFileObject::setCsvControl を呼び出してセットされた値です。 空文字列("")の場合、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構が無効になります。 - - - enclosure の文字は、フィールド内で2回出力される - ことでエスケープされます。しかし、 - escape 文字はその代替として使えます。 - デフォルトのパラメータの値 - "" と \" は同じ意味を持ちます。 - enclosure の文字を - escape 文字でエスケープすることには、 - 特別な意味はありません。それ自身をエスケープする意味ですらありません。 - - + PHP 8.4.0 以降では、escape diff --git a/reference/ssh2/functions/ssh2-auth-pubkey-file.xml b/reference/ssh2/functions/ssh2-auth-pubkey-file.xml index 45ba9da936..9af4e8dd3c 100644 --- a/reference/ssh2/functions/ssh2-auth-pubkey-file.xml +++ b/reference/ssh2/functions/ssh2-auth-pubkey-file.xml @@ -1,10 +1,10 @@ - + ssh2_auth_pubkey_file - 公開鍵を使用した認証を行う + ファイルから読み込んだ公開鍵を使用した認証を行う @@ -18,7 +18,7 @@ stringpassphrase - ファイルから読み込んだ公開鍵を使用した認証を行います。 + ファイルから読み込んだ公開鍵を使用して認証を行います。 @@ -38,6 +38,7 @@ username + リモートサーバー上で認証するユーザーの名前。 @@ -113,6 +114,13 @@ if (ssh2_auth_pubkey_file($connection, 'username', + + &reftitle.seealso; + + ssh2_auth_pubkey + + + - + ssh2_connect @@ -287,6 +287,7 @@ if (!$connection) die('Connection failed'); ssh2_fingerprint ssh2_auth_none ssh2_auth_password + ssh2_auth_pubkey ssh2_auth_pubkey_file ssh2_disconnect diff --git a/reference/stream/functions/stream-filter-append.xml b/reference/stream/functions/stream-filter-append.xml index 7196b214c9..dbb39e0106 100644 --- a/reference/stream/functions/stream-filter-append.xml +++ b/reference/stream/functions/stream-filter-append.xml @@ -1,6 +1,6 @@ - + @@ -12,12 +12,12 @@ resourcestream_filter_append resourcestream - stringfiltername - intread_write + stringfilter_name + intmode mixedparams - filtername で指定されたフィルタを、 + filter_name で指定されたフィルタを、 stream に付加されているフィルタのリストに加えます。 @@ -35,7 +35,7 @@ - filtername + filter_name フィルタ名。 @@ -43,7 +43,7 @@ - read_write + mode デフォルトでは、 stream_filter_append は @@ -55,7 +55,7 @@ ライトフィルターチェィンにも追加します。 STREAM_FILTER_READ・ STREAM_FILTER_WRITE・ - STREAM_FILTER_ALL を read_writeパラメータに渡すことで、この挙動を変えることができます。 + STREAM_FILTER_ALL を modeパラメータに渡すことで、この挙動を変えることができます。 @@ -84,7 +84,7 @@ &false; が返されるのは、stream がリソースではない場合や - filtername が見つからない場合です。 + filter_name が見つからない場合です。 @@ -137,7 +137,7 @@ Guvf vf n grfg カスタム(ユーザー)フィルタを使うには - カスタムフィルタを filtername に指定するためには、 + カスタムフィルタを filter_name に指定するためには、 まず stream_filter_register 関数でそれを登録しておく 必要があります。 diff --git a/reference/stream/functions/stream-filter-prepend.xml b/reference/stream/functions/stream-filter-prepend.xml index 21451194f4..2fa8caf0fc 100644 --- a/reference/stream/functions/stream-filter-prepend.xml +++ b/reference/stream/functions/stream-filter-prepend.xml @@ -1,6 +1,6 @@ - + @@ -12,12 +12,12 @@ resourcestream_filter_prepend resourcestream - stringfiltername - intread_write + stringfilter_name + intmode mixedparams - filtername で指定されたフィルタを、 + filter_name で指定されたフィルタを、 stream に付加されているフィルタのリストに加えます。 @@ -35,7 +35,7 @@ - filtername + filter_name フィルタ名。 @@ -43,7 +43,7 @@ - read_write + mode デフォルトでは、 stream_filter_prepend は @@ -55,7 +55,7 @@ ライトフィルターチェィンにも追加します。 STREAM_FILTER_READ・ STREAM_FILTER_WRITE・ - STREAM_FILTER_ALL を read_writeパラメータに渡すことで、この挙動を変えることができます。 + STREAM_FILTER_ALL を modeパラメータに渡すことで、この挙動を変えることができます。 このパラメータを使った例については、 stream_filter_append を参照ください。 @@ -86,7 +86,7 @@ &false; が返されるのは、stream がリソースではない場合や - filtername が見つからない場合です。 + filter_name が見つからない場合です。 @@ -95,7 +95,7 @@ カスタム(ユーザー)フィルタを使うには - カスタムフィルタを filtername に指定するためには、 + カスタムフィルタを filter_name に指定するためには、 まず stream_filter_register 関数でそれを登録しておく 必要があります。 diff --git a/reference/var/functions/settype.xml b/reference/var/functions/settype.xml index efe4eab236..c37b4656be 100644 --- a/reference/var/functions/settype.xml +++ b/reference/var/functions/settype.xml @@ -1,6 +1,6 @@ - + @@ -89,6 +89,41 @@ + + &reftitle.errors; + + PHP 8.0.0 以降、type の値が + 有効な型でない場合、ValueError をスローします。 + PHP 8.0.0 より前のバージョンでは、E_WARNING が発生し、 + &false; が返されていました。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + 無効な型が type に渡された場合、 + ValueError をスローするようになりました。 + これより前のバージョンでは、E_WARNING が発生し、 + 関数は &false; を返していました。 + + + + + + + &reftitle.examples; diff --git a/reference/yaml/functions/yaml-parse-file.xml b/reference/yaml/functions/yaml-parse-file.xml index b39e19c0fd..86dae95602 100644 --- a/reference/yaml/functions/yaml-parse-file.xml +++ b/reference/yaml/functions/yaml-parse-file.xml @@ -1,6 +1,6 @@ - + @@ -69,13 +69,18 @@ &reftitle.returnvalues; - - filename にある情報を、 + + filename にエンコードされている値を、 適切な PHP の型に変換した結果を返します。 - &return.falseforfailure;。 - pos が -1 の場合は配列を返します。 - 配列の各要素が、ストリーム内で見つかった個々のドキュメントとなります。 - + + + 失敗した場合、エラーメッセージを含む文字列を返します。 + + + pos が -1 の場合、 + ストリーム内で見つかった個々のドキュメントごとにひとつのエントリを持つ + array を返します。 +