From 7a568eec405670bda73817edd3f879a90e5b9fb3 Mon Sep 17 00:00:00 2001 From: Josh Date: Tue, 9 Sep 2025 14:29:02 -0400 Subject: [PATCH 1/3] Refactor extentions list / categorization XML entities --- extensions.ent | 380 ++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 312 insertions(+), 68 deletions(-) diff --git a/extensions.ent b/extensions.ent index 950a286db13c..2a0915ce0852 100644 --- a/extensions.ent +++ b/extensions.ent @@ -1,96 +1,340 @@ - - -Extension List/CategorizationThis -appendix categorizes more than 150 extensions documented in the PHP -Manual by several criteria.'> + + + -Alphabetical'> + + Extension List/Categorization + + + This appendix categorizes more than 150 extensions documented in the + PHP Manual by several criteria. + +"> + + -Purpose'> - -Basic PHP Extensions'> -Variable and Type Related Extensions'> -Text Processing'> -Affecting PHP's Behaviour"> -Session Extensions'> -Other Basic Extensions'> + + Alphabetical + +"> -Database Extensions'> -Abstraction Layers'> -Vendor Specific Database Extensions'> + + + -XML Manipulation'> + + Purpose + +"> -Web Services'> + + + Basic PHP Extensions + + "> + + Variable and Type Related Extensions + + "> + + Text Processing + + "> + + Affecting PHP's Behaviour + + "> + + Session Extensions + + "> + + Other Basic Extensions + + "> -Credit Card Processing'> - -Math and Cryptography'> -Mathematical Extensions'> -Cryptography Extensions'> + + + Database Extensions + + "> + + Abstraction Layers + + "> + + Vendor Specific Database Extensions + + "> -Human Language and Character Encoding Support'> - -File System and Process Control'> -File System Related Extensions'> -Process Control Extensions'> + + + XML Manipulation + + "> -Accessing Services'> -Mail Related Extensions'> -Authentication Services'> -Other Services'> + + + Web Services + + "> -Compression and Archive Extensions'> + + + Credit Card Processing + + "> -Date and Time Related Extensions'> + + + Math and Cryptography + + "> + + Mathematical Extensions + + "> + + Cryptography Extensions + + "> -Utilization Area Specific Extensions'> -Non-Text MIME Output'> -Image Processing and Generation'> -Audio Formats Manipulation'> -Command Line Specific Extensions'> -Windows Only Extensions'> -Server Specific Extensions'> - - + + + Human Language and Character Encoding Support + + "> -Membership'> + + + File System and Process Control + + "> + + File System Related Extensions + + "> + + Process Control Extensions + + "> -Core ExtensionsThese -are not actual extensions. They are part of the PHP core and cannot be -left out of a PHP binary with compilation options.'> + + + Accessing Services + + "> + + Mail Related Extensions + + "> + + Authentication Services + + "> + + Other Services + + "> -Bundled ExtensionsThese -extensions are bundled with PHP.'> + + + Compression and Archive Extensions + + "> -External ExtensionsThese -extensions are bundled with PHP but in order to compile them, external libraries will be needed.'> + + + Date and Time Related Extensions + + "> - -PECL Extensions -These extensions are available from -&link.pecl;. They may require external libraries. More PECL extensions exist but -they are not documented in the PHP manual yet.'> + + + Utilization Area Specific Extensions + + "> + + Non-Text MIME Output + + "> + + Image Processing and Generation + + "> + + Audio Formats Manipulation + + "> + + Command Line Specific Extensions + + "> + + Windows Only Extensions + + "> + + Server Specific Extensions + + "> + + -StateThis part lists extensions not -intended for the production use - they are either too "old" (deprecated) or -"new" (experimental).'> + + Membership + +"> -Deprecated ExtensionsThese -extensions have been deprecated usually in the favor of some other extensions.'> + + Core Extensions + + + These extensions are built into the PHP core + and are included in every PHP installation. + They cannot be disabled or removed at compile time. + + + Some core extensions provide compile-time configuration options + that allow for customization of specific behaviors or functionality. + + + For clarity, some of the functionality listed below + is provided by the standard extension + and does not represent distinct, standalone extensions. + These features are described separately for convenience + and to highlight the specific aspects of functionality they provide. + + "> + + Bundled Extensions + + + These extensions and features are included with PHP, + but may not always be enabled by default. + Each can be disabled during compilation. + + + Some bundled extensions require specific system resources + or may offer additional functionality + when supplementary libraries are installed. + In some cases, their availability is limited + to certain platforms or use cases. + + "> + + External Extensions + + + These extensions are included with PHP, + but require require external libraries to be enabled. + Each can be enabled during compilation + (if dependency requirements are met). + + "> + + PECL Extensions + + + These extensions are available from &link.pecl;. + They may require external libraries + or have other special requirements. + More PECL extensions exist + but they are not documented in the PHP manual yet. + + "> + + + + -Experimental ExtensionsThe -behaviour of these extensions - including the names of their functions and anything -else documented about these extensions - may change without notice in a future release -of PHP. Use these extensions at your own risk.'> + + State + + + This part lists extensions not intended for production use + — they are either too "new" (experimental) + — or "old" (deprecated). Use at your own risk. + +"> + + Experimental Extensions + + + The behaviour of these extensions + — including function names and anything else documented + — may change without notice in a future release of PHP. + + "> + + Deprecated Extensions + + + These extensions have been deprecated + usually in favor of some other extensions. + + "> From 1a4b8d186d3a47380317a298c6726877d4514b15 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 12:33:01 -0400 Subject: [PATCH 2/3] fix: errors --- extensions.ent | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/extensions.ent b/extensions.ent index 2a0915ce0852..8151358cb98a 100644 --- a/extensions.ent +++ b/extensions.ent @@ -4,8 +4,8 @@ ========================================================================== Entities for the categorized extension list for the PHP manual. These entities are not translated, preventing them from becoming outdated. - -------------------------------------------------------------------------- - Structure: + + Structure: - Introduction - Alphabetical List - Purpose Categories @@ -314,8 +314,8 @@ This part lists extensions not intended for production use - — they are either too "new" (experimental) - — or "old" (deprecated). Use at your own risk. + — they are either too "new"a" (experimental) + — or "old" (deprecated). Use at your own risk. "> From d2d9f6f746f1edf983257dccc9b27eff2f103888 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 12:40:14 -0400 Subject: [PATCH 3/3] chore: fix typo --- extensions.ent | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/extensions.ent b/extensions.ent index 8151358cb98a..ebe8a7f55024 100644 --- a/extensions.ent +++ b/extensions.ent @@ -299,7 +299,7 @@ These extensions are available from &link.pecl;. They may require external libraries or have other special requirements. - More PECL extensions exist + More PECL extensions exist but they are not documented in the PHP manual yet. "> @@ -314,8 +314,8 @@ This part lists extensions not intended for production use - — they are either too "new"a" (experimental) - — or "old" (deprecated). Use at your own risk. + — they are either too "new" (experimental) + — or "old" (deprecated). Use at your own risk. ">