Skip to content

XML schema correction: fix structure in language/ and appendices/ #470

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
Apr 4, 2026
Merged

XML schema correction: fix structure in language/ and appendices/ #470

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
12 changes: 6 additions & 6 deletions appendices/about.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ Devuelve el tamaño de la cadena $string.
</entry>
<entry>
El primer (y aquí el único) parámetro a proporcionar a esta función es el parámetro <parameter>string</parameter>, que debe ser del tipo
&string;.
<type>string</type>.
</entry>
</row>
<row>
Expand All @@ -167,7 +167,7 @@ Devuelve el tamaño de la cadena $string.
</entry>
<entry>
Tipo de valor devuelto por esta función, que es, en este caso,
un &integer; (es decir, el tamaño de una cadena se mide por
un <type>int</type> (es decir, el tamaño de una cadena se mide por
un número).
</entry>
</row>
Expand Down Expand Up @@ -198,7 +198,7 @@ Devuelve el tamaño de la cadena $string.
</screen>
</para>
<para>
¿Qué significa esto? <function>in_array</function> devuelve
¿Qué significa esto? in_array() devuelve
un <link linkend="language.types.boolean">booléano</link> &true; en
caso de éxito (el parámetro
<parameter>needle</parameter> se encontró en el array
Expand All @@ -209,8 +209,8 @@ Devuelve el tamaño de la cadena $string.
de diferentes <link linkend="language.types">tipos</link>: por lo tanto, lleva la mención <emphasis>mixed</emphasis>.
El parámetro <parameter>needle</parameter> (lo que estamos buscando)
puede ser un valor escalar ( &string;, &integer;,
o <link linkend="language.types.float">float</link>), o incluso un <type>array</type>.
<parameter>haystack</parameter> (el <link linkend="language.types.array">array</link>,
o <link linkend="language.types.float">float</link>), o incluso un <link linkend="language.types.array">array</link>.
<parameter>haystack</parameter> (el array,
en el que estamos buscando) es
el segundo parámetro. El tercer parámetro, <emphasis>opcional</emphasis>,
<parameter>strict</parameter>,
Expand Down Expand Up @@ -396,7 +396,7 @@ Devuelve el tamaño de la cadena $string.
Los contribuyentes a la documentación parten de los códigos fuente
<acronym>XML</acronym> disponibles en
<link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link>.
luego traducen a su idioma. No utilizan
luego traducen a su idioma. <emphasis>No</emphasis> utilizan
las versiones generadas (como el <acronym>HTML</acronym> o el texto plano)
ya que es el sistema de edición el que se encarga de hacer las
conversiones del formato <acronym>XML</acronym> a un formato legible.
Expand Down
26 changes: 13 additions & 13 deletions appendices/comparisons.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@
<para>
Antes de utilizar estas tablas, es importante comprender los tipos
y su significado. Por ejemplo, <literal>"42"</literal> es un
&string;, mientras que <literal>42</literal> es un
&integer;. &false; es <type>bool</type> mientras que
<literal>"false"</literal> es un &string;.
<type>string</type>, mientras que <literal>42</literal> es un
<type>int</type>. &false; es <type>bool</type> mientras que
<literal>"false"</literal> es un <type>string</type>.
</para>
<note>
<para>
Expand Down Expand Up @@ -65,7 +65,7 @@
<tbody>
<row>
<entry><literal>$x = "";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
Expand Down Expand Up @@ -129,71 +129,71 @@
</row>
<row>
<entry><literal>$x = 1;</literal></entry>
<entry>&integer;</entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = 42;</literal></entry>
<entry>&integer;</entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = 0;</literal></entry>
<entry>&integer;</entry>
<entry><type>int</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = -1;</literal></entry>
<entry>&integer;</entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "1";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "0";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = "-1";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "php";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "true";</literal></entry>
<entry>&string;</entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
Expand Down
43 changes: 23 additions & 20 deletions appendices/ini.core.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -195,15 +195,15 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Esta directiva le permite deshabilitar ciertas funciones. Toma una lista de nombres de funciones separados por comas.
</para>
<para>
</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.
</para>
<para>
</simpara>
<simpara>
Esta directiva debe definirse en el &php.ini;. Por ejemplo, no puede definirse en el archivo &httpd.conf;.
</para>
</simpara>
<warning>
<simpara>
Esta directiva puede ser eludida y no debe considerarse una
Expand All @@ -219,9 +219,12 @@
<type>string</type>
</term>
<listitem>
<simpara>
<para>
Esta directiva le permite deshabilitar ciertas clases. Toma una lista de nombres de clases separados por comas.
</simpara>
</para>
<para>
Solo las clases internas pueden deshabilitarse usando esta directiva. Las clases definidas por el usuario no se ven afectadas.
</para>
<simpara>
Esta directiva debe definirse en el &php.ini;. Por ejemplo, no puede definirse en el archivo &httpd.conf;.
</simpara>
Expand Down Expand Up @@ -334,7 +337,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
Verifica el <literal>BOM (Byte Order Mark)</literal> y mira si el archivo contiene caracteres multibyte válidos. Esta detección se realiza antes de que se ejecute la función <function>__halt_compiler</function>. Disponible solo en modo multibyte de Zend.
Verifica el BOM (Byte Order Mark) y mira si el archivo contiene caracteres multibyte válidos. Esta detección se realiza antes de que se ejecute la función <function>__halt_compiler</function>. Disponible solo en modo multibyte de Zend.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -525,7 +528,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
<row>
<entry><link linkend="ini.request-order">request_order</link></entry>
<entry>""</entry>
<entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
<entry><constant>INI_PERDIR</constant></entry>
<entry></entry>
</row>
<row>
Expand Down Expand Up @@ -732,7 +735,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
&ini.shorthandbytes;

<simpara>
Si el tamaño de los datos recibidos por el método POST es mayor que <parameter>post_max_size</parameter>, las <link linkend="language.variables.superglobals">superglobales</link> <varname>$_POST</varname> y <varname>$_FILES</varname> estarán vacías. Esto se puede monitorear de diferentes formas, por ejemplo, pasando una variable <varname>$_GET</varname> al script que procesa los datos, es decir, <literal>&lt;form action="edit.php?processed=1"&gt;</literal>, y luego verificar si <varname>$_GET['processed']</varname> está definido.
Si el tamaño de los datos recibidos por el método POST es mayor que post_max_size, <varname>$_POST</varname> y <varname>$_FILES</varname> <link linkend="language.variables.superglobals">superglobales</link> estarán vacías. Esto se puede monitorear de diferentes formas, por ejemplo, pasando una variable <varname>$_GET</varname> al script que procesa los datos, es decir, <literal>&lt;form action="edit.php?processed=1"&gt;</literal>, y luego verificar si <varname>$_GET['processed']</varname> está definido.
</simpara>
<para>
<note>
Expand Down Expand Up @@ -799,7 +802,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
El valor especial <literal>none</literal> desactiva la adición automática.
<note>
<simpara>
Si el script termina con la función <function>exit</function>, no se realizará la adición automática.
Si el script termina con la función <function>exit</function>, <emphasis>no</emphasis> se realizará la adición automática.
</simpara>
</note>
</para>
Expand Down Expand Up @@ -1018,7 +1021,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
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 (<literal>:</literal>) en Unix o por un punto y coma (<literal>;</literal>) en Windows.
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>.
Expand Down Expand Up @@ -1080,7 +1083,7 @@ include_path = ".:${USER}/pear/php"
Cuando un script intenta acceder a un archivo con, por ejemplo, la función <function>include</function> o la función <function>fopen</function>, la ruta al archivo se analiza. Cuando el archivo se encuentra fuera de la estructura de directorios especificada, PHP se negará a acceder a él. Todos los enlaces simbólicos se resuelven, por lo que no es posible eludir esta restricción con un enlace simbólico. Si el archivo no existe, entonces el enlace simbólico no se puede resolver y el nombre del archivo se compara con <option>open_basedir</option>.
</para>
<para>
La opción <option>open_basedir</option> puede afectar más que las funciones del sistema de archivos; por ejemplo, si MySQL está configurado para usar el controlador mysqlnd, <literal>LOAD DATA INFILE</literal> se verá afectado por la opción <option>open_basedir</option>. La mayoría de las extensiones de PHP usan la opción <literal>open_basedir</literal> de esta manera.
La opción <option>open_basedir</option> puede afectar más que las funciones del sistema de archivos; por ejemplo, si <literal>MySQL</literal> está configurado para usar el controlador <literal>mysqlnd</literal>, <literal>LOAD DATA INFILE</literal> se verá afectado por la opción <option>open_basedir</option>. La mayoría de las extensiones de PHP usan la opción <literal>open_basedir</literal> de esta manera.
</para>
<para>
El valor especial <systemitem class="filesystem">.</systemitem> indica que se usará el directorio actual del script como directorio base. Sin embargo, esto es ligeramente peligroso en el sentido de que el directorio actual puede cambiarse fácilmente con la función <function>chdir</function>.
Expand All @@ -1099,10 +1102,10 @@ include_path = ".:${USER}/pear/php"
</para>
<note>
<simpara>
<option>open_basedir</option> puede afinarse en el momento de la ejecución. Esto significa que si <option>open_basedir</option> 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> según el 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.
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>.
</simpara>
</note>
<note>
Expand All @@ -1125,7 +1128,7 @@ include_path = ".:${USER}/pear/php"
</term>
<listitem>
<para>
El directorio raíz de PHP en el servidor. Solo se usa si no está vacío. Si PHP no se compiló con FORCE_REDIRECT, debe definir el doc_root si usa PHP como CGI bajo cualquier servidor web (distinto de IIS). Alternativamente, puede usar la configuración <link linkend="ini.cgi.force-redirect">cgi.force_redirect</link>.
El directorio raíz de PHP en el servidor. Solo se usa si no está vacío. Si PHP no se compiló con FORCE_REDIRECT, <emphasis>debe</emphasis> definir el doc_root si usa PHP como CGI bajo cualquier servidor web (distinto de IIS). Alternativamente, puede usar la configuración <link linkend="ini.cgi.force-redirect">cgi.force_redirect</link>.
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -1207,7 +1210,7 @@ include_path = ".:${USER}/pear/php"
</term>
<listitem>
<para>
Controla si PHP CGI verifica la línea que comienza con <literal>#!</literal> (shebang) en la parte superior del script ejecutado. Esta línea es necesaria si el script está destinado a ejecutarse de forma independiente y a través de un PHP CGI. PHP en modo CGI no lee esta línea y omite su contenido si esta directiva está activa.
Controla si PHP <acronym>CGI</acronym> verifica la línea que comienza con <literal>#!</literal> (shebang) en la parte superior del script ejecutado. Esta línea es necesaria si el script está destinado a ejecutarse de forma independiente y a través de un PHP <acronym>CGI</acronym>. PHP en modo <acronym>CGI</acronym> no lee esta línea y omite su contenido si esta directiva está activa.
</para>
</listitem>
</varlistentry>
Expand All @@ -1231,7 +1234,7 @@ include_path = ".:${USER}/pear/php"
</term>
<listitem>
<para>
Proporciona un <emphasis>real</emphasis> <literal>PATH_INFO</literal>/<literal>PATH_TRANSLATED</literal> para CGI. El comportamiento anterior de PHP era establecer <literal>PATH_TRANSLATED</literal> en <literal>SCRIPT_FILENAME</literal> y no llenar <literal>PATH_INFO</literal>. Para obtener más información sobre <literal>PATH_INFO</literal>, consulte las especificaciones CGI. Si se establece en <literal>1</literal>, PHP CGI corregirá este camino según las especificaciones. Si se establece en <literal>0</literal>, PHP aplicará el comportamiento anterior. De manera predeterminada, esta directiva está activada. Debe modificar sus scripts para usar <literal>SCRIPT_FILENAME</literal> en lugar de <literal>PATH_TRANSLATED</literal>.
Proporciona un <emphasis>real</emphasis> <literal>PATH_INFO</literal>/<literal>PATH_TRANSLATED</literal> para <acronym>CGI</acronym>. El comportamiento anterior de PHP era establecer <literal>PATH_TRANSLATED</literal> en <literal>SCRIPT_FILENAME</literal> y no llenar <literal>PATH_INFO</literal>. Para obtener más información sobre <literal>PATH_INFO</literal>, consulte las especificaciones <acronym>CGI</acronym>. Si se establece en <literal>1</literal>, PHP <acronym>CGI</acronym> corregirá este camino según las especificaciones. Si se establece en 0, PHP aplicará el comportamiento anterior. De manera predeterminada, esta directiva está activada. Debe modificar sus scripts para usar <literal>SCRIPT_FILENAME</literal> en lugar de <literal>PATH_TRANSLATED</literal>.
</para>
</listitem>
</varlistentry>
Expand All @@ -1243,7 +1246,7 @@ include_path = ".:${USER}/pear/php"
</term>
<listitem>
<para>
cgi.force_redirect es necesario por razones de seguridad al usar PHP en modo CGI bajo la mayoría de los servidores web. Si no lo establece, PHP lo activará automáticamente de manera predeterminada. Puede desactivarlo <emphasis>bajo su propio riesgo</emphasis>.
cgi.force_redirect es necesario por razones de seguridad al usar PHP en modo <acronym>CGI</acronym> bajo la mayoría de los servidores web. Si no lo establece, PHP lo activará automáticamente de manera predeterminada. Puede desactivarlo <emphasis>bajo su propio riesgo</emphasis>.
</para>
<note>
<para>
Expand Down
Loading