Skip to content

OCI8 marked as included in PHP 8.x, but actually unbundled in PHP 8.4 #4889

@rottifant

Description

@rottifant

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).

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugDocumentation contains incorrect information

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions