p2media/php Docker 镜像 - 轩辕镜像

PHP环境镜像文档

镜像概述和主要用途

本镜像提供预配置的PHP运行环境，内置常用预构建PHP模块及Composer包管理工具，旨在简化PHP应用的部署流程。无需手动编译和配置PHP扩展，可直接部署各类PHP应用（如博客、CMS、自定义Web系统等），适用于开发、测试及小型生产环境。

核心功能和特性

• 预构建PHP模块：集成常用扩展（如mysqli、pdo_mysql、gd、curl、mbstring、json等），满足多数PHP应用需求
• 内置Composer：预装PHP包管理工具Composer，支持一键安装依赖包，无需额外配置
• 轻量级设计：基于官方PHP镜像优化，体积小巧，启动快速，资源占用低
• 灵活配置：支持通过环境变量或挂载文件自定义php.ini配置，适配不同应用场景
• 多版本支持：提供多个PHP版本标签（如7.4、8.0、8.1等），可按需选择

使用场景和适用范围

• PHP应用开发环境：本地开发测试，快速搭建一致的运行环境，避免"本地能跑线上不行"问题
• 小型PHP应用生产部署：如个人博客（WordPress）、企业官网、自定义PHP后台系统等
• CI/CD流程集成：作为自动化测试或构建环节的运行环境，确保流程一致性
• 教学/演示环境：快速搭建PHP运行环境，用于技术教学或应用演示

使用方法和配置说明

基本使用（docker run）

直接运行容器并挂载PHP应用代码：

bash
# 运行PHP 8.1版本，挂载当前目录到容器内/webapp，暴露80端口（假设使用Apache基础镜像）
docker run -d -p 80:80 -v $(pwd):/var/www/html --name my-php-app php-env:8.1

说明：若使用PHP-FPM版本，需配合Nginx反向代理，示例见下方Docker Compose部分。

使用Composer管理依赖

进入容器执行Composer命令：

bash
# 进入运行中的容器
docker exec -it my-php-app bash

# 在容器内安装依赖（假设应用代码已挂载到/var/www/html）
cd /var/www/html
composer install

自定义php.ini配置

方法1：通过环境变量修改配置

支持以PHP_INI_为前缀的环境变量自定义php.ini参数：

bash
# 设置内存限制为256M，错误报告级别为E_ALL
docker run -d -p 80:80 \
  -e PHP_INI_MEMORY_LIMIT=256M \
  -e PHP_INI_ERROR_REPORTING=E_ALL \
  -v $(pwd):/var/www/html \
  --name my-php-app php-env:8.1

方法2：挂载本地php.ini文件

将自定义php.ini挂载到容器配置目录：

bash
# 假设本地php.ini路径为./php.ini
docker run -d -p 80:80 \
  -v $(pwd):/var/www/html \
  -v $(pwd)/php.ini:/usr/local/etc/php/php.ini \
  --name my-php-app php-env:8.1

Docker Compose部署示例（PHP-FPM + Nginx）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  php-fpm:
    image: php-env:8.1-fpm
    volumes:
      - ./app:/var/www/html  # 挂载PHP应用代码
      - ./php.ini:/usr/local/etc/php/php.ini  # 自定义php.ini
    environment:
      - PHP_INI_MEMORY_LIMIT=512M
      - PHP_INI_MAX_EXECUTION_TIME=60

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html  # 共享PHP代码目录
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # Nginx配置
    depends_on:
      - php-fpm

Nginx配置文件nginx.conf示例：

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

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

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

常用挂载目录