greg0ire/postgres

Symfony开发Docker镜像

镜像概述和主要用途

利用Docker简化Symfony开发环境的初始化过程，使团队成员能够快速开始编码。仅需完成三个步骤：安装Docker、安装Docker Compose、运行docker-compose up。目前包含多种镜像：nginx、php-fpm、php-console、postgres、memcached、mailcatcher、elasticsearch，所有镜像均基于ubuntu:trusty，以减少磁盘空间占用。

核心功能和特性

• 统一基础镜像：所有镜像基于ubuntu:trusty构建，降低磁盘空间占用
• 完整开发组件：包含Web服务器（nginx）、PHP环境（php-fpm、php-console）、数据库（postgres）、缓存（memcached）、邮件捕获（mailcatcher）、搜索引擎（elasticsearch）等开发必需组件
• 即开即用的调试工具：PHP容器内置XDebug远程调试功能
• 便捷DNS配置：通过dnsdock实现服务域名访问，无需手动修改hosts文件

使用场景和适用范围

适用于Symfony应用的开发环境搭建，尤其适合团队协作场景。确保所有开发成员使用一致的环境配置，减少因环境差异导致的开发问题，加速项目初始化过程。

详细使用方法和配置说明

Symfony2应用中的设置步骤

项目包含示例Symfony2应用，可按以下步骤在自己的应用中配置：

1. 创建docker目录，与项目其他文件分离，保持结构清晰
2. 创建容器所需的配置文件。虽然配置文件可内置到镜像中，但建议作为应用的一部分，明确部署时所需的配置依赖
3. 创建docker-compose.yml文件，映射主机路径到容器卷

容器详情

nginx容器

默认配置monitoring.*虚拟主机，可访问nginx和php-fpm状态页面；另提供coverage.*虚拟主机，供phpunit用户使用，从/srv/build/coverage路径提供代码覆盖率报告文件。

PHP容器

包含三个PHP镜像：基础镜像（不直接使用）、php-fpm镜像和php-console镜像。php-console镜像集成nodejs、ruby-sass、composer、php-cs-fixer等开发工具。

XDebug配置：
两个PHP镜像均预配置XDebug远程调试，默认尝试连接172.17.42.1:9000的DBGP客户端。需确保调试客户端不仅监听localhost，并配置远程路径映射（将容器内/srv目录映射到本地代码路径）。

示例：使用vim配合https://github.com/joonty/vdebug的配置

viml
let g:vdebug_options= {
\    "server": '172.17.0.1',
\    "path_maps": {"/srv": "/home/username/path/to/code"}
\}

控制台容器使用：
为提升性能，控制台容器默认禁用XDebug，可通过-d标志临时启用：

shell
php -dzend_extension=xdebug.so <your_command_goes_here>

推荐登录方式：

shell
docker exec --user=$(whoami) --interactive --tty samplesymfonyapp_console_1 /bin/zsh

也可使用/bin/bash替代/bin/zsh。

Composer私有仓库认证：
登录控制台容器后，通过ssh-keygen生成SSH密钥对，将公钥关联到私有仓库账户即可。

mailcatcher容器

提供邮件捕获功能，80端口暴露管理界面，25端口提供SMTP服务。

DNS配置

前提条件

需运行bin/docker-init脚本启动DNS服务器并映射到本地主机。若遇到问题，可参考https://github.com/tonistiigi/dnsdock/blob/master/readme.md文档。

shell
bin/docker-init

配置方法

在docker-compose.yml中为需要DNS解析的镜像设置环境变量：

• DNSDOCK_NAME：服务名称
• DNSDOCK_IMAGE：镜像标识
• DNSDOCK_ALIAS：自定义域名（可选，用于覆盖默认命名规则）

示例配置：

yaml
webserver:
    image: docker.xuanyuan.run/greg0ire/nginx
    ports:
        - '80'
    environment:
        - DNSDOCK_IMAGE=web
        - DNSDOCK_NAME=my_project
        - DNSDOCK_ALIAS=my_app.dev

配置后可通过my_project.web.docker或my_app.dev访问服务，无需修改hosts文件。