Laravel SAIL_XDEBUG_MODE 不适用于调试 Web 调用

Question

我已经开始在 MacOS 上玩我的第一个 Laravel 项目。我正在使用 Laravel Sail 在容器内运行项目，除了调试部分之外，一切似乎都正常。

使用的版本：

• Laravel 8.66，
• PHP 8.0.12，
• X调试3.1.1

根据Laravel docs，我们可以设置SAIL_XDEBUG_MODE来启用debug模式。但是，即使将 PhpStorm 设置为侦听传入连接，调试也无法在 PhpStorm 中进行。我已经看到，与我们在浏览器中看到的

php -i

相比，在容器中运行 phpinfo() 会为

Xdebug

返回不同的配置，即使配置文件是相同的。

以下是浏览器的一些屏幕截图：

以下是我在命令行中看到的屏幕截图：

从所附的屏幕截图中可以看出，在控制台中使用XDEBUG_MODE环境变量，而在浏览器中使用xdebug.mode。是否可以通过 SAIL_XDEBUG_MODE 在控制台和浏览器中拥有相同的配置？

这是使用的 Dockerfile：

FROM ubuntu:21.04

LABEL maintainer="Taylor Otwell"

ARG WWWGROUP

WORKDIR /var/www/html

ENV DEBIAN_FRONTEND noninteractive
ENV TZ=UTC

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

RUN apt-get update \
    && apt-get install -y gnupg gosu curl ca-certificates zip unzip git supervisor sqlite3 libcap2-bin libpng-dev python2 \
    && mkdir -p ~/.gnupg \
    && chmod 600 ~/.gnupg \
    && echo "disable-ipv6" >> ~/.gnupg/dirmngr.conf \
    && apt-key adv --homedir ~/.gnupg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys E5267A6C \
    && apt-key adv --homedir ~/.gnupg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C300EE8C \
    && echo "deb http://ppa.launchpad.net/ondrej/php/ubuntu hirsute main" > /etc/apt/sources.list.d/ppa_ondrej_php.list \
    && apt-get update \
    && apt-get install -y php8.0-cli php8.0-dev \
       php8.0-pgsql php8.0-sqlite3 php8.0-gd \
       php8.0-curl php8.0-memcached \
       php8.0-imap php8.0-mysql php8.0-mbstring \
       php8.0-xml php8.0-zip php8.0-bcmath php8.0-soap \
       php8.0-intl php8.0-readline php8.0-pcov \
       php8.0-msgpack php8.0-igbinary php8.0-ldap \
       php8.0-redis php8.0-swoole php8.0-xdebug \
    && php -r "readfile('http://getcomposer.org/installer');" | php -- --install-dir=/usr/bin/ --filename=composer \
    && curl -sL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y nodejs \
    && curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - \
    && echo "deb https://dl.yarnpkg.com/debian/ stable main" > /etc/apt/sources.list.d/yarn.list \
    && apt-get update \
    && apt-get install -y yarn \
    && apt-get install -y mysql-client \
    && apt-get install -y postgresql-client \
    && apt-get -y autoremove \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

RUN setcap "cap_net_bind_service=+ep" /usr/bin/php8.0

RUN groupadd --force -g $WWWGROUP sail
RUN useradd -ms /bin/bash --no-user-group -g $WWWGROUP -u 1337 sail

COPY start-container /usr/local/bin/start-container
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
COPY php.ini /etc/php/8.0/cli/conf.d/99-sail.ini
RUN chmod +x /usr/local/bin/start-container

EXPOSE 8000

ENTRYPOINT ["start-container"]

这是我的 docker-compose.yml：

# For more information: https://laravel.com/docs/sail
version: '3'
services:
    laravel.test:
        build:
            context: ./vendor/laravel/sail/runtimes/8.0
            dockerfile: Dockerfile
            args:
                WWWGROUP: '${WWWGROUP}'
        image: sail-8.0/app
        extra_hosts:
            - 'host.docker.internal:host-gateway'
        ports:
            - '${APP_PORT:-80}:80'
        environment:
            WWWUSER: '${WWWUSER}'
            LARAVEL_SAIL: 1
            XDEBUG_MODE: '${SAIL_XDEBUG_MODE:-off}'
            XDEBUG_CONFIG: '${SAIL_XDEBUG_CONFIG:-client_host=host.docker.internal}'
            PHP_IDE_CONFIG: "serverName=my.local"
        volumes:
            - '.:/var/www/html'
        networks:
            - sail
        depends_on:
            - mysql
    mysql:
        image: 'mysql:8.0'
        ports:
            - '${FORWARD_DB_PORT:-3306}:3306'
        environment:
            MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
            MYSQL_DATABASE: '${DB_DATABASE}'
            MYSQL_USER: '${DB_USERNAME}'
            MYSQL_PASSWORD: '${DB_PASSWORD}'
            MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
        volumes:
            - 'sailmysql:/var/lib/mysql'
        networks:
            - sail
        healthcheck:
            test: ["CMD", "mysqladmin", "ping", "-p${DB_PASSWORD}"]
            retries: 3
            timeout: 5s
networks:
    sail:
        driver: bridge
volumes:
    sailmysql:
        driver: local

Answer 1

从所附的屏幕截图中可以看出，在控制台中使用 XDEBUG_MODE 环境变量，而在浏览器中使用 xdebug.mode。

Xdebug 如果已设置，则使用

XDEBUG_MODE

，否则它将回退到

xdebug.mode

设置的值。

我不知道 Sail 使用哪个 Web 服务器，但有些服务器会删除环境变量 — 包括

XDEBUG_MODE

。

因此您可以修复该问题，或者更新

Dockerfile

以在下面添加一行：

COPY php.ini /etc/php/8.0/cli/conf.d/99-sail.ini

其中说：

COPY xdebug.ini /etc/php/8.0/cli/conf.d/999-xdebug.ini

并添加

xdebug.ini

的内容（与

php.ini

同目录）：

xdebug.mode=develop,debug

Answer 2

我也遇到了同样的问题，而且我也在 macOS 上。

您必须使用

export

命令，如下所示：

export SAIL_XDEBUG_MODE=develop,debug

Answer 3

在~/.env中，添加：

SAIL_XDEBUG_MODE=debug

您可以在 docker-compose 文件中看到它使用此变量的值，或者默认为

off

。

XDEBUG_MODE: '${SAIL_XDEBUG_MODE:-off}'

您可能需要重新启动 docker 容器才能使其生效。