ipgan/php-custom

PHP 环境镜像（含扩展与Composer）

镜像概述

本镜像提供了一个预配置的PHP运行环境，已集成多种常用扩展模块及Composer依赖管理工具，旨在简化PHP应用的开发、测试与部署流程。无需手动安装核心扩展和依赖管理工具，可直接用于运行各类PHP应用程序。

核心功能与特性

扩展模块

• 数据库支持：
  • mysqli：MySQL数据库交互扩展，支持过程式和面向对象接口
  • PDO：PHP数据对象扩展，提供统一的数据库访问接口，支持MySQL、PostgreSQL、SQLite等多种数据库
• 常用扩展：默认包含mbstring（多字节字符串处理）、curl（HTTP请求）、gd（图像处理）、json（JSON数据处理）、openssl（加密功能）等开发必备模块
• 灵活扩展：基于官方PHP镜像构建，支持通过docker-php-ext-install命令添加更多扩展

工具集成

• 内置Composer：PHP依赖管理工具，可直接执行composer install、composer require等命令管理项目依赖，无需额外安装

使用场景与适用范围

• PHP应用开发：本地开发环境快速搭建，避免环境配置差异问题
• 生产环境部署：中小型PHP应用（如博客、CMS、API服务）的容器化部署
• CI/CD流程：集成到自动化构建流程中，用于代码测试、依赖安装和应用打包
• 数据库应用：需连接MySQL、PostgreSQL等数据库的PHP应用程序

使用方法与配置说明

基本使用

查看PHP版本与模块

bash
# 查看PHP版本
docker run --rm [镜像名称] php -v

# 查看已安装扩展模块
docker run --rm [镜像名称] php -m

运行PHP脚本

bash
# 运行当前目录下的index.php文件
docker run --rm -v $(pwd):/app -w /app [镜像名称] php index.php

依赖管理（Composer）

初始化项目

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称] composer init

安装依赖

bash
# 基于composer.json安装依赖
docker run --rm -v $(pwd):/app -w /app [镜像名称] composer install

# 添加新依赖包（如laravel/framework）
docker run --rm -v $(pwd):/app -w /app [镜像名称] composer require laravel/framework

自定义配置

PHP配置文件

默认PHP配置文件路径为/usr/local/etc/php/php.ini，可通过挂载本地配置文件覆盖默认配置：

bash
# 使用自定义php.ini
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini [镜像名称] php -i | grep "Loaded Configuration File"

环境变量

支持通过环境变量调整PHP运行参数，常用变量包括：

• PHP_INI_SCAN_DIR：自定义PHP配置文件扫描目录（默认/usr/local/etc/php/conf.d）
• COMPOSER_ALLOW_SUPERUSER=1：允许root用户执行Composer命令（容器内默认以root运行时需设置）

部署示例

基本运行示例

bash
# 启动容器并运行PHP内置Web服务器（适用于开发环境）
docker run -d -p 8080:8080 -v $(pwd):/app -w /app [镜像名称] php -S 0.0.0.0:8080

Docker Compose示例（配合Nginx）

yaml
version: '3'
services:
  php:
    image: [镜像名称]
    volumes:
      - ./app:/var/www/html
    working_dir: /var/www/html
    depends_on:
      - mysql

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

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: app_db

说明：上述配置需配合Nginx配置文件（nginx.conf）将PHP请求转发至PHP容器处理，适用于生产环境Web应用部署。

注意事项

• 生产环境建议通过--user参数指定非root用户运行容器，增强安全性
• 敏感配置（如数据库密码）建议通过环境变量或外部配置文件注入，避免硬编码
• 如需添加自定义扩展，可基于此镜像构建新镜像（例如：FROM [镜像名称] RUN docker-php-ext-install soap）