From 9214281a57b67f957ce2d94aec84b6e83f3a2aed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Sun, 20 Sep 2026 13:35:59 +0900
Subject: [PATCH] =?UTF-8?q?filesystem=20=E3=81=AE=203=20=E3=83=95=E3=82=A1?=
 =?UTF-8?q?=E3=82=A4=E3=83=AB=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AE=E5=A4=89?=
 =?UTF-8?q?=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## 翻訳内容

- reference/filesystem/functions/flock.xml — Windows で <constant>LOCK_EX</constant>
  にロックされた PHP のソースファイルを実行するとハングすること、require() では
  ErrorException で失敗することを追記 (php/doc-en@f3112c43e3)
- reference/filesystem/ini.xml — auto_detect_line_endings が PHP 8.1.0 で非推奨に
  なったことを warning として追記 (php/doc-en@9e5166dc6a)
- reference/filesystem/functions/fgetcsv.xml — コード例の整理に追従 (php/doc-en@9936f6b7df)
---
 reference/filesystem/functions/fgetcsv.xml | 27 ++++++++++++++--------
 reference/filesystem/functions/flock.xml   | 22 +++++++++++++++++-
 reference/filesystem/ini.xml               | 15 ++++++++----
 3 files changed, 48 insertions(+), 16 deletions(-)

diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml
index 0520db1da9..2b54e8b237 100644
--- a/reference/filesystem/functions/fgetcsv.xml
+++ b/reference/filesystem/functions/fgetcsv.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 330a38c4d45556b49e06ebe6d39e0e311534cd8c Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 9936f6b7df4f01883b41f60d06fb438e9bf7e667 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.fgetcsv" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -204,19 +204,26 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$row = 1;
-if (($handle = fopen("test.csv", "r")) !== FALSE) {
-    while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
-        $num = count($data);
-        echo "<p> $num fields in line $row: <br /></p>\n";
-        $row++;
-        for ($c=0; $c < $num; $c++) {
-            echo $data[$c] . "<br />\n";
+
+if (($handle = fopen("test.csv", "r")) !== false) {
+    $row = 1;
+
+    while (($fields = fgetcsv($handle, 1000, ",", "\"", "\\")) !== false) {
+        $num = count($fields);
+
+        echo "\n<p>$num fields in line $row:</p>\n<ol>";
+
+        for ($c = 0; $c < $num; $c++) {
+            echo "\n\t<li>", $fields[$c], "</li>";
         }
+
+        echo "\n</ol>";
+
+        $row++;
     }
+
     fclose($handle);
 }
-?>
 ]]>
     </programlisting>
    </example>
diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml
index e08182c85c..4bd86de8a3 100644
--- a/reference/filesystem/functions/flock.xml
+++ b/reference/filesystem/functions/flock.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 75a76afb61d91f04feebc83931c5412b13682d2b Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: f3112c43e303fcd63c0df89798b45bfef9d49e15 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.flock" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -197,6 +197,23 @@ fclose($fp);
     旧式のファイルシステムではサポートされていないため、
     これらの環境の場合は常に&false;を返すことになります。
    </para>
+   <para>
+    Windows では、<constant>LOCK_EX</constant> でロックされた PHP のソースファイルを
+    PHP が実行しようとすると、そのファイルのロックが解放されるまでハングします。
+    以下の例はデッドロックを引き起こします。
+    <informalexample>
+     <programlisting role="php">
+<![CDATA[
+<?php
+if ($argv[1] ?? null === 'child') { die(); }
+$fp = fopen(__FILE__, "rb");
+flock($fp, LOCK_EX);
+shell_exec("php " . escapeshellarg(__FILE__) . " child");
+?>
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
   </warning>
   <note>
    <para>
@@ -204,6 +221,9 @@ fclose($fp);
     ロックするプロセスが同じファイルを二回オープンする場合、
     ファイルをアンロックするまで二番目のハンドルではアクセスできません。
    </para>
+   <simpara>
+    Windows では、LOCK_EX でロックされたファイルを require しようとすると、ErrorException: require(): Read of X bytes failed with errno=13 Permission denied で失敗します。
+   </simpara>
   </note>
  </refsect1>
 
diff --git a/reference/filesystem/ini.xml b/reference/filesystem/ini.xml
index c7ea7ee5ea..7aba2ced05 100644
--- a/reference/filesystem/ini.xml
+++ b/reference/filesystem/ini.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9e5166dc6a5ff650b649298470d19eb7c3637a63 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <section xml:id="filesystem.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
@@ -153,19 +153,24 @@
      <type>bool</type>
     </term>
     <listitem>
-     <para>
+     <simpara>
       onにした場合、PHPは
       <function>fgets</function> および <function>file</function>
       により読み込まれたデータを評価し、UNIX、MS-DOS、Machintoshの行末
       表記を使用しているかどうかを調べます。
-     </para>
-     <para>
+     </simpara>
+     <simpara>
       これにより、PHPがMacintoshシステムと相互運用できるようになりますが、
       デフォルトはOffとなっています。これは、最初の行の行末表記を検出
       する際にごく僅かな性能劣化があるためと、UNIXシステムのもとで復改
       文字を項目セパレータとして使用している人が従来のバージョンと互換
       性がない動作であると感じる可能性があるためです。
-     </para>
+     </simpara>
+     <warning>
+      <simpara>
+       このオプションは PHP 8.1.0 で非推奨になりました。
+      </simpara>
+     </warning>
     </listitem>
    </varlistentry>