ubuntu 22.04 默认php 8.1的gd扩展需libwebp-dev支持webp,安装后重启web服务并验证imagecreatefromwebp函数可用即成功。

Ubuntu 22.04 默认安装的 PHP 8.1 已支持 GD 扩展,但 WebP 图像处理需额外依赖库和正确启用。直接装 php8.1-gd 不一定自动带 WebP 支持——关键看系统是否装了 libwebp 开发包,以及 GD 编译时是否链接了它。
确认当前 GD 是否支持 WebP
运行以下命令检查:
php -i | grep -A5 "gd support" 或 php -r "print_r(gd_info());"
重点看输出中是否有 webp support => 1。如果没有,说明 GD 虽已启用,但不支持 WebP 格式。
安装 WebP 依赖与 GD 扩展
Ubuntu 22.04 的 php8.1-gd 包默认依赖系统级 libwebp,但开发头文件需手动安装:
- 先更新源并安装 WebP 支持库:
sudo apt update && sudo apt install libwebp-dev - 再安装 GD 扩展(确保版本匹配):
sudo apt install php8.1-gd - 验证扩展是否加载:
php -m | grep gd(应有输出)
重启服务使生效
GD 是模块级扩展,安装后需重启对应服务才能在 Web 环境中使用 WebP 函数(如 imagecreatefromwebp):
- Apache 用户:
sudo systemctl restart apache2 - Nginx + PHP-FPM 用户:
sudo systemctl restart php8.1-fpm && sudo systemctl restart nginx
快速验证 WebP 功能是否可用
创建一个测试文件 test-webp.php:
if (function_exists('imagecreatefromwebp')) {
echo "WebP supported ✅";
} else {
echo "WebP not available ❌";
}
?>
在浏览器或 CLI 中执行,输出 ✅ 即表示成功。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











