2000cubits/php-cli

PHP Cli镜像文档

镜像概述

PHP Cli镜像提供了PHP命令行界面（Command Line Interface）运行环境，专注于在命令行模式下执行PHP脚本和应用程序。该镜像不包含Web服务器（如Apache、Nginx）组件，仅提供纯粹的PHP命令行执行环境，适用于各类PHP控制台应用、自动化脚本任务、开发调试及服务器端脚本运行场景。

核心功能和特性

• 纯粹命令行环境：不含Web服务器组件，专注于PHP命令行执行能力，减少资源占用
• 标准PHP命令支持：完整支持php命令行工具，可直接执行PHP脚本、表达式及交互式模式
• 多版本兼容性：提供多个PHP版本标签（如7.4-cli、8.1-cli、8.2-cli等），适配不同项目需求
• 扩展支持：预包含PHP核心扩展，同时支持通过自定义配置安装额外扩展
• 轻量级设计：基于官方基础镜像构建，镜像体积优化，适合容器化部署和快速启动

使用场景和适用范围

• PHP脚本开发调试：在本地环境快速测试和调试PHP脚本逻辑
• 控制台应用运行：执行基于Symfony Console、Laravel Artisan、Yii Console等框架开发的PHP控制台应用
• 定时任务执行：作为容器化定时任务（如Cron任务）的执行环境，运行数据同步、报表生成等周期性脚本
• CI/CD流程集成：在持续集成/部署流程中执行PHP代码检查、单元测试和构建脚本
• 服务器端脚本任务：处理文件操作、数据处理、API调用等后台脚本任务

使用方法和配置说明

基本使用

拉取镜像

通过Docker Hub拉取官方PHP Cli镜像（以8.2版本为例）：

bash
docker pull php:8.2-cli

查看PHP版本

验证PHP环境及版本：

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

输出示例：

PHP 8.2.12 (cli) (built: Oct 27 2023 13:39:47) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.12, Copyright (c) Zend Technologies

运行本地PHP脚本

将本地脚本文件挂载到容器中执行（假设当前目录下有script.php）：

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

• --rm：容器退出后自动删除
• -v $(pwd):/app：将当前主机目录挂载到容器内/app目录
• php /app/script.php：在容器内执行/app/script.php脚本

交互式模式

启动PHP交互式shell：

bash
docker run -it --rm php:8.2-cli php -a

进入交互式模式后可直接输入PHP代码执行：

Interactive shell

php > echo "Hello, PHP Cli";
Hello, PHP Cli
php > exit

高级配置

挂载自定义php.ini

通过挂载本地php.ini配置文件自定义PHP环境：

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

注：PHP Cli默认加载配置路径为/usr/local/etc/php/php.ini，具体路径可通过php --ini命令查看

安装额外扩展

如需添加PHP扩展，可基于官方镜像构建自定义镜像（创建Dockerfile）：

dockerfile
FROM php:8.2-cli

# 安装mysqli扩展示例
RUN docker-php-ext-install mysqli

构建并使用自定义镜像：

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

环境变量配置

通过环境变量调整PHP运行参数（如内存限制）：

bash
docker run --rm -e PHP_MEMORY_LIMIT=512M php:8.2-cli php -r "echo ini_get('memory_limit');"

输出：512M

典型应用示例

运行Laravel Artisan命令

bash
# 假设当前目录为Laravel项目根目录
docker run --rm -v $(pwd):/app -w /app php:8.2-cli php artisan list

执行定时脚本任务

结合cron服务配置定时任务（示例docker-compose.yml）：

yaml
version: '3'
services:
  php-cli:
    image: php:8.2-cli
    volumes:
      - ./scripts:/scripts
      - ./cron.d:/etc/cron.d
    command: cron -f

注：需在./cron.d目录中添加定时任务配置文件，如php-task：* * * * * root php /scripts/定时任务脚本.php >> /var/log/cron.log 2>&1

注意事项

• 该镜像不包含Web服务器组件，无法直接运行PHP Web应用
• 生产环境使用时建议指定具体PHP版本标签（如8.2-cli），避免使用latest标签导致版本变更风险
• 敏感配置和数据建议通过环境变量或挂载方式注入，避免硬编码到镜像中
• 长时间运行的脚本需注意容器资源限制（如内存、CPU）配置