PHPackages                             aileshe/thumb - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. aileshe/thumb

ActiveLibrary[Image & Media](/categories/media)

aileshe/thumb
=============

Thumbnail generator

v1.1.1(8y ago)7142818[1 issues](https://github.com/aileshe/Thumb/issues)MITPHPPHP >=5.3

Since Apr 10Pushed 8y agoCompare

[ Source](https://github.com/aileshe/Thumb)[ Packagist](https://packagist.org/packages/aileshe/thumb)[ RSS](/packages/aileshe-thumb/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (4)Used By (0)

Thumb是什么?
=========

[](#thumb是什么)

Thumb是一个图片等比例缩放的PHP依赖，使用Thumb可以轻松生成不变形的缩略图。

安装
==

[](#安装)

通过composer，这是推荐的方式，可以使用composer.json 声明依赖，或者直接运行下面的命令。

```
composer require aileshe/thumb:*

```

放入composer.json文件中

```
    "require": {
        "aileshe/thumb": "*"
    }

```

然后运行

```
composer update

```

基本用法
====

[](#基本用法)

1. 生成一张缩略图

```
    $src = './public/upload/img_12.jpg'; // 原图路径
    $output = './public/upload/img_12_thumb.jpg'; // 输出保存文件名
    $width = 300; // 预生成缩略图的宽
    $height = 200; // 预生成缩略图的高
    \Thumb\Thumb::out($src,$output,$width,$height);

```

2. 生成缩略图直接输出图象到浏览器

```
    $src = './public/upload/img_12.jpg'; // 原图路径
    $width = 300; // 预生成缩略图的宽
    $height = 200; // 预生成缩略图的高
    \Thumb\Thumb::show($src,$width,$height);

```

3. 生成缩略图直接输出图象到浏览器并保存缩略图

```
    $src = './public/upload/img_12.jpg'; // 原图路径
    $output = './public/upload/img_12_thumb.jpg'; // 输出保存文件名
    $width = 300; // 预生成缩略图的宽
    $height = 200; // 预生成缩略图的高
    \Thumb\Thumb::showOut($src,$output,$width,$height);

```

高级用法 - 自定义缩略剪裁
==============

[](#高级用法---自定义缩略剪裁)

如一张纵向图片在固定宽高等比例缩放后得到的缩略图必须要剪裁部分，所以要么居中剪裁，要么顶部、底部剪裁再去掉多余部分。

```
缩略剪裁方式: middle、top、bottom (默认: 居中)
 ________________    ________________    ________________
 |                |  |                |  |                |
 |                |  |      top       |  |                |
 |________________|  |                |  |                |
 |                |  |________________|  |                |
 |     middle     |  |                |  |                |
 |                |  |                |  |________________|
 |----------------|  |                |  |                |
 |                |  |                |  |      bottom    |
 |                |  |                |  |                |
 |________________|  |________________|  |________________|

\Thumb\Thumb::out([原图路径],[缩图文件名],[缩略图宽],[缩略图高],[middle|top|bottom]);
\Thumb\Thumb::show([原图路径],[缩略图宽],[缩略图高],[middle|top|bottom]);
\Thumb\Thumb::showOut([原图路径],[缩图文件名],[缩略图宽],[缩略图高],[middle|top|bottom]);

```

联系
==

[](#联系)

Author: Dejan
QQ : 673008865

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

3005d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/28887594?v=4)[aileshe](/maintainers/aileshe)[@aileshe](https://github.com/aileshe)

---

Top Contributors

[![aileshe](https://avatars.githubusercontent.com/u/28887594?v=4)](https://github.com/aileshe "aileshe (16 commits)")

---

Tags

phpphp5php7thumbs

### Embed Badge

![Health badge](/badges/aileshe-thumb/health.svg)

```
[![Health](https://phpackages.com/badges/aileshe-thumb/health.svg)](https://phpackages.com/packages/aileshe-thumb)
```

###  Alternatives

[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

495240.6k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)[rsoury/wp-imgix

Rewrites WordPress image URLs to use ImgIX

167.2k](/packages/rsoury-wp-imgix)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)