php freetype 函数 imagettftext 用法，实例代码真好懂。

发布日期： 2025-10-11 阅读量： 作者： admin

最近手头有个小活儿，需要在服务器上动态生成一些带文字的图片，大概就是那种分享图或者加个水印啥的。以前没怎么弄过 PHP 处理图片这么细致的操作，尤其是写字这块儿，所以就自己动手实践了一把。

一开始我先是想，PHP 这玩意儿能不能干这事儿？印象里好像有个叫 GD 库的东西。于是我就先检查了一下我服务器上的 PHP 环境。咋检查？就用了那个老办法，写个小文件，里面就一行 `phpinfo();`，然后在浏览器里打开看看。

在输出的一大堆信息里，我使劲找那个 GD 相关的部分。果然，找到了！里面有一项叫 FreeType Support，后面写着 enabled，这就说明 GD 库是支持 FreeType 的，心里就有底了，说明能用 TrueType 字体来画字，不是那种丑丑的默认字体。

准备工作

知道能行之后，就开始动手了。第一步，总得先有个“画布”？就是得先创建一张图片。我用了 `imagecreatetruecolor` 这个函数，指定了想要的宽度和高度，比如 300x100 像素，搞了一张黑色的背景图先。

代码大概就像这样：

$width = 300;
$height = 100;
$image = imagecreatetruecolor($width, $height);

然后是颜色。光有画布不行，还得有颜料。我想在黑色背景上写白色的字。这就需要用到 `imagecolorallocate` 函数。这函数挺有意思，第一次用它给某个图像资源分配颜色时，它定义的是背景色。但我这里是 `imagecreatetruecolor` 创建的，默认就是黑的，所以我后面再用 `imagecolorallocate` 定义的就是我要用的颜色了。

$white = imagecolorallocate($image, 255, 255, 255); // 定义个白色
$black = imagecolorallocate($image, 0, 0, 0); // 定义个黑色，虽然背景已经是了，有时候可能也需要

我决定还是先用 `imagefill` 把背景明确填成黑色，免得有意外。

imagefill($image, 0, 0, $black); // 把整个图填成黑色

写字的关键一步

画布和颜色都有了，接下来就是重头戏：写字。查了下资料，发现主要靠 `imagettftext` 这个函数。看名字就知道，TTF，就是 TrueType Font，专门用来加载字体文件写字的。

这个函数要的参数还不少，得琢磨琢磨：

第一个参数是图像资源，就是我刚才用 `imagecreatetruecolor` 创建的那个 $image。
第二个是字体大小，这个好理解，就是字号。
第三个是角度，0 就是正常的水平文字，给个 10 就是倾斜 10 度。
第四个和第五个是 X、Y 坐标，决定文字的起始位置（注意，这个坐标不是文字左上角，稍微有点复杂，是基线左下角的位置，得多试试找感觉）。
第六个是颜色，就是我之前用 `imagecolorallocate` 定义的那个 $white。
第七个是字体文件路径。这个是关键！你得在服务器上放一个真实的 `.ttf` 字体文件，比如微软雅黑的 `*` 或者其他的什么字体，然后把这个文件的路径告诉它。我当时就随便找了个免费的字体文件放到了项目目录下。
一个参数就是要写的文字内容了。

我大概是这么写的：

$font_path = './*'; // 假设我把字体文件放这了
$text = '你PHP FreeType！';
imagettftext($image, 20, 0, 50, 50, $white, $font_path, $text); // 在坐标(50, 50)用20号字写白色字

输出和收尾

字写上去了，但这玩意儿还在内存里。得让浏览器知道这是个图片，并且把它显示出来。所以在所有 PHP 代码输出之前，先得告诉浏览器我要输出的是一张图片，比如 PNG 格式。

header('Content-Type: image/png');

然后，用 `imagepng` 函数把内存里的图像数据输出给浏览器。

imagepng($image);

别忘了释放资源，好习惯嘛用 `imagedestroy` 把创建的图像资源从内存里干掉。

imagedestroy($image);

实践感受

整个过程跑下来，还算顺利。最容易出问题的地方就是那个字体文件路径，得确保 PHP 脚本有权限读取这个文件，而且路径得写对。还有就是那个 X、Y 坐标，得多试几次才能精确控制文字的位置。

如果文字太长需要换行，`imagettftext` 自己是不会换行的，得自己先把文字用 `wordwrap` 之类的函数处理一下，分成几行，然后多次调用 `imagettftext` 来写，每次调整 Y 坐标就行。稍微麻烦点，但也能实现。

用 PHP 的 GD 库配合 FreeType 来在图片上写字，功能还是挺强大的，熟悉了之后做点简单的图片生成任务完全没问题。这回实践记录下来，也算给自己备个忘。

上一篇: 个人云主机试用攻略，教你如何选择！

php freetype 函数 imagettftext 用法，实例代码真好懂。

随便看看