如何在 docker 的官方 php-fpm-alpine 镜像上安装 XDebug？

Question

我正在使用基于 php:7.1-fpm-alpine (https://github.com/docker-library/wordpress/blob/master/php7.1/fpm-alpine/Dockerfile) 的 wordpress:php7.1-fpm-alpine。

我试过了RUN pecl install xdebug-2.5.0 && docker-php-ext-enable xdebug

构建时出现错误：

Step 19/19 : RUN pecl install xdebug-2.5.0     && docker-php-ext-enable xdebug
 ---> Running in 52c988e12cb2
downloading xdebug-2.5.0.tgz ...
Starting to download xdebug-2.5.0.tgz (267,640 bytes)
........................................................done: 267,640 bytes
76 source files, building
running: phpize
Configuring for:
PHP Api Version:         20160303
Zend Module Api No:      20160303
Zend Extension Api No:   320160303
Cannot find autoconf. Please check your autoconf installation and the
$PHP_AUTOCONF environment variable. Then, rerun this script.

Answer 1

以下足以在该映像上简单地安装 xdebug：

FROM wordpress:php7.1-fpm-alpine

RUN apk add --no-cache $PHPIZE_DEPS \
    && pecl install xdebug-2.5.0 \
    && docker-php-ext-enable xdebug

构建它，然后从结果图像中的 shell 运行生成以下内容：

$ php -i | grep Xdebug
    with Xdebug v2.5.0, Copyright (c) 2002-2016, by Derick Rethans

Answer 2

如果您担心图像大小，您可以删除依赖项：

FROM wordpress:php7.1-fpm-alpine 
RUN apk --update --no-cache add autoconf g++ make && \
    pecl install -f xdebug && \
    docker-php-ext-enable xdebug && \
    apk del --purge autoconf g++ make

Answer 3

很好的回答@msanchez_aplyca。虽然更正确地通过 apk 删除构建依赖项将是：

RUN apk add --no-cache --virtual .build-deps $PHPIZE_DEPS \
    && pecl install xdebug-2.5.0 \
    && docker-php-ext-enable xdebug \
    && apk del -f .build-deps

Answer 4

对于 PHP >= 7.2 你需要使用 Xdebug 2.6.0+

例如，安装Xdebug 3.0.0（2020年11月25日发布）

Compatible with PHP 8.0

RUN apk add --no-cache --virtual .build-deps $PHPIZE_DEPS \
    && pecl install xdebug-3.0.0 \
    && docker-php-ext-enable xdebug \
    && apk del -f .build-deps

现在你通过添加类似的东西来设置它（使用 Xdebug 3.0.0 语法，more info here）：

# Configure Xdebug
RUN echo "xdebug.start_with_request=yes" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.mode=debug" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.log=/var/www/html/xdebug/xdebug.log" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.discover_client_host=1" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.client_port=9000" >> /usr/local/etc/php/conf.d/xdebug.ini

如何在 docker 的官方 php-fpm-alpine 镜像上安装 XDebug？

How do I install XDebug on docker's official php-fpm-alpine image?

php

docker

alpine

对于 PHP >= 7.2 你需要使用 Xdebug 2.6.0+