php/archived-doc-ja
1
0
Fork 0
mirror of https://github.com/php/doc-ja.git synced 2026-03-23 22:52:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

軽微な差分を優先し26ファイルを既訳更新 (#349)

Browse Source 
- reference/mbstring/functions/mb-decode-numericentity.xml
  1. php/doc-en@4e69a9f2b1
- reference/imap/functions/imap-headerinfo.xml
  1. php/doc-en@4e69a9f2b1
- reference/ssh2/functions/ssh2-auth-pubkey-file.xml
  1. php/doc-en@74ef2355c5
- reference/ssh2/functions/ssh2-connect.xml
  1. php/doc-en@74ef2355c5
- reference/stream/functions/stream-filter-append.xml
  1. php/doc-en@a684294e0b
- reference/stream/functions/stream-filter-prepend.xml
  1. php/doc-en@a684294e0b
- reference/filesystem/functions/fgetcsv.xml
  1. php/doc-en@e1fd0bef1d
  2. php/doc-en@0a3648a718
  3. `&warning.csv.escape-parameter;` の重複を削除（既訳のバグ修正）
- reference/spl/splfileobject/fgetcsv.xml
  1. php/doc-en@e1fd0bef1d
  2. php/doc-en@3a89b55d11
  3. php/doc-en@0a3648a718
- language/predefined/attributes/nodiscard.xml
  1. php/doc-en@30bda33771
- reference/pdo_sqlite/pdo/sqlite/createfunction.xml
  1. php/doc-en@28930349ca
- reference/math/functions/fmod.xml
  1. php/doc-en@54a788ca59
- reference/simplexml/simplexmlelement/addChild.xml
  1. php/doc-en@dca2a8354f
- reference/json/functions/json-last-error.xml
  1. php/doc-en@058ea1e842
- features/commandline.xml
  1. php/doc-en@96b10a9885
- appendices/migration85/incompatible.xml
  1. php/doc-en@048982b729
  2. php/doc-en@f81bbcf9d3
- reference/random/random/randomizer/getfloat.xml
  1. php/doc-en@1ada637cc8
  2. php/doc-en@423a1da63f
- reference/mysqli/mysqli/multi-query.xml
  1. php/doc-en@1beae37b69
- reference/image/functions/getimagesize.xml
  1. php/doc-en@6bb90d24b2
- reference/curl/functions/curl-close.xml
  1. php/doc-en@86c8ebd19e
- reference/curl/functions/curl-share-close.xml
  1. php/doc-en@29c3d13980
- reference/yaml/functions/yaml-parse-file.xml
  1. php/doc-en@132d2a8d63
- reference/mysqli/mysqli/options.xml
  1. php/doc-en@e309a62b16
  2. MYSQLI_SERVER_PUBLIC_KEY の古い「PHP 5.5.0 以降」テキストを削除（既訳のバグ修正）
- appendices/transports.xml
  1. php/doc-en@ae90ecc932
- reference/soap/soapserver/addfunction.xml
  1. php/doc-en@577239f64b
- reference/var/functions/settype.xml
  1. php/doc-en@8d49e302b4
- features/http-auth.xml
  1. php/doc-en@cd4180557a
This commit is contained in:
KentarouTakeda
2026-03-10 08:58:57 +09:00
committed by GitHub
parent d0162cfc0e
commit 768e8d6ed7
26 changed files with 290 additions and 180 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
appendices/migration85/incompatible.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ec01a42be50e84f192c0b19fc6e9cf40a0f7ac31 Maintainer: mumumu Status: ready -->
<!-- EN-Revision: f81bbcf9d36c28bf067b5514cffdbc7663357cf3 Maintainer: mumumu Status: ready -->
<sect1 xml:id="migration85.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>下位互換性のない変更点</title>
@@ -375,9 +375,9 @@
</simpara>
<simpara>
<methodname>PDO::fetch</methodname>,
<methodname>PDO::fetchObject</methodname>,
<methodname>PDO::fetchAll</methodname> の呼び出し中に、
<methodname>PDOStatement::fetch</methodname>,
<methodname>PDOStatement::fetchObject</methodname>,
<methodname>PDOStatement::fetchAll</methodname> の呼び出し中に、
<methodname>PDOStatement::setFetchMode</methodname> を呼び出そうとすると、
<exceptionname>Error</exceptionname> がスローされるようになりました。
これはたとえば、
@@ -403,7 +403,7 @@
</simpara>
<simpara>
<methodname>PDO::fetchAll</methodname> で、
<methodname>PDOStatement::fetchAll</methodname> で、
<constant>PDO::FETCH_INTO</constant> をフェッチモードとして使おうとすると、
<constant>PDO::FETCH_LAZY</constant>
と同様に <exceptionname>ValueError</exceptionname> がスローされるようになりました。

27
appendices/transports.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1268a5eebbd09dbc4c4d5272c2bcdc0b035c256c Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: ae90ecc9328f3abea16a9af69a5f18b24d530832 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>サポートされるソケットトランスポートのリスト</title>
@@ -26,6 +26,13 @@
<literal>ssl://</literal>, <literal>tls://</literal>,
<literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
</simpara>
<note>
<simpara>
<literal>sslv2://</literal> および <literal>sslv3://</literal> トランスポートは
廃止されており、使うべきではありません。後方互換性のためにのみ
ドキュメントに記載されています。
</simpara>
</note>
<note>
<simpara>
@@ -42,8 +49,6 @@
<listitem><simpara><literal>tcp://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>udp://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>ssl://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>sslv2://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>sslv3://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>tls://www.example.com</literal></simpara></listitem>
</itemizedlist>
@@ -80,11 +85,17 @@
</simpara>
<simpara>
<literal>ssl://</literal> は SSL V2 での接続を試みます。
あるいはリモートホストの設定によっては SSL V3 での接続を試みます。
<literal>sslv2://</literal> および
<literal>sslv3://</literal> は、SSL V2 と SSL V3 のどちらのプロトコルを
使用するかを明示的に指定します。
<literal>ssl://</literal> は、クライアントとリモートホスト双方の機能と設定に
応じて、安全な SSL/TLS 接続のネゴシエーションを試みます。実際に使用される
プロトコルは、OpenSSL の設定と <function>stream_context_create</function>
で指定するオプション（<literal>ssl.crypto_method</literal> など）によって
決定されます。
</simpara>
<simpara>
SSLv2 および SSLv3 プロトコルは廃止されており、安全ではありません。
これらの使用は強く推奨されず、PHP および OpenSSL の最近のバージョンでは
デフォルトで無効になっています。
</simpara>
</section>

9
features/commandline.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 74ba8fee2972b6ba4f955392d760dea54e757a95 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 96b10a98853e3b8236504e5775f95eb4a15c82c3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka,mumumu -->
<chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>PHP をコマンドラインから使用する</title>
@@ -1789,6 +1789,13 @@ php >
<note>
<simpara>この機能は Windows ではサポートされていません。</simpara>
</note>
<note>
<simpara>
PHP のコマンドラインの使い方やオプションについては、
<command>php --help</command> または <command>man php</command> を実行してください。
すべてのオプションがウェブサーバーの実行時に適用されるわけではありません。
</simpara>
</note>
<warning>
<para>
この機能は <emphasis>実験的なもの</emphasis> であり、

101
features/http-auth.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bdf9a4e40204c805f2c2a5c94c2f2f8f5556195a Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: cd4180557a185469a64a7eb26f7be98d0a5f1ebb Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,takagi,mumumu -->
<chapter xml:id="features.http-auth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>PHP による HTTP 認証</title>
@@ -14,7 +14,7 @@
パスワードを入力すると、PHP スクリプトを含むその URL は、次回以降、
<link linkend="reserved.variables">定義済みの変数</link>
<varname>PHP_AUTH_USER</varname> と、 <varname>PHP_AUTH_PW</varname> と、
<varname>PHP_AUTH_TYPE</varname> にそれぞれユーザー名、
<varname>AUTH_TYPE</varname> にそれぞれユーザー名、
パスワード、認証型が代入された状態で呼ばれます。
定義済みの変数は、配列
<varname>$_SERVER</varname> でアクセス可能です。
@@ -24,14 +24,16 @@
<para>
ページ上でクライアント認証を強制するスクリプトの例を以下に示します。
</para>
<para>
<example>
<title>Basic HTTP 認証の例</title>
<programlisting role="php">
<![CDATA[
<?php
if (!isset($_SERVER['PHP_AUTH_USER'])) {
header("WWW-Authenticate: Basic realm=\"My Realm\"");
header("HTTP/1.0 401 Unauthorized");
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic realm="My Realm"');
echo "ユーザーがキャンセルボタンを押した時に送信されるテキスト\n";
exit;
} else {
@@ -45,12 +47,12 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
</para>
<note>
<title>互換性に関する注意</title>
<title>互換性</title>
<para>
HTTPヘッダ行をコーディングする際には注意を要します。全てのクライアントへの
互換性を最大限に保証するために、キーワード "Basic" には、
大文字の"B"を使用して書くべきです。realm文字列は(一重引用符ではなく)
二重引用符で括る必要があります。また、<emphasis>HTTP/1.0 401</emphasis>
二重引用符で括る必要があります。また、<emphasis>HTTP/1.1 401</emphasis>
ヘッダ行のコード <emphasis>401</emphasis> の前には、
1つだけ空白を置く必要があります。
認証パラメータは、
@@ -66,15 +68,8 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
ユーザーを調べるといったことをすることになるでしょう。
</para>
<para>
バグのある Internet Explorer ブラウザには注意してください。このブラ
ウザは、ヘッダの順序に関してとてもうるさいようです。今のところ、
<literal>HTTP/1.0 401</literal> ヘッダの前に
<emphasis>WWW-Authenticate</emphasis> ヘッダを送るのが効果があるようです。
</para>
<note>
<title>設定上の注意</title>
<title>Apache の設定</title>
<para>
PHP は、外部認証が動作しているかどうかの判定を
<literal>AuthType</literal> ディレクティブの有無で行います。
@@ -86,62 +81,34 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
にある認証を要するURLからパスワードを盗むことを防ぐわけではありませ
ん。
</simpara>
<simpara>
サーバーからレスポンスコード 401 を受けた際に、Netscape Navigatorおよび
Internet Explorer は共にローカルブラウザのウインドウ上の認証キャッシュを
消去します。この機能により、簡単にユーザーを"ログアウト"させ、強制的に
ユーザー名とパスワードを再入力させることができます。この機能は、
"タイムアウト" 付きのログインや、"ログアウト" ボタンに適用されています。
</simpara>
<example>
<title>新規に名前 / パスワードを入力させる HTTP 認証の例</title>
<programlisting role="php">
<![CDATA[
<?php
function authenticate() {
header('WWW-Authenticate: Basic realm="Test Authentication System"');
header('HTTP/1.0 401 Unauthorized');
echo "このリソースにアクセスする際には有効なログインIDとパスワードを入力する必要があります。\n";
exit;
}
if (!isset($_SERVER['PHP_AUTH_USER']) ||
($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) {
authenticate();
} else {
echo "<p>Welcome: " . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "<br />";
echo "Old: " . htmlspecialchars($_REQUEST['OldAuth']);
echo "<form action='' method='post'>\n";
echo "<input type='hidden' name='SeenBefore' value='1'>\n";
echo "<input type='hidden' name='OldAuth' value=\"" . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "\" />\n";
echo "<input type='submit' value='Re Authenticate'>\n";
echo "</form></p>\n";
}
?>
]]>
</programlisting>
</example>
<simpara>
この動作は、<literal>HTTP Basic</literal> 認証の標準に基づいていません。よって、この機能に
依存しないように注意する必要があります。<literal>Lynx</literal> によるテストの結果、
<literal>Lynx</literal> は、認証証明書を 401 サーバー応答によりクリアしないことが明らかに
なっています。このため、back を押してから forward を再度押すことにより
証明書の要件が変更されない限りリソースをオープンすることができます。
しかし、ユーザーは <literal>'_'</literal> キーを押すことにより認証情報をクリアすることが可能です。
</simpara>
<simpara>
IIS サーバーと CGI 版の PHP の組み合わせで HTTP 認証を使うには、
IIS の設定の "<literal>ディレクトリセキュリティ</literal>" の "<literal>編集</literal>" ボタンを押して
"<literal>匿名アクセス</literal>" のみをオンにしてください。
その他のフィールドはオフのままにしてください。
</simpara>
<note>
<title>IIS に関する注意:</title>
<title>ブラウザの挙動</title>
<simpara>
IIS上 で HTTP 認証を使用する場合、PHP の
<link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link>
ディレクティブは<literal>0</literal> (デフォルト値) にセットされて
いなければなりません。
HTTP Basic 認証は非常に基本的なもので、ログアウトをサポートするようには
設計されていません。HTTP はステートレスなプロトコルであるため、
ほとんどのブラウザは <literal>2xx</literal> ステータスコードを受け取ると
すぐに認証情報をキャッシュし、ブラウザを閉じるまですべてのリクエストで
その認証情報を送信し続けます。サーバーが認証情報の再入力を求める
プロンプトを要求するための標準的な方法は定義されていません。
長年にわたり、この問題に対するさまざまな回避策がインターネット上で
広まってきましたが、それらはすべて、異なるブラウザが未定義のエッジケース
（あるいは HTTP 標準の違反さえも）をどのように処理するかに依存しています。
このような回避策は避け、Basic 認証を重要な用途に使用しないことが最善です。
</simpara>
</note>
<note>
<title>IIS の設定</title>
<simpara>
IIS サーバーと CGI 版の PHP の組み合わせで HTTP 認証を使うには、
php.ini ディレクティブ <link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link>
を <literal>0</literal> (デフォルト値) に設定し、IIS の設定の
"<literal>ディレクトリセキュリティ</literal>" を編集する必要があります。
"<literal>編集</literal>" ボタンを押して
"<literal>匿名アクセス</literal>" のみをオンにしてください。
その他のフィールドはオフのままにしてください。
</simpara>
</note>

3
language/predefined/attributes/nodiscard.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 02bee41067ab2822cbffcb4b3b2387f79488dffd Maintainer: KentarouTakeda Status: ready -->
<!-- EN-Revision: 30bda33771e1c8fa8fc8a5ee7559fd7fa189caa0 Maintainer: KentarouTakeda Status: ready -->
<reference xml:id="class.nodiscard" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>NoDiscard アトリビュート</title>
<titleabbrev>NoDiscard</titleabbrev>
@@ -36,6 +36,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>NoDiscard</classname>
</ooclass>

14
reference/curl/functions/curl-close.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ce98b568f85353c4bf263133f09c4db9294833f9 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 86c8ebd19ed93843f293bdcecc9ce68cb4ab57bc Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.curl-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -53,6 +53,18 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
この関数は推奨されなくなりました。
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
この関数は何もしなくなりました(<acronym>NOP</acronym>)。
</entry>
</row>
&curl.changelog.handle-param;
</tbody>
</tgroup>

14
reference/curl/functions/curl-share-close.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fc9a0a8b29a7a099998bdd71fe5350a10b18fe62 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 29c3d13980c8b29b700afd85c916e064638a7944 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.curl-share-close" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -52,6 +52,18 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
この関数は推奨されなくなりました。
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
この関数は何もしなくなりました(<acronym>NOP</acronym>)。
</entry>
</row>
&curl.changelog.share-handle-param;
</tbody>
</tgroup>

28
reference/filesystem/functions/fgetcsv.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 781f2ec04ee8817687e5e333bc3e64ab973322d7 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 0a3648a71895f35f570573d31ca9e003786aa993 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xml:id="function.fgetcsv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fgetcsv</refname>
<refpurpose>ファイルポインタから行を取得し、CSVフィールドを処理する</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -92,18 +92,21 @@
シングルバイト文字 1 文字のみ、または空文字列でなければなりません。
空文字列(<literal>""</literal>) を指定すると、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構が無効になります。
</para>
<note>
<warning xml:id="function.fgetcsv..warn.escape.parameter">
<simpara>
<parameter>enclosure</parameter> の文字は、フィールド内で2回出力される
ことでエスケープされます。しかし、
<parameter>escape</parameter> 文字はその代替として使えます。
デフォルトのパラメータの値
<literal>""</literal> と <literal>\"</literal> は同じ意味を持ちます。
<parameter>enclosure</parameter> の文字を
<parameter>escape</parameter> 文字でエスケープすることには、
特別な意味はありません。それ自身をエスケープする意味ですらありません。
入力ストリームにおいて、<parameter>enclosure</parameter> 文字は
クォートされた文字列の中で2回連続させることで常にエスケープでき、
パース結果では単一の <parameter>enclosure</parameter> 文字になります。
<parameter>escape</parameter> 文字の動作は異なります:
入力中に <parameter>escape</parameter> と
<parameter>enclosure</parameter> 文字の並びが出現した場合、
パース結果には両方の文字がそのまま残ります。
よって、デフォルトのパラメータの場合、
<literal>"a""b","c\"d"</literal> のような CSV の行は
それぞれ <literal>a"b</literal> と <literal>c\"d</literal>
にパースされます。
</simpara>
</note>
</warning>
<warning>
<simpara>
PHP 8.4.0 以降では、<parameter>escape</parameter>
@@ -191,7 +194,6 @@
</tgroup>
</informaltable>
</para>
&warning.csv.escape-parameter;
</refsect1>
<refsect1 role="examples">

14
reference/image/functions/getimagesize.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f8d1e172bd6d11986f0dfeb11756b90c039a39bc Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 6bb90d24b240a0b81e4b203cd8b7ed56bd54033a Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
<refnamediv>
@@ -188,6 +188,10 @@ if ($size && $fp) {
<function>getimagesize</function> は
<constant>E_NOTICE</constant> レベルのエラーを発生させます。
</para>
<para>
PHP 8.0.0 以降、<parameter>filename</parameter> が空の場合に
<exceptionname>ValueError</exceptionname> がスローされます。
</para>
</refsect1>
<refsect1 role="changelog">
@@ -209,6 +213,14 @@ if ($size && $fp) {
これより前のバージョンでは、幅と高さの情報は <literal>0x0</literal> として報告され、ビット数とチャンネル情報は全く報告されていませんでした。
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>filename</parameter> が空の場合に
<exceptionname>ValueError</exceptionname> がスローされるようになりました。
これより前のバージョンでは、<constant>E_WARNING</constant> が発生し、関数は &false; を返していました。
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>

9
reference/imap/functions/imap-headerinfo.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 4e69a9f2b14deefca0befec576335e33152448f3 Maintainer: hirokawa Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.imap-headerinfo" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -51,13 +51,6 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>defaulthost</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

7
reference/json/functions/json-last-error.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7100979e254970cef72c6f91b32352e7c7898635 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 058ea1e8420b9c1b24402af52545e8313428e1d1 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.json-last-error" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -101,6 +101,11 @@
<entry>おそらく正しくエンコードされていない、不正な UTF-16 文字</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_NON_BACKED_ENUM</constant></entry>
<entry>シリアライズできない、Backed Enum でない値が含まれています。PHP 8.1.0 以降で使用可能。</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>

5
reference/math/functions/fmod.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 761d72245071f89a626903c9bcdc6aaff1252d54 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 54a788ca59d95ff2b4189406437345a21b489435 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.fmod" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -49,7 +49,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>num1</parameter>/<parameter>num2</parameter> の剰余を返します。
<parameter>num1</parameter>/<parameter>num2</parameter> の浮動小数点の剰余を返します。
第二引数が 0 の場合は <constant>NAN</constant> (<type>float</type>) を返します。
</para>
</refsect1>
<refsect1 role="examples">

10
reference/mbstring/functions/mb-decode-numericentity.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a60ef65239113c7871643be68ada91081376c936 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 4e69a9f2b14deefca0befec576335e33152448f3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<refentry xml:id="function.mb-decode-numericentity" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -50,14 +50,6 @@
&mbstring.encoding.parameter;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>is_hex</parameter></term>
<listitem>
<para>
このパラメータは使われていません。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

12
reference/mysqli/mysqli/multi-query.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d470f625f96a83d65464619297cccad7ce46e743 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 1beae37b6904f55cfd33dbe99ad83a23eb78b144 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="mysqli.multi-query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -27,14 +27,11 @@
</para>
&mysqli.sqlinjection.warning;
<para>
ひとつの呼び出し中に、クエリはデータベースに非同期に送信されますが、
データベースはそれらを順番に実行します。
クエリはひとつの呼び出しでデータベースに送信され、順番に処理されます。
<methodname>mysqli_multi_query</methodname>
は PHP に制御を戻す前に、最初のクエリの実行が完了するのを待ちます。
MySQLサーバーはその後、次のクエリを順番に実行していきます。
次の結果セットの準備が出来ると、
MySQL は PHP 側が <function>mysqli_next_result</function>
を実行するのを待ちます。
その間、MySQL サーバーは PHP とは非同期に残りのクエリの処理を続け、
結果を取得できる状態にします。
</para>
<para>
複数のクエリを処理するために、
@@ -42,6 +39,7 @@
を使うことを推奨します。
全てのクエリの実行が完了し、結果を PHP が取得するまで、
接続はビジー状態になります。
全てのクエリが処理されるまで、同じ接続上では他のステートメントを実行できません。
次のクエリを順番に実行するには、
<function>mysqli_next_result</function> を使います。
次の結果セットの準備ができていない場合、

21
reference/mysqli/mysqli/options.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fbb5e68567180d47b639b57adf196cc01889f4c6 Maintainer: takagi Status: ready -->
<!-- EN-Revision: e309a62b16c7dc48883b1b426bb8c15918488681 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="mysqli.options" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -70,6 +70,12 @@
<entry><constant>MYSQLI_OPT_LOCAL_INFILE</constant></entry>
<entry><literal>LOAD LOCAL INFILE</literal> の使用可/不可。</entry>
</row>
<row>
<entry><constant>MYSQLI_OPT_LOAD_DATA_LOCAL_DIR</constant></entry>
<entry>
<literal>LOAD DATA LOCAL INFILE</literal> で使用するディレクトリ。
</entry>
</row>
<row>
<entry><constant>MYSQLI_INIT_COMMAND</constant></entry>
<entry>MySQL サーバーへの接続後に実行するコマンド。</entry>
@@ -99,7 +105,6 @@
<entry><constant>MYSQLI_SERVER_PUBLIC_KEY</constant></entry>
<entry>
RSA 公開鍵ファイル。SHA-256 ベースの認証で使います。
PHP 5.5.0 以降で利用可能です。
</entry>
</row>
<row>
@@ -130,6 +135,18 @@
サーバーの証明書を検証するかしないかを指定します。
</entry>
</row>
<row>
<entry><constant>MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS</constant></entry>
<entry>
クライアントが期限切れのパスワードを受け入れるかどうかを指定します。
</entry>
</row>
<row>
<entry><literal>1</literal></entry>
<entry>
ネットワーク通信の圧縮を使用するかどうかを指定します。
</entry>
</row>
</tbody>
</tgroup>
</table>

6
reference/pdo_sqlite/pdo/sqlite/createfunction.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 51610360d58ed09bc9d1312f419057c0d1d1a998 Maintainer: KentarouTakeda Status: ready -->
<!-- EN-Revision: 28930349caaaa78f908c380e44066d37a70e97b8 Maintainer: KentarouTakeda Status: ready -->
<!-- CREDITS: KentarouTakeda -->
<refentry xml:id="pdo-sqlite.createfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -99,7 +99,7 @@
<listitem>
<simpara>
ビット単位のフラグの組み合わせ。
現在は、<constant>PDO::SQLITE_DETERMINISTIC</constant> だけがサポートされています。
現在は、<constant>Pdo\Sqlite::DETERMINISTIC</constant> だけがサポートされています。
これは、単一のSQLステートメント内では、
同じ入力に対して常に同じ結果を返すことを指定します。
</simpara>
@@ -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();
?>
]]>

11
reference/random/random/randomizer/getfloat.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 423a1da63f8265c57827234807709232afd274ec Maintainer: mumumu Status: ready -->
<refentry xml:id="random-randomizer.getfloat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Random\Randomizer::getFloat</refname>
@@ -348,6 +348,15 @@ Lat: +69.244304 Lng: -53.548951
に記されている γ-section アルゴリズムを実装しています。
</para>
</note>
<caution>
<para>
アンダーフローは、γ-section アルゴリズムでは意図的に処理されないままになっています。
そのため、浮動小数点数の非正規化数の範囲にある境界を持つ区間、
つまり絶対値がおよそ
<literal>2<superscript>-1020</superscript></literal>（約 <literal>8.9e-308</literal>）よりも小さい境界を持つ区間では、
不正な値が返される可能性があります。
</para>
</caution>
</refsect1>
<refsect1 role="seealso">

6
reference/simplexml/simplexmlelement/addChild.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: takagi Status: ready -->
<!-- EN-Revision: dca2a8354fc170f26545210ac78424ccc30950ea Maintainer: takagi Status: ready -->
<refentry xml:id="simplexmlelement.addchild" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>SimpleXMLElement::addChild</refname>
@@ -39,6 +39,10 @@
<para>
指定されている場合は、子要素の値。
</para>
<para>
特殊文字 <literal>&lt;</literal> と <literal>&gt;</literal> は自動的にエスケープされますが、
<literal>&amp;</literal> は手動でエスケープする必要があります。
</para>
</listitem>
</varlistentry>
<varlistentry>

39
reference/soap/soapserver/addfunction.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: takagi Status: ready -->
<!-- EN-Revision: 577239f64b3959c22d348a5f381eaf32fde996ed Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka -->
<refentry xml:id="soapserver.addfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -35,10 +35,14 @@
いくつかの関数をエクスポートするには、関数名の配列を渡してください。
</para>
<para>
全ての関数をエクスポートする場合、特別な定数
<constant>SOAP_FUNCTIONS_ALL</constant>
を渡してください。
全ての関数をエクスポートするには、関数名の配列を渡してください。
</para>
<simpara>
PHP 8.4.0 以降、<type>int</type> 値
（<constant>SOAP_FUNCTIONS_ALL</constant> を含む）を渡すことは非推奨になりました。
<function>get_defined_functions</function> を使って全ての関数を取得し、
配列として渡してください。
</simpara>
<note>
<para>
<parameter>functions</parameter> は、全ての入力引数を
@@ -61,6 +65,30 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<methodname>SoapServer::addFunction</methodname> に
<type>int</type> を渡すこと
（<constant>SOAP_FUNCTIONS_ALL</constant> を含む）は非推奨になりました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -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);
?>
]]>

15
reference/spl/splfileobject/fgetcsv.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f1eb91d07d2df082384b3f83c9d2a0dc1e439d32 Maintainer: masakielastic Status: ready -->
<!-- EN-Revision: 0a3648a71895f35f570573d31ca9e003786aa993 Maintainer: masakielastic Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="splfileobject.fgetcsv" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
@@ -57,18 +57,7 @@
<methodname>SplFileObject::setCsvControl</methodname> を呼び出してセットされた値です。
空文字列(<literal>""</literal>)の場合、(RFC 4180 に準拠していない) 独自仕様のエスケープ機構が無効になります。
</para>
<note>
<simpara>
<parameter>enclosure</parameter> の文字は、フィールド内で2回出力される
ことでエスケープされます。しかし、
<parameter>escape</parameter> 文字はその代替として使えます。
デフォルトのパラメータの値
<literal>""</literal> と <literal>\"</literal> は同じ意味を持ちます。
<parameter>enclosure</parameter> の文字を
<parameter>escape</parameter> 文字でエスケープすることには、
特別な意味はありません。それ自身をエスケープする意味ですらありません。
</simpara>
</note>
<xi:include xpointer="function.fgetcsv..warn.escape.parameter"/>
<warning>
<simpara>
PHP 8.4.0 以降では、<parameter>escape</parameter>

14
reference/ssh2/functions/ssh2-auth-pubkey-file.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 12f0e72200ea9249d0fc2f118528bd24b24c44a6 Maintainer: shimooka Status: ready -->
<!-- EN-Revision: 74ef2355c59e814d14f75a0792d22727be72f137 Maintainer: shimooka Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ssh2-auth-pubkey-file">
<refnamediv>
<refname>ssh2_auth_pubkey_file</refname>
<refpurpose>公開鍵を使用した認証を行う</refpurpose>
<refpurpose>ファイルから読み込んだ公開鍵を使用した認証を行う</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -18,7 +18,7 @@
<methodparam choice="opt"><type>string</type><parameter>passphrase</parameter></methodparam>
</methodsynopsis>
<simpara>
ファイルから読み込んだ公開鍵を使用した認証を行います。
ファイルから読み込んだ公開鍵を使用して認証を行います。
</simpara>
</refsect1>
@@ -38,6 +38,7 @@
<term><parameter>username</parameter></term>
<listitem>
<simpara>
リモートサーバー上で認証するユーザーの名前。
</simpara>
</listitem>
</varlistentry>
@@ -113,6 +114,13 @@ if (ssh2_auth_pubkey_file($connection, 'username',
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>ssh2_auth_pubkey</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

3
reference/ssh2/functions/ssh2-connect.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 12f0e72200ea9249d0fc2f118528bd24b24c44a6 Maintainer: shimooka Status: ready -->
<!-- EN-Revision: 74ef2355c59e814d14f75a0792d22727be72f137 Maintainer: shimooka Status: ready -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.ssh2-connect">
<refnamediv>
<refname>ssh2_connect</refname>
@@ -287,6 +287,7 @@ if (!$connection) die('Connection failed');
<member><function>ssh2_fingerprint</function></member>
<member><function>ssh2_auth_none</function></member>
<member><function>ssh2_auth_password</function></member>
<member><function>ssh2_auth_pubkey</function></member>
<member><function>ssh2_auth_pubkey_file</function></member>
<member><function>ssh2_disconnect</function></member>
</simplelist>

18
reference/stream/functions/stream-filter-append.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: a684294e0b7ce0c18e2212b002b442b6ceba321d Maintainer: hirokawa Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.stream-filter-append" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -12,12 +12,12 @@
<methodsynopsis>
<type>resource</type><methodname>stream_filter_append</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>string</type><parameter>filtername</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam>
<methodparam><type>string</type><parameter>filter_name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
<parameter>filtername</parameter> で指定されたフィルタを、
<parameter>filter_name</parameter> で指定されたフィルタを、
<parameter>stream</parameter> に付加されているフィルタのリストに加えます。
</para>
</refsect1>
@@ -35,7 +35,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filtername</parameter></term>
<term><parameter>filter_name</parameter></term>
<listitem>
<para>
フィルタ名。
@@ -43,7 +43,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>read_write</parameter></term>
<term><parameter>mode</parameter></term>
<listitem>
<para>
デフォルトでは、 <function>stream_filter_append</function> は
@@ -55,7 +55,7 @@
<literal>ライトフィルターチェィン</literal>にも追加します。
<constant>STREAM_FILTER_READ</constant>・
<constant>STREAM_FILTER_WRITE</constant>・
<constant>STREAM_FILTER_ALL</constant> を <parameter>read_write</parameter>パラメータに渡すことで、この挙動を変えることができます。
<constant>STREAM_FILTER_ALL</constant> を <parameter>mode</parameter>パラメータに渡すことで、この挙動を変えることができます。
</para>
</listitem>
</varlistentry>
@@ -84,7 +84,7 @@
<para>
&false; が返されるのは、<parameter>stream</parameter> がリソースではない場合や
<parameter>filtername</parameter> が見つからない場合です。
<parameter>filter_name</parameter> が見つからない場合です。
</para>
</refsect1>
@@ -137,7 +137,7 @@ Guvf vf n grfg
<note>
<title>カスタム(ユーザー)フィルタを使うには</title>
<simpara>
カスタムフィルタを <parameter>filtername</parameter> に指定するためには、
カスタムフィルタを <parameter>filter_name</parameter> に指定するためには、
まず <function>stream_filter_register</function> 関数でそれを登録しておく
必要があります。
</simpara>

18
reference/stream/functions/stream-filter-prepend.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: a684294e0b7ce0c18e2212b002b442b6ceba321d Maintainer: hirokawa Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.stream-filter-prepend" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -12,12 +12,12 @@
<methodsynopsis>
<type>resource</type><methodname>stream_filter_prepend</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>string</type><parameter>filtername</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam>
<methodparam><type>string</type><parameter>filter_name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
<parameter>filtername</parameter> で指定されたフィルタを、
<parameter>filter_name</parameter> で指定されたフィルタを、
<parameter>stream</parameter> に付加されているフィルタのリストに加えます。
</para>
</refsect1>
@@ -35,7 +35,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filtername</parameter></term>
<term><parameter>filter_name</parameter></term>
<listitem>
<para>
フィルタ名。
@@ -43,7 +43,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>read_write</parameter></term>
<term><parameter>mode</parameter></term>
<listitem>
<para>
デフォルトでは、 <function>stream_filter_prepend</function> は
@@ -55,7 +55,7 @@
<literal>ライトフィルターチェィン</literal>にも追加します。
<constant>STREAM_FILTER_READ</constant>・
<constant>STREAM_FILTER_WRITE</constant>・
<constant>STREAM_FILTER_ALL</constant> を <parameter>read_write</parameter>パラメータに渡すことで、この挙動を変えることができます。
<constant>STREAM_FILTER_ALL</constant> を <parameter>mode</parameter>パラメータに渡すことで、この挙動を変えることができます。
このパラメータを使った例については、
<function>stream_filter_append</function> を参照ください。
</para>
@@ -86,7 +86,7 @@
<para>
&false; が返されるのは、<parameter>stream</parameter> がリソースではない場合や
<parameter>filtername</parameter> が見つからない場合です。
<parameter>filter_name</parameter> が見つからない場合です。
</para>
</refsect1>
@@ -95,7 +95,7 @@
<note>
<title>カスタム(ユーザー)フィルタを使うには</title>
<simpara>
カスタムフィルタを <parameter>filtername</parameter> に指定するためには、
カスタムフィルタを <parameter>filter_name</parameter> に指定するためには、
まず <function>stream_filter_register</function> 関数でそれを登録しておく
必要があります。
</simpara>

37
reference/var/functions/settype.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d816a0fad6c458d9515f697cc89e26ca9d8069f5 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 8d49e302b484f0e5c237dd16ca1afef3b7515f46 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.settype" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -89,6 +89,41 @@
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
PHP 8.0.0 以降、<parameter>type</parameter> の値が
有効な型でない場合、<exceptionname>ValueError</exceptionname> をスローします。
PHP 8.0.0 より前のバージョンでは、<constant>E_WARNING</constant> が発生し、
&false; が返されていました。
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
無効な型が <parameter>type</parameter> に渡された場合、
<exceptionname>ValueError</exceptionname> をスローするようになりました。
これより前のバージョンでは、<constant>E_WARNING</constant> が発生し、
関数は &false; を返していました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>

19
reference/yaml/functions/yaml-parse-file.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4b0e5ea18a47ee567fdad728e3d4c3081a0c602 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 132d2a8d63f971351f5c82046495ad78443bc46a Maintainer: takagi Status: ready -->
<refentry xml:id="function.yaml-parse-file" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -69,13 +69,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>filename</parameter> にある情報を、
<simpara>
<parameter>filename</parameter> にエンコードされている値を、
適切な PHP の型に変換した結果を返します。
&return.falseforfailure;。
<parameter>pos</parameter> が <literal>-1</literal> の場合は配列を返します。
配列の各要素が、ストリーム内で見つかった個々のドキュメントとなります。
</para>
</simpara>
<simpara>
失敗した場合、エラーメッセージを含む文字列を返します。
</simpara>
<simpara>
<parameter>pos</parameter> が <literal>-1</literal> の場合、
ストリーム内で見つかった個々のドキュメントごとにひとつのエントリを持つ
<type>array</type> を返します。
</simpara>
</refsect1>
<refsect1 role="notes">