squeezely/phpcli

PHP CLI 扩展镜像文档

镜像概述

本镜像为基于官方PHP基础镜像构建的CLI（命令行界面）专用版本，专注于提供轻量级、高效的PHP命令行运行环境。与包含Web服务器组件的PHP镜像不同，本镜像移除了不必要的Web服务依赖，仅保留CLI运行所需的核心组件，适合无需Web服务的PHP脚本执行场景。

核心功能与特性

• 基于官方基础镜像：构建于PHP官方基础镜像之上，确保兼容性和安全性
• CLI专用优化：专注于命令行环境，剔除Web服务器（如Apache、Nginx）相关组件，减少资源占用
• 基础扩展支持：包含PHP核心扩展及常用工具类扩展，满足基础脚本运行需求
• 轻量级设计：镜像体积更小，启动速度更快，适合资源受限环境
• 灵活可配置：支持通过环境变量或挂载配置文件自定义PHP运行参数

使用场景与适用范围

• PHP脚本执行：直接运行本地PHP脚本文件（如.php格式的工具脚本、数据处理脚本）
• 自动化任务：配合定时任务工具（如cron）执行周期性任务（日志清理、数据同步、报表生成等）
• 后台处理：运行无需用户交互的后台任务（如文件转换、数据解析、消息队列消费）
• 开发测试：在隔离环境中测试PHP脚本功能，避免本地环境依赖冲突

使用方法与配置说明

基本运行命令

通过以下命令可直接运行PHP脚本（假设当前目录下有待执行脚本script.php）：

bash
docker run --rm -v $(pwd):/app php-cli-extended php /app/script.php

参数说明：

• --rm：容器退出后自动删除，避免残留
• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录，实现脚本文件共享
• php-cli-extended：镜像名称（需替换为实际镜像标签）
• php /app/script.php：容器内执行的命令，即通过PHP解释器运行/app/script.php脚本

自定义PHP配置

通过环境变量配置

支持通过环境变量调整PHP基础配置，常用环境变量包括：

示例：设置内存限制为256M并运行脚本

bash
docker run --rm -e PHP_MEMORY_LIMIT=256M -v $(pwd):/app php-cli-extended php /app/script.php

通过挂载配置文件

如需更复杂的配置，可将本地php.ini文件挂载到容器内PHP配置目录：

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

Docker Compose 配置示例

对于需要持久化配置或多容器协作的场景，可使用docker-compose.yml：

yaml
version: '3'
services:
  php-cli:
    image: php-cli-extended
    volumes:
      - ./scripts:/app          # 挂载本地脚本目录
      - ./php.ini:/usr/local/etc/php/php.ini  # 挂载自定义配置
    environment:
      - PHP_MEMORY_LIMIT=256M
      - PHP_MAX_EXECUTION_TIME=60
    command: php /app/background-task.php  # 默认执行的后台任务脚本

启动命令：docker-compose up -d（后台运行）

扩展安装（可选）

如需添加额外PHP扩展，可通过Dockerfile基于本镜像构建自定义镜像：

dockerfile
FROM php-cli-extended
RUN docker-php-ext-install pdo_mysql  # 安装pdo_mysql扩展

构建命令：docker build -t php-cli-custom .