Skip to content

[Sync-En] ini.core: warn that open_basedir does not restrict Unix domain sockets #1310

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
Sep 18, 2026
+30 −21
Merged

[Sync-En] ini.core: warn that open_basedir does not restrict Unix domain sockets #1310

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
51 changes: 30 additions & 21 deletions appendices/ini.core.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: cf7dcffba0ab8ce14dbfd6019f2861f5a6843ed5 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: f011a5989304239063769239761b5c39c68af12f Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->

<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand Down Expand Up @@ -38,7 +38,7 @@
<row>
<entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry><constant>INI_PERDIR</constant></entry>
<entry></entry>
</row>
<row>
Expand Down Expand Up @@ -83,13 +83,13 @@
<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>
<entry>"2"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponible a partir de 7.1.0.</entry>
<entry>Disponible a partir de PHP 7.1.0.</entry>
</row>
<row>
<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>
<entry>"0"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Disponible a partir de 7.4.0</entry>
<entry>Disponible a partir de PHP 7.4.0</entry>
</row>
<row>
<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>
Expand All @@ -104,7 +104,7 @@
<entry></entry>
</row>
<row>
<entry><link linkend="ini.zend.detect-unicode">zend.detect-unicode</link></entry>
<entry><link linkend="ini.zend.detect-unicode">zend.detect_unicode</link></entry>
<entry>NULL</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
Expand Down Expand Up @@ -143,7 +143,7 @@
</term>
<listitem>
<para>
Define si las etiquetas cortas de apertura de PHP (<userinput>&lt;? ?&gt;</userinput>) están permitidas o no. Si desea usar PHP con XML, debe desactivar esta opción de configuración para poder usar <userinput>&lt;?xml ?&gt;</userinput>. De lo contrario, puede escribirlo usando PHP, por ejemplo: <userinput>&lt;?php echo '&lt;?xml version="1.0"&gt;'; ?&gt;</userinput>. Si esta opción está desactivada, debe usar la versión larga de las etiquetas de apertura de PHP (<userinput>&lt;?php ?&gt;</userinput>).
Define si las etiquetas cortas de apertura de PHP (<userinput>&lt;? ?&gt;</userinput>) están permitidas o no. Si desea usar PHP con XML, puede desactivar esta opción de configuración para poder usar <userinput>&lt;?xml ?&gt;</userinput> directamente. De lo contrario, puede escribirlo usando PHP, por ejemplo: <userinput>&lt;?php echo '&lt;?xml version="1.0"?&gt;'; ?&gt;</userinput>. Si esta opción está desactivada, debe usar la versión larga de las etiquetas de apertura de PHP (<userinput>&lt;?php ?&gt;</userinput>).
</para>
<note>
<para>
Expand All @@ -160,7 +160,7 @@
</term>
<listitem>
<simpara>
El número de decimales significativos que se mostrarán en los números de coma flotante. <literal>-1</literal> significa que se utilizará el mejor algoritmo para redondear este número.
El número de dígitos significativos que se mostrarán en los números de coma flotante. <literal>-1</literal> significa que se utilizará el mejor algoritmo para redondear este número.
</simpara>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -196,7 +196,7 @@
</term>
<listitem>
<simpara>
Esta directiva le permite deshabilitar ciertas funciones. Toma una lista de nombres de funciones separados por comas.
Esta directiva le permite deshabilitar ciertas funciones. Toma una lista de nombres de funciones separados por comas. A partir de PHP 8.0.0, deshabilitar una función elimina su definición, lo que permite redefinirla en el código de usuario. Antes de PHP 8.0.0, deshabilitar una función solo impedía que fuera invocada.
</simpara>
<simpara>
Solo las <link linkend="functions.internal">funciones internas</link> pueden deshabilitarse usando esta directiva. Las <link linkend="functions.user-defined">funciones definidas por el usuario</link> no se ven afectadas.
Expand All @@ -220,7 +220,7 @@
</term>
<listitem>
<simpara>
Esta directiva le permite deshabilitar ciertas clases. Toma una lista de nombres de clases separados por comas.
Esta directiva le permite deshabilitar ciertas clases. Toma una lista de nombres de clases separados por comas. Deshabilitar una clase solo impide su instanciación.
</simpara>
<simpara>
Solo las clases internas pueden deshabilitarse usando esta directiva. Las clases definidas por el usuario no se ven afectadas.
Expand All @@ -245,7 +245,7 @@
</term>
<listitem>
<simpara>
Cuando se establece en <literal>1</literal>, se generará el código de aserción (en modo de desarrollo). Cuando se establece en <literal>0</literal>, se generará el código de aserción, pero se ignorará (no se ejecutará) durante la ejecución. Cuando se establece en <literal>-1</literal>, el código de aserción no se generará, haciendo que las aserciones sean completamente neutrales (en modo de producción).
Cuando se establece en <literal>1</literal>, se generará y ejecutará el código de aserción (en modo de desarrollo). Cuando se establece en <literal>0</literal>, se generará el código de aserción, pero se ignorará (no se ejecutará) durante la ejecución. Cuando se establece en <literal>-1</literal>, el código de aserción no se generará, haciendo que las aserciones sean completamente neutrales (en modo de producción).
</simpara>
<note>
<para>
Expand All @@ -265,7 +265,7 @@
</term>
<listitem>
<simpara>
La longitud máxima de los argumentos de función de cadenas en los trazas de pila convertidos en cadenas. Debe estar en el rango entre <literal>"0"</literal> y <literal>"1000000"</literal>.
La longitud máxima de los argumentos de función de tipo string en las trazas de pila convertidas en cadenas. Debe estar en el rango entre <literal>"0"</literal> y <literal>"1000000"</literal>.
</simpara>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -296,7 +296,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
Excluye los argumentos en los trazas de pila generados desde las excepciones.
Excluye los argumentos en las trazas de pila generados desde las excepciones.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -436,7 +436,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
<link linkend="ini.memory-limit">memory_limit</link> a un valor que
supere <parameter>max_memory_limit</parameter> produce una advertencia
y el valor queda limitado. Establézcala a <literal>-1</literal>
(el valor por omisión) para no imponer ningún límite superior.
(el valor por defecto) para no imponer ningún límite superior.
</simpara>

