Skip to content

About

Docker images with Oracle drivers configuration (based on kooldev/php)

Resources

Stars

4 stars

Watchers

5 watching

Forks

Latest commit

 

History

51 Commits

Folders and files

Repository files navigation

Description

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.

Available Tags

8.4

8.4 with Swoole

8.3

8.3 with Swoole

8.2

8.2 with Swoole

There are also older versions available like 7.4-oci8-nginx, 7.4-oci8-nginx-prod.

Environment Variables

Please refer to kooldev/php.

NGINX

Please refer to kooldev/php.

Swoole

Please refer to kooldev/php.

Usage

Please refer to kooldev/php.

Contributing

Update images with templates

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.

License

The MIT License (MIT). Please see License File for more information.

Rebuilds and validation

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/Dockerfile

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

About

Docker images with Oracle drivers configuration (based on kooldev/php)

Resources

Stars

4 stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages