PHP Docker镜像文档

镜像概述

本镜像为PHP脚本语言提供Docker化运行环境，同时支持CLI（命令行接口）和FPM（FastCGI进程管理器）两种模式。需注意：特定工具相关的镜像（如Composer、Laravel等）已迁移至独立仓库，例如原标签chekote/php:8.1.27-laravel8.x已调整为chekote/laravel8.x:php8.1.27。此调整旨在简化特定用例下新镜像的版本识别，例如Laravel 10项目可直接从chekote/laravel10.x仓库获取最新镜像，无需额外检查工具类型。

源码地址：[***]

核心功能与特性

• 双模式支持：同时提供CLI和FPM两种运行模式，满足命令行脚本执行与Web应用部署需求。
• 工具镜像独立化：工具相关镜像（如Laravel、Composer）迁移至专属仓库，优化版本管理与获取流程。
• 版本清晰：独立仓库设计使特定框架/工具的镜像版本与PHP版本绑定更明确，便于项目版本匹配。

使用场景与适用范围

• PHP应用开发：本地开发环境快速搭建，支持CLI模式下的脚本调试与运行。
• Web应用部署：配合Nginx等Web服务器，通过FPM模式部署PHP Web应用。
• 特定框架/工具场景：需使用Laravel等框架时，可直接从对应独立仓库（如chekote/laravel10.x）获取适配镜像。

使用方法与配置说明

基础镜像拉取

拉取基础PHP镜像（以CLI/FPM模式为例）：

bash
docker pull chekote/php:<version>

注：<version>为具体PHP版本号，如8.1.27

CLI模式使用

通过CLI模式执行PHP命令：

bash
# 查看PHP版本
docker run --rm chekote/php:8.1.27 php -v

# 执行本地PHP脚本（挂载当前目录至容器内/app）
docker run --rm -v $(pwd):/app chekote/php:8.1.27 php /app/script.php

FPM模式使用

配合Nginx部署Web应用（示例docker-compose.yml）：

yaml
version: '3'
services:
  php-fpm:
    image: chekote/php:8.1.27
    volumes:
      - ./php-app:/var/www/html
    expose:
      - "9000"
  
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./php-app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm

其中nginx.conf需配置FPM转发：

nginx
server {
    listen 80;
    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

工具镜像使用

对于Laravel等框架，从独立仓库拉取镜像：

bash
# 拉取Laravel 10.x适配的PHP镜像
docker pull chekote/laravel10.x:php8.1.27

# 使用Laravel镜像运行命令
docker run --rm chekote/laravel10.x:php8.1.27 php artisan --version

镜像标签说明

• 基础镜像标签：chekote/php:<php-version>（如chekote/php:8.1.27），包含CLI和FPM模式。
• 工具镜像标签：chekote/<tool-name>:php<php-version>（如chekote/laravel8.x:php8.1.27），对应特定工具/框架的适配版本。