Docker-PHP V4.0.0-beta1 发布!

Docker-PHP v4.0.0-beta1 发布

容器化让部署变得轻松，但总有一些小细节能让整个流程更丝滑。今天，我要和大家聊聊 Serversideup 的 docker-php 项目最新发布的 v4.0.0-beta1 版本。这是一个 beta 预发布版，但它带来的变化让我眼前一亮——从 FrankenPHP 的增强支持，到 Laravel 自动化脚本的升级，再到各种细致的 QoL（Quality of Life）改进，都在为生产级部署铺路。如果你像我一样，热衷于用 Docker 构建高效的 PHP 应用，那这个版本绝对值得一试！

FrankenPHP 的华丽变身：更安全、更灵活的图像变体

首先，让我们来谈谈这个版本的最大亮点：FrankenPHP 图像的全面升级。FrankenPHP 作为一种高性能的 PHP 运行时，已经在社区中崭露头角，而 docker-php v4.0.0-beta1 则在官方基础上进行了深度优化。这些图像默认以非特权模式运行（作为 www-data 用户），监听 8080（HTTP）和 8443（HTTPS）端口，这大大提升了安全性。想象一下，在 Kubernetes 等编排器中零停机部署的场景，这些设计简直是为大规模生产环境量身定制。

更酷的是，原生健康检查端点现在超级智能！你可以通过 $HEALTHCHECK_PATH 环境变量自定义路径，默认是 Caddy 的 /healthcheck，但也能轻松切换到 Laravel 的 /up。默认的 Caddyfile 也超级强大：内置 CloudFlare 支持、性能缓存规则、安全头配置、灵活日志输出，甚至还能简单生成自签名证书（或用 Let's Encrypt）。它假设 TLS 终止在外部进行，这让扩展变得更容易。

此外，这个版本支持更多操作系统变体，从源代码编译而成。标签格式是 {php-minor-version}-{variation}-{os-version}，支持的 OS 包括 Debian Trixie (13)、Bookworm (12)、Alpine 3.22 和 3.21。无论你是 Debian 派还是 Alpine 轻量主义者，都能找到适合的镜像。总之，这些变化让 FrankenPHP 在 docker-php 中真正“活”了起来，成为容器化 PHP 的新宠。

Laravel 自动化脚本大升级：从“优化”到“迁移模式”

如果你是 Laravel 开发者，这个版本的 Laravel 自动化脚本重构绝对是福音。以前的脚本已经很方便了，现在它更智能、更贴合最佳实践。

• 默认运行 php artisan optimize ：通过 AUTORUN_LARAVEL_OPTIMIZE（默认 true）自动执行优化命令，兼容之前的单个标志如 AUTORUN_LARAVEL_ROUTE_CACHE。这意味着你的应用启动时就能享受到路由缓存和配置优化的好处，性能直线上升！
• 引入“迁移模式”：用 AUTORUN_LARAVEL_MIGRATION_MODE 控制迁移行为： 还能指定数据库连接（如 AUTORUN_LARAVEL_MIGRATION_DATABASE=mysql,pgsql），完美支持多租户应用。想顺便跑种子数据？设置 AUTORUN_LARAVEL_MIGRATION_SEED=true 就行。
  • default：标准的前向迁移（php artisan migrate）。
  • fresh：删除所有表后重新迁移（php artisan migrate:fresh）。
  • refresh：回滚并重新运行迁移（php artisan migrate:refresh）。
• 调试更友好 ：开启 AUTORUN_DEBUG=true，就能看到详细输出，排查问题超方便。

这些改进让容器启动像魔法一样顺畅，尤其在 CI/CD 管道中，节省了我无数调试时间。

新环境变量与 NGINX 监听协议：精细控制一触即发

v4.0.0-beta1 引入了一大波新环境变量，让你对 PHP 和 NGINX 的配置如臂使指。举例来说：

• PHP 相关：如 PHP_OPCACHE_JIT=off（JIT 默认关闭）、PHP_MAX_INPUT_VARS=1000（输入变量上限）、PHP_REALPATH_CACHE_TTL=120（路径缓存 TTL），这些都能通过环境变量微调，优化你的应用性能。
• NGINX 专属：NGINX_LISTEN_IP_PROTOCOL=all（默认支持 IPv4/IPv6），设为 ipv6 或 ipv4 就能针对 IPv6-only 集群优化。NGINX_CLIENT_MAX_BODY_SIZE=100M 也默认上调了上传限制。

还有 PHP_FPM_PM_STATUS_PATH=/status 用于 FPM 状态监控，以及 AUTORUN_LARAVEL_MIGRATION_FORCE=true 强制迁移。这些变量的作者来自社区大牛，如 @jaydrogers 和 @aSeriousDeveloper，体现了开源协作的魅力。

质量提升与 Bug 修复：小细节见真章

除了大功能，这个版本在用户体验上也下足了功夫。

• 健康检查优化：启动期（start-period）设为 60s，间隔 3s，超时 3s，重试 3 次，正常间隔 10s。这让容器健康状态更准确，避免了假阳性。
• 启动脚本重设计：entrypoint.d 脚本现在优雅处理 exit 0，容器启动信息脚本也更清晰。
• 文件权限工具升级：docker-php-serversideup-set-file-permissions 现在自动检测服务，添加 --dir 参数支持多目录。
• 静默健康检查日志：fpm-nginx 和 fpm-apache 变体下，健康检查请求不再刷屏访问日志。

Bug 修复方面：

• 修复了所有镜像中的会话配置弃用警告（session.sid_bits_per_character 等）。
• S6-based 镜像重添 docker-serversideup-php-s6-init 脚本。
• fpm-nginx 修复了相对重定向（absolute_redirect off）和 Symfony 资产映射的 svgz Bug，还修了 Alpine 实例的权限通知。
• fpm-apache 添加了 Referer 和 User Agent 到访问日志。

此外，install-php-extensions 脚本更新到 v2.9.11，确保依赖更稳定。

结语：Beta 版已就位，生产力即将起飞

docker-php v4.0.0-beta1 虽是 beta，但它标志着项目向 v4 的跃进——更注重生产级部署、社区反馈和性能优化。新贡献者如 @robsontenorio 和 @dlundgren 的加入，也让这个项目更具活力。如果你正在用 Docker 跑 PHP，尤其是 Laravel 项目，不妨拉取这个镜像试试（记得备份！）。未来正式版会更稳，期待它在 Kubernetes 和云原生场景中的大放异彩。

想深入了解？直接去 GitHub 仓库瞧瞧 changelog。如果你有反馈，欢迎在评论区分享你的容器化心得。保持 coding，PHP 容器世界，等你探索！