Wolfi-OS PHP Repository

This Repository contains popular PHP extensions pre-compiled to be used in Wolfi-OS. I am trying to upstream all packages to the official repository. The packages are all built for x86_64 and aarch64. A GitHub bot is automatically updating the packages and opens a new PR if a new version is available. The repository is hosted with Cloudflare R2 storage and with good caching rules, so it should be fast worldwide.

Installation of Repository

with Dockerfile

FROM cgr.dev/chainguard/wolfi-base

RUN echo "https://wolfi.shyim.me" > /etc/apk/repositories && \
echo "https://packages.wolfi.dev/os" >> /etc/apk/repositories && \
cat <<EOF > /etc/apk/keys/php-signing.rsa.pub
-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9s0rytmiqI5l6IgwLqiD
ecg3jwDIHWfzVmzfedTen4KW5MkmUVXgFXbmegD/e4arNzqkw2tpqIkYgKO4G5MF
wMvfvx4NP/dDBmEwRkqiq53+TfiaLZQYpotZy1Zrb7GHQBIQ+hK1ekN+WFBOmhd5
fwdPPBLbG1aOjigyydLdriLCDOf7mo7OZq7K42Ima2/Mp/Cdb12JswxIc5XYuJwX
35grsQy7dcli7QUbh20f/teB0hMb70V9RanXf2I8lzZ74djHMlDk6lJ0blBA8Wzl
P0m+yznoGIcSvix18XO78/TlbEajH/m8w4mjrNsgzeRlMeexOz0JO6fn7FtcRh3X
QmgAQ5QRy3ioZ1haEdr+oLlEOGUlmG1xdnpRCPAb8L0Xu7qDJr8Sm7DKPpzM5Jc4
k8/WCHJzsmOYPSV83itxTk6hfiMY5L/IsJsOe9/ZzUxmpiLEY5NSjiS+jSu/I492
PePYfiX/on7GNEzbRRaQzQ9cwKSKswpXxkk8dPQUTDPZ4SGclJzE0Yle/utQ4AJM
vMYK/ceaMC56CvEfoUmH3o2H0Y8MRhEE0hQ7xmIWlTfgJx256ToXG3auNVWs2Ax2
cwcAYarHaBAYoljBMyCqMWW+7nLCXoI0bAb0O4f2X2I6zpD2MsE7obLQA6l6x/X+
og/rYbYh7rDgqPyhAU8tJicCAwEAAQ==
-----END PUBLIC KEY-----
EOF

RUN ...

with apko

apko

contents:
  keyring:
+    - https://wolfi.shyim.me/php-signing.rsa.pub
    - https://packages.wolfi.dev/os/wolfi-signing.rsa.pub
  repositories:
+    - https://wolfi.shyim.me
    - https://packages.wolfi.dev/os
  packages:
    - wolfi-base
    - frankenphp-8.3

afterwards all packages of this repository can be installed with apk add <package> or apko.

Available Packages

There is no web package browser. The easiest way is to use apk search to find the package you need.

docker run --rm -it ghcr.io/shyim/wolfi-php/base:latest
apk update
apk search <term>

FrankenPHP

This repository contains FrankenPHP for PHP 8.2 and 8.3. The package is called frankenphp-8.2 and frankenphp-8.3.

A basic example to use FrankenPHP in your Dockerfile:

FROM ghcr.io/shyim/wolfi-php/base:latest

RUN <<EOF
set -eo pipefail
apk add --no-cache \
    frankenphp-8.2 \
    php-frankenphp-8.2
adduser -u 82 www-data -D
EOF

WORKDIR /var/www/html
USER www-data
EXPOSE 8000

ENTRYPOINT [ "/usr/bin/frankenphp", "run" ]
CMD [ "--config", "/etc/caddy/Caddyfile" ]

After building the image, you can run the container with docker run -p 8000:8000 <image> and it should show a PHP info page.

To learn more about FrankenPHP, see here

Base images

We provide also base image for ready to start without touching configuration:

• FrankenPHP
• Nginx + PHP-FPM
• Caddy + PHP-FPM
• FPM standalone

Pinning package versions

To pin the version of a package, you can specify the version in the apk add command. Example could be:

apk add --no-cache php-8.2=8.2.17-r0

To get the exact current version of a package, you can run apk info php-8.2.

Package updates

We have a Bot which checks every hour of there is a package update, and opens a PR if there is a new version available.

Examples

• Symfony Demo with FrankenPHP
• Symfony Demo with FPM
• Symfony Demo with Nginx
• Symfony Demo with Caddy

Thanks to Namespace.so

Thanks to namespace.so for sponsoring their fast GitHub runners. Checkout namespace.so if you need better GitHub runners or Docker remote builders.