# PHP GD2或FreeType检测失败

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

# 是否安装GD2扩展?

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

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

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

  • macOS、Linux下,请执行php -i | grep -E "GD|FreeType"命令,无输出则并未安装,已经安装好的输出类似于:
[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"命令,无输出则并未安装,已经安装好的输出类似于:
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机制