Merge branch 'master' into tidy-84

Author: asumikam

.github/workflows/integrate.yaml

@@ -12,14 +12,21 @@ jobs:
   build:
     name: "Build"
 
-    runs-on: "ubuntu-20.04"
+    runs-on: "ubuntu-24.04"
 
     strategy:
       matrix:
         language:
           - "ja"
 
     steps:
+      - name: "Set up PHP"
+        uses: "shivammathur/setup-php@v2"
+        with:
+          php-version: "8.3"
+          extensions: "sqlite3"
+          coverage: "none"
+
       - name: "Checkout php/doc-${{ matrix.language }}"
         uses: "actions/checkout@v4"
         with:
@@ -39,5 +46,52 @@ jobs:
           path: "doc-base"
           repository: "php/doc-base"
 
+      - name: "Checkout php/phd"
+        uses: "actions/checkout@v4"
+        with:
+          path: "phd"
+          repository: "php/phd"
+
       - name: "Build documentation for ${{ matrix.language }}"
-        run: "php8.0 doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout --with-lang=${{ matrix.language }}"
+        run: "php doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout --with-lang=${{ matrix.language }}"
+
+      - name: "Render documentation for ${{ matrix.language }}"
+        run: "php phd/render.php --docbook doc-base/.manual.xml --package PHP --format xhtml"
+
+      - name: "Save documentation for ${{ matrix.language }}"
+        uses: "actions/upload-artifact@v4"
+        with:
+          name: "manual-html"
+          path: "output/php-chunked-xhtml"
+          retention-days: 7
+
+  textlint:
+    name: "Textlint"
+
+    needs: ["build"]
+    runs-on: "ubuntu-24.04"
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+
+      - name: "Install Node.js"
+        uses: "actions/setup-node@v4"
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: "build/package-lock.json"
+
+      - name: "Download artifacts"
+        uses: "actions/download-artifact@v4"
+        with:
+          name: "manual-html"
+          path: "build/output"
+
+      - name: "Install textlint"
+        run: "npm ci --no-audit"
+        working-directory: "build"
+
+      - name: "Run textlint"
+        run: "npx textlint --color ./output"
+        working-directory: "build"

.gitignore

@@ -0,0 +1 @@
+node_modules/

README_Glossary.md

@@ -3,6 +3,10 @@
 ここには、PHP マニュアル 日本語版で「統一した」訳語を当てている単語を記録しています。  
 以下の単語の訳がブレていたら、issue または Pull Request で報告してください。
 
