Problem installing Xdebug in Docker and PhpStorm

Question

I am trying to install Xdebug with Docker and PhpStorm but when I put the code in Dockerfile, an error occurs.

Code:

FROM php:7.1-fpm
# Install selected extensions and other stuff
RUN apt-get update \
    && apt-get -y --no-install-recommends install  php-xdebug \
    && apt-get clean; rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/* \ && echo "zend_extension=/usr/lib/php/20160303/xdebug.so" > /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.remote_enable=on" >> /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.remote_handler=dbgp" >> /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.remote_port=9000" >> /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.remote_autostart=on" >> /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.remote_connect_back=0" >> /etc/php/7.1/mods-available/xdebug.ini \
    && echo "xdebug.idekey=docker" >> /etc/php/7.1/mods-available/xdebug.ini

Error:

E: Package 'php-xdebug' has no installation candidate
/bin/sh: 1: cannot create /etc/php/7.1/mods-available/xdebug.ini: Directory nonexistent
ERROR: Service 'php' failed to build: The command '/bin/sh -c apt-get update     && apt-get -y --no-install-recommends install  php-xdebug     && apt-get clean; rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /usr/share/doc/*     && echo "zend_extension=/usr/lib/php/20160303/xdebug.so" > /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.remote_enable=on" >> /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.remote_handler=dbgp" >> /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.remote_port=9000" >> /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.remote_autostart=on" >> /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.remote_connect_back=0" >> /etc/php/7.1/mods-available/xdebug.ini     && echo "xdebug.idekey=docker" >> /etc/php/7.1/mods-available/xdebug.ini' returned a non-zero code: 2

Dockerfile: /site/php/ Docker-Compose: /site/docker-compose.yml — Richard Nicson
– Richard Nicson, Commented Sep 13, 2019 at 14:45

Stefano · Accepted Answer · 2019-09-13 15:18:06Z

12

The image php:7.1-fpm uses Debian Buster and, for some reasons that I'm unable to figure out at the moment, the php-xdebug appears to be not available in the repo even though the package appears in the site (https://packages.debian.org/buster/php-xdebug).

I rewrote the Dockerfile in a way that it works but I'll keep checking.

Dockerfile:

FROM php:7.1-fpm

RUN pecl install xdebug

RUN echo 'zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20160303/xdebug.so' | tee /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_enable=on" | tee -a /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_handler=dbgp" | tee -a /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_port=9000" | tee -a /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_autostart=on" | tee -a /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_connect_back=0" | tee -a /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.idekey=docker" | tee -a /usr/local/etc/php/conf.d/xdebug.ini

answered Sep 13, 2019 at 15:18

Stefano

5,1061 gold badge23 silver badges31 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

Laurent W. Over a year ago

If it's not working, check the location of the xdebug.so file. It was no-debug-non-zts-20190902 for me.

okainov yesterday

Unfortunately pecl installation is deprecated in 2025, would be great to have modern answer...

Collectives™ on Stack Overflow

Problem installing Xdebug in Docker and PhpStorm

1 Answer 1

2 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

2 Comments

Your Answer

Sign up or log in

Post as a guest

Related