Minimal PHP Docker image with Oracle OCI8 drivers. It's use is intended for kool.dev, but can fit in any other PHP use-case.
This image is based on kooldev/php, please refer to that repo README for further documentation.
There are also older versions available like 7.4-oci8-nginx, 7.4-oci8-nginx-prod.
Please refer to kooldev/php.
Please refer to kooldev/php.
Please refer to kooldev/php.
Please refer to kooldev/php.
The Dockerfile's are automatically managed by fwd-template.json configuration file and files in the template folder. We should always make changes directly to these files.
After any changes, we need to run kool run template to parse the templates and generate folder/files for each version.
The MIT License (MIT). Please see License File for more information.
CI rebuilds on docker-php-swoole-updated repository dispatches, using
an explicit parent pull once per build, retaining its ID for build ancestry and
runtime checks instead of pulling again during tests. The event is sent after all Swoole
image publications succeed. Upstream PHP scheduled parent rebuilds propagate
through Swoole to OCI8; there is no direct PHP event receiver or separate OCI8
rebuild cron, avoiding duplicate or premature builds against old Swoole parents.
Workflow runs are serialized by ref. Only superseded PR runs are canceled;
main-branch release runs are allowed to finish. Dispatch delivery requires the
upstream Swoole repository's dispatch credentials and OCI8 recipient
configuration. If delivery fails, recover with this workflow's manual
workflow_dispatch on main after the required parents have been published.
Only builds on this repository's main branch publish images; PRs do not.
CI uses shared Bash/jq actions,
pinned in the workflow. Twelve native amd64 jobs build/test once; one publisher
validates and promotes their tested digests. See the shared release rules for
publication guards and retry behavior.
To validate a local build:
docker run --rm -v "$PWD:/app" fireworkweb/fwd:v1.0 fwd template
git diff --exit-code
docker build --pull -t oci8-test 8.4-oci8-nginx
bash tests/test-image.sh oci8-test 8.4-oci8-nginx/DockerfileThe smoke test checks PHP against the freshly pulled parent, OCI8, native
Instant Client loading, and the expected Oracle no-listener error from a
loopback connection. It is bounded to 30 seconds. Instant Client 11.2 hangs
in the tested Alpine image with Docker's --network none, so this check uses
the normal bridge but connects only to loopback. It does not test
authentication, queries, TLS, SQL*Plus, or a live Oracle database.
These images remain amd64-only. The template still downloads legacy Oracle
Instant Client 11.2 x64 ZIPs from a third-party GitHub repository's mutable
master branch without checksum verification. Successful loading is not
provenance or security validation. Replacing that source/client and adding ARM
support require separate licensing, provenance, and compatibility review.
Swoole variants depend on the separately published Swoole parents; verify
delivery of the post-publication event through the PHP → Swoole → OCI8 chain.
After merging, maintainers must publish and verify every supported tag's
runtime version and digest before considering stale published images fixed.