+- visibility
+  * 「アクセス権」で統一
+  * protected/private/public を付けた、メソッドやプロパティが可視な範囲のこと
+  * 但し、「非対称可視性プロパティ」(Asymmetric Property Visibility)は 例外
 - extension
   * 拡張モジュール ( [#24](https://github.com/php/doc-ja/issues/24) )
 - internal function / builtin function

appendices/about.xml

@@ -189,7 +189,7 @@ int strlen ( string $string )
         <entry>
          strlen() 関数の最初の（この場合は唯一の）引数が
          <parameter>string</parameter>という名前であり
-         それは<type>文字列</type>である
+         それは文字列(<type>string</type>)である
         </entry>
        </row>
        <row>

appendices/comparisons.xml

@@ -15,10 +15,10 @@
  </para>
  <para>
   この表を活用する前に、型とその意味について理解しておく必要があります。
-  例えば、<literal>"42"</literal>は<type>文字列</type>ですが
-  <literal>42</literal>は<type>整数</type>です。
-  &false;は<type>bool</type>ですが<literal>"false"</literal>は
-  <type>文字列</type>です。
+  例えば、<literal>"42"</literal>は <type>string</type> ですが
+  <literal>42</literal>は <type>int</type> です。
+  &false; は <type>bool</type> ですが <literal>"false"</literal> は
+  <type>string</type> です。
  </para>
  <note>
   <para>

appendices/migration70/incompatible/other.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 6d2f72b0f2d7fbda2e3aa79ab58f190b4cdac867 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6a52dd81e3f791065b4b65a68d393012a7fdd858 Maintainer: takagi Status: ready -->
 
 <sect2 xml:id="migration70.incompatible.other">
  <title>下位互換性のないその他の変更</title>
@@ -373,6 +373,16 @@ switch (1) {
   </para>
  </sect3>
 
+ <sect3 xml:id="migration70.incompatible.other.break-continue-constant">
+  <title>break と continue 文に定数は渡せなくなった</title>
+  <para>
+   <literal>break</literal> と <literal>continue</literal>
+   文は定数を引数として渡せなくなりました。
+   渡すと、
+   <constant>E_COMPILE_ERROR</constant> が発生します。
+  </para>
+ </sect3>
+
  <sect3 xml:id="migration70.incompatible.other.mhash">
   <title>Mhash はもう拡張モジュールではありません</title>
   <para>

appendices/migration74/incompatible.xml

@@ -42,12 +42,11 @@
 
    <para>
     ファイルの最後の (改行が最後に付かない) <literal>&lt;?php</literal>
-    タグは、PHPタグの開始タグとして解釈されるようになりました。以前は、短い形式の開始タグ <literal>&lt;?</literal> の後にリテラル
+    タグは、PHPタグの開始タグとして解釈されるようになりました。以前は、短縮型の開始タグ <literal>&lt;?</literal> の後にリテラル
     <literal>php</literal>
-    を続けたものとして解釈されるか、(<literal>short_open_tag=1</literal>
-    の場合は) 文法エラー になるか、(<literal>short_open_tag=0</literal>
-    の場合は) <literal>&lt;?php</literal>
-    というリテラルとして解釈されていました。
+    を続けたものとして解釈された結果文法エラーになる (<literal>short_open_tag=1</literal>
+    の場合) か、<literal>&lt;?php</literal> という文字列リテラルとして解釈されていました (<literal>short_open_tag=0</literal>
+    の場合) 。
    </para>
   </sect3>
 

appendices/migration74/windows-support.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c517cdf9196d0b6374b1112af979768c7cb391e9 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="migration74.windows-support" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Windows のサポート</title>
@@ -17,7 +17,16 @@
   <title>CTRLキーの扱い</title>
   <para>
    <function>sapi_windows_set_ctrl_handler</function>
-   関数でハンドラを設定することで、コンソールにおける CTRL+C や CTRL+BREAK
+   関数でハンドラを設定することで、コンソールにおける
+   <keycombo action='simul'>
+    <keycap>CTRL</keycap>
+    <keycap>C</keycap>
+   </keycombo>
+   や
+   <keycombo action='simul'>
+    <keycap>CTRL</keycap>
+    <keycap>BREAK</keycap>
+   </keycombo>
    をキャッチできるようになりました。
   </para>
   <para>

appendices/migration80.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 0b48d83885dc23f3818284dd6c10f21890cdf72a Maintainer: mumumu Status: ready -->
 
 <appendix xml:id="migration80" xmlns="http://docbook.org/ns/docbook">
  <title>PHP 7.4.x から PHP 8.0.x への移行</title>
@@ -22,6 +22,7 @@
  </para>
 
  &appendices.migration80.new-features;
+ &appendices.migration80.new-classes;
  &appendices.migration80.incompatible;
  &appendices.migration80.deprecated;
  &appendices.migration80.other-changes;

appendices/migration80/incompatible.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision: 351500 $ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>下位互換性のない変更点</title>
@@ -1885,7 +1885,7 @@ echo file_get_contents('http://example.org', false, $ctx);
 
   <para>
    <methodname>XMLReader::open</methodname>,
-   <methodname>XMLReader::xml</methodname> が staticメソッドになりました。
+   <methodname>XMLReader::XML</methodname> が staticメソッドになりました。
    これらは、まだインスタンスメソッドとして呼び出すことが出来ますが、
    クラスを継承し、これらのメソッドをオーバーライドする場合は、
    それらは static として宣言する必要があります。