首先推薦安裝vscode的php擴(kuò)展包，這里推薦phptools這個擴(kuò)展，它包含了從調(diào)試，測試，到格式化，自動補(bǔ)全一些列功能。

xdebug

xdebug 是一個php的擴(kuò)展，它可以幫助我們調(diào)試php，我們可以在初始化php容器的時候，直接安裝它。

xdebug

這里需要注意的是xdebug的版本，主要是2和3的版本，不同版本的xdebug配置會有一些不同。

Dockerfiles

首先我們需要創(chuàng)建php容器的Dockerfile文件，文件內(nèi)容如下：

FROM php:fpm
RUN pecl install xdebug
RUN docker-php-ext-enable xdebug

nginx

這里我們使用nginx作為服務(wù)器，它的Dockerfile文件如下：

FROM nginx:alpine
COPY nginx/default.conf /etc/nginx/conf.d

nginx 默認(rèn)的default.conf 內(nèi)容:

server {
    listen 0.0.0.0:80;

    root /var/www/html;

    location / {
        index index.php index.html;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
    }

    error_log /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
}

docker-compose

接下來我們創(chuàng)建一個docker-compose.yml來管理php和nginx兩個容器。

version: "3"
services:
  nginx:
    build:
      context: .
      dockerfile: nginx/Dockerfile
    ports: 
      - "8080:80"
    networks:
      - internal
    volumes:
      - ./data/:/var/www/html
  php:
    build:
      context: .
      dockerfile: php/Dockerfile
    networks:
      - internal
    environment:
      XDEBUG_MODE: debug
      XDEBUG_CONFIG: client_host=host.docker.internal client_port=9003
    volumes:
      - ./data/:/var/www/html
networks:
  internal:
    driver: bridge

在這里，我們通過environment來配置php的參數(shù)，配置xdebug相關(guān)信息。

image.png

最后

啟動docker-compose ，訪問localhost:8080 可以訪問php首頁。

在vscode中創(chuàng)建一個launch.json配置文件，用來配置調(diào)試信息。

vscode launch

配置信息如下：

{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html": "${workspaceFolder}/data"
},

image.png

通過listen for xdebug啟動監(jiān)聽，在瀏覽器中訪問 http://localhost:8080?XDEBUG_SESSION_START=1就可以監(jiān)聽到調(diào)試，其中XDEBUG_SESSION_START參數(shù)是用來告訴告訴xdebug調(diào)試這個請求。(貌似不加這個參數(shù)也可以)

image.png