PHPackages                             douyasi/laravel-ckeditor - 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. [Templating &amp; Views](/categories/templating)
4. /
5. douyasi/laravel-ckeditor

ActiveLibrary[Templating &amp; Views](/categories/templating)

douyasi/laravel-ckeditor
========================

CKEditor for laravel

1.2(4y ago)31081MITPHPPHP &gt;=5.5.9

Since Jan 27Pushed 4y ago2 watchersCompare

[ Source](https://github.com/douyasi/laravel-ckeditor)[ Packagist](https://packagist.org/packages/douyasi/laravel-ckeditor)[ RSS](/packages/douyasi-laravel-ckeditor/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

CKEditor(4) for Laravel with image upload support
=================================================

[](#ckeditor4-for-laravel-with-image-upload-support)

[ENGLISH README](./README_en.md)

> `CKEditor` —— 国外大名鼎鼎的富文本编辑器，官方网站： 。目前官方最新版本为 `CKEditor5` ，建议配合 `React/Vue` 等前端框架工程化使用。

[![Latest Stable Version](https://camo.githubusercontent.com/c4a05353be7151a48d31ebe1e1a0e3a256b665187fe3772da9dfbaa672ea35f9/68747470733a2f2f706f7365722e707567782e6f72672f646f75796173692f6c61726176656c2d636b656469746f722f762f737461626c652e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/douyasi/laravel-ckeditor)[![Latest Unstable Version](https://camo.githubusercontent.com/7706a55ed09f3bc117e1c85500c57ba94aa7d832928a4f02a37da6e3ed52a9fd/68747470733a2f2f706f7365722e707567782e6f72672f646f75796173692f6c61726176656c2d636b656469746f722f762f756e737461626c652e7376673f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/douyasi/laravel-ckeditor)[![License](https://camo.githubusercontent.com/9e01c8e583115251e01d186b3159aef7a2853f3c9c1139c34a15e090c59e9a9f/68747470733a2f2f706f7365722e707567782e6f72672f646f75796173692f6c61726176656c2d636b656469746f722f6c6963656e73653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/douyasi/laravel-ckeditor)[![Total Downloads](https://camo.githubusercontent.com/67aa64fa8d214f381a470f6da37fb4361daeb445acf135f100a61ddf1bd68924/68747470733a2f2f706f7365722e707567782e6f72672f646f75796173692f6c61726176656c2d636b656469746f722f646f776e6c6f6164733f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/douyasi/laravel-ckeditor)

更新日志
----

[](#更新日志)

- `2022-05-25` 发布 `1.2` 版本，更新 `CKEditor4` 版本到最新的 `4.19.0` 版本，并适配图片上传接口。

兼容版本
----

[](#兼容版本)

本扩展包经过测试，适配 `Laravel 5` 以上所有版本（`Laravel 5 - 9` 均适配）。

安装与配置
-----

[](#安装与配置)

在 `composer.json` 新增 `"douyasi/laravel-ckeditor": "~1.0"` 依赖，然后执行： `composer update` 操作。

亦可在项目目录下，终端中执行 `composer require "douyasi/laravel-ckeditor:~1.0"` 命令。

```
$ cd /path/to/your/laravel/project
$ vim composer.json
# 添加 "douyasi/laravel-ckeditor": "~1.0"
$ composer install/update -vvv
# 或者 执行
$ composer require "douyasi/laravel-ckeditor: ~1.0"
```

如果 Laravel 插件自动发现功能没起到作用，需要手动在 `app.php` 中添加：

```
'providers' => [
        'Douyasi\CKEditor\CKEditorServiceProvider',
],
```

然后，执行下面 `artisan` 命令，发布该扩展包配置等项。

```
php artisan vendor:publish --provider="Douyasi\CKEditor\CKEditorServiceProvider" --force
```

现在您可以访问 `/laravel-ckeditor/example/basic` (基础版）或 `/laravel-ckeditor/example/standard` (标准版）或 `/laravel-ckeditor/example/full` (完整版）路由，不出意外，您可以看到扩展包提供的示例页面。

编辑器图片默认会上传到 `public/uploads/content` 目录下；编辑器相关功能配置位于 `config/ckeditor.php` 文件中。

使用说明
----

[](#使用说明)

> 参考本扩展包 `resources\views` 目录下 `example` 代码，引入必须的静态的资源 `{!! ckeditor_js() !!}` 和 `{!! ckeditor_css() !!}` 。

#### 各版本编辑器工具栏对比图

[](#各版本编辑器工具栏对比图)

[![基础版](https://camo.githubusercontent.com/ebf2c08f52518d9b27c2265125331d8df52dd1240ef79e775147fa555053072f/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f32336635643863623234366631313164326162316438336162666164326366302e706e67)](https://camo.githubusercontent.com/ebf2c08f52518d9b27c2265125331d8df52dd1240ef79e775147fa555053072f/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f32336635643863623234366631313164326162316438336162666164326366302e706e67)图1 - 基础（`basic`）版

[![标准版](https://camo.githubusercontent.com/b347a381f0986958a095ca09e4554ed05e357497c10a86a69d71594145837ac0/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f66343162613839616436303030356436643532666138666638393632633239362e706e67)](https://camo.githubusercontent.com/b347a381f0986958a095ca09e4554ed05e357497c10a86a69d71594145837ac0/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f66343162613839616436303030356436643532666138666638393632633239362e706e67)图2 - 标准（`standard`）版

[![完整版](https://camo.githubusercontent.com/0422187baba8aab2583bd6f8d93d1beb6c239485267f2d5511f47f0164c09096/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f36326137643462373964363066373339623331343631393034396232353131632e706e67)](https://camo.githubusercontent.com/0422187baba8aab2583bd6f8d93d1beb6c239485267f2d5511f47f0164c09096/687474703a2f2f6d7765622d757079756e2e746573742e757063646e2e6e65742f323031382f30312f31322f36326137643462373964363066373339623331343631393034396232353131632e706e67)图3 - 完整（`full`）版

目前本扩展包自定义（`customized`）版与完整版完全相同，发布包资源之后，开发者自行配置与修改 `customized.blade.php` 模板文件（位于 `resource/views/vendor/ckeditor/parts/` 目录），其他版本的模板建议不要修改。

#### 使用示例

[](#使用示例)

如果想使用 `CKEditor` 基础版编辑器，就引入 `@include('ckeditor::parts.basic', ['editorId' => 'editor1'])` 代码。其中，传入的 `editorId` 变量值需与前端上面 `textarea` 元素 `id` 一一对应。其他版本，如 `standard` (标准版）、 `full` （完整版） 、 `customized` （自定义版）以此来推。

下面示例代码引入的 `full` 版 CKEditor 编辑器：

```
>

    CKEditor Example
    {!! ckeditor_js() !!}
    {!! ckeditor_css() !!}

        &lt;p&gt;This is some sample text. You are using &lt;a href=&quot;http://ckeditor.com&quot;&gt;CKEditor&lt;/a&gt;, an online &lt;abbr title=&quot;What You See Is What You Get&quot;&gt;WYSIWYG&lt;/abbr&gt;&amp;nbsp;editor.&lt;/p&gt;

    @section('ckeditorExtraScript')
    // 可以继续追加额外的 CKEditor 代码，具体请参考官方文档 https://sdk.ckeditor.com/ 或 https://docs.ckeditor.com/ckeditor4/docs/
    language: 'zh-TW',
    uiColor: '#9AB8F3',
    filebrowserImageUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&type=images&by=btn_up',
    // filebrowserUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&by=btn_up',
    imageUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&type=images&by=drop_or_clipboard_up',  // only for image
    // uploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&by=drop_or_clipboard_up',
    @overwrite
    @include('ckeditor::parts.full', ['editorId' => 'editor1'])

```

#### 图片上传

[](#图片上传)

图片上传默认使用本扩展包提供的服务（仅限本地存储），你也可以编写自己的代码使用自己的 路由。要禁用本包上传服务，只需修改 `ckeditor.php` 配置中 `usingLocalPackageUploadServer` 项为 `false` 。

图片上传支持三种模式：传统表单、浏览器拖曳上传和剪切板粘贴图片上传（PS - 部分浏览器可能不支持拖曳与剪切板粘贴上传）。

[![upload-gif](https://camo.githubusercontent.com/b71827d5af9a211eb198e56b22b39dc649d088b1dfae647e3ec1eaf0e8cc0116/68747470733a2f2f73312e797374617469632e636e2f75706c6f6164732f636f6e74656e742f32303138303530332f356165623261373133666366355f34356f2e676966)](https://camo.githubusercontent.com/b71827d5af9a211eb198e56b22b39dc649d088b1dfae647e3ec1eaf0e8cc0116/68747470733a2f2f73312e797374617469632e636e2f75706c6f6164732f636f6e74656e742f32303138303530332f356165623261373133666366355f34356f2e676966)

传统浏览器表单按钮提交上传，需配置 `filebrowserImageUploadUrl` 或 `filebrowserUploadUrl` ；浏览器拖曳文件上传或者剪切板粘贴图片上传，需配置 `imageUploadUrl` 或 `uploadUrl` ：

```
filebrowserImageUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&type=images&by=btn_up',
imageUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&type=images&by=drop_or_clipboard_up',
filebrowserUploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&by=btn_up',
uploadUrl : '/laravel-ckeditor/upload?_token={!! csrf_token() !!}&by=drop_or_clipboard_up',
```

关于
--

[](#关于)

博客 ：

> `Copyright (c) 2014-2099` [douyasi](https://github.com/douyasi) - 由 [ycrao](https://raoyc.com) 创建的组织。

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

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

Total

2

Last Release

1542d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f0bca08de3586af706a2ada29662ba46249150dce37ee138180020329eac204?d=identicon)[raoyc](/maintainers/raoyc)

---

Top Contributors

[![ycrao](https://avatars.githubusercontent.com/u/3280204?v=4)](https://github.com/ycrao "ycrao (39 commits)")

---

Tags

ckeditorckeditor4clipboard-uploaddrop-uploadlaravellaravel-adminlaravel-packagephpupload-imageswysiwyg-editorlaravelwysiwygckeditor4Image uploadweb editordouyasi

### Embed Badge

![Health badge](/badges/douyasi-laravel-ckeditor/health.svg)

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

###  Alternatives

[ktquez/laravel-tinymce

TinyMCE editor for Laravel and Lumen Framework

2525.4k](/packages/ktquez-laravel-tinymce)[techguy/laravel-ckeditor

JavaScript WYSIWYG web text editor (for laravel).

1113.8k](/packages/techguy-laravel-ckeditor)

PHPackages © 2026

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