Remove translations of extensions moved to doc-extensions

.github/workflows/check-extensions-migration.yml

@@ -0,0 +1,85 @@
+# https://docs.github.com/en/actions
+# Temporary: end-to-end test of the move of the third-party extensions to
+# php/doc-extensions, with the Spanish manual. It builds the extensions manual
+# and this manual from the branches of the pull requests of the block, serves
+# both with web-php and checks that the old URLs are redirected and that the
+# manuals link to each other. The test is web-php/tests/extensions-migration.sh,
+# which anyone can run locally with the same six repositories (LANGUAGE=es).
+#
+# Remove this workflow once the pull requests are merged, or replace the pinned
+# refs by master.
+
+name: "Extensions migration"
+
+on:
+  pull_request:
+    branches: ["master"]
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  end-to-end:
+    name: "End to end"
+    runs-on: ubuntu-latest
+    steps:
+      # The six repositories side by side: this is the layout expected by the
+      # doc-base scripts and by the test. The explicit ref takes the real head
+      # of this pull request, not the merge commit.
+      - name: "Checkout php/doc-es"
+        uses: actions/checkout@v7
+        with:
+          path: es
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      # Fallback of the translation, with the moved extensions removed.
+      - name: "Checkout php/doc-en"
+        uses: actions/checkout@v7
+        with:
+          repository: php/doc-en
+          path: en
+          ref: refs/pull/5998/head
+
+      - name: "Checkout php/doc-base"
+        uses: actions/checkout@v7
+        with:
+          repository: php/doc-base
+          path: doc-base
+
+      - name: "Checkout php/phd"
+        uses: actions/checkout@v7
+        with:
+          repository: php/phd
+          path: phd
+          ref: refs/pull/270/head
+
+      - name: "Checkout php/doc-extensions"
+        uses: actions/checkout@v7
+        with:
+          repository: php/doc-extensions
+          path: extensions
+          ref: refs/pull/49/head
+
+      - name: "Checkout php/web-php"
+        uses: actions/checkout@v7
+        with:
+          repository: php/web-php
+          path: web-php
+          ref: refs/pull/2038/head
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.4"
+          extensions: "dom, iconv, intl, libxml, mbstring, simplexml, sqlite3, xmlreader, xmlwriter"
+          coverage: none
+
+      - name: "Build both manuals and test the redirects and the links"
+        env:
+          LANGUAGE: es
+        run: sh web-php/tests/extensions-migration.sh "$GITHUB_WORKSPACE"

appendices/aliases.xml

@@ -3,7 +3,7 @@
 <!-- EN-Revision: e2274fb291cb76151378a209e8c92612d1ba5340 Maintainer: lacatoire Status: ready -->
 <!-- Reviewed: yes -->
 
-<appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook">
+<appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Lista de alias</title>
  <para>
   Hay muchas funciones en PHP que pueden ser llamadas bajo
@@ -238,92 +238,92 @@
      <row>
       <entry>mysql</entry>
       <entry><function>mysql_db_query</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_createdb</entry>
       <entry><function>mysql_create_db</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_db_name</entry>
       <entry><function>mysql_result</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_dbname</entry>
       <entry><function>mysql_result</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_dropdb</entry>
       <entry><function>mysql_drop_db</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_fieldflags</entry>
       <entry><function>mysql_field_flags</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_fieldlen</entry>
       <entry><function>mysql_field_len</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_fieldname</entry>
       <entry><function>mysql_field_name</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_fieldtable</entry>
       <entry><function>mysql_field_table</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_fieldtype</entry>
       <entry><function>mysql_field_type</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_freeresult</entry>
       <entry><function>mysql_free_result</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_listdbs</entry>
       <entry><function>mysql_list_dbs</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_listfields</entry>
       <entry><function>mysql_list_fields</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_listtables</entry>
       <entry><function>mysql_list_tables</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_numfields</entry>
       <entry><function>mysql_num_fields</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_numrows</entry>
       <entry><function>mysql_num_rows</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_selectdb</entry>
       <entry><function>mysql_select_db</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>mysql_tablename</entry>
       <entry><function>mysql_result</function></entry>
-      <entry><link linkend="ref.mysql">MySQL</link></entry>
+      <entry><link xlink:href="../extensions/ref.mysql.php">MySQL</link></entry>
      </row>
      <row>
       <entry>ociassignelem</entry>
@@ -598,7 +598,7 @@
      <row>
       <entry>recode</entry>
       <entry><function>recode_string</function></entry>
-      <entry><link linkend="ref.recode">Recode</link></entry>
+      <entry><link xlink:href="../extensions/ref.recode.php">Recode</link></entry>
      </row>
      <row>
       <entry>show_source</entry>

