lacatoire · Oct 19, 2026 · Oct 22, 2026 · Oct 22, 2026 · Oct 22, 2026 · Oct 22, 2026
diff --git a/.github/workflows/check-extensions-migration.yml b/.github/workflows/check-extensions-migration.yml
@@ -0,0 +1,83 @@
+# https://docs.github.com/en/actions
+# Temporary: end-to-end test of the move of the third-party extensions to
+# php/doc-extensions. 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.
+#
+# 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-fr"
+        uses: actions/checkout@v7
+        with:
+          path: fr
+          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"
+        run: sh web-php/tests/extensions-migration.sh "$GITHUB_WORKSPACE"
diff --git a/appendices/aliases.xml b/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>Liste des alias de fonctions</title>
  <para>
   Il y a beaucoup de fonctions en PHP qui peuvent être appelées sous
@@ -240,92 +240,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>
@@ -600,7 +600,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>

diff --git a/appendices/filters.xml b/appendices/filters.xml
@@ -581,7 +581,7 @@ Le fichier compressé fait 1488 octets de long.
     <literal>mcrypt.*</literal> et <literal>mdecrypt.*</literal>
     fournissent un système de chiffrement symétrique utilisant libmcrypt.
     Les deux jeux de filtres supportent les mêmes algorithmes disponibles à
-    l'<link linkend="ref.mcrypt">extension mcrypt</link> sous la forme
+    l'<link xlink:href="../extensions/ref.mcrypt.php">extension mcrypt</link> sous la forme
     <literal>mcrypt.ciphername</literal> où <parameter>ciphername</parameter>
     est le nom du chiffrement qui sera transmis à
     <function>mcrypt_module_open</function>.

diff --git a/appendices/migration56/changed-functions.xml b/appendices/migration56/changed-functions.xml
@@ -3,7 +3,7 @@
 <!-- EN-Revision: da75c15e022c72fdab6ed68f936ee41ecc5909b1 Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes Maintainer: pmartin -->
 
-<sect1 xml:id="migration56.changed-functions">
+<sect1 xml:id="migration56.changed-functions" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Fonctions modifiées</title>
 
  <sect2 xml:id="migration56.changed-functions.core">
@@ -50,7 +50,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>

diff --git a/appendices/migration56/incompatible.xml b/appendices/migration56/incompatible.xml
@@ -3,7 +3,7 @@
 <!-- EN-Revision: b67451f6fb5aa8602d88fb8680c581f79b76655c Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes Maintainer: pmartin -->
 
-<sect1 xml:id="migration56.incompatible">
+<sect1 xml:id="migration56.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Modifications entraînant une incompatibilité ascendante</title>
  <simpara>
   Bien que la plupart du code PHP 5 existant devrait fonctionner sans aucune 
