PHP 8.1 Upgrade / Compilation Failed: /bin/ld: cannot find -liconv: No such file

aaP_joybepari360

Server Environment:

OS: Ubuntu 22.04 LTS (Jammy)

Control Panel: aaPanel (Latest)

Web Server: Nginx (Single Server)

Issue Description:
While upgrading/compiling PHP-8.1 from the aaPanel App Store, the installation process failed during the build phase (make: *** Error 1).

Error Log snippet:

Plaintext
make: *** [Makefile:319: sapi/fpm/php-fpm] Error 1
make: *** Waiting for unfinished jobs....
collect2: error: ld returned 1 exit status
make: *** [Makefile:307: sapi/cli/php] Error 1
collect2: error: ld returned 1 exit status
make: *** [Makefile:352: sapi/phpdbg/phpdbg] Error 1
/bin/ld: cannot find -liconv: No such file or directory
collect2: error: ld returned 1 exit status
make: *** [Makefile:378: sapi/cgi/php-cgi] Error 1
(Screenshot attached for full terminal logs)

Questions:

Is this a missing dependency issue on Ubuntu 22.04, or is the linker failing to locate the compiled libiconv path?

How can I cleanly resolve the -liconv linker issue so that PHP-8.1 compiles and runs without affecting existing services?

Any advice or fix commands from the aaPanel team/community would be greatly appreciated. Thanks!

aaPanel_Kern

Hello.

Problem solved?
Is it okay to manually run this command to install the dependencies?
sudo apt-get install libiconv-dev

aaP_joybepari360

aaPanel_Kern
Hello @aaPanel_Kern,

Following up on my setup:

In the aaPanel App Store, there is no update option showing for PHP anymore. Currently, PHP 8.1 (8.1.34) and PHP 8.4 (8.4.24) are working from CLI, and PHP 8.1 FPM is running normally.
Should I continue using the current PHP installations as-is, or is there any risk of hidden/internal errors that require a clean reinstall?
apt install libiconv-dev returns “Unable to locate package libiconv-dev” on Ubuntu 22.04 LTS. Do I still need to run any additional build or repair commands?
For future fresh deployments, what base packages, build dependencies, or prerequisites does the aaPanel team officially recommend installing on a fresh Ubuntu 22.04 server before running the aaPanel installation script, to avoid missing dependency/linker issues during PHP or other software compilations?

Thanks!

aaPanel_Kern

Hello.

This seems to have been updated successfully

aaP_joybepari360

Hello aaPanel Team,
I have a fresh Ubuntu 22.04 LTS server with aaPanel installed. phpMyAdmin is showing this warning:
“The $cfg['TempDir'] (/www/server/phpmyadmin/phpmyadmin_32b9b821d5a029a6/tmp/) is not accessible. phpMyAdmin is not able to cache templates and will be slow because of this.”
Could you please tell me the correct and secure way to fix this permission/TempDir issue permanently? I

aaPanel_Kern

Hello.

This issue does not affect usage and you are advised to ignore it

aaP_joybepari360