WordPress 使用 TimThumb 生成文章缩略图（历史方法与现代替代方案）

2020-04-23 · Ryan · 发表评论

前言：为什么需要自定义缩略图？

默认情况下，WordPress 会为上传的每张图片生成多个尺寸的缩略图（如缩略图、中等尺寸、大尺寸）。如果主题或插件并未全部使用这些尺寸，就会导致服务器空间被大量未使用的图片文件占用。为了解决这个问题，过去开发者常使用一个名为 timthumb.php 的脚本来按需动态生成缩略图。

关于 TimThumb 的重要须知

请注意：TimThumb 是一个已过时且存在安全风险的历史方案。

依赖 GD 库：需要服务器 PHP 环境支持 GD 图像处理库。
消耗服务器资源：每次请求都会动态处理图片，对服务器 CPU 和内存有一定压力。
不支持外部图片：默认只能处理托管在自己服务器上的图片。
已知安全漏洞：历史上出现过严重的安全漏洞，可能导致服务器被入侵。
项目已停止维护：作者明确表示不再更新此项目，使用它意味着承担潜在的安全风险。

鉴于以上风险，强烈不建议在现代 WordPress 网站中继续使用 TimThumb。本文档将首先介绍其历史使用方法，然后重点推荐更安全、高效的现代替代方案。

第一步：关闭 WordPress 默认缩略图功能

为了节省空间，可以先禁止 WordPress 自动生成多余的图片尺寸。在 WordPress 后台，进入“设置” → “媒体”。

将“缩略图大小”、“中等大小”、“大尺寸”的宽度和高度全部设置为 0 或留空。保存后，新上传的图片将只保留原始文件，不再自动生成其他尺寸。

注意：此设置仅对新上传的图片生效，已上传图片已生成的缩略图文件需要手动清理。

TimThumb 的历史部署方法

1. 下载与部署

下载 timthumb.php 文件（请从可靠来源获取其最终版本）。
将该文件上传到当前使用的 WordPress 主题文件夹内。
在同一主题文件夹中，创建一个名为 cache 的新文件夹，用于存储 TimThumb 生成的缓存图片。通常需要将该文件夹的权限设置为 755 或 777（具体取决于服务器配置）。

2. 获取文章缩略图地址的函数

需要在主题的 functions.php 文件中添加以下函数，用于获取文章的缩略图地址（优先使用自定义字段，其次使用文章特色图像，最后从文章内容中提取第一张图）。

// WordPress 获取文章缩略图地址函数
function post_thumbnail_src() {
    global $post;
    $post_thumbnail_src = '';

    // 1. 检查自定义字段 'thumbnail'
    if ($values = get_post_custom_values("thumbnail")) {
        $post_thumbnail_src = $values[0];
    }
    // 2. 检查是否有设置文章特色图像
    elseif (has_post_thumbnail()) {
        $thumbnail_src = wp_get_attachment_image_src(get_post_thumbnail_id($post->ID), 'full');
        $post_thumbnail_src = $thumbnail_src[0];
    }
    // 3. 从文章内容中提取第一张图片
    else {
        ob_start();
        ob_end_clean();
        $output = preg_match_all('/<img.+src=['"]([^'"]+)['"].*>/i', $post->post_content, $matches);
        if (!empty($matches[1][0])) {
            $post_thumbnail_src = $matches[1][0];
        }
        // 4. 都没有则使用默认图片
        if (empty($post_thumbnail_src)) {
            $post_thumbnail_src = get_template_directory_uri() . "/images/no-image.jpg";
        }
    }
    return $post_thumbnail_src; // 注意：原文是 echo，这里改为 return 更灵活
}

3. 在模板中调用

在需要显示缩略图的地方（如 index.php, archive.php），插入以下代码：

<img src="<?php echo get_template_directory_uri(); ?>/timthumb.php?src=<?php echo post_thumbnail_src(); ?>&h=150&w=200&zc=1" alt="<?php the_title(); ?>" />

参数说明：

h: 缩略图高度（像素）。
w: 缩略图宽度（像素）。
zc: 缩放裁剪模式。1 表示缩放并裁剪到精确尺寸；0 表示按比例缩放，不裁剪，可能留白。

4. 安全修补（历史方法）

由于 TimThumb 的漏洞常与外部域名白名单有关，一个旧版的修补建议是：在 timthumb.php 文件中，找到 $allowedSites 数组定义，并将其删除或注释掉，这样可以禁止处理任何外部图片，降低风险。

// 外部域名白名单（建议删除或注释以下整个数组以禁用外链）
// $allowedSites = array (
//        'flickr.com',
//        'picasa.com',
//        'blogger.com',
//        'wordpress.com',
//        'img.youtube.com',
// );

现代 WordPress 缩略图最佳实践

鉴于 TimThumb 的种种问题，以下是更推荐的现代解决方案：

方案一：使用 WordPress 核心功能与图像处理插件

恢复并利用默认缩略图：在“设置-媒体”中设置好你真正需要的几个尺寸（如文章列表图、相关文章图）。
使用专业图像优化插件：例如 ShortPixel、Imagify 或 EWWW Image Optimizer。这些插件可以智能压缩、优化已上传和新增的图片，并清理未使用的缩略图，从根源上节省空间并提升性能。

方案二：使用现代、安全的替代脚本或 CDN

CDN 动态图片处理：使用像 Cloudinary、Imgix 或 Akamai Image Manager 这样的服务。它们可以通过 URL 参数实时裁剪、缩放、优化图片，功能强大且不消耗源站资源。
使用维护良好的开源库：如果必须在服务器端处理，可以考虑集成像 Intervention Image（基于 PHP GD 或 Imagick）这样的现代、活跃维护的库，并自行封装安全调用。

方案三：主题开发推荐

对于主题开发者，处理文章缩略图的最佳方式是：

在 functions.php 中使用 add_image_size() 精确注册主题需要的图片尺寸。
在模板中使用 the_post_thumbnail('your-registered-size') 调用。
配合 wp_get_attachment_image_srcset() 实现响应式图片，适配不同设备。
使用插件或自定义代码定期清理（如 Force Regenerate Thumbnails）未使用的图片尺寸。

总结：TimThumb 是特定历史时期的解决方案，如今已不再适用。请优先考虑 WordPress 原生功能结合优化插件，或采用专业的云端图片处理服务，以确保网站的性能、安全性与可维护性。