GD库是PHP内置图像处理扩展，启用需三步：一确认加载（CLI用php -m | grep gd，Web用phpinfo()查GD Support为enabled）；二修改php.ini启用extension=gd（Linux为gd.so，Windows为php_gd2.dll或gd.dll）并核对extension_dir路径；三验证png_support、jpeg_support、freetype_support全为true且imagecreatefrompng等函数返回有效资源。
GD库是PHP内置图像处理扩展，不是独立安装包，启用核心在于确认加载、检查依赖、验证支持项。它不需额外下载源码编译，但必须确保底层系统库完整、配置路径准确、服务重载生效。
确认GD是否已加载（分环境验证）
CLI和Web环境可能使用不同php.ini，需分别检查：
- 终端执行
php -m | grep -i gd，有输出说明命令行已加载 - 创建
info.php（内容<?php phpinfo(); ?>），浏览器访问后搜索“gd”区块，确认GD Support显示enabled - 运行
php --ini与phpinfo()中“Loaded Configuration File”对比，确保编辑的是实际生效的php.ini
修改php.ini启用扩展（路径与写法要匹配）
不同部署方式写法不同，不能一概而论：
- Linux动态加载：取消注释
extension=gd.so（Ubuntu/Debian常为extension=gd，且由/etc/php/*/mods-available/gd.ini控制，需sudo phpenmod gd） - Windows：取消注释
extension=gd或extension=php_gd2.dll（PHP 8.0+多用gd.dll） - 务必检查
extension_dir值为绝对路径，且该目录下存在对应扩展文件（如ext/gd.dll或extensions/gd.so）
补全系统级图像依赖库（否则函数返回false）
GD.so本身不带解码逻辑，依赖libpng、libjpeg、freetype等动态库：
立即学习“PHP免费学习笔记（深入）”；
- Linux执行
ldd $(php-config --extension-dir)/gd.so | grep -E "(png|jpeg|freetype)"，确认无“not found” - Ubuntu/Debian：
sudo apt install libpng-dev libjpeg-dev libfreetype6-dev - CentOS/RHEL：
sudo yum install libpng-devel libjpeg-devel freetype-devel - Windows phpEnv：将
libpng16.dll、libjpeg-9.dll、freetype6.dll复制到PHP安装根目录（与php.exe同级）
验证格式支持与函数可用性（关键看细节）
仅显示“GD Support enabled”不够，还需确认具体能力：
- 运行
<?php print_r(gd_info()); ?>，检查png_support、jpeg_support、freetype_support是否全为true - 直接调用测试函数：
var_dump(imagecreatefrompng(__DIR__.'/test.png'));，非false才表示真正可用 - 若
imagecreatefrompng()报“Call to undefined function”，说明扩展未加载；若返回false，大概率是PNG支持缺失而非函数不存在
