Oberon PHP 容器镜像

镜像概述

本镜像基于官方PHP-FPM镜像构建，针对应用部署需求进行优化配置。集成了常用PHP扩展、多语言环境支持及前端开发工具，采用mlocati/docker-php-extension-installer进行PHP模块管理，并通过renatomefi/php-fpm-healthcheck实现FPM健康检查。适用于需要PHP运行环境且包含前端构建流程的应用部署场景。

核心功能与特性

语言环境支持

支持以下 locales：

• en_GB.UTF-8
• en_US.UTF-8
• nl_NL.UTF-8
• de_DE.UTF-8
• fr_FR.UTF-8
• es_ES.UTF-8

默认启用的PHP扩展

• gd
• exif
• mcrypt
• zip
• mbstring
• intl
• bcmath
• curl
• pdo_mysql
• xsl
• soap
• mysqli
• simplexml
• sockets
• xmlrpc
• opcache
• mysql
• ldap
• memcache
• memcached
• redis
• imagick

额外软件

为支持无独立前端分离的应用（如React），集成前端构建工具：

• nodejs
• npm
• yarn
• bower
• gulp
• pm2

使用场景

适用于需要PHP运行环境且包含前端资源构建流程的应用部署，尤其适合中小型Web应用，可在单一容器内完成PHP后端运行与前端资源构建。

使用方法与配置说明

Docker Compose 示例

以下是使用VIRTUAL_HOST标签和jwilder-proxy的完整docker-compose.yml示例：

version: '3'
services:
    web:
        image: oberonamsterdam/apache24-fpm
        restart: always
        network_mode: "bridge"
        environment:
            - "VIRTUAL_HOST=${DOCKER_VHOST}"
        links:
            - php
        depends_on:
            - php
        volumes:
            - .:/app/:cached

    php:
        image: oberonamsterdam/php:7.4-fpm
        restart: always
        network_mode: "bridge"
        volumes:
            - .:/app/:cached
        environment:
            - "PHP_SESSION_SAVE_HANDLER=redis"
            - "PHP_SESSION_SAVE_PATH=tcp://redis:6379"
        links:
            - redis
        depends_on:
            - redis

    redis:
        image: redis:alpine
        restart: always
        network_mode: "bridge"

配置Redis会话存储示例

通过环境变量可配置PHP使用Redis存储会话：

version: '3'
services:
    php:
        image: oberonamsterdam/php:7.4-fpm
        network_mode: "bridge"
        environment:
            - "PHP_SESSION_SAVE_HANDLER=redis"
            - "PHP_SESSION_SAVE_PATH=tcp://redis:6379"
        links:
            - redis
        depends_on:
            - redis

    redis:
        image: redis:alpine
        network_mode: "bridge"

默认环境变量

以下环境变量可在.env文件或docker-compose.yml的environment标签中覆盖：

PHP_MAX_EXECUTION_TIME=120
PHP_MEMORY_LIMIT=256M
PHP_UPLOAD_LIMIT=8M
PHP_OPCACHE_LIMIT=64M
PHP_OPCACHE_REVALIDATE=2
PHP_SESSION_SAVE_HANDLER=files
PHP_SESSION_SAVE_PATH=""
PHP_SMTP_HOST=localhost
PHP_MAX_INPUT_VARS=1000

开发环境建议将PHP_OPCACHE_REVALIDATE设置为"0"，默认值"2"为性能与开发体验的平衡设置。

变更日志

• 2024-10-25：修复PHP 8.3的imagick使用imagick@master，将nodejs更新至20.x
• 2023-12-04：添加PHP 8.3支持，注意：mlocati/docker-php-extension-installer暂不支持PHP 8.3的imagick，将nodejs更新至18.x
• 2023-01-16：添加PHP 8.2支持，PHP 7.0-8.2使用相同模块，PHP 5.6包含部分额外模块
• 2021-11-30：添加PHP 8.1，注意PHP 8.x容器默认使用composer 2.0（/usr/local/bin/composer）
• 2021-07-27：将composer 2.0设为默认（可通过/usr/local/bin/composer-1运行composer 1.0）
• 2020-11-27：添加mlocati/docker-php-extension-installer依赖管理支持，移除旧依赖列表，修复PHP56/70/71构建，使用renatomefi/php-fpm-healthcheck添加健康检查
• 2020-10-26：添加composer 2.0，"composer"命令对应1.0，"composer-2"对应2.0
• 2020-03-16：添加WEBP支持