additiveeu/php

PHP 8.0 with postgres and xDebug

镜像概述和主要用途

本镜像基于PHP 8.0构建，集成了PostgreSQL数据库支持和xDebug调试工具，旨在为PHP应用开发提供完整的开发与调试环境。通过环境变量可灵活配置xDebug参数，满足不同调试场景需求。

核心功能和特性

• 基于PHP 8.0运行环境
• 集成PostgreSQL客户端支持，可直接与PostgreSQL数据库交互
• 包含xDebug调试工具，支持远程调试
• 支持通过环境变量自定义xDebug配置，优化调试性能

使用场景和适用范围

• PHP应用程序开发环境搭建
• 需要PostgreSQL数据库交互的PHP项目开发与调试
• 需进行代码调试、断点调试的PHP开发场景
• 支持CI/CD流程中的开发环境部署

使用方法和配置说明

环境变量配置

以下环境变量用于配置xDebug参数：

XDEBUG_COVERAGE_ENABLE

• 说明：启用或禁用代码覆盖率分析，禁用可提升xDebug性能
• 可选值：false | true
• 默认值：false

XDEBUG_REMOTE_AUTOSTART

• 说明：启用或禁用xDebug自动启动
• 可选值：true | false
• 默认值：未明确指定（需根据实际需求设置）

XDEBUG_REMOTE_ENABLE

• 说明：启用或禁用xDebug功能
• 可选值：false | true
• 默认值：false

XDEBUG_REMOTE_PORT

• 说明：xDebug远程调试端口
• 默认值：9000

XDEBUG_REMOTE_HOST

• 说明：xDebug远程调试主机地址，通常需设置为容器网络网关
• 获取网关命令：

  bash
  docker network inspect --format '{{ range .IPAM.Config }}{{.Gateway}}{{end}}' bridge
  

• 默认值：172.17.0.1

Docker部署示例

基本运行命令

bash
docker run -d \
  -e XDEBUG_REMOTE_ENABLE=true \
  -e XDEBUG_REMOTE_HOST=172.17.0.1 \
  -e XDEBUG_REMOTE_PORT=9000 \
  -e XDEBUG_REMOTE_AUTOSTART=true \
  --name php80-dev \
  additive/php80-postgres-xdebug

挂载项目目录并暴露端口

bash
docker run -d \
  -p 8080:80 \
  -v /path/to/your/php/project:/var/www/html \
  -e XDEBUG_REMOTE_ENABLE=true \
  -e XDEBUG_REMOTE_HOST=$(docker network inspect --format '{{ range .IPAM.Config }}{{.Gateway}}{{end}}' bridge) \
  -e XDEBUG_REMOTE_PORT=9000 \
  --name php80-dev \
  additive/php80-postgres-xdebug

docker-compose配置示例

yaml
version: '3'
services:
  php:
    image: additive/php80-postgres-xdebug
    ports:
      - "8080:80"
    volumes:
      - ./php-project:/var/www/html
    environment:
      - XDEBUG_REMOTE_ENABLE=true
      - XDEBUG_REMOTE_AUTOSTART=true
      - XDEBUG_REMOTE_PORT=9000
      - XDEBUG_REMOTE_HOST=172.17.0.1
    networks:
      - app-network

networks:
  app-network:
    driver: bridge