php-dev

镜像概述和主要用途

php-dev是一个包含Web服务器、PHP及Web应用开发所需工具的Docker镜像。通过在docker-compose.yml中设置参数，可以轻松选择所需的PHP版本以及启动Apache或Nginx Web服务器。建议使用pluswerk/docker-global作为项目的包装器，因为此Dockerfile的构建考虑了这一点。

配置步骤

创建compose/Development/docker-compose.yml文件，如下所示。修改所有设置，主要包括VIRTUAL_HOST、WEB_DOCUMENT_ROOT，必要时修改应用上下文。环境变量CONTEXT用于切换不同的docker-compose.yml文件。

然后将start.sh复制到项目中并启动。

文档说明

基础Docker镜像分别为webdevops/php-apache-dev和webdevops/php-nginx-dev。(github)

核心功能和特性

功能特性

• XDebug - 如何调试代码
• 环境变量 - 可配置项说明
• PHP性能分析 - 分析代码慢/内存占用高的原因

辅助信息

• 代码覆盖率 - 使用代码覆盖率测试代码（phpunit、infection）
• 更改docker项目名称 - 所有项目位于同名文件夹时的处理
• Nginx反向代理 - VIRTUAL_HOST说明

使用方法和配置示例

Docker Compose配置示例

以下是docker-compose.yml文件的示例。将此文件放入项目中，配置后即可启动Docker项目。更多信息请参见文档。

示例文件：compose/Development/docker-compose.yml

yaml
version: '3.5'

services:
  web:
    image: pluswerk/php-dev:nginx-7.4

    volumes:
      - .:/app
# 如果不需要node容器，docker socket可省略
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ~/.ssh:/home/application/.ssh
      - ~/.composer/cache:/home/application/.composer/cache
      - ~/.gitconfig:/home/application/.gitconfig

    environment:
#     有关VIRTUAL_*的详细说明，请参见文档中的Nginx反向代理部分
      - VIRTUAL_HOST=docker-website.${TLD_DOMAIN:?TLD_DOMAIN is required},sub.docker-website.${TLD_DOMAIN:?TLD_DOMAIN is required}
#     - HTTPS_METHOD=noredirect

      - WEB_DOCUMENT_ROOT=/app/public
      - XDEBUG_CLIENT_HOST=${XDEBUG_CLIENT_HOST:-}
      - XDEBUG_CLIENT_PORT=${XDEBUG_CLIENT_PORT:-9000}
      - php.xdebug.idekey=${XDEBUG_IDEKEY:-PHPSTORM}

#      项目环境变量（启用所需项）
#      - APP_ENV=development_docker
#      - PIMCORE_ENVIRONMENT=development_docker
#      - TYPO3_CONTEXT=Development/docker

#      不要忘记通过bash start.sh连接
      - APPLICATION_UID=${APPLICATION_UID:-1000}
      - APPLICATION_GID=${APPLICATION_GID:-1000}

  node:
    image: node:lts
    volumes:
      - ./:/app
    working_dir: /app
    environment:
#      不要忘记通过bash start.sh连接
      - APPLICATION_UID=${APPLICATION_UID:-1000}
      - APPLICATION_GID=${APPLICATION_GID:-1000}
    stop_signal: SIGKILL
    entrypoint: bash -c 'groupmod -g $$APPLICATION_GID node; usermod -u $$APPLICATION_UID node; tail -f /dev/null'

networks:
  default:
    external:
      name: global

上述示例提示：
在您自己的配置中，可能需要将docker-website替换为项目名称，例如typo3。TLD_DOMAIN是环境变量，Nginx容器监听该变量以接收传入请求（例如example.com）。您的项目将可通过typo3.example.com访问。

使用场景和适用范围

该镜像为基础PHP安装，能够运行大多数PHP应用程序，并已成功测试/用于以下项目：

• TYPO3 >=7
• PIMCore >= 5.4
• 独立PHP项目（Symfony、Laravel/Lumen、Vanilla）
• WordPress >= 4.5

如果发现任何错误，请随时提交issue和/或pull request。