headgent/phpcli Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PHP CLI 镜像文档

镜像概述

本镜像提供版本化、多架构支持的PHP CLI环境，旨在为PHP控制台应用提供快速、可重现的运行环境。通过标准化的镜像配置，确保开发、测试和生产环境的一致性，简化PHP脚本和控制台应用的部署流程。

核心功能与特性

• 版本化支持：提供多种PHP版本（如7.4、8.0、8.1、8.2等），满足不同项目的兼容性需求
• 多架构兼容：支持amd64、arm64等主流架构，适用于多种硬件环境
• 轻量级设计：基于官方PHP镜像优化，减少不必要依赖，降低镜像体积
• 可重现性：固定版本标签确保环境一致性，避免因依赖变化导致的部署问题
• 易于扩展：支持通过环境变量或自定义配置文件扩展PHP功能和扩展

使用场景与适用范围

• 开发和运行PHP控制台应用（如命令行工具、脚本任务）
• 定时任务（Cron任务）的PHP脚本执行
• CI/CD流程中的PHP代码测试、构建和部署
• 需要跨架构部署的PHP应用
• 对环境一致性要求高的开发团队

使用方法与配置说明

基本使用

通过docker run命令直接运行PHP脚本：

bash
docker run --rm -v $(pwd):/app headgent/phpcli:8.2 php /app/script.php

指定PHP版本

镜像标签格式为{PHP版本}，例如：

• headgent/phpcli:8.2（PHP 8.2）
• headgent/phpcli:8.1（PHP 8.1）
• headgent/phpcli:7.4（PHP 7.4）

挂载代码目录

将本地代码目录挂载到容器内的/app目录，方便开发和测试：

bash
docker run --rm -v $(pwd):/app headgent/phpcli:8.2 php /app/main.php

自定义PHP配置

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

bash
docker run --rm -v $(pwd):/app -v $(pwd)/php.ini:/usr/local/etc/php/php.ini headgent/phpcli:8.2 php /app/script.php

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  phpcli:
    image: headgent/phpcli:8.2
    volumes:
      - ./:/app
    command: php /app/script.php

运行：

bash
docker-compose up

环境变量

扩展安装

如需额外PHP扩展，可基于本镜像构建自定义镜像，例如创建Dockerfile：

dockerfile
FROM headgent/phpcli:8.2
RUN docker-php-ext-install pdo_mysql

构建并使用：

bash
docker build -t my-phpcli .
docker run --rm my-phpcli php -m | grep pdo_mysql