通用型PHP镜像文档

镜像概述和主要用途

本镜像源自thecodingmachine的Docker仓库，是一套开发者友好的通用PHP镜像，旨在简化PHP应用的Docker化部署。它提供高度灵活的配置选项，支持多种运行环境和扩展管理，同时解决了Docker常见的文件权限问题，确保在Linux、Windows、MacOS系统上稳定运行。

核心功能和特性

灵活的扩展与配置管理

• 通过环境变量轻松启用/禁用PHP扩展（如PHP_EXTENSIONS=mysqli,pdo_mysql）
• 支持通过环境变量直接修改php.ini配置（如PHP_INI_memory_limit=256M、PHP_INI_date_timezone=Asia/Shanghai）

多样化类型与变体

• 两种镜像类型：
  • slim：轻量级，无预加载扩展，适合资源受限场景
  • fat：全功能型，内置常用PHP扩展，满足大多数应用需求
• 三种运行变体：
  • cli：命令行接口，适用于脚本执行、定时任务等
  • apache：集成Apache服务器，直接提供Web服务
  • fpm：FastCGI进程管理器，适合与Nginx等反向代理配合使用

fat镜像增强功能

• 任务调度：内置Supercronic（Cron兼容任务运行器），可通过环境变量配置定时任务（如SUPERCRONIC_TASK_1="0 2 * * * /app/backup.sh"）
• 依赖管理：预装Composer（PHP依赖管理工具）及Prestissimo（Composer并行下载插件），大幅加速依赖安装

全栈支持与兼容性

• NodeJS集成：所有变体可通过NODE_VERSION环境变量选择安装NodeJS，方便构建前端静态资源
• 跨平台兼容：专门优化文件权限处理，在Linux、Windows、MacOS系统上均通过严格测试

使用场景和适用范围

• 开发环境：快速搭建本地PHP开发环境，支持灵活配置扩展和依赖管理
• 生产部署：根据应用需求选择slim（轻量）或fat（全功能）类型，搭配apache/fpm变体部署Web应用
• 定时任务：通过fat镜像的Supercronic功能处理周期性任务（如数据备份、日志清理）
• 全栈项目：需同时处理PHP后端和NodeJS前端构建的项目（如Laravel+Vue.js应用）

使用方法和配置说明

基础使用示例

1. 运行CLI变体（查看PHP版本）

docker run --rm thecodingmachine/php:8.2-cli-fat php -v

2. 启动Apache服务（映射8080端口）

docker run -p 8080:80 thecodingmachine/php:8.2-apache-slim

扩展与PHP配置示例

启用mysqli扩展并设置内存限制：

docker run -e PHP_EXTENSIONS=mysqli -e PHP_INI_memory_limit=256M thecodingmachine/php:8.2-cli-fat

Cron任务配置（fat镜像）

定义每天凌晨2点执行备份脚本：

docker run -e SUPERCRONIC_TASK_1="0 2 * * * /app/backup.sh" thecodingmachine/php:8.2-cli-fat

NodeJS安装配置

指定安装NodeJS 18：

docker run -e NODE_VERSION=18 thecodingmachine/php:8.2-cli-fat node -v

完整文档参考

更多配置细节（如PHP版本支持、高级扩展配置等），请查看官方完整文档：thecodingmachine/docker-images-php