Skip to content

Remove translations of extensions moved to doc-extensions - #3696

Draft
lacatoire wants to merge 8 commits into
php:masterfrom
lacatoire:refactor/retirer-extensions-doc-extensions
Draft

lacatoire wants to merge 8 commits into
php:masterfrom
lacatoire:refactor/retirer-extensions-doc-extensions

Conversation

@lacatoire

@lacatoire lacatoire commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

Per the third-party extension documentation RFC, translations are not carried over to php/doc-extensions and are removed from the manual. This removes the 94 reference/<ext>/ folders (php/doc-extensions#12) and points 60 links at ../extensions/<page>.php. A temporary workflow runs the end-to-end test of the block.

Draft until php/doc-en#5998 removes the same extensions from the fallback manual.

Block: php/phd#270, php/doc-extensions#49, php/doc-en#5998, php/web-php#2038. They build on php/phd#260, php/doc-en#5658 and php/web-php#1960.

Outside the block, the same change for Spanish as a second proof of concept: php/doc-es#1491 (the test runs with LANGUAGE=es).

Test: put doc-base (master), phd, en, fr, extensions and web-php side by side, each pull request on its branch, then run sh web-php/tests/extensions-migration.sh (about 40 seconds, PLAYWRIGHT=1 adds the Playwright tests).

Merge order. A redirect only answers for a missing page, so each step can be checked on its own:

  1. Add class to generate redirects.json from redirects.xml sidecar phd#260, Write redirects.json inside the php-web directory phd#270
  2. Add redirect.xml map for manual pages on php.net doc-en#5658, migrate doc redirects to redirects.json sidecar from doc-en web-php#1960
  3. Add the redirect map of the pages moved from the main manual doc-extensions#49, Serve the pages of the moved extensions from /manual/extensions/ web-php#2038, then publish /manual/extensions/ (no visible change yet)
  4. Remove the extensions moved to doc-extensions doc-en#5998: the old URLs now redirect
  5. this pull request, then the other translations (once Remove the extensions moved to doc-extensions doc-en#5998 is merged, the touched files need the EN-Revision of its merge commit)
  6. remove the workflow and its pinned refs

Known gaps: the PDO driver pages (cubrid, ibm, informix, sqlsrv) are not in the extensions manual yet, and two back links point at renamed pages.

The links to pages that moved to php/doc-extensions point to the extensions
manual, which is served next to the language manuals.
…ns manual

The references from language-snippets.ent and the PDO drivers table point at
../extensions/<page>.php.
The workflow builds the extensions manual and this manual from the pull
requests of the block and runs the test of web-php: redirects, links in both
directions and shortcuts. It goes away with the pinned refs once the block is
merged.
@lacatoire
lacatoire force-pushed the refactor/retirer-extensions-doc-extensions branch from 6e59db2 to 75c71ce Compare October 22, 2026 14:33
reference/mysqlinfo/set.xml and reference/pdo/drivers.xml still included
entities of the removed directories.
The entities of language-snippets.ent do not inherit the namespace.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant