Skip to content

PHP GD2 或 FreeType 检测失败 ​

此错误表示您当前命令行的 PHP 未安装GD2扩展或者未安装FreeType库

是否安装 GD2 扩展? ​

请执行 php -m 命令,在打印的列表中检查是否有 gd 扩展,若未列出该扩展,请参考 安装扩展

  • 您可以执行 php -v 命令确认当前命令行PHP版本
  • 您可以执行 php --ini 命令确认 php.ini 文件位置

是否安装(链接) FreeType 库? ​

  • 在 macOS、Linux 下,请执行 php -i | grep -E "GD|FreeType" 命令,无输出则并未安装,已经安装好的输出类似于:
ini
[root@centos ~]# php -i | grep -E "GD|FreeType"
GD Support => enabled
GD Version => bundled (2.1.0 compatible)
FreeType Support => enabled
FreeType Linkage => with freetype
FreeType Version => 2.9.1
  • 在 Windows 下,请打开 CMD(管理员) 或 Windows PowerShell(管理员),执行 php -i | findstr "FreeType" 命令,无输出则并未安装,已经安装好的输出类似于:
ini
PS C:\WINDOWS\system32> php -i | findstr "FreeType"
FreeType Support => enabled
FreeType Linkage => with freetype
FreeType Version => 2.9.1

安装 FreeType 库 ​

Windows ​

Windows 下集成环境通常都默认安装了 FreeType,若确实检测为未安装,请考虑:

  1. 切换 PHP版本
  2. 检查您的集成环境是否有可视化安装扩展的功能
  3. 查阅集成环境官网如何安装缺少的扩展
  4. 更换集成环境软件
Linux ​

您可以考虑以下方法安装 FreeType 库

  1. 重新编译 PHP
  2. 用 brew 安装一个新的 PHP
  3. 使用第三方集成环境,比如 宝塔面板 的 PHP 已经默认安装了 FreeType
Mac ​
  1. 使用第三方集成环境 phpenv、mamp、mamp pro、xampp 等
  2. 用 brew 安装一个新的 PHP
  3. 重新编译 PHP 或自己配环境,但您通常需要先关闭 Rootless机制