Skip to content

[Sync-En] filesystem: local files skip the stat cache #1516

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 1 commit into from
Oct 26, 2026
Merged

[Sync-En] filesystem: local files skip the stat cache #1516

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions reference/filesystem/entities.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>
15 changes: 11 additions & 4 deletions reference/filesystem/functions/clearstatcache.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>
Expand All @@ -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.
Expand Down Expand Up @@ -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">
Expand Down
4 changes: 2 additions & 2 deletions reference/filesystem/functions/file-exists.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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>

Expand Down
4 changes: 2 additions & 2 deletions reference/filesystem/functions/is-executable.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>
Expand Down Expand Up @@ -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>
Expand Down
4 changes: 2 additions & 2 deletions reference/filesystem/functions/is-readable.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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">
Expand Down Expand Up @@ -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>
Expand Down
4 changes: 2 additions & 2 deletions reference/filesystem/functions/is-writable.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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">
Expand Down Expand Up @@ -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>

Expand Down
Loading