PHPackages                             poplanchong123/image-compress - 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. poplanchong123/image-compress

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

poplanchong123/image-compress
=============================

A powerful image compression library similar to TinyPNG

1.0.1(7mo ago)05MITPHPPHP >=5.6

Since Sep 26Pushed 7mo agoCompare

[ Source](https://github.com/poplanchong123/image-compress)[ Packagist](https://packagist.org/packages/poplanchong123/image-compress)[ RSS](/packages/poplanchong123-image-compress/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

Image Compress
==============

[](#image-compress)

一个强大的PHP图片压缩库，提供类似TinyPNG的功能。

特性
--

[](#特性)

- 支持多种图片格式（JPG/JPEG、PNG、GIF）
- 智能压缩算法，在保证画质的前提下减小文件体积
- 支持等比缩放图片尺寸
- 多种输入方式支持：
    - 上传图片文件
    - 本地图片路径
    - Base64编码的图片数据
- 灵活的输出选项：
    - 保存到指定路径
    - 返回文件流
- 批量处理支持
- 完善的错误处理机制

安装
--

[](#安装)

```
composer require poplanchong123/image-compress
```

要求
--

[](#要求)

- PHP >= 5.6
- GD扩展
- Fileinfo扩展

快速开始
----

[](#快速开始)

```
use Poplanchong123\ImageCompress\ImageCompressor;
use Poplanchong123\ImageCompress\Input\FileInput;
use Poplanchong123\ImageCompress\Output\FileOutput;

// 创建压缩器实例
$compressor = new ImageCompressor([
    'max_width' => 1920,
    'max_height' => 1080,
    'quality' => 85
]);

// 压缩图片
$input = new FileInput('path/to/input.jpg');
$output = new FileOutput('path/to/output.jpg');
$result = $compressor->compress($input, $output);
```

配置选项
----

[](#配置选项)

- `max_width`: 最大宽度（像素）
- `max_height`: 最大高度（像素）
- `quality`: 压缩质量（1-100）
- `preserve_aspect_ratio`: 是否保持宽高比（默认：true）
- `strip_metadata`: 是否去除元数据（默认：true）

输入方式
----

[](#输入方式)

### 文件输入

[](#文件输入)

```
use Poplanchong123\ImageCompress\Input\FileInput;

$input = new FileInput('path/to/image.jpg');
```

### Base64输入

[](#base64输入)

```
use Poplanchong123\ImageCompress\Input\Base64Input;

$input = new Base64Input($base64String);
```

输出方式
----

[](#输出方式)

### 文件输出

[](#文件输出)

```
use Poplanchong123\ImageCompress\Output\FileOutput;

$output = new FileOutput('path/to/output.jpg');
```

### 流输出

[](#流输出)

```
use Poplanchong123\ImageCompress\Output\StreamOutput;

$output = new StreamOutput();
$imageData = $compressor->compress($input, $output);
```

批量处理
----

[](#批量处理)

```
$inputs = [
    new FileInput('path/to/image1.jpg'),
    new FileInput('path/to/image2.png')
];

$outputs = [
    new FileOutput('path/to/output1.jpg'),
    new FileOutput('path/to/output2.png')
];

$results = $compressor->batchCompress($inputs, $outputs);
```

错误处理
----

[](#错误处理)

库使用异常机制处理错误。所有的异常都继承自`ImageCompressException`：

```
try {
    $result = $compressor->compress($input, $output);
} catch (ImageCompressException $e) {
    echo "压缩失败：" . $e->getMessage();
}
```

示例
--

[](#示例)

更多使用示例请查看`examples`目录。

许可证
---

[](#许可证)

MIT License

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance63

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity31

Early-stage or recently created project

 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

2

Last Release

227d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e3a187a6e7803eba13578b255852bcccde8237939b3d1f2fe13e6adcdf1b606?d=identicon)[poplanchong123](/maintainers/poplanchong123)

---

Top Contributors

[![poplanchong123](https://avatars.githubusercontent.com/u/9860456?v=4)](https://github.com/poplanchong123 "poplanchong123 (7 commits)")

### Embed Badge

![Health badge](/badges/poplanchong123-image-compress/health.svg)

```
[![Health](https://phpackages.com/badges/poplanchong123-image-compress/health.svg)](https://phpackages.com/packages/poplanchong123-image-compress)
```

###  Alternatives

[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

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

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)

PHPackages © 2026

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