PHP的GD扩展在CLI中加载正常但Apache 2中无法加载

问题概述 #

在Android的Termux里搭建了Apache+PHP本地服务器（用于VR头显本地加载PHP内容），GD扩展在PHP命令行（CLI）中可正常使用，但通过Apache运行PHP时加载失败，调用gd_info()会报错Call to undefined function gd_info()。

CLI环境下GD正常表现：

• 执行php -i能看到GD模块相关内容，且显示已加载/data/data/com.termux/files/usr/etc/php/conf.d/gd.ini
• 进入php -a控制台运行var_dump(gd_info())可正常返回信息

Apache环境问题：

• 访问php_info()页面，配置路径与CLI显示一致，但无GD模块内容
• 已尝试取消php.ini中extension=gd注释、设置extension_dir、在httpd.conf指定PHPIniDir，确认php.ini已加载，但GD仍未生效

解决步骤 #

1. 核对Apache的PHP模块与CLI版本是否一致 #

Termux可能出现PHP CLI和Apache所用PHP模块版本不匹配的情况，先检查版本：

# 查看CLI版本
php -v
# 查找Apache的PHP模块并查看版本
find /data/data/com.termux/files/usr -name "libphp*.so" | xargs file

若版本不一致，卸载重装匹配的包：

pkg remove apache2 php
pkg install apache2 php

2. 确保PHP配置加载conf.d目录 #

默认PHP应自动加载conf.d下的.ini文件，但Apache的PHP模块可能未启用该配置。编辑/data/data/com.termux/files/usr/etc/php/php.ini，确认存在以下内容（无则添加）：

; 加载conf.d下所有配置文件
include=/data/data/com.termux/files/usr/etc/php/conf.d/*.ini
; 指定扩展目录
extension_dir = "/data/data/com.termux/files/usr/lib/php/modules"

3. 手动在httpd.conf中指定GD扩展路径 #

先定位GD扩展的实际位置：

find /data/data/com.termux/files/usr -name "gd.so"

假设路径为/data/data/com.termux/files/usr/lib/php/modules/gd.so，编辑httpd.conf，在PHP模块配置块中添加：

<IfModule php_module>
    PHPIniDir "/data/data/com.termux/files/usr/etc/php"
    LoadFile "/data/data/com.termux/files/usr/lib/libgd.so"
    LoadModule gd_module "/data/data/com.termux/files/usr/lib/php/modules/gd.so"
</IfModule>

修改后重启Apache：

apachectl restart

4. 检查文件权限 #

确保Apache进程可读取GD扩展文件和配置文件：

# 设置文件权限
chmod 644 /data/data/com.termux/files/usr/lib/php/modules/gd.so
chmod 644 /data/data/com.termux/files/usr/etc/php/conf.d/gd.ini
# 将目录权限赋予Apache运行用户（通常为http）
chown -R http:http /data/data/com.termux/files/usr/lib/php/modules/
chown -R http:http /data/data/com.termux/files/usr/etc/php/

5. 重新编译PHP（万不得已时使用） #

若为手动编译的PHP，可能编译参数未适配Apache模块，重新编译时添加对应参数：

pkg install libgd-dev
# 切换到PHP源码目录（替换为实际路径）
cd /path/to/php-source
./configure --enable-gd=shared --with-external-gd --with-apxs2=/data/data/com.termux/files/usr/bin/apxs
make && make install

验证方法 #

修改配置后重启Apache：

apachectl restart

访问包含php_info()的页面，查看是否出现GD模块章节，或使用以下脚本测试：

<?php
if (function_exists('gd_info')) {
    var_dump(gd_info());
} else {
    echo "GD模块未加载";
}
?>

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