Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/WyriHaximusNet/docker-php
Opinionated PHP Docker images
https://github.com/WyriHaximusNet/docker-php
docker hacktoberfest parallel php php7 php8 reactphp uv
Last synced: 7 days ago
JSON representation
Opinionated PHP Docker images
- Host: GitHub
- URL: https://github.com/WyriHaximusNet/docker-php
- Owner: WyriHaximusNet
- License: mit
- Created: 2019-03-23T18:58:29.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T06:03:48.000Z (3 months ago)
- Last Synced: 2024-04-25T07:25:25.841Z (3 months ago)
- Topics: docker, hacktoberfest, parallel, php, php7, php8, reactphp, uv
- Language: PHP
- Homepage: https://hub.docker.com/r/wyrihaximusnet/php
- Size: 427 KB
- Stars: 38
- Watchers: 3
- Forks: 6
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-stars - WyriHaximusNet/docker-php - Opinionated PHP Docker images (PHP)
- awesome-jekyll - WyriHaximusNet/docker-php - Opinionated PHP Docker images (PHP)
README
# Opinionated ReactPHP optimised PHP Docker images
[](https://github.com/wyrihaximusnet/docker-php/actions)
[](https://hub.docker.com/r/wyrihaximusnet/php/)
[](https://hub.docker.com/r/wyrihaximusnet/php/)
[](https://hub.docker.com/r/wyrihaximusnet/php/)
# Images
This repo builds two different images, plus a `-dev` image for each containing [`composer`](https://getcomposer.org/),
bash, git, ssh, strace, gdb, and make, and a `-root` image for all `*(-dev)` images where the default user is root. All the images
are based on [`Alpine Linux`](https://alpinelinux.org/) and [`Debian Linux`](https://www.debian.org/). All images come with
extensions used to increase the performance of [`ReactPHP`](https://reactphp.org/) (such as event loop extensions). Such extensions
are highlighted **build** in the extensions list below. All the `Alpine Linux` images are scanned for vulnerabilities, and not pushed
if any are found. The `Debian Linux` containers easily a few hundred so those aren't scanned. (There is no use in doing so.)
## Images News
Sometimes big changes happen to images, to stay informed please subscribe to this thread: https://github.com/WyriHaximusNet/docker-php/issues/46
### CVE Matrix
Currently Alpine and Debian images are treated differently, this matrix defines the differences between Alpine and Debian images:
| Base Image | Description |
|------------|------------------------------------------------------------------|
| Alpine | Don't push when CVE's are found when building |
| Debian | Not scanned for CVE's due to the ton of low CVE's found in there |
## The available tags
The docker registry prefix is `wyrihaximusnet/php`, thus `wyrihaximusnet/php:OUR-TAGS`
In order to provide upgrade path we intend to keep one or more versions of PHP.
[Currently Available tags on Docker hub](https://hub.docker.com/r/wyrihaximusnet/php/tags/)
The tag naming strategy consists of (Read as a regex):
- PHP: `(phpMajor).(phpMinor)-(nts|zts)-(alpine((alpineMajor).(alpineMinor))|bullseye|buster|strech)(-slim)(-dev)(-root)?`
- Example: `8.2-zts-alpine-slim`, `8.3-nts-alpine3.13-dev`, `8.1-zts-buster-slim`
## Example usage
The following example has two build staging, the first for leading in any required dependencies, and the second the
actual image we'd want to use. In the second stage we copy the dependencies in without needing composer in the
production image. We create the image with the following command:
```bash
docker build . -t IMAGE_NAME:TAG --target=runtime
```
```dockerfile
FROM ghcr.io/wyrihaximusnet/php:8.3-zts-alpine-slim-dev AS install-dependencies
WORKDIR /opt/app
COPY ./composer.lock /opt/app/composer.lock
COPY ./composer.json /opt/app/composer.json
COPY ./src/ /opt/app/src/
RUN composer install --ansi --no-interaction --prefer-dist --no-dev -o
FROM ghcr.io/wyrihaximusnet/php:8.3-zts-alpine-slim AS runtime
WORKDIR /opt/app
COPY ./composer.lock /opt/app/composer.lock
COPY ./composer.json /opt/app/composer.json
COPY --from=install-dependencies /opt/app/vendor/ /opt/app/vendor/
COPY ./src/ /opt/app/src/
COPY ./app.php /opt/app/app.php
ENTRYPOINT ["php", "/opt/app/app.php"]
```
### NTS
NTS, or non-thread safe is the PHP version most people use. This image comes with the following extensions:
| Extension | Description |
|-----------|------------------------------------------|
| ext-eio | Provides interface to the libeio library |
| ext-pcntl | PCNTL OS signals |
| ext-uv | LibUV event loop |
| ext-event | Libevent event loop |
### ZTS
ZTS, or zend thread safe is the PHP version that is safe to be used and required my threading extensions such as
pthreads or parallel. This image comes with the following extensions:
| Extension | Description |
|--------------|------------------------------------------------------------|
| ext-eio | Provides interface to the libeio library |
| ext-parallel | A succinct parallel concurrency API for PHP7 using threads |
| ext-pcntl | PCNTL OS signals |
| ext-uv | LibUV event loop |
Both versions come with the following list of non-non-blocking related (core-) extensions:
* bcmath
* Core
* ctype
* curl
* date
* dom
* fileinfo
* filter
* ftp
* gd
* gmp
* hash
* iconv
* json
* libxml
* mbstring
* mysqlnd
* openssl
* pcre
* PDO
* pdo_pgsql
* pdo_sqlite
* pgsql
* Phar
* posix
* readline
* Reflection
* session
* SimpleXML
* sodium
* SPL
* sqlite3
* standard
* tokenizer
* vips
* xml
* xmlreader
* xmlwriter
* zip
* zlib
# Slim images
Slim images include all the above extensions except the following, as those notoriously require heavy dependencies:
* gd
* vips
# Credits
This project is based on [Usabilla](https://usabilla.com/)'s [PHP Docker Template](https://github.com/usabilla/php-docker-template).
Lots of the documentation on that repository also applies here, with the big difference that this project only
supplies CLI images.