PHPackages                             hinet/laravel-summernote - 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. [Utility & Helpers](/categories/utility)
4. /
5. hinet/laravel-summernote

ActiveLibrary[Utility & Helpers](/categories/utility)

hinet/laravel-summernote
========================

Summernote editor integration for Laravel.

1.1.3(4y ago)15211MITJavaScript

Since Jul 8Pushed 3y ago1 watchersCompare

[ Source](https://github.com/hinet/laravel-summernote)[ Packagist](https://packagist.org/packages/hinet/laravel-summernote)[ RSS](/packages/hinet-laravel-summernote/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (0)

Laravel-Summernote
==================

[](#laravel-summernote)

Summernote editor integration for Laravel.

使用
==

[](#使用)

安装
--

[](#安装)

```
$ composer require "hinet/laravel-summernote"
```

配置
--

[](#配置)

1. 添加下面一行到 `config/app.php` 中 `providers` 部分：

    ```
    Hinet\LaravelSummernote\SummernoteServiceProvider::class,
    ```
2. 发布配置文件与资源

    ```
    $ php artisan vendor:publish --provider='Hinet\LaravelSummernote\SummernoteServiceProvider'
    ```

    如果发布异常可以使用:

    ```
    $ php artisan vendor:publish
    ```

    然后选择Hinet\\LaravelSummernote\\SummernoteServiceProvider
3. 模板引入编辑器

    这行的作用是引入编辑器需要的 css,js 等文件，所以你不需要再手动去引入它们。

    ```
    @include('vendor.summernote.assets')
    ```
4. 编辑器的初始化

    ```

        $(function() {
            $('#content').summernote($.extend(summernoteOptions, {
                lang:'zh-CN',//根据config/app.php中配置的语言
                height: 300,
            }));
        });

    ```
5. 使用Markdown插件

    ```

        $(function() {
            $('#content').summernote($.extend(summernoteOptions, {
                lang:'zh-CN',//根据config/app.php中配置的语言
                height: 300,
                toolbar : [
                    ['style', ['style']],
                    ['font', ['bold', 'underline', 'clear']],
                    ['fontname', ['fontname']],
                    ['color', ['color']],
                    ['para', ['ul', 'ol', 'paragraph']],
                    ['table', ['table']],
                    ['insert', ['link', 'picture', 'video']],
                    ['markdown'],
                    ['view', ['fullscreen', 'codeview', 'help']]
                ],
            }));
        });

    ```

说明
==

[](#说明)

1. 如果你使用的是 laravel 5.3 以下版本，请先创建软链接： ```
    # 请在项目根目录执行以下命令
    $ ln -s `pwd`/storage/app/public `pwd`/public/storage
    ```
2. 在 `config/summernote.php` 配置 `disk` 为 `'public'` 情况下，上传路径在：`public/uploads/` 下，确认该目录存在并可写。
3. 如果要修改上传路径，请在 `config/summernote.php` 里各种类型的上传路径，但是都在 public 下。
4. 请在 `.env` 中正确配置 `APP_URL` 为你的当前域名，否则可能上传成功了，但是无法正确显示。

七牛支持
----

[](#七牛支持)

如果你想使用七牛云储存，需要进行下面几个简单的操作：

1.安装和配置 [laravel-filesystem-qiniu](https://github.com/overtrue/laravel-filesystem-qiniu)

2.配置 `config/summernote.php` 的 `disk` 为 `qiniu`:

```
'disk' => 'qiniu'
```

3.剩下时间打局 LOL，已经完事了。

> 七牛的 `access_key` 和 `secret_key` 可以在这里找到： ,在创建 `bucket` （空间）的时候，推荐大家都使用公开的空间。

事件
--

[](#事件)

你肯定有一些朋友肯定会有一些比较特殊的场景，那么你可以使用本插件提供的事件来支持：

> 请按照 Laravel 事件的文档来使用：

### 上传中事件

[](#上传中事件)

> Hinet\\LaravelSummernote\\Events\\Uploading

在保存文件之前，你可以拿到一些信息：

- `$event->file` 这是请求的已经上传的文件对象，`Symfony\Component\HttpFoundation\File\UploadedFile` 实例。
- `$event->filename` 这是即将存储时用的新文件名
- `$event->config` 上传配置，数组。

你可以在本事件监听器返回值，返回值将替换 `$filename` 作为存储文件名。

### 上传完成事件

[](#上传完成事件)

> Hinet\\LaravelSummernote\\Events\\Uploaded

它有两个属性：

- `$event->file` 与 Uploading 一样，上传的文件
- `$event->result` 上传结构，数组，包含以下信息：

    ```
    'state' => 'SUCCESS',
    'url' => 'http://xxxxxx.qiniucdn.com/xxx/xxx.jpg',
    'title' => '文件名.jpg',
    'original' => '上传时的源文件名.jpg',
    'type' => 'jpg',
    'size' => 17283,
    ```

你可以监听此事件用于一些后续处理任务，比如记录到数据库。

License
=======

[](#license)

MIT

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 68.2% 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 ~361 days

Total

5

Last Release

1793d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/85a6bc2552f88eb20f4f5c6633812ba9693a876f16acb38b43497116a688d28a?d=identicon)[hinet](/maintainers/hinet)

---

Top Contributors

[![hiship](https://avatars.githubusercontent.com/u/183052291?v=4)](https://github.com/hiship "hiship (15 commits)")[![hinet](https://avatars.githubusercontent.com/u/2193699?v=4)](https://github.com/hinet "hinet (5 commits)")[![overtrue](https://avatars.githubusercontent.com/u/1472352?v=4)](https://github.com/overtrue "overtrue (2 commits)")

---

Tags

summernotelaravel summernote

### Embed Badge

![Health badge](/badges/hinet-laravel-summernote/health.svg)

```
[![Health](https://phpackages.com/badges/hinet-laravel-summernote/health.svg)](https://phpackages.com/packages/hinet-laravel-summernote)
```

###  Alternatives

[ddoe/wysiwyg-editor-module

Summernote WYSIWYG Editor for OXID eShop.

19981.7k2](/packages/ddoe-wysiwyg-editor-module)[nubs/vectorix

A vector library.

162.4k2](/packages/nubs-vectorix)

PHPackages © 2026

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