PHP CLI 镜像文档

概述

PHP CLI（Command Line Interface）镜像提供独立的PHP命令行运行环境，专为在命令行模式下执行PHP脚本和应用程序设计。该镜像专注于非Web场景，无需依赖Web服务器组件，结构轻量，适合各类命令行任务执行。

核心功能与特性

• 多PHP版本支持：提供7.4+系列多个PHP版本标签（如7.4、8.0、8.1、8.2、8.3等），满足不同项目版本需求。
• 内置常用扩展：默认包含PHP核心扩展及高频使用扩展（如mbstring、json、curl、xml、zip等），减少基础配置工作。
• 轻量级设计：基于***PHP镜像精简构建，去除Web服务器相关组件，镜像体积更小，启动速度更快。
• 灵活定制能力：支持通过Dockerfile或运行时命令安装额外扩展、调整PHP.ini配置，适应个性化需求。
• 跨平台兼容：可在Linux、macOS、Windows等主流操作系统的Docker环境中运行。

使用场景

• 命令行脚本执行：运行数据处理、文件操作、日志分析等各类PHP命令行脚本。
• 自动化任务：作为cron定时任务、周期性数据同步、报表生成等自动化流程的执行环境。
• PHP开发调试：本地开发中快速测试PHP代码片段、调试命令行应用逻辑。
• CI/CD流程集成：在持续集成/部署流程中运行PHP单元测试、代码检查、构建脚本等环节。
• 微服务组件：作为微服务架构中的独立命令行服务，处理特定业务逻辑（如消息队列消费、异步任务处理）。

使用方法

1. 获取镜像

通过Docker Hub拉取指定PHP版本的镜像，标签格式为php:<版本>-cli：

bash
# 拉取PHP 8.2版本（示例）
docker pull php:8.2-cli

# 拉取特定小版本（推荐生产环境使用，避免版本变动）
docker pull php:8.2.18-cli

查看所有可用版本标签：***PHP Docker镜像标签页

2. 基本使用

2.1 运行PHP命令

直接执行PHP命令（如查看版本信息）：

bash
docker run --rm php:8.2-cli php -v

输出示例：

PHP 8.2.18 (cli) (built: Apr 12 2024 10:14:33) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.18, Copyright (c) Zend Technologies

2.2 执行本地PHP脚本

挂载本地脚本目录并执行：

bash
# 当前目录下存在script.php文件
docker run --rm -v $(pwd):/app -w /app php:8.2-cli php script.php

参数说明：

• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录
• -w /app：设置容器工作目录为/app
• php script.php：容器内执行的命令（运行script.php脚本）

3. 高级配置

3.1 安装额外扩展

通过docker-php-ext-install命令安装扩展，支持临时安装或构建自定义镜像两种方式：

临时安装（单次生效）：

bash
# 安装gd扩展（需先安装系统依赖）
docker run --rm php:8.2-cli bash -c "apt-get update && apt-get install -y libpng-dev \
    && docker-php-ext-install gd && php -m | grep gd"

构建自定义镜像（持久化扩展）： 创建Dockerfile：

dockerfile
FROM php:8.2-cli
# 安装gd扩展及系统依赖
RUN apt-get update && apt-get install -y libpng-dev \
    && docker-php-ext-install gd \
    # 清理apt缓存，减小镜像体积
    && apt-get clean && rm -rf /var/lib/apt/lists/*

构建并使用：

bash
docker build -t my-php-cli .
docker run --rm my-php-cli php -m | grep gd  # 验证扩展安装

3.2 配置PHP.ini

通过挂载自定义php.ini文件覆盖默认配置：

bash
# 假设本地存在自定义php.ini（路径：./php.ini）
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini php:8.2-cli php --ini

执行后可查看加载的配置文件路径，确认自定义php.ini已生效。

3.3 环境变量使用

通过-e参数传递环境变量，在PHP脚本中通过getenv()或$_ENV获取：

bash
# 传递环境变量并在脚本中使用
docker run --rm -e APP_ENV=production php:8.2-cli php -r "echo 'Environment: ' . getenv('APP_ENV');"

4. Docker Compose 配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  php-cli:
    image: php:8.2-cli
    volumes:
      - ./scripts:/app  # 挂载本地脚本目录到容器/app
    working_dir: /app
    environment:
      - APP_ENV=development
      - DB_HOST=mysql  # 可与其他服务（如数据库）联动
    command: ["php", "worker.php"]  # 默认执行的worker脚本
    depends_on:
      - mysql  # 依赖mysql服务（需在compose中定义mysql服务）

  # 示例：联动mysql服务（如需数据库支持）
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=test_db

启动服务：

bash
docker-compose up

版本支持

主要支持的PHP版本标签：

• php:7.4-cli（维护中，安全更新至2024年11月）
• php:8.0-cli（维护中，安全更新至2025年11月）
• php:8.1-cli（活跃支持，安全更新至2026年11月）
• php:8.2-cli（活跃支持，安全更新至2027年11月）
• php:8.3-cli（最新稳定版，活跃支持中）

详细版本生命周期及安全支持信息可参考PHP***支持政策。

注意事项

• 镜像默认不包含Web服务器组件（如Apache、Nginx），仅提供CLI运行环境。
• 生产环境建议使用具体小版本标签（如8.2.18-cli），避免因版本自动更新导致兼容性问题。
• 敏感配置（如数据库密码、API密钥）应通过环境变量或安全配置文件挂载传递，避免硬编码在镜像中。
• 长时间运行的任务（如守护进程）需确保容器启动命令不会退出（可通过php -S或循环脚本实现）。