OCI8 marked as included in PHP 8.x, but actually unbundled in PHP 8.4
Nobody has claimed this yet.
- Dominant language
- XML
- Stars
- 596
- Forks
- 890
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 55
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).
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the OCI8 requirements page at https://www.php.net/manual/en/oci8.requirements.php and compare its bundled-version wording with the PHP 8.4 migration guide and unbundle RFC linked in the issue. Update the OCI8 documentation to distinguish PHP 8.0–8.3 from PHP 8.4 and later, where OCI8 must be installed via PECL, then verify related wording remains consistent.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- php
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 78/100