# QinBlog **Repository Path**: wfdaj/QinBlog ## Basic Information - **Project Name**: QinBlog - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-05-30 - **Last Updated**: 2024-05-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 环境要求 ``` 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 MAIL_USERNAME=xxxxxx@qq.com # <-- 你的邮箱 MAIL_PASSWORD=xxxxxx # <-- 从邮箱服务商获取的密码 MAIL_ENCRYPTION=ssl MAIL_FROM_ADDRESS=xxxxxx@qq.com # <-- 你的邮箱 MAIL_FROM_NAME=Larashop # <-- 应用名 ``` - 创建数据库，名称与 `.env` 中 `DB_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，更多安全配置等，可参考我的另一篇文章： ### Supervisor 进程监护配置 由于应用中使用了任务队列，所以需要对队列进程进行监护，防止队列意外停止，这里使用Supervisor。关于 Supervisor 的使用，可以参考我之前写的这篇： 参考配置： ```sh [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。配置方法：登录 创建一个项目，选择图标到购物车后，添加到项目。进入 “我的项目”，选择 “Symbol” 类型，复制 .js 后缀的 url，到管理后台 -- 站点配置，填入对应的输入框，然后保存即可。 ## 主要功能展示 - 文章列表 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/zYfQc1TXRm.png!large) - 发表文章-分类选择 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/sGIu09a6Dk.png!large) - 发表文章-打标签 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/2tTfRAl0zx.gif!large) - Markdown编辑器 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/pIgcMkILjK.png!large) - 全文检索 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/bA5r3g6MYN.png!large) - 文章页面 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/ljege20hhX.png!large) - 管理后台-站点设置 ![image](https://cdn.learnku.com/uploads/images/202006/09/27146/IzJwyVeqZP.png!large)