&ini.shorthandbytes;
Expand Down Expand Up @@ -753,7 +753,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<simpara>
Si se desactiva esta opción, las variables <varname>$_POST</varname> y <varname>$_FILES</varname> no se <emphasis>poblarán</emphasis>. El cuerpo de la petición permanece sin consumir en <link linkend="wrappers.php">php://input</link> y puede leerse manualmente o analizarse mediante <function>request_parse_body</function>. Esto puede ser interesante para las solicitudes a través de un proxy o para analizar los datos transmitidos directamente en la memoria.
Si se desactiva esta opción, las variables <varname>$_POST</varname> y <varname>$_FILES</varname> no se <emphasis>poblarán</emphasis>. El cuerpo de la petición permanece sin consumir en <link linkend="wrappers.php">php://input</link> y puede leerse manualmente o analizarse mediante <function>request_parse_body</function>. Esto puede ser útil para redirigir peticiones a través de un proxy o para procesar los datos POST de forma eficiente en memoria.
</simpara>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -820,10 +820,10 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
Especifica el nombre de un archivo que se recorrerá automáticamente antes del archivo principal. Este archivo se incluye como si se hubiera incluido con la función <function>require</function>, por lo que se usa <link linkend="ini.include-path">include_path</link>.
Especifica el nombre de un archivo que se analizará automáticamente antes del archivo principal. Este archivo se incluye como si se hubiera incluido con la función <function>require</function>, por lo que se usa <link linkend="ini.include-path">include_path</link>.
</para>
<para>
El valor especial <literal>none</literal> desactiva la adición automática.
El valor especial <literal>none</literal> desactiva la anteposición automática.
</para>
</listitem>
</varlistentry>
Expand All @@ -835,7 +835,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
Especifica el nombre del archivo que se recorrerá automáticamente después del archivo principal. Este archivo se incluye como si se hubiera incluido con la función <function>require</function>, por lo que se usa <link linkend="ini.include-path">include_path</link>.
Especifica el nombre del archivo que se analizará automáticamente después del archivo principal. Este archivo se incluye como si se hubiera incluido con la función <function>require</function>, por lo que se usa <link linkend="ini.include-path">include_path</link>.
</para>
<para>
El valor especial <literal>none</literal> desactiva la adición automática.
Expand Down Expand Up @@ -1063,7 +1063,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
Especifica una lista de directorios donde las funciones <function>require</function>, <function>include</function>, <function>fopen</function>, <function>file</function>, <function>readfile</function> y <function>file_get_contents</function> buscarán los archivos. El formato es idéntico a la variable de entorno del sistema <envar>PATH</envar>: una lista de directorios separados por dos puntos en Unix o por un punto y coma en Windows.
</para>
<para>
PHP considera cada entrada del camino de inclusión por separado al buscar archivos para incluir. Verificará el primer camino y, si no encuentra el archivo, verificará el siguiente camino, hasta encontrar el archivo para incluir o devolver una alerta de tipo <constant>E_WARNING</constant> o de tipo <constant>E_ERROR</constant> usando la función <function>set_include_path</function>.
PHP considera cada entrada del camino de inclusión por separado al buscar archivos para incluir. Verificará el primer camino y, si no encuentra el archivo, verificará el siguiente camino, hasta encontrar el archivo para incluir o devolver una alerta de tipo <constant>E_WARNING</constant> o de tipo <constant>E_ERROR</constant>. El camino de inclusión puede modificarse o establecerse en tiempo de ejecución usando la función <function>set_include_path</function>.
</para>
<para>
<example>
Expand Down Expand Up @@ -1141,7 +1141,7 @@ include_path = ".:${USER}/pear/php"
</para>
<note>
<simpara>
open_basedir puede afinarse en el momento de la ejecución. Esto significa que si open_basedir se establece en <literal>/www/</literal> en el archivo &php.ini;, un script puede afinar la configuración en <literal>/www/tmp/</literal> en el momento de la ejecución usando la función <function>ini_set</function>. Al recorrer varios directorios, puede usar la constante <constant>PATH_SEPARATOR</constant> según el sistema operativo.
open_basedir puede afinarse en el momento de la ejecución. Esto significa que si open_basedir se establece en <literal>/www/</literal> en el archivo &php.ini;, un script puede afinar la configuración en <literal>/www/tmp/</literal> en el momento de la ejecución usando la función <function>ini_set</function>. Al recorrer varios directorios, puede usar la constante <constant>PATH_SEPARATOR</constant> como separador, independientemente del sistema operativo.
</simpara>
<simpara>
A partir de PHP 8.3.0, <option>open_basedir</option> ya no acepta rutas que contengan el directorio padre (<literal>..</literal>) cuando se establece en tiempo de ejecución usando <function>ini_set</function>.
Expand All @@ -1152,6 +1152,15 @@ include_path = ".:${USER}/pear/php"
Usar open_basedir establecerá <link linkend="ini.realpath-cache-size">realpath_cache_size</link> a <literal>0</literal> y, por lo tanto, <emphasis>desactivará</emphasis> la caché realpath.
</para>
</note>
<warning>
<simpara>
<option>open_basedir</option> no restringe el acceso a los sockets de dominio Unix.
Las funciones de socket de PHP como <function>stream_socket_client</function> y
<function>fsockopen</function> pueden conectarse a la ruta de un socket Unix
(por ejemplo, <filename>unix:///var/run/docker.sock</filename>)
independientemente de la configuración de <option>open_basedir</option>.
</simpara>
</warning>
<caution>
<para>
<literal>open_basedir</literal> es solo una medida de protección adicional y no es de ninguna manera exhaustiva, y no debe dependerse de ella cuando se necesita seguridad.
Expand Down Expand Up @@ -1314,11 +1323,11 @@ include_path = ".:${USER}/pear/php"
</term>
<listitem>
<para>
Si cgi.force_redirect está activado y no está ejecutando un servidor web Apache o Netscape (iPlanet), <emphasis>debería</emphasis> definir un nombre de variable de entorno que PHP usará para verificar si todo está correcto para continuar la ejecución.
Si cgi.force_redirect está activado y no está ejecutando un servidor web Apache o Netscape (iPlanet), <emphasis>puede</emphasis> ser necesario definir un nombre de variable de entorno que PHP usará para verificar si todo está correcto para continuar la ejecución.
</para>
<note>
<para>
Definir esta variable <emphasis>puede</emphasis> tener consecuencias de seguridad. <emphasis>Saber lo que hace antes de hacerlo</emphasis>.
Definir esta variable <emphasis>puede</emphasis> tener consecuencias de seguridad. <emphasis>Asegúrese de saber lo que hace antes de hacerlo</emphasis>.
</para>
</note>
</listitem>
Expand Down