PHPackages                             gzoran/laravel-admin-cropper - 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. gzoran/laravel-admin-cropper

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

gzoran/laravel-admin-cropper
============================

Integrate Cropper into laravel-admin

1.0.2(6y ago)01.4kMITPHPPHP >=7.0.0

Since Jan 20Pushed 6y agoCompare

[ Source](https://github.com/gzoran/laravel-admin-cropper)[ Packagist](https://packagist.org/packages/gzoran/laravel-admin-cropper)[ Docs](https://github.com/laravel-admin-extensions/cropper)[ RSS](/packages/gzoran-laravel-admin-cropper/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (2)Versions (4)Used By (0)

cropper extension for laravel-admin
===================================

[](#cropper-extension-for-laravel-admin)

这是一个`laravel-admin`扩展，用来将`cropper`集成进`laravel-admin`的表单中

源码来源于：

截图
--

[](#截图)

[![](./demo.jpg)](./demo.jpg)

安装
--

[](#安装)

```
composer require "gzoran/laravel-admin-cropper:~1.0"
```

然后

```
php artisan vendor:publish --tag=laravel-admin-cropper
```

配置
--

[](#配置)

在`config/admin.php`文件的`extensions`，加上属于这个扩展的一些配置

```
    'extensions' => [

        'cropper' => [

            // 如果要关掉这个扩展，设置为false
            'enable' => true,
        ]
    ]
```

使用
--

[](#使用)

在form表单中使用它：

```
$form->cropper('content','label');
```

默认模式是自由剪裁模式，如果需要强制剪裁尺寸，请使用（注意该尺寸就是最后得到的图片尺寸 非“比例”）

```
$form->cropper('content','label')->cRatio($width,$height);
```

自定义文件名称（使用 basename 方法，原 name 方法在此插件无效）

```
$form->cropper('content','label')
    ->basename(function () {
        return time() . '_' . str_random(10);
    });
```

> 使用 basename 方法请返回一个不包含拓展名的自定义文件名称

自定义存储路径

```
$form->cropper('content','label')->move('images/users/avatars');
```

PS （特性预读）
---------

[](#ps-特性预读)

1、图片并不是预上传的，而是前端转base64之后填入input，服务端再转回图片保存的

2、图片格式是默认原格式保存的。就是说，如果原图是透明底色的png图片，保存之后仍旧是透明底色的png图片，并不会损失（前端logo神器）

3、该扩展是可多次调用的。在同一个表单内能调动多次，不会相互干扰。

4、扩展继承了laravel-admin 的ImageField类 和File类。 所以你不必去纠结图片的修改 和删除问题。他们都是自动操作的。 当然，因为继承了ImageField类，所以也能使用 “intervention/image” 的各种(crop,fit,insert)方法 （前提是你已经composer require intervention/image）

License
-------

[](#license)

Licensed under [The MIT License (MIT)](LICENSE).

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

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

Total

3

Last Release

2552d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0ad4f92147e31cc7ad2b275c7e295cef20e5d08dc917bb997267f0d9ece3d50?d=identicon)[gzoran](/maintainers/gzoran)

---

Top Contributors

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

---

Tags

imageextensionlaravel-admincropper

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/gzoran-laravel-admin-cropper/health.svg)

```
[![Health](https://phpackages.com/badges/gzoran-laravel-admin-cropper/health.svg)](https://phpackages.com/packages/gzoran-laravel-admin-cropper)
```

###  Alternatives

[laravel-admin-ext/cropper

Integrate Cropper into laravel-admin

7233.5k](/packages/laravel-admin-ext-cropper)[laravel-admin-ext/media-player

Intergrates mediaelement into laravel-admin

3253.7k](/packages/laravel-admin-ext-media-player)[bilginnet/yii2-cropper

Yii2 Bootstrap Cropper Input Widget

2232.1k](/packages/bilginnet-yii2-cropper)[simonvomeyser/commonmark-ext-lazy-image

Adds support for lazy images to the phpleague/commonmark markdown parser package

1821.3k1](/packages/simonvomeyser-commonmark-ext-lazy-image)[maxmirazh33/yii2-uploadable-cropable-image

Yii2 extension for upload and crop images

1020.8k](/packages/maxmirazh33-yii2-uploadable-cropable-image)[somehow-digital/typo3-media-processing

Media Processing

101.1k](/packages/somehow-digital-typo3-media-processing)

PHPackages © 2026

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