GD扩展未启用或格式支持不全导致imagecreatefrompng()等函数不可用；需先用extension_loaded('gd')确认加载状态，再通过gd_info()检查png_support等参数，最后按系统环境安装对应GD扩展及依赖库。
PHP 运行时提示 Call to undefined function imagecreatefrompng() 或 phpinfo() 中 GD 模块未显示，说明 GD 库确实没启用——这不是代码问题，是环境配置缺失。
确认 GD 是否真的没加载
别急着重装，先验证。在 PHP 脚本中执行：
var_dump(extension_loaded('gd'));
返回 false 才是真缺失；若返回 true 却仍报错，可能是 GD 编译时没带某格式支持（比如没编译 PNG 或 JPEG 支持）。此时检查 gd_info()：
var_dump(gd_info());
重点关注 png_support、jpeg_support、webp_support 是否为 true。
立即学习“PHP免费学习笔记（深入）”；
Linux 下启用 GD（以 Ubuntu/Debian 为例）
GD 是 PHP 扩展，不是独立服务，启用方式取决于 PHP 安装方式：
- 如果用
apt安装的 PHP（如php8.1），直接安装对应扩展包：sudo apt install php8.1-gd
- 安装后必须重启 Web 服务：
sudo systemctl restart apache2
或sudo systemctl restart php8.1-fpm
- 如果用源码编译的 PHP，需重新配置并启用 GD：
./configure --with-gd --with-jpeg-dir=/usr --with-png-dir=/usr --with-freetype-dir=/usr
，再make && sudo make install
Windows 下启用 GD（PHP 原生包）
打开 php.ini 文件（注意是 CLI 和 Web 使用的两个不同 php.ini，常见位置：C:\php\php.ini 或 C:\xampp\php\php.ini）：
- 取消注释这行：
;extension=gd
→ 改成extension=gd
- 确保
extension_dir指向正确的扩展目录，例如：extension_dir = "ext"
- Windows 下 GD 依赖
libpng16.dll、libjpeg-9.dll等，这些 DLL 必须在PATH或 PHP 目录下可被找到；若启动时报Unable to load dynamic library 'gd'，大概率是缺依赖 DLL
容器或云环境（Docker / Laravel Sail / Heroku）
这类环境里 GD 不是“默认开启”，而是需要显式声明：
- Dockerfile 中加一句：
RUN docker-php-ext-install gd
（适用于官方php:apache或php:fpm镜像） - Laravel Sail 用户：修改
sail/php/Dockerfile，在docker-php-ext-install后追加gd，然后./sail build --no-cache
- Heroku 上需通过
.buildpacks或composer.json的require字段触发扩展安装，单纯写extension=gd在php.ini里无效
GD 缺失最常被误判为“函数写错了”，其实连 imagecreatetruecolor() 都调不了——核心就两点：扩展是否加载成功、格式支持是否完整。尤其在 Alpine 容器里，php8-alpine 默认不带 GD，且依赖库名和 Debian 不同（比如要装 libpng-dev 而非 libpng16-dev），这点容易忽略。
