tobi312/php

PHP (含Apache2/FPM/NGINX) Docker镜像文档

支持的标签及对应Dockerfile链接

• https://github.com/Tob1as/docker-php/blob/master/alpine.fpm.slim.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/alpine.fpm.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/alpine.fpm_nginx.slim.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/alpine.fpm_nginx.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/alpine.fpm_nginx.extended.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/debian.apache.slim.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/debian.apache.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/debian.fpm.slim.Dockerfile
• https://github.com/Tob1as/docker-php/blob/master/debian.fpm.Dockerfile

所有容器镜像均提供8.1、8.2、8.3和8.4版本。;-)

PHP版本生命周期支持情况（生命周期结束时间）：[**]
请勿使用已不再支持的PHP版本镜像！*

什么是PHP？

PHP是一种用于Web开发的服务器端脚本语言，也可作为通用编程语言使用。PHP可嵌入纯HTML中，或与多种模板引擎及Web框架配合使用。PHP代码通常由解释器处理，该解释器可作为Web服务器的原生模块或通用网关接口（CGI）实现。

***.org/wiki/PHP

!https://raw.githubusercontent.com/docker-library/docs/master/php/logo.png

关于本镜像

• 基于官方PHP镜像构建：https://hub.docker.com/_/php/ / https://github.com/docker-library/php
• 官方基础镜像默认启用以下PHP扩展（可通过php -m命令查看）：Core ctype curl date dom fileinfo filter ftp hash iconv json libxml mbstring mysqlnd openssl pcre PDO pdo_sqlite Phar posix readline Reflection session SimpleXML sodium SPL sqlite3 standard tokenizer xml xmlreader xmlwriter zlib
• 本镜像在基础镜像上扩展了额外PHP扩展，例如：SQL数据库、gd、imagick、ldap等。详情请查看Dockerfile。
• 为简化扩展安装并减小镜像体积，使用https://github.com/mlocati/docker-php-extension-installer%E5%B7%A5%E5%85%B7%E3%80%82
• PHP及扩展相关信息可参考：php.net 和 pecl.php.net。

如何使用本镜像

基本运行命令

bash
$ docker run --name phpcontainer -v $(pwd)/html:/var/www/html:rw -p 端口:80 -e PHP_ERRORS=1 -e PHP_UPLOAD_MAX_FILESIZE=250 -d tobi312/php:8.1-apache

环境变量

• 通用变量

  • TZ（设置时区，示例："Europe/Berlin"）
  • PHP_ERRORS（设为1启用错误显示）
  • PHP_MEM_LIMIT（设置内存限制，单位MB，示例：128）
  • PHP_POST_MAX_SIZE（设置POST数据最大大小，单位MB，示例：250）
  • PHP_UPLOAD_MAX_FILESIZE（设置上传文件最大大小，单位MB，示例：250）
  • PHP_MAX_FILE_UPLOADS（设置最大上传文件数，示例：20）
  • CREATE_PHPINFO_FILE（设为1启用phpinfo文件，用于开发和测试）
  • CREATE_INDEX_FILE（设为1启用默认索引文件，用于开发和测试）

• 仅PHP-FPM适用

  • ENABLE_PHP_FPM_STATUS（设为1启用状态页，路径/php_fpm_status）

• 仅Apache2适用

  • ENABLE_APACHE_REWRITE（设为1启用重写模块）
  • ENABLE_APACHE_ACTIONS（设为1启用actions模块）
  • ENABLE_APACHE_SSL（设为1启用SSL模块）
  • ENABLE_APACHE_HEADERS（设为1启用headers模块）
  • ENABLE_APACHE_ALLOWOVERRIDE（设为1启用AllowOverride）
  • ENABLE_APACHE_REMOTEIP（设为1启用X-Forwarded-For，仅在代理/负载均衡器后使用！）
  • ENABLE_APACHE_STATUS（设为1启用状态页）
  • ENABLE_APACHE_SSL_REDIRECT（设为1启用SSL重定向，需先启用SSL和重写模块）
  • APACHE_SERVER_NAME（设置服务器名称，示例：example.com）
  • APACHE_SERVER_ALIAS（设置服务器别名，示例：'[***] *.example.com'）
  • APACHE_SERVER_ADMIN（设置服务器管理员***，示例：***）
  • DISABLE_APACHE_DEFAULTSITES（设为1禁用默认站点，需自行挂载配置至/etc/apache2/sites-enabled）

• 仅NGINX适用

  • ENABLE_NGINX_REMOTEIP（设为1启用X-Forwarded-For，仅在代理/负载均衡器后使用！）
  • ENABLE_NGINX_STATUS（设为1启用状态页）
  • 或挂载自定义配置至/etc/nginx/conf.d/default.conf

端口说明

• 含Apache/NGINX的PHP：80（HTTP），可选443（HTTPS）
• 仅FPM的PHP：9000

自定义Dockerfile示例

如需构建自定义镜像，可参考以下示例（以Apache镜像为例，复制额外entrypoint文件）：

dockerfile
FROM tobi312/php:8.1-apache
COPY *.sh /entrypoint.d/

Docker Compose配置示例

yaml
version: "2.4"
services:
  php:
    image: tobi312/php:8.1-apache
    container_name: phpcontainer
    restart: unless-stopped
    ## 端口（仅apache/nginx适用）：
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./html:/var/www/html:rw
      ## 可选：挂载自定义entrypoint文件目录：
      #- ./entrypoint.d:/entrypoint.d:ro
      ## 可选（Apache）：自定义SSL证书和密钥：
      #- ./ssl/mySSL.crt:/etc/ssl/certs/ssl-cert-snakeoil.pem:ro
      #- ./ssl/mySSL.key:/etc/ssl/private/ssl-cert-snakeoil.key:ro
      ## 可选（NGINX）：自定义nginx配置：
      #- ./nginx_default.conf:/etc/nginx/conf.d/default.conf:ro
    environment:
      TZ: "Europe/Berlin"
      PHP_ERRORS: 1
      PHP_MEM_LIMIT: 128
      PHP_POST_MAX_SIZE: 250
      PHP_UPLOAD_MAX_FILESIZE: 250
      PHP_MAX_FILE_UPLOADS: 20
      CREATE_PHPINFO_FILE: 0
      CREATE_INDEX_FILE: 0
      ## 以下变量仅Apache适用
      ENABLE_APACHE_REWRITE: 1
      ENABLE_APACHE_ACTIONS: 0
      ENABLE_APACHE_SSL: 0
      ENABLE_APACHE_HEADERS: 0
      ENABLE_APACHE_ALLOWOVERRIDE: 1
      ENABLE_APACHE_REMOTEIP: 0
      ENABLE_APACHE_STATUS: 0
      #ENABLE_APACHE_SSL_REDIRECT: 0
      #APACHE_SERVER_NAME: ""
      #APACHE_SERVER_ALIAS: ""
      #APACHE_SERVER_ADMIN: ""
      #DISABLE_APACHE_DEFAULTSITES: 0
      ## 以下变量仅NGINX适用
      #ENABLE_NGINX_REMOTEIP: 0
      #ENABLE_NGINX_STATUS: 0

镜像相关链接

• https://hub.docker.com/r/tobi312/php/
• https://github.com/Tob1as/docker-php