PHPackages                             clarence/thumbnail - 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. clarence/thumbnail

ActiveLibrary

clarence/thumbnail
==================

A library for making thumbnails, especially for composed images' thumbnail

v1.0.2(10y ago)5183MITPHPPHP &gt;5.3.0

Since Feb 25Pushed 10y ago1 watchersCompare

[ Source](https://github.com/Clarence-pan/thumbnail)[ Packagist](https://packagist.org/packages/clarence/thumbnail)[ RSS](/packages/clarence-thumbnail/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (4)Used By (0)

thumbnail 缩略图
=============

[](#thumbnail-缩略图)

A library for make multi images' thumbnail in PHP

用PHP写的一个生成多张图片的组合缩略图

Install 安装
==========

[](#install-安装)

Except downloading the source code from [github](https://github.com/clarence-pan/thumbnail), it is recommended to install via composer:

除了从 [github](https://github.com/clarence-pan/thumbnail) 上下载源码外，推荐使用composer安装：

```
composer require clarence/thumbnail
```

Examples 示例
===========

[](#examples-示例)

Composite the following 4 images into a thumbnail:

将以下四张图组合起来生成一张缩略图：

1. [![](https://github.com/Clarence-pan/thumbnail/raw/master/test/img/1.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/img/1.jpg?raw=true)
2. [![](https://github.com/Clarence-pan/thumbnail/raw/master/test/img/2.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/img/2.jpg?raw=true)
3. [![](https://github.com/Clarence-pan/thumbnail/raw/master/test/img/3.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/img/3.jpg?raw=true)
4. [![](https://github.com/Clarence-pan/thumbnail/raw/master/test/img/4.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/img/4.jpg?raw=true)

Let's see the result firstly:

先看效果：

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/example.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/example.jpg?raw=true)

Then, the example codes:

再看代码：

```
// file: test/example.php
$thumbnail = \Clarence\Thumbnail\Thumbnail::createFromImages($srcImages, 240, 320);
$thumbnail->writeImage($outputDir."/example.jpg");
```

Really pretty simple codes:

十分简单的代码~

`Thumbnail::createFromImages` is ussed to create the composited thumbnail. The first parameter is an array of original images' pathes; The second parameter is the thumbnail's width; The third parameter is the thumbnail's height; Then the image created is an instance of `Imagick` - so `writeImage` can be used to save it to a file.

`Thumbnail::createFromImages` 就是用于生成缩略图的关键函数，其第一个参数是原始图片的文件路径列表，第二个参数是生成的缩略图的宽度，第三个参数是生成的缩略图的高度；生成的图片是一个`Imagick`对象，然后可以使用`writeImage`将其保存到文件。

Other thumbnail types 其他缩略图类型
=============================

[](#other-thumbnail-types-其他缩略图类型)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/1-Thumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/1-Thumbnail.jpg?raw=true) (1 image)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/2-Thumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/2-Thumbnail.jpg?raw=true) (2 images)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/3-Thumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/3-Thumbnail.jpg?raw=true) (3 images)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/4-Thumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/4-Thumbnail.jpg?raw=true) (4 images)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/4-CropThumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/4-CropThumbnail.jpg?raw=true) (CropThumbnail)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/4-ScaleThumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/4-ScaleThumbnail.jpg?raw=true) (ScaleThumbnail)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/4-EqualScaleTopLeftThumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/4-EqualScaleTopLeftThumbnail.jpg?raw=true) (EqualScaleTopLeftThumbnail)

[![](https://github.com/Clarence-pan/thumbnail/raw/master/test/output/4-EqualScaleCenterThumbnail.jpg?raw=true)](https://github.com/Clarence-pan/thumbnail/blob/master/test/output/4-EqualScaleCenterThumbnail.jpg?raw=true) (EqualScaleCenterThumbnail)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

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 ~17 days

Total

3

Last Release

3692d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6440e0a9290b2e59c6c088202673fe19172717b7476ba4c821936a62d227d3f8?d=identicon)[Clarence-pan](/maintainers/Clarence-pan)

---

Top Contributors

[![Clarence-pan](https://avatars.githubusercontent.com/u/8750132?v=4)](https://github.com/Clarence-pan "Clarence-pan (12 commits)")

### Embed Badge

![Health badge](/badges/clarence-thumbnail/health.svg)

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

PHPackages © 2026

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