-
Notifications
You must be signed in to change notification settings - Fork 828
Description
Affected page
https://www.php.net/manual/en/oci8.requirements.php
Issue description
The OCI8 documentation – requirements currently states:
“OCI8 3.0 is included with PHP 8. It is also available from » PECL. For PHP 7, use OCI8 2.2 from » PECL. [...]”
This statement is misleading for users on PHP 8.4 and later.
According to the PHP 8.4 migration guide and the unbundle RFC, the OCI8 and PDO_OCI extensions were removed from PHP core and moved to PECL as of PHP 8.4.
So the current wording gives the impression that OCI8 is still bundled with all PHP 8 versions, which is no longer true.
Steps to reproduce
No response
Suggested fix
Update the OCI8 introduction and related docs to clearly state something like:
“OCI8 3.x is included with PHP 8.0–8.3.
Starting with PHP 8.4, OCI8 is no longer bundled and must be installed via PECL.”
For PDO_OCI the documentation has already been updated to mention PHP 8.4 explicitly in #4103.
For OCI8, however, the same / a similar clarification was suggested but removed during review.
As a result, the OCI8 docs lack any note that it is unbundled from PHP 8.4 onwards, which may confuse users (including me).