voxtecnologiahub/php-7.4-cli-alpine-vox

PHP 7.4 FPM Alpine镜像文档

镜像概述

本镜像基于php:7.4-fpm-alpine构建，集成了Composer包管理器、Xdebug调试工具、Redis扩展及多种PHP核心扩展，适用于GitLab CI/CD环境下的PHP应用开发、测试与部署。镜像通过Alpine Linux实现轻量级打包，同时包含本地化配置、时区设置及权限管理脚本，满足现代PHP应用的运行需求。

核心功能与特性

基础环境

• 基础镜像：php:7.4-fpm-alpine（Alpine Linux系统，轻量级且资源占用低）
• 维护者：Edmo Farias <***>
• 版本：latest

预装工具与扩展

• 开发工具：Composer、Git、Vim、Bash、Wget、Curl、Openssh-client
• PHP扩展：
  • 数据库：pgsql、pdo_pgsql
  • 图形处理：gd（支持freetype、jpeg）
  • 其他核心：intl、zip、soap、bcmath、sockets
  • 调试与缓存：xdebug、redis
• 系统依赖：tzdata（时区支持）、icu（国际化）、libzip（压缩支持）、libsodium（加密）

配置优化

• 自定义PHP配置：php.ini（/usr/local/etc/php/php.ini）
• PHP-FPM池配置：www.conf（/usr/local/etc/php/pool.d/www.conf）
• Xdebug配置：xdebug-dev.ini（/usr/local/etc/php/conf.d/xdebug-dev.ini）
• 时区设置：通过环境变量动态配置系统及PHP时区
• 本地化支持：集成glibc及多语言 locale 配置

脚本支持

• permission.sh：权限管理脚本（位于/bin/）
• install.sh：依赖安装辅助脚本（位于/bin/）

使用场景

1. GitLab CI/CD流程：作为CI/CD流水线中的构建或运行环境，支持PHP项目的依赖安装、代码检查、单元测试
2. 本地开发环境：配合Docker Compose搭建本地PHP开发环境，支持Xdebug调试
3. 轻量级生产部署：适用于资源受限环境下的PHP应用部署，如微服务架构中的PHP服务节点

使用方法

构建参数（ARG）

环境变量（ENV）

Docker部署示例

1. 构建镜像

bash
docker build \
  --build-arg APP_ENV=dev \
  --build-arg WORKING_DIR=/var/www/app \
  --build-arg LOCALE=en_US \
  --build-arg ENCODE=UTF-8 \
  --build-arg TIME_ZONE=Asia/Shanghai \
  -t php74-fpm-alpine:custom .

2. 运行容器

bash
docker run -d \
  -p 9000:9000 \
  -v /path/to/your/app:/var/www/app \
  -e COMPOSER_ALLOW_SUPERUSER=1 \
  --name php-app \
  php74-fpm-alpine:custom

3. Docker Compose配置示例

yaml
version: '3.8'

services:
  php:
    build:
      context: .
      args:
        APP_ENV: dev
        WORKING_DIR: /var/www/app
        LOCALE: en_US
        ENCODE: UTF-8
        TIME_ZONE: Asia/Shanghai
    ports:
      - "9000:9000"
    volumes:
      - ./app:/var/www/app
    environment:
      - COMPOSER_ALLOW_SUPERUSER=1
    restart: unless-stopped

扩展与配置管理

• 启用/禁用扩展：通过修改/usr/local/etc/php/conf.d/目录下的配置文件控制扩展加载
• 调整PHP-FPM参数：编辑/usr/local/etc/php/pool.d/www.conf配置进程数、超时时间等
• Xdebug配置：通过/usr/local/etc/php/conf.d/xdebug-dev.ini调整调试参数（如远程主机、端口）

权限管理

运行容器内权限脚本设置应用目录权限：

bash
docker exec -it php-app /bin/permission.sh