编译PHP源码时启用--with-bz2选项出现链接错误求助

错误根源 #

链接报错的核心是/usr/local/lib/libbz2.a未使用-fPIC参数编译——PHP编译共享对象（如动态扩展）时，依赖的静态库必须支持位置无关代码（PIC），否则会触发 relocation 类型的链接错误。

解决步骤 #

1. 清理手动安装的bzip2残留 #

先移除/usr/local下的bzip2相关文件，避免干扰系统官方库的识别：

rm -rf /usr/local/lib/libbz2*
rm -rf /usr/local/include/bzlib.h
rm -rf /usr/local/bin/bzip2

2. 安装系统官方bzip2开发包 #

系统默认的bzip2-devel包已经预编译了PIC支持，直接用dnf安装即可：

dnf install -y bzip2-devel

3. 重新编译PHP #

方式一：让PHP自动识别系统库

清空之前的编译缓存，修正configure命令的笔误（原命令中--with-unapdo-mysql应为--with-pdo-mysql）后重新编译：

make clean
./configure --prefix=/usr/local/php82 --enable-cli --enable-fpm --program-suffix=82 --with-xsl --with-apxs2=/usr/local/apache/bin/apxs --with-zlib --enable-bcmath --with-bz2 --enable-calendar --enable-ftp --with-gettext --enable-gd --enable-intl --enable-mbstring --with-mysqli --with-pdo-mysql --enable-soap --enable-sockets --with-zip
make
make install

方式二：手动指定系统bzip2路径（自动识别失败时用）

如果系统库路径未被优先识别，configure时手动指定bz2的头文件和库路径：

make clean
./configure --prefix=/usr/local/php82 --enable-cli --enable-fpm --program-suffix=82 --with-xsl --with-apxs2=/usr/local/apache/bin/apxs --with-zlib --enable-bcmath --with-bz2=/usr --enable-calendar --enable-ftp --with-gettext --enable-gd --enable-intl --enable-mbstring --with-mysqli --with-pdo-mysql --enable-soap --enable-sockets --with-zip
make
make install

备选方案：手动编译带PIC的bzip2 #

如果必须手动编译bzip2，需在编译时添加-fPIC参数：

1. 下载并解压bzip2源码：

wget https://sourceware.org/pub/bzip2/bzip2-1.0.8.tar.gz
tar zxf bzip2-1.0.8.tar.gz
cd bzip2-1.0.8

2. 修改Makefile，添加-fPIC到编译参数：

sed -i 's/CFLAGS = -Wall/CFLAGS = -Wall -fPIC/' Makefile

3. 编译安装：

make
make install

完成后重新编译PHP即可。

内容的提问来源于stack exchange，提问作者youdsmedia