RPM distro: php-devel is not the right package to install

[remicollet]

1/ phpize

This command is not provided by the "devel" package but by the "cli" one, so when running pie, it is always installed

2/ php-config

The "devel" package provides this command, with the php headers and other build stuff

3/ package name

Since EL 10.2, there is a php8.4 stack.

So the package is not always php-devel but may be php8.4-devel (and later php8.5-devel... php8.6-devel...)

4/ command to install

dnf install /usr/bin/php-config

[remicollet]

To raise the problem

$ podman run --rm -ti rockylinux:10
...
# dnf install epel-release
...
# dnf install pie      (this will pull "best" php, so php8.4-cli)
...
# pie install -v remi/xpass
🥧 PHP Installer for Extensions (PIE) 1.4.5.0, from The PHP Foundation
You are running PHP 8.4.21
Target PHP installation: 8.4.21 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php)
Using pie.json: /root/.pie/php8.4_63ae1a19ff7e4ede35580d303a9ba79b/pie.json
Checking if all build tools are installed.
The following build tools are missing: gcc, make, autoconf, pkg-config, libtoolize/glibtoolize, phpize
The following command will be run: dnf install -y gcc make autoconf pkgconf-pkg-config libtool php-devel
Would you like to install them now?y
Could not install the missing build tools. You may need to install them manually.
Symfony\Component\Process\Exception\ProcessFailedException: The command "'dnf' 'install' '-y' 'gcc' 'make' 'autoconf' 'pkgconf-pkg-config' 'libtool' 'php-devel'" failed.

Exit Code: 1(General error)

Indeed "php-devel" cannot be installed

# dnf install php-devel
Last metadata expiration check: 0:05:01 ago on Tue Jun 23 06:29:23 2026.
Error: 
 Problem: problem with installed package php8.4-cli-8.4.21-1.el10_2.x86_64
  - package php8.4-cli-8.4.21-1.el10_2.x86_64 from @System conflicts with php-cli < 8.4 provided by php-cli-8.3.31-1.el10_2.x86_64 from appstream
  - package php8.4-cli-8.4.16-1.el10.x86_64 from appstream conflicts with php-cli < 8.4 provided by php-cli-8.3.31-1.el10_2.x86_64 from appstream
  - package php8.4-cli-8.4.21-1.el10_2.x86_64 from appstream conflicts with php-cli < 8.4 provided by php-cli-8.3.31-1.el10_2.x86_64 from appstream
  - package php-devel-8.3.31-1.el10_2.x86_64 from appstream requires php-cli(x86-64) = 8.3.31-1.el10_2, but none of the providers can be installed
  - cannot install the best candidate for the job
(try to add '--allowerasing' to command line to replace conflicting packages or '--skip-broken' to skip uninstallable packages or '--nobest' to use not only best candidate packages)

So

# dnf install /usr/bin/php-config    (this will pull php8.4-devel or php-devel, matching installed version)
...
# pie install remi/xpass
🥧 PHP Installer for Extensions (PIE) 1.4.5.0, from The PHP Foundation
You are running PHP 8.4.21
Target PHP installation: 8.4.21 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php)
Found package: remi/xpass:v1.2.1 which provides ext-xpass
Extracted remi/xpass:v1.2.1 source to: /root/.pie/php8.4_63ae1a19ff7e4ede35580d303a9ba79b/vendor/remi/xpass
phpize complete.
Configure complete with options: --with-php-config=/usr/bin/php-config
Build complete: /root/.pie/php8.4_63ae1a19ff7e4ede35580d303a9ba79b/vendor/remi/xpass/modules/xpass.so
Install complete: /usr/lib64/php/modules/xpass.so
✅ Extension is enabled and loaded in /usr/bin/php

[remicollet]

Additional run case

If all build tools are installed (gcc make autoconf pkgconf-pkg-config libtool), pie asks for phpize, which is installed, but fails

# phpize 
Can't find PHP headers in /usr/include/php
The php-devel package is required for use of this command.

# pie install remi/xpass -v
🥧 PHP Installer for Extensions (PIE) 1.4.5.0, from The PHP Foundation
You are running PHP 8.4.21
Target PHP installation: 8.4.21 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php)
Using pie.json: /root/.pie/php8.4_63ae1a19ff7e4ede35580d303a9ba79b/pie.json
Checking if all build tools are installed.
The following build tools are missing: phpize
The following command will be run: dnf install -y php-devel

[remicollet]

Trivial fix in src/SelfManage/BuildTools/CheckAllBuildTools.php

-                    PackageManager::Dnf->value => 'php-devel'
-                    PackageManager::Yum->value => 'php-devel'
+                    PackageManager::Dnf->value => preg_replace('((.*)php)', '$1php-config', PHP_BINARY),
+                    PackageManager::Yum->value => preg_replace('((.*)php)', '$1php-config', PHP_BINARY),

Notice: phpize is installed but not usable, so the missing package is properly detected (on wrong name).