v3.0.0-beta5

🚀 What's new

• Added ability to select images based on the GitHub Repository Version (#323)

• Add new variable of SHOW_WELCOME_MESSAGE to reduce console ouput (#319)

🐛 Fixes

• Add check for Unit custom certs by @jbxonline in #321
• Fixed Debug Mode with unprivileged images (#327)

New Contributors

• @jbxonline made their first contribution in #321

Full Changelog: v3.0.0-beta4...v3.0.0-beta5

v3.0.0-beta4

What's Changed

Caution

Even if you're not running these beta images, we strongly encourage you to prepare for the v3 release and reading our migration guide: https://serversideup.net/open-source/docker-php/docs/guide/migrating-from-v2-to-v3

This release contains the final breaking changes before a production release.

Background

In order to improve container security and compatibility, we have moved to running the containers as www-data by default.

⚠️ BREAKING CHANGES: How this affects you

• Instead of running things as root by default, everything runs as www-data to improve security, users experience, and compatibility with other hosts/orchestrators
• FPM-NGINX, FPM-Apache, & Unit now listen on 8080 and 8443 by default
• If you're installing extensions or customizing the image, you'll likely need to run USER root then perform your action before dropping back to USER www-data (Learn more about file permissions)
• The syntax for docker-php-serversideup-set-id has changed to uid:gid

Getting the images to accept requests on 80 and 443

Simply use Docker's port methods to forward correctly:

docker run --rm -e SSL_MODE=mixed -p 80:8080 -p 443:8443 serversideup/php:beta-8.3-fpm-nginx

What's changed

• Change execution to be unprivileged by @jaydrogers in #311

Read the migration guide

We've put together this migration guide and checklist: https://serversideup.net/open-source/docker-php/docs/guide/migrating-from-v2-to-v3

Full Changelog: v3.0.0-beta3...v3.0.0-beta4

v3.0.0-beta3

What's Changed

• Improve release process by @jaydrogers in #282
• Install opcache extension by default by @josiasmontag in #294
• Improve Laravel Migration support for SQLite & Laravel 11 by @jaydrogers in #302
• Set default NGINX values for "fastcgi_buffers" and "fastcgi_buffer_size" by @jaydrogers in #305

⚠️ Potential Breaking Changes Coming

Caution

There may be a breaking change coming up for fpm-nginx and fpm-apache images.

In order to dramatically improve container security and preventing "file permission hell" with new users, we may be changing the default ports for Apache and NGINX so we can run this as the www-data user by default. See this post for more details (open for comment): #179 (comment)

Be sure to chime in and subscribe to releases for the latest news.

New Contributors

• @josiasmontag made their first contribution in #294

Full Changelog: v3.0.0-beta2...v3.0.0-beta3

v3.0.0-beta2

😅 Getting ready for the upgrade

Caution

If you're not already aware, there are MAJOR improvements coming in v3 over v2. Unfortunately this required some breaking changes. Read more about the beta here →

Make sure you're aware of what's coming up soon. If you fail to take action, you will have issues if your application automatically updates.

In short make sure you understand this guide BEFORE the new v3 gets launched:
Migration guide from v2 to v3 →

🚀 New Features (from beta1 → beta2)

• fpm-apache is now available

⚠️ Breaking Change (from beta1 → beta2)

• LOG_LEVEL conflicted with Laravel (#277), so we changed it to LOG_OUTPUT_LEVEL
• The release-v3-0.docker-php.pages.dev preview site has been merged into main. Everything is now located at https://serversideup.net/open-source/docker-php/

🛠️ Dependency updates

• Bumped docker-php-extension-installer to 2.2.1

v2.2.1

🧼 Cleanup

• An explicit S6 Overlay version can now be set in src/cli/Dockerfile

v2.2.0

🤩 New Documentation Site

Our biggest focus of this release was creating a Documentation Site that is managed directly in GitHub.

👉 The site is available at: https://serversideup.net/open-source/docker-php/

How it works

• The documentation site is run with Nuxt Content v2
• All documentation site items are located under /docs
• It is very easy for someone to run this locally with yarn install & yarn dev

Deployment

• When someone opens a PR, a documentation preview URL is created with CloudFlare pages as a preview
• When that PR is merged to main, the site is deployed to CloudFlare pages in the production environment
• We use a CloudFlare Worker to proxy https://serversideup.net/open-source/docker-php/ to CloudFlare pages

Full Project Detail

You can see the full project detail here. This was created and managed by Bugflow.

✨ Docker Image Enhancements

• Silence start up banner if S6_LOGGING is set to 1 (#126)
• Isolate migrations to allow multiple containers to preform Laravel migrations correctly (#129)

🙌 First Time Contributor(s)

• @bluehaoran

v2.1.0

✨ Enhancements

• Added php-redis package in PHP 8.2

🐛 Fixes

• Fixed simple typo in container startup

v2.0.2

(This version contains a minor fix in the tagging process from v2.0.1 -- no changes to the docker images have been made)

✨ Enhancements

• There we no changes to the Docker images from v2.0.0. This is only a cleanup release on how Docker images are built & tagged

🧼 Cleanup

• Adjusted CI workflow to have beta images reference the main branch
• Configured production Docker images to only be built on "release"

Related PRs

• See this PR for more detail: #91

v2.0.1

(This release had a minor tagging error on production release. No changes were made to the Docker images. See v2.0.2 for latest details)

v2.0.0

✨ Enhancements

• Added PHP 8.2 support
• Added Multi-arch docker image support 💪
• Use Ubuntu 22.04 as base image
• Added healthchecks on initialization (#75)
• Upgrade all scripts and init structures to use S6 Overlay 3.x standards
• Allow openbase_dir to be controlled by an environment variable
• Added php_intl package (#56)
• Added bcmath package (#58)
• Allow SSL to be configured with SSL_MODE (#79)

🧼 Cleanup

• Eliminated all development dependencies (other than having Docker installed)
• Reorganized repository to have all source code in /src directory
• Improved Verbosity to be less noisy, but configurable by the S6_VERBOSITY variable
• Improved build script to accept arguments on which versions to build

🐛 Fixes

• Prevent PHP flags from being too strict (#45)
• Fixed initialization order of PHP-FPM services (https://community.serversideup.net/t/502-bad-gateway-on-google-cloud-run/700)
• Fixed GPG signing issue with Ondrej repos
• Fixed "laravel-automations" script where it was not passing environment variables set via docker run (View Related Discussion →)

😅 Migrating from V1

• There are no breaking changes if you did not make any major customization to the image 🎉. If you made a lot of custom scripts with S6 Overlay, check out their migration guide from S6 Overlay V2 → V3.