appendices/filters.xml

@@ -587,7 +587,7 @@ El fichero comprimido tiene 1488 bytes.
     <literal>mcrypt.*</literal> y <literal>mdecrypt.*</literal>
     proporcionan un sistema de cifrado simétrico utilizando libmcrypt.
     Ambos conjuntos de filtros soportan los mismos algoritmos disponibles en la
-    <link linkend="ref.mcrypt">extensión mcrypt</link> en forma
+    <link xlink:href="../extensions/ref.mcrypt.php">extensión mcrypt</link> en forma
     <literal>mcrypt.ciphername</literal> donde <parameter>ciphername</parameter>
     es el nombre del cifrado que será transmitido a
     <function>mcrypt_module_open</function>.

appendices/migration56/changed-functions.xml

@@ -2,7 +2,7 @@
 <!-- EN-Revision: da75c15e022c72fdab6ed68f936ee41ecc5909b1 Maintainer: argosback Status: ready -->
 <!-- Reviewed: yes Maintainer: argosback -->
 
-<sect1 xml:id="migration56.changed-functions">
+<sect1 xml:id="migration56.changed-functions" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Funciones modificadas</title>
 
  <sect2 xml:id="migration56.changed-functions.core">
@@ -47,7 +47,7 @@
  </sect2>
 
  <sect2 xml:id="migration56.changed-functions.mcrypt">
-  <title><link linkend="book.mcrypt">Mcrypt</link></title>
+  <title><link xlink:href="../extensions/book.mcrypt.php">Mcrypt</link></title>
 
   <itemizedlist>
    <listitem>

appendices/migration56/incompatible.xml

@@ -2,7 +2,7 @@
 <!-- EN-Revision: b67451f6fb5aa8602d88fb8680c581f79b76655c Maintainer: argosback Status: ready -->
 <!-- Reviewed: yes Maintainer: argosback -->
 
-<sect1 xml:id="migration56.incompatible">
+<sect1 xml:id="migration56.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Cambios incompatibles con versiones anteriores</title>
  <simpara>
   Aunque la mayoría del código PHP 5 existente debería funcionar sin ninguna
