pixartprinting/php

PHP Docker镜像文档

镜像概述和主要用途

本镜像为经过测试、生产就绪的PHP Docker镜像，提供多种标签选择以适配不同的PHP版本需求和系统基础环境。镜像支持固定版本PHP部署及轻量级/稳定系统基础选择，适用于各类生产环境中的PHP应用部署场景。

核心功能和特性

版本与标签说明

• 8.2：固定为PHP 8.1版本的镜像
• 8.1：固定为PHP 8.1版本的镜像
• 8.0.5：固定为PHP 8.0.5版本的镜像
• 7.4：固定为PHP 7.4版本的镜像，无主要版本更新
• alpine：基于Alpine Linux的轻量级镜像，包含最新当前版本PHP
• latest：基于Debian系统的镜像，包含最新当前版本PHP
• stretch：基于Debian Stretch系统的镜像，支持PHP 7.0

使用场景和适用范围

• 生产环境部署：适用于需要稳定、可靠PHP运行环境的生产级应用
• 版本特定需求：需固定PHP 7.0、7.4、8.0.5、8.1等版本时，可选择对应标签
• 轻量级部署：对镜像体积有严格要求的场景，推荐使用alpine标签（基于Alpine Linux，体积更小）
• 系统基础偏好：需使用Debian系统基础（软件包更丰富、兼容性更好）时，可选择latest或stretch标签
• 旧版本兼容：需部署依赖PHP 7.0的 legacy 应用时，可选择stretch标签

详细使用方法和配置说明

拉取镜像

使用docker pull命令拉取指定标签的镜像：

bash
# 拉取基于Alpine的轻量级最新PHP镜像
docker pull docker.xuanyuan.run/[镜像名称]:alpine

# 拉取固定PHP 8.1版本的镜像
docker pull docker.xuanyuan.run/[镜像名称]:8.1

# 拉取基于Debian的最新PHP镜像
docker pull docker.xuanyuan.run/[镜像名称]:latest

# 拉取支持PHP 7.0的Debian Stretch镜像
docker pull docker.xuanyuan.run/[镜像名称]:stretch

运行容器

基础运行示例

bash
# 查看PHP版本（交互式运行，退出后容器自动删除）
docker run -it --rm [镜像名称]:8.1 php -v

# 运行PHP内置Web服务器（暴露80端口，挂载当前目录为应用目录）
docker run -d -p 80:80 -v $(pwd):/var/www/html [镜像名称]:latest php -S 0.0.0.0:80 -t /var/www/html

Docker Compose配置示例

创建docker-compose.yml文件，部署PHP应用：

yaml
version: '3.8'
services:
  php-app:
    image: docker.xuanyuan.run/[镜像名称]:8.1
    ports:
      - "8080:80"  # 映射宿主机8080端口到容器80端口
    volumes:
      - ./app:/var/www/html  # 挂载本地应用代码到容器内
    command: php -S 0.0.0.0:80 -t /var/www/html  # 启动内置Web服务器
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

配置说明

自定义PHP配置

可通过挂载自定义PHP配置文件来自定义PHP运行参数，常见配置路径：

• 主配置文件：/usr/local/etc/php/php.ini
• 扩展配置目录：/usr/local/etc/php/conf.d/

示例：挂载本地php.ini到容器：

bash
docker run -v $(pwd)/php.ini:/usr/local/etc/php/php.ini [镜像名称]:latest

环境变量

根据PHP应用需求，可通过-e参数传递环境变量，例如设置时区：

bash
docker run -e TZ=Asia/Shanghai [镜像名称]:alpine

注：具体支持的环境变量需根据镜像内置PHP配置确定，建议结合应用需求自定义。