@@ -108,7 +108,7 @@ array(3) {
  </sect2>
 
  <sect2 xml:id="migration56.incompatible.mcrypt">
-  <title>Les fonctions <link linkend="book.mcrypt">Mcrypt</link> requièrent maintenant des clés ou IV valides</title>
+  <title>Les fonctions <link xlink:href="../extensions/book.mcrypt.php">Mcrypt</link> requièrent maintenant des clés ou IV valides</title>
 
   <para>
    <function>mcrypt_encrypt</function>, <function>mcrypt_decrypt</function>,

diff --git a/appendices/migration70/incompatible/removed-functions.xml b/appendices/migration70/incompatible/removed-functions.xml
@@ -3,7 +3,7 @@
 <!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes Maintainer: girgias -->
 
-<sect2 xml:id="migration70.incompatible.removed-functions">
+<sect2 xml:id="migration70.incompatible.removed-functions" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Fonctions supprimées</title>
 
  <sect3 xml:id="migration70.incompatible.removed-functions.call-user-method">
@@ -33,7 +33,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 fonction obsolète <function>mcrypt_generic_end</function> a été
@@ -54,7 +54,7 @@
    Toutes les fonctions ext/mysql
   </title>
   <para>
-   Toutes les fonctions <link linkend="book.mysql">ext/mysql</link> ont été supprimées.
+   Toutes les fonctions <link xlink:href="../extensions/book.mysql.php">ext/mysql</link> ont été supprimées.
    Pour plus d'informations sur le choix d'une autre API MySQL, consulter
    <link linkend="mysqlinfo.api.choosing">choisir une API MySQL</link>.
   </para>
@@ -67,9 +67,9 @@
   <para>
    Toutes les fonctions <literal>ext/mssql</literal> ont été supprimées.
    <simplelist role="alternatives">
-    <member><link linkend="ref.pdo-sqlsrv">PDO_SQLSRV</link></member>
+    <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 linkend="book.sqlsrv">SQLSRV</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>

diff --git a/appendices/migration72/other-changes.xml b/appendices/migration72/other-changes.xml
@@ -84,10 +84,10 @@
  </sect2>
 
  <sect2 xml:id="migration72.other-changes.mcrypt">
-  <title>Déplacement de <link linkend="book.mcrypt">MCrypt</link> vers PECL</title>
+  <title>Déplacement de <link xlink:href="../extensions/book.mcrypt.php">MCrypt</link> vers PECL</title>
 
   <para>
-   L'extension <link linkend="book.mcrypt">MCrypt</link> a maintenant été 
+   L'extension <link xlink:href="../extensions/book.mcrypt.php">MCrypt</link> a maintenant été
    déplacée du noyau vers PECL. Étant donné que la bibliothèque mcrypt n'a pas 
    vu de mises à jour depuis 2007, son utilisation est fortement découragée. 
    À la place, l'extension <link linkend="book.openssl">OpenSSL</link> ou

diff --git a/appendices/migration74/removed-extensions.xml b/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>
     - l'accès à une base de données InterBase et/ou Firebird est toujours 
     disponible avec le pilote Firebird du PDO. 
    </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>

diff --git a/faq/databases.xml b/faq/databases.xml
@@ -25,8 +25,8 @@
       ou <link linkend="book.uodbc">Unified ODBC API</link>.
      </para>
      <para>
-      Sur les machines Windows, il est également possible d'utiliser <link linkend="ref.pdo-sqlsrv">PDO_SQLSRV</link>
-      ou <link linkend="book.sqlsrv">SQLSRV</link>.
+      Sur les machines Windows, il est également possible d'utiliser <link xlink:href="../extensions/ref.pdo-sqlsrv.php">PDO_SQLSRV</link>
+      ou <link xlink:href="../extensions/book.sqlsrv.php">SQLSRV</link>.
      </para>
      <para>
       Consulter aussi la réponse à la question suivante.

diff --git a/install/pie.xml b/install/pie.xml
@@ -17,7 +17,7 @@
   <simpara>
    Après <link xlink:href="&url.pie;?tab=readme-ov-file#using-pie---what-do-i-need-to-get-started">l'installation
    des prérequis et de PIE lui-même</link>, il est ensuite possible d'installer
-   l'<link linkend="mongodb.mongodb">extension MongoDB</link> en exécutant
+   l'<link xlink:href="../extensions/mongodb.mongodb.php">extension MongoDB</link> en exécutant
    la commande suivante en ligne de commande.
   </simpara>
   <example>

diff --git a/install/unix/alpine.xml b/install/unix/alpine.xml
@@ -56,7 +56,7 @@
    Seules les extensions principales sont installées avec le paquet de base.
    Des extensions supplémentaires telles que
    <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>

diff --git a/install/unix/debian.xml b/install/unix/debian.xml
@@ -54,7 +54,7 @@
   <simpara>
    Dans l'exemple précédent, PHP a été installé avec juste les composants principaux. Il y a fort
    à parier que des modules supplémentaires soient nécessaires, tels que
-   <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. Ils peuvent aussi être installés via la commande <command>apt</command>.

diff --git a/install/unix/dnf.xml b/install/unix/dnf.xml
@@ -52,7 +52,7 @@
    Dans la dernière section, PHP a été installé avec seulement les modules de base. Il est
    très probable que des modules supplémentaires seront souhaités, tels que
    <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>

diff --git a/install/unix/pacman.xml b/install/unix/pacman.xml
@@ -52,7 +52,7 @@
    de base. Il est très probable que des modules additionnels soient souhaités,
    tels que
    <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>

diff --git a/install/windows/recommended.xml b/install/windows/recommended.xml
@@ -69,7 +69,7 @@ wincache.ocenabled=1 ; removed as of wincache 2.0.0.0
   </example>
 
   Pour plus d'informations, voir : 
-  <link linkend="wincache.configuration">Configuration de WinCache</link>
+  <link xlink:href="../extensions/wincache.configuration.php">Configuration de WinCache</link>
  </para>
 
  </sect2>