v3.2.0

🤩 What's new

• Docker Healthchecks are now natively supported (by @jaydrogers in #364)
• FPM debug mode been greatly improved (by @jaydrogers in #362)

❤️ Native Docker Health Checks

This is a HUGE step forward for some pretty exciting things that we have coming up. Getting accurate container health is crucial in ensuring uptime and zero-downtime deployments. All container health is now natively supported and able to be dynamically changed with HEALTHCHECK_PATH (default: "/healthcheck").

You can set HEALTHCHECK_PATH=/up to monitor the Laravel 11 Health Check endpoint. 🥳

More about how this works here:

🐛 Bug fixes

• We fixed a sneaky bug where Apache containers would fail to start if the container was cached (#365)

Full Changelog: v3.1.1...v3.2.0

v3.1.1

Fixes

• Triggering rebuild to fix #358

Full Changelog: v3.1.0...v3.1.1

v3.1.0

⏫ Version updates

• Update Nginx Unit version to 1.32.1 by @DvDty in #344
• Updated php-installer to 2.2.14

🐛Fixes

• Resolve Unit Port Expose Settings & Upgrade PHP Extension Installer to 2.2.14 by @jaydrogers in #356

📝Doc fixes

• Fixed typo in docs by @angus-mcritchie in #350

🎉 New Contributors

• @angus-mcritchie made their first contribution in #350
• @DvDty made their first contribution in #344

Full Changelog: v3.0.2...v3.1.0

v3.0.2

Fixes

• Resolved issue where SHOW_WELCOME_MESSAGE was not working

CI/CD

• Improve automated site previews by @jaydrogers in #338
• Change to upload to GHCR for PRs only by @jaydrogers in #340

Full Changelog: v3.0.1...v3.0.2

v3.0.1

🐛 Fixes

• Fixed a number of typos in docs and code (#337)
• Fixed typo in names of:
  • Renamed UNIT_PROCCESSES_IDLE_TIMEOUT → UNIT_PROCESSES_IDLE_TIMEOUT
  • Renamed UNIT_PROCCESSES_MAX → UNIT_PROCESSES_MAX
  • Renamed UNIT_PROCCESSES_SPARE → UNIT_PROCESSES_SPARE

Full Changelog: v3.0.0...v3.0.1

v3.0.0

🚀 HUGE RELEASE: New Features

We've been busy overhauling our PHP Docker Images to make them more production-ready and easier to use. Here are some of the new features we've added:

Caution

This release has a number of breaking changes (all for the good). If you're still using our Ubuntu-based images, you can continue to use our previous version by using the 2.2.1 release tag (*-v2.2.1). This can help buy you some time for your migration.

Read our v2 to v3 migration guide for more details →

• Based on official PHP Images - We're now building an improved developer experience on top of the official PHP Docker images.
• Unprivileged user by default - We're now running our images as an unprivileged user by default. This is a huge step forward in security and compatibility.
• PHP 8.3 support - We're now shipping the latest and greatest.
• Pin to the exact minor version - Pin your app to the exact minor version of PHP that you want to use. This means you can pin to 8.2.12 instead of 8.2.
• Easier start up script customization - We now have a folder called /etc/entrypoint.d that allows you to easily customize your container with scripts. Just put them in numerical order and we'll execute any shell script you want. No S6 Overlay knowledge required.
• Expanded Laravel Automations - We added automations to run config:cache, route:cache, view:cache, event:cache, migrate --force --isolated, and storage:link
• NGINX Unit Support - We're offering NGINX Unit as a variation as an alternative to PHP-FPM. This allows you to run PHP applications without the need for a webserver like NGINX or Apache to run with PHP-FPM.
• Available on GitHub Packages - We're now publishing our images to GitHub Packages. This means you can use our images without needing to authenticate with Docker Hub.

🤩 Learn more & Get Started

Read the differences between our images vs others →

New Contributors

• @flemming-petersen made their first contribution in #204
• @josiasmontag made their first contribution in #294
• @jbxonline made their first contribution in #321

Full Changelog: v2.2.1...v3.0.0

v3.0.0-beta7

✨ What's new

• Set Unit's processes to be dynamic by default (like we do for FPM). Adds new variables:
  • UNIT_PROCCESSES_IDLE_TIMEOUT (default: 30)
  • UNIT_PROCCESSES_MAX (default: 20)
  • UNIT_PROCCESSES_SPARE (default: 2)

🐛Fixes

The changes above fix this issue with the default configuration:

• #331

Full Changelog: v3.0.0-beta6...v3.0.0-beta7

v3.0.0-beta6

Fixes

• Fixed a GitHub Actions syntax error 😅🔥🔥🔥

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

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