huedawn/php-ext

huedawn/php-ext 镜像文档

镜像概述和主要用途

该镜像基于官方PHP Docker镜像扩展而来，预安装了mysqli、intl和zip扩展，提供两种核心使用方式：作为Apache Web服务器部署PHP Web应用，或作为CLI环境运行PHP脚本。使用时需根据场景选择对应标签（如latest-apache用于Web服务，latest-cli用于命令行脚本）。

核心功能和特性

• 扩展官方兼容性：基于官方PHP镜像构建，确保与标准PHP环境兼容
• 关键扩展集成：包含mysqli（MySQL数据库连接）、intl（国际化支持）、zip（压缩文件处理）扩展
• 双模式支持：同时支持Apache Web服务器模式和CLI脚本运行模式
• 灵活部署：适配Dockerfile构建、Docker Compose编排及终端直接运行等多种部署方式

使用场景和适用范围

适用于需要以下功能的PHP开发与运行场景：

• 开发依赖mysqli扩展的MySQL数据库驱动Web应用
• 运行需intl扩展的国际化PHP程序（如多语言、区域格式化）
• 处理包含zip压缩文件的PHP脚本任务
• 快速搭建本地PHP开发环境或临时执行PHP脚本

详细的使用方法和配置说明

Apache模式

用于部署PHP Web应用，通过Apache服务器提供HTTP访问能力。

使用Dockerfile构建应用镜像

创建自定义Dockerfile，基于该镜像打包应用代码：

dockerfile
FROM huedawn/php-ext:latest-apache
LABEL Name=my-apache-app Version=0.0.1
COPY "${PWD}" /var/www/html  # 将当前目录代码复制到Apache网站根目录

使用Docker Compose编排服务

通过compose.yaml配置本地开发环境，实现代码热更新与端口映射：

yaml
name: my-apache-app

services:
  home:
    image: huedawn/php-ext:latest-apache
    volumes:
      - type: bind
        source: "$PWD"  # 本地当前目录
        target: /var/www/html  # 容器内Apache网站根目录
    ports:
      - "80:80"  # 将容器80端口映射到主机80端口

终端直接运行容器

通过docker run命令快速启动单容器Web服务：

console
docker run -d -p 80:80 --name my-apache-app -v "$PWD":/var/www/html huedawn/php-ext:latest-apache

参数说明：

• -d：后台运行容器
• -p 80:80：端口映射（主机端口:容器端口）
• --name my-apache-app：指定容器名称
• -v "$PWD":/var/www/html：挂载本地代码目录到容器网站根目录

CLI模式

用于直接执行PHP脚本，适合命令行工具、定时任务或临时脚本运行。

终端执行PHP脚本

通过docker run命令在CLI环境中运行指定PHP脚本：

console
docker run -it --rm --name my-php-script -v "$PWD":/usr/src/myphpapp -w /usr/src/myphpapp huedawn/php-ext:latest-cli php my-script.php

参数说明：

• -it：交互式终端模式（支持脚本输入输出）
• --rm：脚本执行完毕后自动删除容器
• --name my-php-script：指定容器名称
• -v "$PWD":/usr/src/myphpapp：挂载本地脚本目录到容器工作目录
• -w /usr/src/myphpapp：设置容器工作目录
• php my-script.php：执行指定PHP脚本（替换为实际脚本文件名）