Sync docs with EN for doc-en PRs

php · Nov 11, 2024 · f44371a · f44371a · alfsb · Nov 22, 2024
1 parent c8a0d1d
commit f44371a
Show file tree

Hide file tree

Showing 43 changed files with 2,688 additions and 2,026 deletions.
diff --git a/features/commandline.xml b/features/commandline.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e Maintainer: seros Status: ready -->
+<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: seros Status: ready -->
 <!-- Reviewed: no Maintainer: seros -->
 
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -460,11 +460,12 @@ $ php -c /directorio/propio/fichero-propio.ini mi_script.php
          de configuración permitidas en &php.ini;. Ésta es la sintaxis:
          <screen>
 <![CDATA[
- -d directiva_de_configuracion[=valor]
+ -d configuration_directive[=valor]
  ]]>
          </screen>
         </para>
         <para><example>
+         <title>Ejemplo de usar <literal>-d</literal> para establecer una configuración INI</title>
          <screen>
 <![CDATA[
 # Si se omite el valor, se establecerá un "1" a la directiva

diff --git a/install/unix/apache2.xml b/install/unix/apache2.xml
@@ -224,14 +224,14 @@ LoadModule php5_module modules/libphp5.so
 
 
        <informalexample>
-        <programlisting role="apache-conf">
+    <programlisting role="apache-conf">
 <![CDATA[
 <FilesMatch \.php$>
     SetHandler application/x-httpd-php
 </FilesMatch>
 ]]>
-       </programlisting>
-       </informalexample>
+    </programlisting>
+   </informalexample>
 
        <para>
         O, si se deseara permitir que ficheros .php, .php2, .php3, .php4, .php5, .php6, y

diff --git a/install/unix/nginx.xml b/install/unix/nginx.xml
@@ -46,13 +46,13 @@
     Obtener y desempaquetar el código fuente de PHP:
    </para>
 
-   <example xml:id="install.unix.nginx.extract.php">
+   <informalexample xml:id="install.unix.nginx.extract.php">
     <screen>
 <![CDATA[
 tar zxf php-x.x.x
 ]]>
     </screen>
-   </example>
+   </informalexample>
   </listitem>
 
   <listitem>
@@ -63,7 +63,7 @@ tar zxf php-x.x.x
     se realiza una configuración sencilla con soporte para PHP-FPM y MySQL.
    </para>
 
-   <example xml:id="install.unix.nginx.build.php">
+   <informalexample xml:id="install.unix.nginx.build.php">
     <screen>
 <![CDATA[
 cd ../php-x.x.x
@@ -72,23 +72,23 @@ make
 sudo make install
 ]]>
     </screen>
-   </example>
+   </informalexample>
   </listitem>
 
   <listitem>
    <para>
     Obtener y mover los ficheros de configuración a sus ubicaciones correctas
    </para>
 
-   <example xml:id="install.unix.nginx.configure.php">
+   <informalexample xml:id="install.unix.nginx.configure.php">
     <screen>
 <![CDATA[
 cp php.ini-development /usr/local/php/php.ini
 cp /usr/local/etc/php-fpm.conf.default /usr/local/etc/php-fpm.conf
 cp sapi/fpm/php-fpm /usr/local/bin
 ]]>
     </screen>
-   </example>
+   </informalexample>
   </listitem>
 
   <listitem>
@@ -106,25 +106,25 @@ cp sapi/fpm/php-fpm /usr/local/bin
     Cargar el php.ini:
    </para>
 
-   <example xml:id="install.unix.nginx.configure.ini">
+   <informalexample xml:id="install.unix.nginx.configure.ini">
     <screen>
 <![CDATA[
 vim /usr/local/php/php.ini
 ]]>
     </screen>
-   </example>
+   </informalexample>
 
    <para>
     Localizar <literal>cgi.fix_pathinfo=</literal> y modificarla como sigue:
    </para>
 
-   <example xml:id="install.unix.nginx.configure.pathinfo">
+   <informalexample xml:id="install.unix.nginx.configure.pathinfo">
     <screen>
 <![CDATA[
 cgi.fix_pathinfo=0
 ]]>
     </screen>
-   </example>
+   </informalexample>
   </listitem>
 
   <listitem>
@@ -133,19 +133,19 @@ cgi.fix_pathinfo=0
     www-data y el grupo www-data antes de poder iniciar el servicio:
    </para>
 
-   <example xml:id="install.unix.nginx.modify.phpfpm">
+   <informalexample xml:id="install.unix.nginx.modify.phpfpm">
     <screen>
 <![CDATA[
 vim /usr/local/etc/php-fpm.conf
 ]]>
     </screen>
-   </example>
+   </informalexample>
 
    <para>
     Buscar y modificar lo siguiente: 
    </para>
 
-   <example xml:id="install.unix.nginx.modify.phpfpm.usergroup">
+   <informalexample xml:id="install.unix.nginx.modify.phpfpm.usergroup">
     <screen>
 <![CDATA[
 ; Usuario/grupo de procesos de Unix
@@ -155,19 +155,19 @@ user = www-data
 group = www-data
 ]]>
     </screen>
-   </example>
+   </informalexample>
 
    <para>
     Ahora se puede iniciar el servicio de php-fpm:
    </para>
 
-   <example xml:id="install.unix.nginx.start.phpfpm">
+   <informalexample xml:id="install.unix.nginx.start.phpfpm">
     <screen>
 <![CDATA[
 /usr/local/bin/php-fpm
 ]]>
     </screen>
-   </example>
+   </informalexample>
 
    <para>
     Esta guía no continua configurando php-fpm; si se tiene interés en
@@ -180,20 +180,20 @@ group = www-data
     Ahora Nginx debe configurarse para que pueda procesar aplicaciones de PHP:
    </para>
 
-   <example xml:id="install.unix.nginx.configure.nginx">
+   <informalexample xml:id="install.unix.nginx.configure.nginx">
     <programlisting>
 <![CDATA[
 vim /usr/local/nginx/conf/nginx.conf
 ]]>
     </programlisting>
-   </example>
+   </informalexample>
 
    <para>
     Modificar el bloque de ubicaciones predeterminado para que intente
     servir ficheros .php:
    </para>
 
-   <example xml:id="install.unix.nginx.configure.nginx.location">
+   <informalexample xml:id="install.unix.nginx.configure.nginx.location">
     <programlisting role="nginx-conf">
 <![CDATA[
 location / {
@@ -202,15 +202,15 @@ location / {
 }
 ]]>
     </programlisting>
-   </example>
+   </informalexample>
 
    <para>
     El siguiente paso es asegurarse de que los ficheros .php se pasan al
     «backend» de PHP-FPM. Bajo el bloque de ubicaciones predeterminado de PHP
     comentado, añadir lo siguiente:
    </para>
 
-   <example xml:id="install.unix.nginx.configure.nginx.php">
+   <informalexample xml:id="install.unix.nginx.configure.nginx.php">
     <programlisting role="nginx-conf">
 <![CDATA[
 location ~* \.php$ {
@@ -222,35 +222,35 @@ location ~* \.php$ {
 }
 ]]>
     </programlisting>
-   </example>
+   </informalexample>
 
    <para>
     Reiniciar Nginx.
    </para>
 
-   <example xml:id="install.unix.nginx.restart.nginx">
+   <informalexample xml:id="install.unix.nginx.restart.nginx">
     <screen>
 <![CDATA[
 sudo /usr/local/nginx/sbin/nginx -s stop
 sudo /usr/local/nginx/sbin/nginx
 ]]>
     </screen>
-   </example>
+   </informalexample>
   </listitem>
 
   <listitem>
    <para>
     Crear un fichero de prueba
    </para>
 
-   <example xml:id="install.unix.nginx.test.nginx.php">
+   <informalexample xml:id="install.unix.nginx.test.nginx.php">
     <screen>
 <![CDATA[
 rm /usr/local/nginx/html/index.html
 echo "<?php phpinfo(); ?>" >> /usr/local/nginx/html/index.php
 ]]>
     </screen>
-   </example>
+   </informalexample>
 
    <para>
     Ahora, navegar a http://localhost. phpinfo() debería mostrarse.

diff --git a/install/windows/apache2.xml b/install/windows/apache2.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e Maintainer: jorgeolaya Status: ready -->
+<!-- EN-Revision: 2871f7103c7cfcfd95db64eb0930085965fd9330 Maintainer: jorgeolaya Status: ready -->
 <!-- Reviewed: yes Maintainer: julionc -->
 
 <sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -42,16 +42,24 @@
 
  <sect2 xml:id="install.windows.apache2.module">
   <title>Instalación como un controlador de Apache</title>
+  <note>
+   <simpara>
+    Cuando se utiliza apache2handler SAPI, se debe utilizar la versión
+    Thread Safe (TS) de PHP.
+   </simpara>
+  </note>
   <para>
    Para cargar el módulo PHP en Apache 2.x las siguientes líneas en el
    fichero de configuración &httpd.conf; de Apache deben ser añadidas:
    <example>
     <title>PHP y Apache 2.x como controlador</title>
     <programlisting role="apache-conf">
 <![CDATA[
-#
-LoadModule php8_module "c:/php/php8apache2_4.dll"
-AddHandler application/x-httpd-php .php
+# before PHP 8.0.0 the name of the module was php7_module
+LoadModule php_module "c:/php/php8apache2_4.dll"
+<FilesMatch \.php$>
+    SetHandler application/x-httpd-php
+</FilesMatch>
 # configure the path to php.ini
 PHPIniDir "C:/php"
 ]]>
@@ -60,37 +68,13 @@ PHPIniDir "C:/php"
   </para>
   <note>
    <simpara>
-    Recuerde, la ruta real de PHP debe sustituirse por
+    La ruta real de PHP debe sustituirse por
     <filename>C:/php/</filename> en los ejemplos anteriores.
-    Asegúrese que el fichero al que hace referencia en la directiva LoadModule
+    Asegúrese que el fichero al que hace referencia en la directiva <literal>LoadModule</literal>
     está en la ubicación especificada, y utilize <filename>php7apache2_4.dll</filename>
     para PHP 7, o <filename>php8apache2_4.dll</filename> para PHP 8.
    </simpara>
   </note>
-  <para>
-   The above configuration will enable PHP handling of any file that has a
-   .php extension, even if there are other file extensions. For example, a
-   file named <filename>example.php.txt</filename> will be executed by the
-   PHP handler. To ensure that only files that <emphasis>end in</emphasis>
-   <filename>.php</filename> are executed, use the following configuration
-   instead:
-
-   La configuración anterior permitirá el manejo de PHP de cualquier fichero que
-   contenga la extensión .php, incluso si hay otras extensiones de fichero. Por ejemplo,
-   el fichero llamado <filename>example.php.txt</filename> será ejecutado por el
-   controlador PHP. Para garantizar que solo se ejecuten los ficheros que <emphasis>terminen en</emphasis>
-   <filename>.php</filename>, utilice la siguiente configuración:
-  </para>
-
-  <example>
-   <programlisting role="apache-conf">
-<![CDATA[
-<FilesMatch \.php$>
-    SetHandler application/x-httpd-php
-</FilesMatch>
-]]>
-   </programlisting>
-  </example>
  </sect2>
 
  <sect2 xml:id="install.windows.apache2.cgi">
@@ -142,14 +126,17 @@ PHPIniDir "C:/php"
   <para>
    Configure su servidor web como se muestra a continuación, teniendo cuidado de ajustar cualquier ruta
    que reflejen la forma en que ha instalado las cosas en su sistema particular:
+
    <example>
     <title>Configurar Apache para ejecutar PHP como FastCGI</title>
     <programlisting>
 <![CDATA[
 LoadModule fcgid_module modules/mod_fcgid.so
 # ¿Dónde está el fichero php.ini?
 FcgidInitialEnv PHPRC        "c:/php"
-AddHandler fcgid-script .php
+<FilesMatch \.php$>
+    SetHandler fcgid-script
+</FilesMatch>
 FcgidWrapper "c:/php/php-cgi.exe" .php
 ]]>
     </programlisting>