novigoconsulting/php74

PHP 7.4 Docker镜像文档

镜像概述

本镜像为基于PHP 7.4版本的Docker环境封装，旨在提供稳定、轻量的PHP 7.4运行时环境，支持开发、测试及生产环境中PHP 7.4应用的快速部署。镜像包含PHP 7.4核心运行组件，并可按需扩展配置，适用于各类PHP Web应用、命令行工具及服务。

核心功能与特性

• PHP 7.4运行环境：内置PHP 7.4.x稳定版本，包含CLI（命令行接口）和FPM（FastCGI进程管理器）两种运行模式，满足不同场景需求。
• 基础扩展支持：默认集成常用PHP扩展，如mysqli、pdo_mysql、json、mbstring、curl、gd等，可通过配置添加额外扩展。
• 多平台兼容：支持amd64、arm64等主流架构，适配不同硬件环境。
• 轻量级设计：基于Alpine或Debian基础镜像（依具体版本而定），平衡体积与功能完整性。
• 灵活配置：支持通过环境变量、配置文件挂载等方式自定义PHP配置（如php.ini参数调整）。

使用场景

• Web应用开发：本地开发环境搭建，快速运行基于PHP 7.4的Web应用（如WordPress、Laravel等框架）。
• CI/CD流程：集成到持续集成/持续部署管道，用于自动化测试、构建PHP 7.4应用。
• 生产环境部署：配合Nginx/Apache等Web服务器，部署PHP 7.4应用至生产环境，支持容器编排工具（如Kubernetes、Docker Compose）。
• 命令行工具运行：执行PHP脚本、定时任务（Cron Job）等PHP CLI程序。

使用方法与配置说明

基本运行

通过docker run运行

PHP CLI模式（执行PHP脚本）：

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

PHP-FPM模式（配合Web服务器）：

bash
docker run -d --name php74-fpm -v $(pwd)/app:/var/www/html php:7.4-fpm

Docker Compose配置示例

创建docker-compose.yml文件，集成PHP-FPM与Nginx：

yaml
version: '3'
services:
  php-fpm:
    image: php:7.4-fpm
    volumes:
      - ./app:/var/www/html
    restart: always

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d
    depends_on:
      - php-fpm
    restart: always

自定义配置

挂载PHP配置文件

覆盖默认php.ini配置：

bash
docker run -d --name php74-fpm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini -v $(pwd)/app:/var/www/html php:7.4-fpm

安装额外扩展

通过docker-php-ext-install命令安装扩展（需在容器内执行或构建自定义镜像）：

bash
# 临时进入容器安装
docker exec -it php74-fpm bash
docker-php-ext-install zip exif

# 或构建自定义镜像（Dockerfile示例）
FROM php:7.4-fpm
RUN docker-php-ext-install pdo_mysql mysqli zip

环境变量说明

扩展管理

默认扩展可通过php -m查看，如需添加未默认包含的扩展，可使用官方提供的docker-php-ext-*工具链：

• docker-php-ext-install：安装并启用扩展（如pdo_mysql、gd）
• docker-php-ext-enable：启用已安装的扩展
• docker-php-source：获取PHP源码（用于编译扩展）

示例：安装GD扩展

bash
docker run --rm -it php:7.4-cli bash
apt-get update && apt-get install -y libpng-dev
docker-php-ext-install gd

注意事项

• PHP 7.4已停止官方安全支持，生产环境建议评估升级至更高版本，如必须使用，需确保镜像及依赖组件的安全性维护。
• 生产环境部署时，建议基于官方镜像构建自定义镜像，预安装所需扩展并固化配置，避免运行时频繁修改。
• 敏感配置（如数据库密码）应通过环境变量或 secrets 管理工具注入，避免硬编码在镜像或配置文件中。