@@ -103,7 +103,7 @@ array(3) {
  </sect2>
 
  <sect2 xml:id="migration56.incompatible.mcrypt">
-  <title>Las funciones <link linkend="book.mcrypt">Mcrypt</link> ahora requieren claves o IV válidos</title>
+  <title>Las funciones <link xlink:href="../extensions/book.mcrypt.php">Mcrypt</link> ahora requieren claves o IV válidos</title>
 
   <para>
    <function>mcrypt_encrypt</function>, <function>mcrypt_decrypt</function>,

appendices/migration70/incompatible/removed-functions.xml

@@ -2,7 +2,7 @@
 <!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: argosback Status: ready -->
 <!-- Reviewed: yes Maintainer: argosback -->
 
-<sect2 xml:id="migration70.incompatible.removed-functions">
+<sect2 xml:id="migration70.incompatible.removed-functions" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Funciones eliminadas</title>
 
  <sect3 xml:id="migration70.incompatible.removed-functions.call-user-method">
@@ -34,7 +34,7 @@
  </sect3>
 
  <sect3 xml:id="migration70.incompatible.removed-functions.mcrypt">
-  <title>Alias <link linkend="book.mcrypt">mcrypt</link></title>
+  <title>Alias <link xlink:href="../extensions/book.mcrypt.php">mcrypt</link></title>
 
   <para>
    La función obsoleta <function>mcrypt_generic_end</function> se
@@ -55,7 +55,7 @@
    Todas las funciones ext/mysql
   </title>
   <para>
-   Todas las funciones <link linkend="book.mysql">ext/mysql</link> se han eliminado.
+   Todas las funciones <link xlink:href="../extensions/book.mysql.php">ext/mysql</link> se han eliminado.
    Para más información sobre la elección de otra API MySQL,
    consulte <link linkend="mysqlinfo.api.choosing">elegir una API MySQL</link>.
   </para>
@@ -68,10 +68,8 @@
   <para>
    Todas las funciones <literal>ext/mssql</literal> se han
    eliminado. <simplelist
-    role="alternatives"> <member><link
-    linkend="ref.pdo-sqlsrv">PDO_SQLSRV</link></member> <member><link
-    linkend="ref.pdo-odbc">PDO_ODBC</link></member> <member><link
-    linkend="book.sqlsrv">SQLSRV</link></member> <member><link linkend="book.uodbc">Unified ODBC API</link></member>
+    role="alternatives"> <member><link xlink:href="../extensions/ref.pdo-sqlsrv.php">PDO_SQLSRV</link></member> <member><link
+    linkend="ref.pdo-odbc">PDO_ODBC</link></member> <member><link xlink:href="../extensions/book.sqlsrv.php">SQLSRV</link></member> <member><link linkend="book.uodbc">Unified ODBC API</link></member>
    </simplelist>
   </para>
  </sect3>

appendices/migration72/other-changes.xml

@@ -84,10 +84,10 @@
  </sect2>
 
  <sect2 xml:id="migration72.other-changes.mcrypt">
-  <title>Traslado de <link linkend="book.mcrypt">MCrypt</link> a PECL</title>
+  <title>Traslado de <link xlink:href="../extensions/book.mcrypt.php">MCrypt</link> a PECL</title>
 
   <para>
-   La extensión <link linkend="book.mcrypt">MCrypt</link> ha sido trasladada del núcleo a PECL.
+   La extensión <link xlink:href="../extensions/book.mcrypt.php">MCrypt</link> ha sido trasladada del núcleo a PECL.
    Dado que la biblioteca mcrypt no ha visto actualizaciones desde 2007, su uso está
    fuertemente desaconsejado. En su lugar, debe utilizarse <link linkend="book.openssl">OpenSSL</link>
    o la extensión

appendices/migration74/removed-extensions.xml

@@ -15,19 +15,19 @@
  <itemizedlist>
   <listitem>
    <simpara>
-    <link linkend="book.ibase">Firebird/Interbase</link>
+    <link xlink:href="../extensions/book.ibase.php">Firebird/Interbase</link>
     - el acceso a una base de datos basada en InterBase y/o Firebird sigue siendo
     con el driver PDO Firebird.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
-    <link linkend="book.recode">Recode</link>
+    <link xlink:href="../extensions/book.recode.php">Recode</link>
    </simpara>
   </listitem>
   <listitem>
    <simpara>
-    <link linkend="book.wddx">WDDX</link>
+    <link xlink:href="../extensions/book.wddx.php">WDDX</link>
    </simpara>
   </listitem>
  </itemizedlist>

faq/databases.xml

@@ -24,8 +24,8 @@
      o la <link linkend="book.uodbc">API ODBC Unificada</link>.
     </para>
     <para>
-     En máquinas Windows se puede usar <link linkend="ref.pdo-sqlsrv">PDO_SQLSRV</link>
-     o <link linkend="book.sqlsrv">SQLSRV</link>.
+     En máquinas Windows se puede usar <link xlink:href="../extensions/ref.pdo-sqlsrv.php">PDO_SQLSRV</link>
+     o <link xlink:href="../extensions/book.sqlsrv.php">SQLSRV</link>.
     </para>
     <para>
      Consulte también la respuesta de la siguiente pregunta.

install/pie.xml

@@ -17,7 +17,7 @@
   <simpara>
    Tras <link xlink:href="&url.pie;?tab=readme-ov-file#using-pie---what-do-i-need-to-get-started">instalar
    los requisitos y PIE en sí</link>, puede instalar la
-   <link linkend="mongodb.mongodb">extensión MongoDB</link> ejecutando
+   <link xlink:href="../extensions/mongodb.mongodb.php">extensión MongoDB</link> ejecutando
    el siguiente comando en la línea de comandos.
   </simpara>
   <example>

install/unix/debian.xml

@@ -53,7 +53,7 @@
   <title>Un mejor control de la configuración</title>
   <simpara>
    En el ejemplo anterior, PHP fue instalado con solo los componentes principales. Es probable que se necesiten módulos adicionales, tales como
-   <link linkend="book.mysql">MySQL</link>,
+   <link xlink:href="../extensions/book.mysql.php">MySQL</link>,
    <link linkend="book.curl">cURL</link>,
    <link linkend="book.image">GD</link>,
    etc. También pueden ser instalados a través del comando <command>apt</command>.

install/unix/dnf.xml

@@ -53,7 +53,7 @@
    En la última sección, PHP ha sido instalado solo con los módulos básicos. Es
    muy probable que se requieran módulos adicionales, tales como
    <simplelist type="inline">
-    <member><link linkend="book.mysql">MySQL</link></member>
+    <member><link xlink:href="../extensions/book.mysql.php">MySQL</link></member>
     <member><link linkend="book.curl">cURL</link></member>
     <member><link linkend="book.image">GD</link></member>
     <member>etc.</member>

install/windows/recommended.xml

@@ -64,7 +64,7 @@ wincache.ocenabled=1 ; removed as of wincache 2.0.0.0
   </example>
 
   Para más información, leer :
-  <link linkend="wincache.configuration">Configuración de WinCache</link>
+  <link xlink:href="../extensions/wincache.configuration.php">Configuración de WinCache</link>
  </para>
 
  </sect2>