Skip to content

Commit 64df4dd

Browse files
KentarouTakedaKentarouTakeda
authored
doc-en と同期（PDO・mysqli の文法修正、session の PHP 8.4 非推奨注記ほか・16ファイル） (#421)
* doc-en と同期し PDO と mysqli の文法修正を反映（11ファイル） php/doc-en@1cc1b81 (#5712) の追従。多くは <para> から <simpara> への 変更だが、以下は原文の記述内容が変わっている。 - reference/pdo/constants.xml: PDO::ATTR_STATEMENT_CLASS の説明を差し替え。 クラス名だけでなく、コンストラクタ引数の配列も設定する旨と、配列の 第1要素がクラス名・第2要素が引数の配列である旨を追加 - reference/mysqli/configure.xml: サポート表に「8.2.0 以降」の行を追加し、 既存行を「5.4.0 から 8.1.x まで」に変更。拡張モジュールとクライアント ライブラリを自由に組み合わせられる旨の段落を削除 - reference/mysqli/summary.xml: mysqli::get_warnings の NOT DOCUMENTED を 実際の説明に置き換え、$mysqli_stmt::field_count から - not documented を削除。 field_count・param_count・sqlstate から given / statement の限定語を削除 - reference/mysqli/mysqli/poll.xml: reject パラメータの説明を no pending asynchronous query exists to poll に書き換え - reference/mysqli/mysqli/stmt-init.xml: mysqli_stmt function を mysqli_stmt method に変更し、戻り値を an object から a mysqli_stmt object に具体化 - reference/mysqli/ini.xml: mysqli.max_links の説明から MySQL を削除 - reference/mysqli/quickstart.xml: 原文のタイポ（complain / databased）と neither に対する not の誤りを修正し、emulation を support に言い換え。 あわせて php/doc-en@c2088ac ([skip-revcheck] #3202) の Such a separation is sometimes considered the only ... も取り込む * session の INI ディレクティブに PHP 8.4.0 の非推奨注記を追加 php/doc-en@7fabff2 (#5702) の追従。 - session.use_only_cookies を無効にすること、session.referer_check と session.trans_sid_hosts に空でない値を設定すること、 session.use_trans_sid を有効にすること、session.trans_sid_tags を デフォルト値から変更することが、いずれも PHP 8.4.0 以降は非推奨である旨を 一覧表の Changelog 列と本文の警告に追加 - session.trans_sid_tags のデフォルト値の記述から input=src を削除 * security/database に mssql_query の例が削除済み拡張である旨の note を追加 php/doc-en@0009ebd (#5709) の追従。攻撃例で使っている mssql_query が PHP 7.0.0 で削除された mssql 拡張モジュールのものであり、現在は sqlsrv または pdo_sqlsrv を使うべきである旨の note が原文に追加された。 * localeconv の戻り値の説明の誤りを修正 php/doc-en@92367ae (#5707) の追従。p_cs_precedes・p_sep_by_space・ n_cs_precedes・n_sep_by_space は int を返すが、原文が true / false と 記述していた誤りが修正され、1 / 0 になった。 * shell_exec にバッククォート演算子が非推奨である旨を追記 php/doc-en@81593f0 (#5719) の追従。identical to the backtick operator が identical to the deprecated backtick operator に変更された。 * getimagesize の参考に getimagesizefromstring を追加 php/doc-en@22ca944 の追従。
1 parent d20a7c7 commit 64df4dd

16 files changed

Lines changed: 120 additions & 78 deletions

File tree

‎reference/exec/functions/shell-exec.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7973fd533364af4dd6282ca9e7bee2dffec39b1c Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 81593f08db3320d5366bf925c8561f097a9d69ad Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
66
<refentry xml:id="function.shell-exec" xmlns="http://docbook.org/ns/docbook">
@@ -15,11 +15,11 @@
1515
<type class="union"><type>string</type><type>false</type><type>null</type></type><methodname>shell_exec</methodname>
1616
<methodparam><type>string</type><parameter>command</parameter></methodparam>
1717
</methodsynopsis>
18-
<para>
19-
この関数は <link
18+
<simpara>
19+
この関数は、非推奨の <link
2020
linkend="language.operators.execution">バッククォート演算子</link>
2121
と等価です。
22-
</para>
22+
</simpara>
2323
<note>
2424
<para>
2525
Windows では、パイプがテキストモードでオープンされるため、

‎reference/image/functions/getimagesize.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 22ca9442cb38626cc8fc522c62f74f32b3dc9709 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
66
<refnamediv>
@@ -286,6 +286,7 @@ if (isset($info["APP13"])) {
286286
<refsect1 role="seealso">
287287
&reftitle.seealso;
288288
<simplelist>
289+
<member><function>getimagesizefromstring</function></member>
289290
<member><function>image_type_to_mime_type</function></member>
290291
<member><function>exif_imagetype</function></member>
291292
<member><function>exif_read_data</function></member>

‎reference/mysqli/configure.xml‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 050e16021ff71318012fa16322e98d8603d5ab38 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa -->
55
<section xml:id="mysqli.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66

@@ -34,14 +34,15 @@
3434
各拡張モジュールが使用するクライアントライブラリを選択したりすることができます。
3535
</para>
3636

37-
<para>
37+
<simpara>
3838
クライアントライブラリには MySQL Native Driver を使うことを推奨します。
39+
PHP 8.2.0 以降では、MySQL Native Driver が唯一の選択肢です。
3940
そのほうがパフォーマンスが向上し、MySQL Client Library
4041
を使用した場合には使えない機能も使用することができます。
4142
<link linkend="mysqli.overview.mysqlnd">PHP の MySQL Native
4243
Driver とは?</link>
4344
に、MySQL Native Driver の利点が簡単にまとめられています。
44-
</para>
45+
</simpara>
4546

4647
<para>
4748
<literal>/path/to/mysql_config</literal> は、MySQL Server に含まれる
@@ -62,7 +63,14 @@
6263
</thead>
6364
<tbody>
6465
<row>
65-
<entry>5.4.x 以降</entry>
66+
<entry>8.2.0 以降</entry>
67+
<entry>mysqlnd</entry>
68+
<entry><option role="configure">--with-mysqli</option></entry>
69+
<entry>libmysqlclient はサポートされません。</entry>
70+
<entry>mysqlnd しか使えなくなりました。</entry>
71+
</row>
72+
<row>
73+
<entry>5.4.0 から 8.1.x まで</entry>
6674
<entry>mysqlnd</entry>
6775
<entry><option role="configure">--with-mysqli</option></entry>
6876
<entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
@@ -86,14 +94,6 @@
8694
</tgroup>
8795
</table>
8896

89-
<para>
90-
MySQL 拡張モジュールとクライアントライブラリの組み合わせは自由であることに注意しましょう。
91-
たとえば、MySQL 拡張モジュールは MySQL Client Library (libmysqlclient) を使うようにして有効にし、
92-
一方 <literal>mysqli</literal> 拡張モジュールは MySQL Native Driver
93-
を使うようにするということも可能です。
94-
しかし、それ以外にも拡張モジュールとクライアントライブラリのすべての組み合わせが使用可能です。
95-
</para>
96-
9797
</section>
9898

9999
<section xml:id="mysqli.installation.windows">

‎reference/mysqli/ini.xml‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.runtime;
@@ -147,9 +147,9 @@
147147
<type>int</type>
148148
</term>
149149
<listitem>
150-
<para>
150+
<simpara>
151151
作成できる持続的接続の最大数。0 を設定すると無制限となります。
152-
</para>
152+
</simpara>
153153
</listitem>
154154
</varlistentry>
155155
<varlistentry xml:id="ini.mysqli.max-links">
@@ -158,9 +158,9 @@
158158
<type>int</type>
159159
</term>
160160
<listitem>
161-
<para>
162-
プロセス毎の MySQL 接続の最大数。
163-
</para>
161+
<simpara>
162+
プロセス毎の接続の最大数。
163+
</simpara>
164164
</listitem>
165165
</varlistentry>
166166
<varlistentry xml:id="ini.mysqli.default-port">

‎reference/mysqli/mysqli/poll.xml‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: c5ccd084c8f830801a939bf1829ddddcaf019730 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.poll" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -56,18 +56,18 @@
5656
<varlistentry>
5757
<term><parameter>error</parameter></term>
5858
<listitem>
59-
<para>
60-
クエリが失敗した、あるいは接続が切断されたなどのエラーが発生した接続のリスト。
61-
</para>
59+
<simpara>
60+
クエリが失敗した、あるいは接続が切断されたなどのエラーが発生した接続のリスト。
61+
</simpara>
6262
</listitem>
6363
</varlistentry>
6464
<varlistentry>
6565
<term><parameter>reject</parameter></term>
6666
<listitem>
67-
<para>
68-
関数から結果を取得できるような非同期クエリが実行されていないという理由で、
69-
拒否された接続のリスト。
70-
</para>
67+
<simpara>
68+
問い合わせの対象となる保留中の非同期クエリが存在しないという理由で、
69+
拒否された接続のリスト。
70+
</simpara>
7171
</listitem>
7272
</varlistentry>
7373
<varlistentry>

‎reference/mysqli/mysqli/stmt-init.xml‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.stmt-init" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -26,10 +26,10 @@
2626
ステートメントオブジェクトを割り当て、初期化します。
2727
</para>
2828
<note>
29-
<para>
30-
<function>mysqli_stmt_prepare</function> がコールされるまで、
31-
これ以降のあらゆる mysqli_stmt 関数のコールは失敗します。
32-
</para>
29+
<simpara>
30+
これ以降、<function>mysqli_stmt_prepare</function> をコールするまでは、
31+
<classname>mysqli_stmt</classname> のどのメソッドをコールしても失敗します。
32+
</simpara>
3333
</note>
3434
</refsect1>
3535

@@ -44,9 +44,9 @@
4444

4545
<refsect1 role="returnvalues">
4646
&reftitle.returnvalues;
47-
<para>
48-
オブジェクトを返します。
49-
</para>
47+
<simpara>
48+
<classname>mysqli_stmt</classname> オブジェクトを返します。
49+
</simpara>
5050
</refsect1>
5151

5252
<refsect1 role="seealso">

‎reference/mysqli/quickstart.xml‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 60a292997b3c6341cf52099d901aa0b5f8673d87 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: mumumu Status: ready -->
44

55
<chapter xml:id="mysqli.quickstart" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>クイックスタートガイド</title>
@@ -253,13 +253,13 @@ mysqli.default_socket=/tmp/mysql.sock
253253
ソケット(パイプ名)のデフォルトは
254254
<literal>\\.\pipe\MySQL</literal> となります。
255255
</para>
256-
<para>
256+
<simpara>
257257
Unixドメインソケットベース、
258258
および Windows の名前付きパイプベースの接続が両方確立されず、
259259
port パラメータが未設定の場合、
260260
ライブラリはデフォルトのポートを
261261
<literal>3306</literal> に設定します。
262-
</para>
262+
</simpara>
263263
<para>
264264
<link linkend="mysqlnd.overview">mysqlnd</link>
265265
ライブラリと
@@ -331,7 +331,7 @@ mysqli.default_socket=/tmp/mysql.sock
331331
Webサーバーは多くの
332332
PHP プロセスをforkさせる可能性があることに注意して下さい。
333333
</para>
334-
<para>
334+
<simpara>
335335
持続的接続についてよくある不満が、
336336
再利用する前にステートがリセットされないというものです。
337337
たとえば、
@@ -343,7 +343,7 @@ mysqli.default_socket=/tmp/mysql.sock
343343
これは、望ましくない副作用と見なされるかもしれません。
344344
一方で、<literal>persistent</literal> という名前は、
345345
ステートを維持することを約束していると理解されるかもしれません。
346-
</para>
346+
</simpara>
347347
<para>
348348
mysqli 拡張モジュールは、
349349
持続的接続について、両方の解釈をサポートしています:
@@ -1079,9 +1079,9 @@ array(2) {
10791079
<para>
10801080
<emphasis role="bold">クライアント側でプリペアドステートメントをエミュレートする</emphasis>
10811081
</para>
1082-
<para>
1082+
<simpara>
10831083
API は、クライアント側でのプリペアドステートメントのエミュレートをサポートしていません。
1084-
</para>
1084+
</simpara>
10851085
<para>
10861086
<emphasis role="bold">参照</emphasis>
10871087
</para>
@@ -1198,13 +1198,13 @@ Hi!
11981198
</screen>
11991199
</example>
12001200
</para>
1201-
<para>
1201+
<simpara>
12021202
アプリケーションやフレームワークの開発者は、
12031203
セッションの値やデータベースカタログを調べることによって、
12041204
もっと便利なAPIを提供できます。
12051205
しかし、カタログを調べることをベースにしたカスタムのやり方は、
12061206
パフォーマンスに影響がある可能性があることに注意して下さい。
1207-
</para>
1207+
</simpara>
12081208
<para>
12091209
<emphasis role="bold">結果セットを扱う</emphasis>
12101210
</para>

‎reference/mysqli/summary.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4e8c90ca8a4a63575341cde6f5fbdc34419d2cff Maintainer: lacatoire Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: lacatoire Status: ready -->
44
<chapter xml:id="mysqli.summary" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55

66
<title>MySQLi 拡張モジュールの関数概要</title>
@@ -203,7 +203,7 @@
203203
<entry><methodname>mysqli::get_warnings</methodname></entry>
204204
<entry><function>mysqli_get_warnings</function></entry>
205205
<entry>N/A</entry>
206-
<entry>ドキュメント化されていない</entry>
206+
<entry>SHOW WARNINGS の結果を取得する</entry>
207207
</row>
208208
<row>
209209
<entry><methodname>mysqli::init</methodname></entry>
@@ -388,7 +388,7 @@
388388
<entry><link linkend="mysqli-stmt.field-count">$mysqli_stmt::field_count</link></entry>
389389
<entry><function>mysqli_stmt_field_count</function></entry>
390390
<entry>N/A</entry>
391-
<entry>指定されたステートメントのフィールド数を返す - ドキュメント化されていない</entry>
391+
<entry>ステートメントのフィールド数を返す</entry>
392392
</row>
393393
<row>
394394
<entry><link linkend="mysqli-stmt.insert-id">$mysqli_stmt::insert_id</link></entry>
@@ -406,13 +406,13 @@
406406
<entry><link linkend="mysqli-stmt.param-count">$mysqli_stmt::param_count</link></entry>
407407
<entry><function>mysqli_stmt_param_count</function></entry>
408408
<entry>N/A</entry>
409-
<entry>指定されたステートメントのパラメータ数を返す</entry>
409+
<entry>ステートメントのパラメータ数を返す</entry>
410410
</row>
411411
<row>
412412
<entry><link linkend="mysqli-stmt.sqlstate">$mysqli_stmt::sqlstate</link></entry>
413413
<entry><function>mysqli_stmt_sqlstate</function></entry>
414414
<entry>N/A</entry>
415-
<entry>直前のステートメント操作の SQLSTATE エラーを返す</entry>
415+
<entry>直前の操作の SQLSTATE エラーを返す</entry>
416416
</row>
417417
<row>
418418
<entry><emphasis role="bold">メソッド</emphasis></entry>

‎reference/mysqlinfo/set.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7cff4d34f0324c9de72d15957e1b62e20f37dfaf Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu --><set xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="set.mysqlinfo">
55
<title>MySQL ドライバおよびプラグイン</title>
66
<titleabbrev>MySQL</titleabbrev>

‎reference/pdo/constants.xml‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: mumumu Status: ready -->
44
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
55
<appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.constants;
@@ -434,7 +434,9 @@
434434
</term>
435435
<listitem>
436436
<simpara>
437-
ステートメントが返すクラス名を設定します。
437+
<classname>PDOStatement</classname> オブジェクトを拡張するクラス名と、
438+
そのコンストラクタの引数を設定します。
439+
配列の最初の要素がクラス名で、2 番目の要素がコンストラクタの引数の配列です。
438440
</simpara>
439441
</listitem>
440442
</varlistentry>

0 commit comments

Comments
 (0)