Question

我正在使用基于wordpress:php7.1-fpm-alpine（https://github.com/docker-library/wordpress/blob/master/php7.1/fpm-alpine/Dockerfile）的php:7.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日发布）

与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？

4 个答案:

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