From 696b6d55ce98d71733baedd203f91bac3b982055 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 26 Oct 2026 07:58:32 +0100
Subject: [PATCH] [Sync-En] filesystem: local files skip the stat cache

---
 reference/filesystem/entities.ent             | 24 +++++++++++++++++++
 .../filesystem/functions/clearstatcache.xml   | 15 ++++++++----
 .../filesystem/functions/file-exists.xml      |  4 ++--
 .../filesystem/functions/is-executable.xml    |  4 ++--
 .../filesystem/functions/is-readable.xml      |  4 ++--
 .../filesystem/functions/is-writable.xml      |  4 ++--
 6 files changed, 43 insertions(+), 12 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..9e7bedfb9b
--- /dev/null
+++ b/reference/filesystem/entities.ent
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: lacatoire 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>
+   Para los ficheros locales, el resultado de esta función no se almacena en
+   la caché y el fichero se comprueba de nuevo en cada llamada. Para las rutas
+   que utilizan otros <link linkend="wrappers">wrappers</link>, el resultado se
+   almacena en la caché.
+   Consulte <function>clearstatcache</function> para más detalles.
+  </simpara>
+ </note>
+</entity>
+
+</entities>
diff --git a/reference/filesystem/functions/clearstatcache.xml b/reference/filesystem/functions/clearstatcache.xml
index b30c6b491c..aac7942f3a 100644
--- a/reference/filesystem/functions/clearstatcache.xml
+++ b/reference/filesystem/functions/clearstatcache.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e82ff8a846af03b863c4a57fbedc0a93af0e68db Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="function.clearstatcache" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -24,13 +24,13 @@
    debe utilizar la función <function>clearstatcache</function>
    para borrar de la memoria los resultados de la última llamada a la función.
   </para>
-  <para>
+  <simpara>
    Tenga en cuenta que PHP no guarda en caché información sobre
-   un fichero inexistente. Si se llama a <function>file_exists</function>
+   un fichero inexistente. Si se llama a <function>is_file</function>
    sobre un fichero que no existe, la función devolverá &false;
    hasta que se cree el fichero. Si se crea el fichero,
    la función devolverá &true; incluso si se borra el fichero.
-  </para>
+  </simpara>
   <note>
    <para>
     Esta función guarda en caché información sobre ficheros.
@@ -60,6 +60,13 @@
    <function>filetype</function>, y
    <function>fileperms</function>.
   </para>
+  <simpara>
+   Las funciones <function>file_exists</function>,
+   <function>is_writable</function>, <function>is_readable</function> e
+   <function>is_executable</function> solo utilizan la caché para las rutas que
+   emplean un wrapper distinto del sistema de ficheros local. Los ficheros
+   locales se comprueban directamente en cada llamada.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/filesystem/functions/file-exists.xml b/reference/filesystem/functions/file-exists.xml
index 11398f4d1b..d8d7f108da 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: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes Maintainer: PhilDaiguille -->
 <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 c783d1794e..c902c80a5e 100644
--- a/reference/filesystem/functions/is-executable.xml
+++ b/reference/filesystem/functions/is-executable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8d8cd43bfcd67415f3d548b7209c5b1a63d88fd1 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-executable">
  <refnamediv>
@@ -74,7 +74,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 4019d0474e..efcd16f45b 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: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-readable">
@@ -78,7 +78,7 @@ if (is_readable($filename)) {
    permisos que el usuario que ejecuta el servidor web
    (a menudo, es 'nobody', nadie).
   </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 2d1ecf5f7d..80bae825d3 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: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a641e6b538290c138828651ac2a8713eb79c5389 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-writable">
@@ -79,7 +79,7 @@ if (is_writable($filename)) {
 
  <refsect1 role="notes">
   &reftitle.notes;
-  &note.clearstatcache;
+  &ext.filesystem.access-check-cache;
   &tip.fopen-wrapper.stat;
  </refsect1>