将 Xdebug 从 php-fpm 和 nginx 容器中分离出来

Question

我想将我的所有开发工具与主要的 php-fpm 和 nginx 容器分开。所以我基本上有 3 个名为 php-fpm 的容器在端口 9000 上运行，nginx 在端口 80 和 dev-tools 上运行。我已经在我的开发工具容器上安装了 xdebug、composer 等，但我很困惑如何配置 xdebug 以便它可以与 php-fpm 容器一起使用并可以调试我的网站？第二个问题 xdebug 是否需要 php-cli 或 php-fpm 才能自行运行？

#dev-tools

FROM php:7.2-cli-alpine

# Install the PHP extensions we need
RUN set -ex \
    && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin -- --filename=composer.phar \
    && apk add --no-cache git \
    && pecl install xdebug \
    && docker-php-ext-enable xdebug

Answer 1

xdebug 默认使用端口9000，与PHP-FPM 端口冲突。

您需要在 php.ini 中更改 PHP-FPM 池配置或 xdebug 的分配端口。我建议更新您的 PHP-FPM 配置以侦听不同的端口，因为使用 xdebug 进行调试的配置较少。

如果您想在 PHP-FPM 中更改端口。

/php-fpm.d/pool.conf

[pool]
listen = 127.0.0.1:9001

适当地更新您的 NGINX 配置以使用新端口。

否则，如果您想在 PHP 中更改 xdebug 端口。

php.ini

[xdebug]
xdebug.remote_port=9001

将您的调试（PHP 编辑器/IDE）软件和防火墙配置更新到新端口。或者使用 SSH 隧道将新的远程端口 9001 转发到默认的本地端口 9000

---

关于你的第二个问题

xdebug 仅作为 PHP (php-fpm) 的扩展运行，如果它设置为在您的 PHP ini 设置中加载。它不作为单独的后台服务运行。

例子：

[Browser Client -> http://example.com/path/to/script.php] 
   in -> [NGINX] 
        in -> [php-fpm /path/to/script.php] 
[xdebug remote host:port] <- out

或

[terminal command line] 
    in -> [php /path/to/script.php] 
[xdebug remote host:port] <-out

所以是的，xdebug 需要 php-fpm 或 php-cli 来运行，因为它们是一回事。

如果通过使用 php-fpm 的 Apache/NGINX，则需要将其加载到您的 fpm 配置中。如果通过 CLI 界面，则需要在 CLI 配置中加载。

请记住，您可以根据环境使用不同的 ini 配置运行 PHP。见PHP - The configuration file