xdebug installation fails on 8.x debian (missing lib/php-header.h)

[schmunk42]

Version of install-php-extensions

v.1.5.29

Error description

Build fails in Docker build for RUN install-php-extensions xdebug.
With fatal error: lib/php-header.h: No such file or directory

See for example https://github.com/yiisoft/yii-docker/runs/7444548717?check_suite_focus=true#step:6:752 - also tested with the command above.

2: compilation terminated.
2: make: *** [Makefile:286: src/lib/lib.lo] Error 1
2:  cc -I. -I/tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1 -I/tmp/pickle.tmp/pickle-7f747bef79dcb11e3af9f2d35a5c23574d431cf4/include -I/tmp/pickle.tmp/pickle-7f747bef79dcb11e3af9f2d35a5c23574d431cf4/main -I/tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1 -I/usr/local/include/php -I/usr/local/include/php/main -I/usr/local/include/php/TSRM -I/usr/local/include/php/Zend -I/usr/local/include/php/ext -I/usr/local/include/php/ext/date/lib -I/tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/src -I/tmp/pickle.tmp/pickle-7f747bef79dcb11e3af9f2d35a5c23574d431cf4/src -DHAVE_CONFIG_H -g -O2 -DZEND_COMPILE_DL_EXT=1 -c /tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/src/lib/usefulstuff.c -MMD -MF src/lib/usefulstuff.dep -MT src/lib/usefulstuff.lo  -fPIC -DPIC -o src/lib/.libs/usefulstuff.o
2: make: *** [Makefile:304: src/lib/var.lo] Error 1
2: make: *** [Makefile:262: src/base/base.lo] Error 1
2: /tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/src/lib/compat.c:42:10: fatal error: lib/php-header.h: No such file or directory
2:    42 | #include "lib/php-header.h"
2:       |          ^~~~~~~~~~~~~~~~~~
2: compilation terminated.
2: make: *** [Makefile:271: src/lib/compat.lo] Error 1
2: /tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/src/lib/str.c:23:10: fatal error: lib/php-header.h: No such file or directory
2:    23 | #include "lib/php-header.h"
2:       |          ^~~~~~~~~~~~~~~~~~
2: compilation terminated.
2: make: *** [Makefile:298: src/lib/str.lo] Error 1
2: In file included from /tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/src/lib/usefulstuff.c:33:
2: /tmp/pickle.tmp/xdebug/xdebug-3.2.0alpha1/php_xdebug.h:28:10: fatal error: lib/php-header.h: No such file or directory
2:    28 | #include "lib/php-header.h"
2:       |          ^~~~~~~~~~~~~~~~~~
2: compilation terminated.
2: make: *** [Makefile:268: src/lib/usefulstuff.lo] Error 1The command '/bin/sh -c install-php-extensions         xdebug' returned a non-zero code: 1

Docker image

php:8.x

Minimal Dockerfile

FROM php:8.1-apache
COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
RUN install-php-extensions \
        xdebug

[CodeCasterNL]

Docs:

Pre-release versions extensions available on PECL can be setup by suffixing the extension's name with its state i.e. alpha, beta, rc, preview, devel or snapshot. [...] When the latest version available on PECL is not stable, and you want to keep the last stable version, force it by suffixing the extension's name with the stable state.

The latest xdebug release on PECL (3.2.0alpha, 2022-07-20) is not stable, but alpha.

A workaround until that's fixed would be to tag a specific version:

install-php-extensions xdebug-^3.1

Or require stable:

install-php-extensions xdebug-stable

On an image building on 8.1:fpm-alpine, the error was:

configure: error: rtnetlink.h is required, install the linux-headers package: apk add --update linux-headers

[b1rdex]

Having the same problem with Alpine.

Actually, this is kinda strange, because the version is marked as beta on pecl:

For me install xdebug that prints (installing version stable) should not install beta versions :)

@mlocati, what do you think about the issue?

[schmunk42]

@mlocati @CodeCasterNL I tried to modify all extension installations to -stable.

But with this image https://github.com/yiisoft/yii2-docker/actions/runs/2718005323 I run into problems for PHP <7.2 now.

Actually either I should be able to install a stable version of the extension for all PHP versions.
Or as mentioned by @b1rdex I should explicitly tell the installer that I want a alpha or beta version.

[schmunk42]

I am reopening this, please let us know if we should create a new ticket for the issues described above.

[CodeCasterNL]

@schmunk42

INSTALLING REMOTE MODULE mongodb

(installing version stable)
pecl/mongodb requires PHP (version >= 7.2.0, version <= 8.99.99), installed version is 7.1.33

That's a different issue AFAIK.

[schmunk42]

Yes, but I am stuck there, because I can not build all images from 5.6 to 8.1, due to the fact that for 8.x it tries to install the 3.2alpha.

That's why I followed your advice also there to use -stable but this leads to the error you just mentioned.

If I just use it for xdebug-stable it still fails below 7.2, see https://github.com/yiisoft/yii2-docker/runs/7466830525?check_suite_focus=true

[igoooor]

Issue is not resolved for me using php:8.1.8-fpm-alpine3.16
RUN install-php-extensions xdebug
exits with:

The command '/bin/sh -c install-php-extensions xdebug' returned a non-zero code: 1
2022-07-22T11:08:12.549574363Z stdout P 2: configure: error: rtnetlink.h is required, install the linux-headers package: apk add --update linux-headers

Do we need to do any extra step to have it working agian?

[b1rdex]

@igoooor use xdebug-stable

[igoooor]

thanks for the quick answer.
Is that a temporary fix, or should I always use xdebug-stable from now on?

[CodeCasterNL]

Yes, but I am stuck there, because I can not build all images from 5.6 to 8.1, due to the fact that for 8.x it tries to install the 3.2alpha.

That's why I followed your advice also there to use -stable but this leads to the error you just mentioned.

If I just use it for xdebug-stable it still fails below 7.2, see https://github.com/yiisoft/yii2-docker/runs/7466830525?check_suite_focus=true

So two days ago it used to work? Did it detect the PHP version and according Mongo (and other extension) version or did Mongo recently publish a new version that won't work with PHP < 7.2?

[b1rdex]

thanks for the quick answer. Is that a temporary fix, or should I always use xdebug-stable from now on?

@igoooor this issue consist of multiple problems.

1. xdebug alpha release is missing a file: add missing php-header.h file for PECL package xdebug/xdebug#851 and that's why it errors on install
2. pickle has a bug – it picks not a stable version by default: Pickle picks RC instead of latest stable FriendsOfPHP/pickle#247 (and that's why xdebug-alpha is installed)

If xdebug alpha release had no errors, then you'd silently get an alpha version this thread wouldn't exist at all :D

So this is not a docker-php-extension-installer issue at all. I'll try to dig the problem with pickle.