Laravel - 标签 - 菠菜眾長

cell-blog 功能介绍与安装

Lruihao — Sat, 25 Jul 2020 20:51:11 +0000

基于 Laravel7 开发，Markdown 语法的个人独立博客。Cell Blog, 也是我的毕业设计作品，目前已開源。

功能

支持 Markdown, 文章实时预览效果
支持多种编程语言代码高亮
编辑器图片上传
后台上传文件管理
文章搜索
文章分类
文章标签
热门文章
随机格言
文章管理（发布，评论开关，排序）
自定义导航（显示开关，排序）
自定义页面（发布开关）
友情链接（显示开关，排序）
COS 桶相册
丰富的博客配置（方便扩展，支持自定义 JS 脚本）
不蒜子计数
Leancloud 计数
Valine 评论插件
文章分享插件

截图

安装

注意事项：PHP 取消禁用函数putenv()和symlink()，安装fileinfo扩展。

下载

1

git clone https://github.com/Lruihao/cell-blog.git

进入站点

1

cd cell-blog

生成。env

1

cp .env.example .env

编辑。env 环境配置

1
2
3
4
5
6
7


APP_URL=http://localhost #使用本地文件系统存储文件时，必须填写正确地址
APP_DEBUG=false #关闭调试
DB_HOST= #数据库地址
DB_PORT=3306 #数据库端口
DB_DATABASE= #数据库名称
DB_USERNAME= #数据库用户
DB_PASSWORD= #数据库密码

打开app\Providers\AppServiceProvider.php, 注释SystemController:load() 防止后续步骤报错

1
2
3
4
5


    public function boot()
    {
        Schema::defaultStringLength(191);
        //SystemController::load();
    }

安装项目依赖

1

composer install

生成 key

1

php artisan key:generate

运行数据迁移和后台数据填充

php artisan admin:install已包含数据迁移命令php artisan migrate
G:\cell-blog\app\Admin directory already exists !无需理会，继续执行剩下命令即可。

1
2
3
4
5


php artisan admin:install

php artisan admin:import media-manager

php artisan db:seed

默认下使用了本地文件系统，创建 storage 目录在 public 的软链接

1

php artisan storage:link

打开app\Providers\AppServiceProvider.php, 取消注释SystemController:load()

1
2
3
4
5


    public function boot()
    {
        Schema::defaultStringLength(191);
        SystemController::load();
    }

将博客网站根目录指向入口 public 目录

如果使用 Nginx，要设置伪静态

1
2
3


location / {
    try_files $uri $uri/ /index.php?$query_string;
}

启动服务后，在浏览器打开http://localhost/admin/, 使用用户名admin和密码admin登录。

License

Cell Blog is open-sourced software licensed under the MIT license.

cell-blog 开发记录

Lruihao — Sat, 25 Jul 2020 20:42:42 +0000

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

运行迁移

1

php artisan migrate

创建模型 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 = "";
}

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
添加验证码

Media manager

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