Skip to content

HubQin/QinBlog

Repository files navigation

环境要求

Laravel 6.X
PHP 7.2+
MySQL 5.7+
Redis 5.0+

主要功能

  • 文章
    • 集成 Markdown 编辑器,支持拖拽上传图片
    • 多标签选择器
    • 支持全文检索(Laravel Scount + TNTSearch + Jieba 分词)
    • 可分专题发布文章
    • 代码高亮
    • 文章页面自动生成目录
    • 支持分类、打标签
    • 文章浏览量统计
    • 按年月份归档
    • slug 自动生成/自动翻译
  • 评论
    • 支持多级嵌套评论
    • 收到评论 / 回复后站内通知
  • 用户
    • 支持 GitHub 登录
    • 站长登录前 / 后台,同步前 / 后台登录状态
    • 用户注册自动生成头像
  • 管理后台
    • 站点信息可配置
  • 一些优化项
    • 文章链接添加语义化slug
    • 侧边栏数据使用 Laravel ViewComposer 统一输出
    • 侧边栏数据Redis缓存
    • 文章浏览量Redis缓存
    • 文章创建索引使用队列
    • Slug自动翻译使用队列

项目信息

博客部署

下载代码

https://github.com/HubQin/QinBlog.git blog

Laravel 配置

  • 创建 .env 文件

    cp .env.example .env
    
  • 配置 .env 文件如下:

    App_NAME=Larashop  # <-- 应用名
    App_ENV=production # <-- 运行环境
    App_KEY= # <-- 后面将运行命令生成
    App_DEBUG=false # <-- 关闭调试(部署过程方便调试可先设为 true)
    App_URL=xxxx.xxx #  <-- 你的网站地址
    
    LOG_CHANNEL=stack
    
    DB_CONNECTION=MySQL
    DB_HOST=MySQL # <-- MySQL 主机,注意是填 MySQL 在 docker-compose 中的服务名
    DB_PORT=3306
    DB_DATABASE=myblog # <-- 数据库名称
    DB_USERNAME=root   # <-- 数据库用户名
    DB_PASSWORD=xxxxxx # <-- 数据库密码,填写在 docker-compse.yml 文件中设置的密码
    
    BROADCAST_DRIVER=log
    CACHE_DRIVER=Redis # <-- 缓存驱动
    QUEUE_CONNECTION=Redis # <-- 队列驱动
    SESSION_DRIVER=file
    SESSION_LIFETIME=120
    
    Redis_HOST=Redis # <-- Redis 主机,填写规则同 MySQL
    Redis_PASSWORD=xxxxxx # <-- 填写在 redis.conf 中设置的密码(requirepass),没设置则不用写
    Redis_PORT=6379
    
    # 暂时没用到邮箱,可不配置
    MAIL_DRIVER=smtp
    MAIL_HOST=smtp.qq.com
    MAIL_PORT=465
    [email protected] # <-- 你的邮箱
    MAIL_PASSWORD=xxxxxx # <-- 从邮箱服务商获取的密码
    MAIL_ENCRYPTION=ssl
    [email protected] # <-- 你的邮箱
    MAIL_FROM_NAME=Larashop # <-- 应用名 
    
  • 创建数据库,名称与 .envDB_DATABASE 的值相同

  • 安装依赖

    Composer install --no-dev --prefer-dist --optimize-autoloader
    
  • 生成 KEY

    PHP artisan key:generate
    
  • 创建软链接

    PHP artisan storage:link
    
  • 数据表迁移

    PHP artisan migrate --force
    
  • 生成配置、路由、事件缓存

    PHP artisan route:cache PHP artisan config:cache PHP artisan event:cache
    
  • 导入后台菜单和角色数据:在数据库运行 /database/admin-menu-and-role-data.sql 文件

  • 发布管理后台资源文件

    PHP artisan vendor:publish --provider="Encore\\Admin\\AdminServiceProvider"
    
  • 创建后台管理员账号

    运行 PHP artisan admin:create-user,依照提示输入管理员名称、密码等

Nginx 配置

可参考官网配置:https://laravel.com/docs/7.x/deployment#nginx

需要更完善的配置,如配置 HTTPS,更多安全配置等,可参考我的另一篇文章:https://learnku.com/articles/40979

Supervisor 进程监护配置

由于应用中使用了任务队列,所以需要对队列进程进行监护,防止队列意外停止,这里使用Supervisor。关于 Supervisor 的使用,可以参考我之前写的这篇:https://learnku.com/articles/36939

参考配置:

[program:qin]
process_name=%(program_name)s_%(process_num)02d
directory=/var/www/HTML/qin
command=PHP artisan queue:work --tries=3 --sleep=3 --daemon
autostart=true
autorestart=true
numprocs=1
user=root
stopasgroup=true
killasgroup=true
redirect_stderr=true
stdout_logfile=/var/www/HTML/qin/storage/logs/queue.log

解决文件权限问题

  • 日志和缓存权文件限

    sudo chown -R $USER:www-data storage
    sudo chown -R $USER:www-data Bootstrap/cache
    chmod -R 775 storage
    chmod -R 775 Bootstrap/cache
    
  • 全文检索数据文件权限

    由于最开始你发表文章时,索引是由队列生成的,而队列有可能是 root 账号生成的(比如,在docker环境中),这可能导致 Web 访问的账号无法修改该文件。所以,部署完成后发表一篇文章后, 在 storage/indices 目录会创建 posts.index 文件,在项目根目录下运行 chmod 0777 storage/indices/posts.index,给予最高权限。

  • 站点配置文件 config/site 也要给予最高权限,因为管理后台配置站点要修改到这个文件。

iconfont 图标设置

分类图标使用了 iconfont。配置方法:登录 https://www.iconfont.cn/ 创建一个项目,选择图标到购物车后,添加到项目。进入 “我的项目”,选择 “Symbol” 类型,复制 .js 后缀的 url,到管理后台 -- 站点配置,填入对应的输入框,然后保存即可。

主要功能展示

  • 文章列表

image

  • 发表文章-分类选择

image

  • 发表文章-打标签

image

  • Markdown编辑器

image

  • 全文检索

image

  • 文章页面

image

  • 管理后台-站点设置

image