agilitycisltd/laravel-base

PHP 基础扩展Docker镜像

镜像概述

本镜像为PHP运行环境镜像，特点是仅包含基本扩展，所有构建依赖在构建过程结束时已被移除，确保镜像轻量级且最小化。适用于对镜像体积有要求、需要精简PHP运行环境的场景，如需扩展功能，可自行安装构建依赖并在使用后清理。

核心功能与特性

• 仅含基本扩展：镜像仅包含PHP运行所需的基础扩展，避免冗余组件。
• 构建依赖已清理：构建过程中使用的依赖在结束时被彻底移除，显著减小镜像体积。
• 支持功能扩展：允许用户根据项目需求安装额外扩展，需自行管理构建依赖的安装与后续清理。
• OPcache预配置：默认集成并优化配置OPcache参数，提升PHP代码执行性能。

使用场景

• 轻量级PHP应用部署，需最小化镜像体积的环境。
• 对镜像安全性有要求，需减少不必要依赖的生产或测试场景。
• 需要自定义扩展安装，且希望自主控制依赖管理的PHP项目。

使用方法

扩展安装说明

如需为项目安装更多PHP扩展，需注意以下步骤：

1. 手动安装扩展所需的构建依赖（如编译器、库文件等）；
2. 安装目标扩展；
3. 扩展安装完成后，务必移除已安装的构建依赖，以保持镜像精简。

配置说明

环境变量

镜像支持通过以下环境变量配置PHP OPcache参数，可根据实际需求调整：

PHP_OPCACHE_ENABLE: 1  # 是否启用OPcache，默认1（启用）
PHP_OPCACHE_ENABLE_CLI: 1  # 是否为CLI模式启用OPcache，默认1（启用）
PHP_OPCACHE_VALIDATE_TIMESTAMPS: 0  # 是否验证文件时间戳，默认0（禁用，适合生产环境）
PHP_OPCACHE_MAX_ACCELERATED_FILES: 10000  # 最大加速文件数量，默认10000
PHP_OPCACHE_MEMORY_CONSUMPTION: 192  # OPcache内存消耗（MB），默认192
PHP_OPCACHE_MAX_WASTED_PERCENTAGE: 10  # 最大允许浪费内存百分比，默认10

# PHP 8及以上版本特有配置
PHP_OPCACHE_JIT: tracing  # JIT编译模式，默认tracing（跟踪模式）
PHP_OPCACHE_JIT_BUTTER_SIZE: 100M  # JIT缓冲区大小，默认100M

注意事项

• 每次向master分支推送代码或合并PR时，将触发所有版本和变体镜像的重建。请在推送和合并前确保充分测试，避免不必要的构建资源消耗。