gd_info()显示WebP Support为false，说明PHP编译时未正确链接libwebp；需确认系统已安装libwebp-dev（Debian/Ubuntu）或libwebp-devel（RHEL/CentOS），并在configure阶段显式指定--with-webp-dir=/usr（路径以pkg-config --variable=prefix libwebp为准），且该参数必须位于--with-gd之后。
gd_info() 显示 WebP Support 为 false 怎么办
不是 PHP 没装 GD，而是编译时没连上 libwebp。即使系统已装 libwebp-dev（Debian/Ubuntu）或 libwebp-devel（RHEL/CentOS），PHP configure 阶段若未显式指定路径，--with-gd 会跳过 WebP 支持，且不报错。
- 先运行
php -r "print_r(gd_info()['WebP Support']);"确认值为false - 检查系统是否真有开发包：
dpkg -l libwebp-dev或rpm -q libwebp-devel - 重新编译 PHP 时，必须加
--with-webp-dir=/usr（路径以pkg-config --variable=prefix libwebp输出为准） - 注意顺序：
--with-webp-dir要在--with-gd之后、且不能漏掉--with-gd
imagecreatefromwebp() 报 “Unknown image type” 或警告 “Unsupported image type”
这说明 GD 在运行时根本没识别出 WebP 文件头，根源仍是编译缺失或路径错配。错误日志里通常不会直接写 “WebP”，而是笼统提示类型不支持，容易误判为文件损坏。
-
file your-image.webp确保输出含Web/P image，排除文件本身异常 - 用
getimagesize('your-image.webp')测试：若返回IMAGETYPE_WEBP（值为 18），说明 PHP 内核能识别格式，问题纯属 GD 层 - 某些旧版
libwebp（如 0.5.x）不被 GD 2.1.0+ 完全兼容，建议升级到libwebp >= 1.0.0 - Windows 下若用预编译包，需确认
php_gd2.dll对应的构建版本明确标注 “with WebP”
宝塔面板下重编 PHP 仍不生效的典型陷阱
宝塔默认 PHP 编译脚本常忽略 --with-webp-dir，即使你手动加了参数，也可能被内部逻辑覆盖或路径硬编码。
- 执行
bt 16进入编译界面后，不要只看“编译参数”框——点开“高级选项”，确认勾选了 “启用 WebP 支持”（部分版本该选项独立存在） - 编译前删掉
/www/server/php/{version}/src下的Makefile和config.status，避免缓存旧配置 - 编译完成后，运行
ldd $(php-config --extension-dir)/gd.so | grep webp，若无输出，说明链接失败 - Ubuntu 系用户特别注意：
libwebp-dev包可能安装在/usr/lib/x86_64-linux-gnu，此时需传--with-webp-dir=/usr而非--with-webp-dir=/usr/lib/x86_64-linux-gnu
PHP 8.1+ 下 WebP 相关函数行为变化
imagewebp() 本身没被移除，但它的第三个参数（quality）在 8.1 后对无损模式（$quality = 100）处理更严格，传非整数或超范围值会静默失败而非降级。
- 始终用
is_int($quality) && $quality >= 0 && $quality 校验质量值 - 生成透明背景 WebP 时，
imagealphablending($im, false)和imagesavealpha($im, true)缺一不可，否则透明通道丢失 - GD 不支持 WebP 的 ICC Profile 或 XMP 元数据，若需保留，得切到
Imagick扩展
WebP 支持不是“开了 GD 就自动有”的功能，它依赖编译期链接、运行时符号解析、以及 PHP 版本对底层库 API 的适配。最容易被忽略的是：即使 libwebp 已安装，configure 脚本也必须看见它，而这个“看见”需要路径精准、参数顺序正确、且不被构建系统覆盖。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
