Skip to content

doc-en と同期(PDO・mysqli の文法修正、session の PHP 8.4 非推奨注記ほか・16ファイル) - #421

Merged
KentarouTakeda merged 6 commits into
php:masterfrom
KentarouTakeda:sync-mysqli-pdo-grammar-and-session-deprecation
Jul 31, 2026
Merged

doc-en と同期(PDO・mysqli の文法修正、session の PHP 8.4 非推奨注記ほか・16ファイル)#421
KentarouTakeda merged 6 commits into
php:masterfrom
KentarouTakeda:sync-mysqli-pdo-grammar-and-session-deprecation

Conversation

@KentarouTakeda

Copy link
Copy Markdown
Collaborator

翻訳内容

PDO・mysqli の文法一括修正への追従(11件)

php/doc-en@1cc1b81 (#5712) が 56 ファイルにわたって行った <para><simpara> 化と英文の文法修正のうち、日本語版に未反映だった分です。多くはマークアップのミラーのみですが、以下は原文の記述内容が変わっています。

  • reference/mysqlinfo/set.xml
    1. php/doc-en@1cc1b81
  • reference/pdo/constants.xml — PDO::ATTR_STATEMENT_CLASS の説明を差し替え(クラス名のみ → クラス名とコンストラクタ引数の配列、および配列の各要素の意味)
    1. php/doc-en@1cc1b81
  • reference/mysqli/quickstart.xml — 原文のタイポ(complain / databased)と、neither に対する not の誤りを修正。emulationsupport に言い換え
    1. php/doc-en@c2088ac
    2. php/doc-en@1cc1b81
  • reference/mysqli/configure.xml — サポート表に「8.2.0 以降」の行を追加し、既存行を「5.4.0 から 8.1.x まで」に変更。拡張モジュールとクライアントライブラリを自由に組み合わせられる旨の段落を削除
    1. php/doc-en@1cc1b81
  • reference/mysqli/ini.xml — mysqli.max_links の説明から MySQL を削除
    1. php/doc-en@1cc1b81
  • reference/mysqli/summary.xml — mysqli::get_warningsNOT DOCUMENTED を実際の説明に置き換え、$mysqli_stmt::field_count から - not documented を削除。given / statement の限定語を削除
    1. php/doc-en@1cc1b81
  • reference/mysqli/mysqli/poll.xml — reject パラメータの説明を no pending asynchronous query exists to poll に書き換え
    1. php/doc-en@1cc1b81
  • reference/mysqli/mysqli/stmt-init.xml — mysqli_stmt functionmysqli_stmt method に変更し、戻り値を an object から a mysqli_stmt object に具体化
    1. php/doc-en@1cc1b81
  • reference/tidy/tidy/parsefile.xml
    1. php/doc-en@1cc1b81
  • reference/tidy/tidy/parsestring.xml
    1. php/doc-en@1cc1b81
  • reference/pgsql/functions/pg-fetch-object.xml
    1. php/doc-en@1cc1b81

なお reference/mysqli/quickstart.xml の php/doc-en@c2088ac[skip-revcheck] 付きのため revcheck には現れませんが、EN-Revision を進める範囲に含まれるので今回あわせて取り込んでいます。

独立ファイル

  • reference/session/ini.xml — session.use_only_cookies を無効にすること、session.referer_checksession.trans_sid_hosts に空でない値を設定すること、session.use_trans_sid を有効にすること、session.trans_sid_tags をデフォルト値から変更することが、いずれも PHP 8.4.0 以降は非推奨である旨を一覧表と本文に追加。あわせて session.trans_sid_tags のデフォルト値の記述から input=src を削除
    1. php/doc-en@7fabff2
  • security/database.xml — 攻撃例で使っている mssql_query() が PHP 7.0.0 で削除された mssql 拡張モジュールのものであり、現在は sqlsrv または pdo_sqlsrv を使うべきである旨の note を追加
    1. php/doc-en@0009ebd
  • reference/strings/functions/localeconv.xml — p_cs_precedes / p_sep_by_space / n_cs_precedes / n_sep_by_space は int を返すのに原文が true / false と記述していた誤りが修正されたことへの追従(1 / 0
    1. php/doc-en@92367ae
  • reference/exec/functions/shell-exec.xml — バッククォート演算子が非推奨である旨を追記
    1. php/doc-en@81593f0
  • reference/image/functions/getimagesize.xml — 参考に getimagesizefromstring() を追加
    1. php/doc-en@22ca944

このマージにより、mysqli・PDO・tidy・pgsql・session・strings・image・exec・mysqlinfo の各モジュールが完訳になります。

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 ... も取り込む
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 を削除
php/doc-en@0009ebd (#5709) の追従。攻撃例で使っている mssql_query が
PHP 7.0.0 で削除された mssql 拡張モジュールのものであり、現在は
sqlsrv または pdo_sqlsrv を使うべきである旨の note が原文に追加された。
php/doc-en@92367ae (#5707) の追従。p_cs_precedes・p_sep_by_space・
n_cs_precedes・n_sep_by_space は int を返すが、原文が true / false と
記述していた誤りが修正され、1 / 0 になった。
php/doc-en@81593f0 (#5719) の追従。identical to the backtick operator が
identical to the deprecated backtick operator に変更された。
@KentarouTakeda
KentarouTakeda merged commit 64df4dd into php:master Jul 31, 2026
2 checks passed
@KentarouTakeda
KentarouTakeda deleted the sync-mysqli-pdo-grammar-and-session-deprecation branch July 31, 2026 06:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant