警告
本文最后更新于 2023-07-07,文中内容可能已过时。
Cell Blog 开发记录,项目地址
搭建 php 环境
- 安装 wampserver
- 安装 composer
- 更换 aliyun 源
1
| composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
|
新建 laravel 项目
1
| composer create-project --prefer-dist laravel/laravel cell-blog "7.*"
|
或者
1
2
| composer global require laravel/installer
laravel new blog
|
下载 debugbar
1
| composer require barryvdh/laravel-debugbar --dev
|
修改语言时区
修改 config/app.php,将 local 的值 en 改成 zh-CN(laravel-admin 自带 zh-CN):
1
2
3
4
| ## 时区
'timezone' => 'Asia/Shanghai',
## 语言
'locale' => 'zh-CN',
|
配置数据库
首先确保安装好了 laravel,并且数据库连接设置正确。
1
2
3
4
5
6
7
8
| APP_URL=http://cell.blog
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3307
DB_DATABASE=cell_blog
DB_USERNAME=root
DB_PASSWORD=123456
|
下载 laravel-admin
1
2
| cd cell-blog
composer require encore/laravel-admin
|
卸载命令composer remove xxx
然后运行下面的命令来发布资源:
1
| php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"
|
在该命令会生成配置文件config/admin.php
,可以在里面修改安装的地址、数据库连接、以及表名,建议都是用默认配置不修改。
然后运行下面的命令完成安装:
1
| php artisan admin:install
|
运行这个命令的时候,如果遇到了下面的错误:
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 1000 bytes (SQL: alter tableusersadd uniqueusers_email_unique(email))
参考这个 issue 来解决 https://github.com/z-song/laravel-admin/issues/1541
在app\Providers\AppServiceProvider.php
添加默认值
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
| <?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Schema; //add fixed sql
class AppServiceProvider extends ServiceProvider
{
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
Schema::defaultStringLength(191); //add fixed sql
}
/**
* Register any application services.
*
* @return void
*/
public function register()
{
//
}
}
|
启动服务后,在浏览器打开 http://localhost/admin/
, 使用用户名 admin
和密码 admin
登录。
报错Disk [admin] not configured, please add a disk config in config/filesystems.php
在config/filesystems.php
中 disks 处添加以下配置后执行php artisan storage:link
来创建软链接(windows 和 linux 的软链接不一样不能直接复制!)
宝塔执行时删除禁用函数 putenv(),symlink()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| 'admin' => [
'driver' => 'local',
'root' => storage_path('app/public/system'),
'url' => env('APP_URL').'/storage/system',
'visibility' => 'public',
],
或
'admin' => [
'driver' => 'local',
'root' => public_path('uploads'),
'url' => env('APP_URL').'/public/uploads/',
'visibility' => 'public',
],
|
下载 dcat-admin
1
| composer require dcat/laravel-admin
|
然后运行下面的命令来发布资源:
1
| php artisan admin:publish
|
在该命令会生成配置文件config/admin.php
,可以在里面修改安装的地址、数据库连接、以及表名,建议都是用默认配置不修改。
然后运行下面的命令完成安装:
1
| php artisan admin:install
|
迁移文件创建表
1
2
3
4
5
6
7
8
9
| php artisan make:migration create_articles_table
php artisan make:migration create_tags_table
php artisan make:migration create_categories_table
php artisan make:migration create_article_tags_table
php artisan make:migration create_navigations_table
php artisan make:migration create_friendship_links_table
php artisan make:migration create_pages_table
php artisan make:migration create_systems_table
php artisan make:migration create_mottoes_table
|
运行迁移
创建模型 model
1
2
3
4
5
6
7
8
| php artisan make:model Models/Article
php artisan make:model Models/Category
php artisan make:model Models/Tag
php artisan make:model Models/Navigation
php artisan make:model Models/FriendshipLink
php artisan make:model Models/Page
php artisan make:model Models/System
php artisan make:model Models/Motto
|
创建控制器
1
2
3
4
5
6
7
8
| php artisan admin:make ArticleController --model=App\Models\Article
php artisan admin:make CategoryController --model=App\Models\Category
php artisan admin:make TagController --model=App\Models\Tag
php artisan admin:make NavigationController --model=App\Models\Navigation
php artisan admin:make FriendshipLinkController --model=App\Models\FriendshipLink
php artisan admin:make PageController --model=App\Models\Page
php artisan admin:make SystemController --model=App\Models\System
php artisan admin:make MottoController --model=App\Models\Motto
|
添加后台路由
app/Admin/routes.php
1
2
3
4
5
6
7
8
| $router->resource('articles', ArticleController::class);
$router->resource('categories', CategoryController::class);
$router->resource('tags', TagController::class);
$router->resource('navigations', NavigationController::class);
$router->resource('friendship-links', FriendshipLinkController::class);
$router->resource('pages', PageController::class);
$router->resource('systems', SystemController::class);
$router->resource('mottoes', MottoController::class);
|
editormd 安装
editormd
github 图像问题
存放本地表情
1
| public\vendor\laravel-admin-ext\editormd\editormd-1.5.0\images\emojis
|
修改 editormd.js 及 editormd.min.js
1
2
3
4
5
| // Emoji graphics files url path
editormd.emoji = {
path : "/iamges/emojis/",
ext : ".png"
};
|
图片上传
csrf 419 错误
可以在VerifyCsrfToken.php
中添加白名单跳过验证,或者手动添加 csrf 验证器:
修改 image-dialog.js 的var dialogContent
参考
1
2
3
4
5
6
7
8
9
10
| if (settings.crossDomainUpload)
{
action += "&callback=" + settings.uploadCallbackURL + "&dialog_id=editormd-image-dialog-" + guid;
}
//添加 csrf 验证
var csrfToken = $('meta[name="csrf-token"]').attr('content');
var csrfField = "";
if (csrfToken) {
csrfField = "<input type='hidden' name='_token' value='" + csrfToken + "' />";
}
|
markdown 转 HTML
https://www.zhiqiexing.com/119.html
Laravel Markdown 安装
1
2
| composer require graham-campbell/markdown
php artisan vendor:publish
|
扩展表格
1
| composer require league/commonmark
|
config/markdown.php
1
2
3
| 'extensions' => [
League\CommonMark\Extension\TaskList\TaskListExtension::class,
],
|
Eloquent 模型事件
Eloquent 模型可以触发事件,允许你在模型生命周期中的多个时间点调用如下这些方法:retrieved, creating, created, updating, updated, saving, saved, deleting, deleted, restoring, restored。事件允许你在一个指定模型类每次保存或更新的时候执行代码。
retrieved 事件会在从数据库中获取已存在模型时触发。当一个新模型被首次保存的时候,creating 和 created 事件会被触发。如果一个模型已经在数据库中存在并调用 save 方法,updating/updated 事件会被触发,无论是创建还是更新,saving/saved 事件都会被触发。
添加后台验证码
依赖 php 扩展fileinfo
添加验证码
1
2
| composer require laravel-admin-ext/media-manager
php artisan admin:import media-manager
|
’extensions’ => [
‘media-manager’ => [
// Select a local disk that you configured in config/filesystem.php
‘disk’ => ‘public’
],
],
1
2
|
## 给 laravel-admin 增加锁屏功能
|
composer require laravel-admin-ext/lock-screen
1
2
3
4
5
6
7
8
| 'route' => [
'prefix' => 'demo',
'namespace' => 'App\\Admin\\Controllers',
// 在中间件数组中加上'admin.lock'
'middleware' => ['web', 'admin', 'admin.lock'],
],
|
前台设计
创建控制器
1
2
3
4
5
| php artisan make:controller HomeController
php artisan make:controller ArticleController
php artisan make:controller CategoryController
php artisan make:controller TagController
php artisan make:controller PageController
|
后台 img 灯箱
https://github.com/laravel-admin-extensions/grid-lightbox
1
2
3
| composer require laravel-admin-ext/grid-lightbox
php artisan vendor:publish --tag=laravel-admin-grid-lightbox
|