From dee646f55f88a7ef495206f849c734c63b3e8977 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: Wed, 28 Oct 2026 23:23:26 +0900
Subject: [PATCH] =?UTF-8?q?filesystem=20=E3=82=92=E5=8E=9F=E6=96=87?=
 =?UTF-8?q?=E3=81=AE=E5=A4=89=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93=20(7?=
 =?UTF-8?q?=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/filesystem/entities.ent             | 25 +++++++++++++++++++
 .../filesystem/functions/clearstatcache.xml   | 14 ++++++++---
 .../filesystem/functions/file-exists.xml      |  4 +--
 .../filesystem/functions/is-executable.xml    |  4 +--
 .../filesystem/functions/is-readable.xml      |  4 +--
 .../filesystem/functions/is-writable.xml      |  4 +--
 reference/filesystem/functions/link.xml       |  9 +------
 7 files changed, 44 insertions(+), 20 deletions(-)
 create mode 100644 reference/filesystem/entities.ent

diff --git a/reference/filesystem/entities.ent b/reference/filesystem/entities.ent
new file mode 100644
index 0000000000..42eabd12cc
--- /dev/null
+++ b/reference/filesystem/entities.ent
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: KentarouTakeda Status: ready -->
+<!--
+    See `manual.xml` for XML namespaces defaults.
+    Keep the lines under 79 columns, to make the process of manual
+    translation easier, and to avoid wrap-around in some other contexts.
+-->
+<entities xmlns       = "http://docbook.org/ns/docbook"
+          xmlns:xlink = "http://www.w3.org/1999/xlink"
+          translate   = "yes">
+
+<entity name="ext.filesystem.access-check-cache">
+ <note>
+  <simpara>
+   ローカルファイルの場合、この関数の結果はキャッシュされず、
+   呼び出すたびにファイルを調べ直します。
+   他の<link linkend="wrappers">ラッパー</link>を使うパスの場合は、
+   結果がキャッシュされます。
+   詳細は、<function>clearstatcache</function> を参照してください。
+  </simpara>
+ </note>
+</entity>
+
+</entities>
diff --git a/reference/filesystem/functions/clearstatcache.xml b/reference/filesystem/functions/clearstatcache.xml
index 9792062ba4..a16a4b4a7a 100644
--- a/reference/filesystem/functions/clearstatcache.xml
+++ b/reference/filesystem/functions/clearstatcache.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e82ff8a846af03b863c4a57fbedc0a93af0e68db Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.clearstatcache" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -26,14 +26,14 @@
    このようなケースでは、<function>clearstatcache</function>を使用することで
    ファイルの情報に関してPHPが持っているキャッシュをクリアすることができます。
   </para>
-  <para>
+  <simpara>
    PHP は存在しないファイルについての情報はキャッシュしないことにも
    注意してください。もし存在しないファイルに対して
-   <function>file_exists</function> をコールする場合、ファイルを作成するまで
+   <function>is_file</function> をコールする場合、ファイルを作成するまで
    この関数は &false; を返します。もしファイルを作成した場合、
    たとえファイルを削除したとしても &true; を返します。
    しかし、<function>unlink</function> はキャッシュを自動的にクリアします。
-  </para>
+  </simpara>
   <note>
    <para>
     この関数は特定のファイルに関する情報をキャッシュします。したがって、
@@ -63,6 +63,12 @@
    <function>filetype</function>, および
    <function>fileperms</function>.
   </para>
+  <simpara>
+   <function>file_exists</function>、<function>is_writable</function>、
+   <function>is_readable</function>、<function>is_executable</function>
+   は、ローカルファイルシステム以外のラッパーを使うパスに対してだけキャッシュを使います。
+   ローカルファイルは毎回直接調べます。
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/filesystem/functions/file-exists.xml b/reference/filesystem/functions/file-exists.xml
index eaf288fdbb..6d192fdbbd 100644
--- a/reference/filesystem/functions/file-exists.xml
+++ b/reference/filesystem/functions/file-exists.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-exists">
  <refnamediv>
@@ -90,7 +90,7 @@ if (file_exists($filename)) {
 
  <refsect1 role="notes">
   &reftitle.notes;
-  &note.clearstatcache;
+  &ext.filesystem.access-check-cache;
   &tip.fopen-wrapper.stat;
  </refsect1>
 
diff --git a/reference/filesystem/functions/is-executable.xml b/reference/filesystem/functions/is-executable.xml
index 34efc48a0a..3b8d66dc80 100644
--- a/reference/filesystem/functions/is-executable.xml
+++ b/reference/filesystem/functions/is-executable.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8d8cd43bfcd67415f3d548b7209c5b1a63d88fd1 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-executable">
  <refnamediv>
@@ -77,7 +77,7 @@ if (is_executable($file)) {
 
  <refsect1 role="notes">
   &reftitle.notes;
-  &note.clearstatcache;
+  &ext.filesystem.access-check-cache;
   &tip.fopen-wrapper.stat;
   <note>
    <simpara>
diff --git a/reference/filesystem/functions/is-readable.xml b/reference/filesystem/functions/is-readable.xml
index 7c1478071d..9c72d99d4a 100644
--- a/reference/filesystem/functions/is-readable.xml
+++ b/reference/filesystem/functions/is-readable.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-readable">
  <refnamediv>
@@ -77,7 +77,7 @@ if (is_readable($filename)) {
    PHP は、Web サーバーを実行しているユーザー ID (たいていは 'nobody')
    でファイルにアクセスすることを覚えておいてください。
   </para>
-  &note.clearstatcache;
+  &ext.filesystem.access-check-cache;
   &tip.fopen-wrapper.stat;
   <note>
    <para>
diff --git a/reference/filesystem/functions/is-writable.xml b/reference/filesystem/functions/is-writable.xml
index 444ebc46f2..80543826db 100644
--- a/reference/filesystem/functions/is-writable.xml
+++ b/reference/filesystem/functions/is-writable.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-writable">
  <refnamediv>
@@ -78,7 +78,7 @@ if (is_writable($filename)) {
  <refsect1 role="notes">
   &reftitle.notes;
   
-  &note.clearstatcache;
+  &ext.filesystem.access-check-cache;
   &tip.fopen-wrapper.stat;
  </refsect1>
  
diff --git a/reference/filesystem/functions/link.xml b/reference/filesystem/functions/link.xml
index be5e1d0cb7..49375cc4ee 100644
--- a/reference/filesystem/functions/link.xml
+++ b/reference/filesystem/functions/link.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 46a0d3708e3c428ad8fa2e1dd38e4755863dc5c2 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 24563376cc172cdb0835373a048f570351f3c05f Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.link">
  <refnamediv>
@@ -82,13 +82,6 @@ link($target, $link);
  <refsect1 role="notes">
   &reftitle.notes;
   &note.no-remote;
-  <note>
-   <simpara>
-    Windows のみ: この関数を使用するには、
-    権限を昇格させたモード、あるいは UAC を無効にした状態で PHP を実行しなければなりません。
-   </simpara>
-  </note>
-
  </refsect1>
 
  <refsect1 role="seealso">