vemcogroup/php-cli Docker 镜像 - 轩辕镜像

php-cli Docker 镜像文档

镜像概述

php-cli 镜像提供了 PHP 命令行接口（Command Line Interface）的轻量级 Docker 环境，允许用户在无需完整 Web 服务器配置的情况下，直接在命令行中执行 PHP 脚本。该镜像基于官方 PHP 基础镜像构建，旨在简化 PHP 命令行应用的部署与运行流程，适用于开发、测试及生产环境中的脚本执行场景。

核心功能与特性

• 轻量级设计：基于精简基础镜像（如 Alpine Linux），减少镜像体积，提升启动速度
• 多版本支持：提供多种 PHP 版本标签（如 7.4-cli, 8.1-cli, 8.2-cli 等），适配不同项目需求
• 原生 PHP 功能：完整支持 PHP 命令行模式下的核心功能，包括脚本执行、交互式 shell、代码 lint 检查等
• 扩展性：可通过自定义配置或安装扩展，满足特定项目对 PHP 扩展的依赖需求
• 环境隔离：容器化运行环境确保 PHP 脚本执行不受主机系统配置影响，提高环境一致性

适用场景

• 命令行脚本执行：运行定时任务脚本（如数据同步、日志处理）、后端服务脚本等
• 开发与调试：本地开发环境中快速测试 PHP 代码片段或脚本逻辑
• CI/CD 流程：集成到持续集成/持续部署流程，执行自动化测试、代码检查或构建任务
• 微服务组件：作为微服务架构中的轻量级任务执行单元，处理后台计算或数据处理任务

使用方法与配置说明

基本使用

通过 docker run 命令快速启动 PHP 命令行环境：

bash
# 查看 PHP 版本
docker run --rm php-cli:latest php -v

# 运行本地 PHP 脚本（将当前目录挂载到容器内 /app 目录）
docker run --rm -v $(pwd):/app php-cli:latest php /app/script.php

# 启动交互式 PHP shell
docker run -it --rm php-cli:latest php -a

常用参数说明

• --rm：容器退出后自动删除，避免残留容器文件
• -v $(pwd):/app：将主机当前目录挂载到容器内 /app 目录，实现脚本文件共享
• -it：交互式终端模式，用于运行 php -a 等需要用户输入的场景
• php-cli:latest：默认使用最新稳定版 PHP，可替换为具体版本标签（如 php-cli:8.2-cli）

环境变量与配置

php-cli 镜像支持通过环境变量或自定义配置文件调整 PHP 运行参数：

环境变量

• PHP_INI_DIR：指定 PHP 配置文件目录（默认 /usr/local/etc/php）
• PHP_MEMORY_LIMIT：设置 PHP 内存限制（默认 128M，需通过自定义 php.ini 生效）

自定义配置

如需修改 PHP 配置，可通过挂载自定义 php.ini 文件实现：

bash
# 挂载本地 php.ini 到容器配置目录
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini php-cli:latest php -i | grep memory_limit

扩展安装

基础镜像通常包含核心扩展，如需额外扩展（如 mysqli, redis 等），可基于该镜像构建自定义镜像：

dockerfile
# 自定义 Dockerfile 示例（安装 mysqli 扩展）
FROM php-cli:8.2-cli
RUN docker-php-ext-install mysqli

构建并使用自定义镜像：

bash
docker build -t my-php-cli .
docker run --rm my-php-cli php -m | grep mysqli

注意事项

• 选择合适的 PHP 版本标签，确保与项目兼容性
• 生产环境中建议固定版本标签（如 8.2-cli），避免因版本更新导致兼容性问题
• 敏感信息（如数据库凭证）建议通过环境变量注入，而非硬编码到脚本或镜像中