# laravel_blog

**Repository Path**: qqphp/laravel_blog

## Basic Information

- **Project Name**: laravel_blog
- **Description**: Laravel诗词博客-匠心编程，热爱生活。喜欢就 Star 吧~
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://qqphp.com
- **GVP Project**: No

## Statistics

- **Stars**: 248
- **Forks**: 56
- **Created**: 2019-07-08
- **Last Updated**: 2025-05-29

## Categories & Tags

**Categories**: blog

**Tags**: None

## README

![Laravel诗词博客](http://qiniu.qqphp.com/uugai.com_1573111132577.png)

> Laravel诗词博客-匠心编程,热爱生活。

> 感謝各位朋友的支持,很开心和你分享我的代码,希望大家也能多写博客,提高自己能力的同时又能以后回顾所学的知识。饮水思源,你的 **Star** 就是对我最好的支持。

> 本博客会一直维护和更新,已有基础上做调整,最大程度上确保原有用户可以 pull 代码,获取最佳体验。如果你在安装过程中遇到了问题,请提交 `Issue` ,我将会为你提供帮助。

![Laravel诗词博客](http://qiniu.qqphp.com/QQ%E6%88%AA%E5%9B%BE20191018102559.png)

#### 简介

1. 采用 Laravel5.8 版本框架搭建
2. 前端使用 Bootstrap4 框架，适配移动、PC
3. 管理后台使用 Laravel-admin1.73 版本
4. 使用 jQuery 的 Pjax 扩展，实现页面无刷新加载
5. 各个板块可自定义、扩展性强、注重细节且性能优异
6. 写作支持 MarkDown 语法编辑器、Simditor 富文本编辑器
7. 完美支持个人音乐播放、图片管理、视频播放
8. 支持多人邮箱订阅，发布文章进行队列邮件通知
9. 提供丰富的 Live2D 看板娘动画效果
10. 文件上传支持七牛云对象存储和其它对象存储
11. 世界上最漂亮的博客之一（may be）

#### 服务器要求

 - 推荐安装Nginx或Apache（其它web服务器也可）
 - 安装 MySQL（推荐5.6版本以上）
 - Redis（非必须，订阅邮箱发信队列使用）
 - 安装 PHP >= 7.1.3 （推荐版本7.2）

 > PHP必要扩展

 ```
[root@centos ~]# php -m
[PHP Modules]
bcmath
Core
ctype
curl
date
dom
filter
ftp
gd
gettext
hash
iconv
intl
json
libxml
mbstring
mcrypt
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
Reflection
session
shmop
SimpleXML
soap
sockets
SPL
sqlite3
standard
sysvsem
tokenizer
xml
xmlreader
xmlrpc
xmlwriter
zip
zlib
 ```

#### 如何搭建此博客？

> 博客开源发布以来，受到了很多人的认同和赞美，同时也收到了很多大家给出的有效建议，在此很感谢大家支持。不过在安装过程中由于大家安装环境不同，部分朋友可能遇到个别小问题难以解决，请提交 `Issue` ，我将会为你提供帮助，**安装步骤务必仔细查阅**，已由作者经过多次实际操作验证，确保可用。

- ##### Laravel 诗词博客开源地址

 > GitHub项目地址： `https://github.com/qqphp`

 > 码云项目地址：`https://gitee.com/qqphp`

 > 如果你喜欢此博客，或者对你有帮助，可以 **Star** 支持，十分感谢。

- ##### 在 `.env` 文件中,配置数据库连接等配置

 ```
APP_DEBUG        = false
APP_URL          = https://qqphp.com(你的域名)
QUEUE_CONNECTION = database
 ```

- 数据库配置

 ```
DB_CONNECTION = mysql
DB_HOST       = 127.0.0.1
DB_PORT       = 3306
DB_DATABASE   = 数据库名
DB_USERNAME   = 帐号
DB_PASSWORD   = 密码
 ```

- ##### 导入初始化演示数据

  - 将 `.../laravel_blog/sql/qqphp.sql` 文件数据，导入 MySQL 数据库。

- ##### 设置文件目录软链接

  - 执行命令： php artisan aetherupload:groups 会自动在配置文件的 groups 下新增分组
  - Linux系统下赋予 `storage`，`public` 目录读写权限，执行 `chmod -R 777 storage` 和 `chmod -R 777 public` 命令
  - Linux系统下执行创建软链接 `ln -s /www/wwwroot/项目目录/storage/ /www/wwwroot/项目目录/public/`

- 配置文件上传，可保存本地服务器或者七牛云对象存储平台

上传本地存储需在 `.env` 文件中加入 `UPLOAD_TYPE=admin`

上传到七牛云需在 `.env` 文件中加入 `UPLOAD_TYPE=qiniu`，需在 `config/filesystems.php` 文件中添加以下配置。

```
'qiniu' => [
        'driver'  => 'qiniu',
        'domains' => [
            'default'   => 'qiniu.qqphp.com', // 你的七牛域名【融合CDN加速域名 *必填】
            'https'     => '',                // 你的HTTPS域名
            'custom'    => '',                // 你的自定义域名
        ],
        'access_key'=> 'Yne-lN5CK1a0**********duEEylaoUjQAI',     //AccessKey【*必填】
        'secret_key'=> 'I2AecMg_MHUxEj**********zZo9hSWykRx3NO',  //SecretKey【*必填】
        'bucket'    => 'leiyong-blog',                            //Bucket名字【实例名称 *必填】
        'notify_url'=> '',  // 持久化处理回调地址
        'url'       => '',  // 填写文件访问根url
        'access'    => '',  // 空间访问控制 public 或 private
    ],
```

- ##### 登录博客后台，进行个人站点配置

  博客后台访问网址： `域名/admin`，开始愉快博客写作之旅。

  > 默认后台管理账号: `admin`，密码:  `admin` 

#### 鸣谢

 `Laravel诗词博客` 本博客致谢开源作者们开发的优秀插件或服务。

 - [Laravel](https://laravel.com)
 - [Laravel-admin](https://github.com/z-song/laravel-admin)
 - [Jquery-pjax](https://github.com/defunkt/jquery-pjax)
 - [APlayer](http://aplayer.js.org)
 - [DPlayer ](http://dplayer.js.org)
 - [Toc-helper](https://gitee.com/itlangz/toc-helper)
 - [Simditor](https://simditor.tower.im)
 - [Font Awesome](https://fontawesome.com)
 - [Composer](https://getcomposer.org)
 - [Creative-Tim](https://www.creative-tim.com)
 - [Bootstrap](https://getbootstrap.com)

#### 常见问题

- 1.执行 `composer install` 命令,报错无法下载扩展?

 > 首先确保MySQL数据库能正常连接,然后检查 PHP 扩展、再次确认 PHP >= 7.1.3 版本。Linux 可以执行 `php -m` 查看已有扩展。

- 2.无法上传大视频或者歌曲文件？

 > 确认上传文件目录 `public` 和 `storage` 有增删权限，且在上述安装步骤中设置了软连接。
 >
 > 修改 PHP 配置文件 `php.ini` 的上传文件参数，在配置文件中找到如下参数修改：

```
file_uploads         = on;    # 是否允许通过HTTP上传文件的开关。
upload_max_filesize = 1024m;  # 允许上传文件大小的最大值。
post_max_size       = 1024m;  # 指通过表单 POST 给 PHP 的所能接收的最大值。
max_execution_time  = 300;    # 每个 PHP 页面运行的最大时间值(秒)。
memory_limit        = 256m;   # 每个 PHP 页面所吃掉的最大内存。
```

- 3.音乐和视频无法播放，HTTP 异步请求报 206 或 416 状态码？

 > 安装好后，音乐、视频无法播放，HTTP 异步请求出现 **416 、206** 的状态码。是由于缺失 PHP 必要扩展，检查 PHP 扩展是否包含安装教程中所罗列的必要扩展。

- 4.文章内容无法显示或显示后又自动隐藏？

 > 是由于 `Composer install` 时执行过程中出现错误，导致部分扩展未能下载造成,如 Pjax 扩展，可以删除 `Vendor` 目录，检查 PHP 扩展，确认操作环境无误后，重新执行 `Composer install` 下载扩展，删除浏览器缓存，重新查看文章。

- 5.以上步骤配置执行完后,访问域名报 500 的错误？

 > 确保入口文件，也就是运行目录指向 `.../public/` 目录下。
 >
 > 检查是否已经配置 Laravel 的伪静态设置,确保请求引导至 `index.php` 前端控制器。
 >
 > 参考 Laravel5.8  中文文档配置 : `https://learnku.com/docs/laravel/5.8/installation/3879`。配置好伪静态，重启web服务器访问即可。

- 6.composer install时出现 `Warning: putenv() has been disabled for security reasons` 的问题？

 > 是由于 PHP 可能在安装后会自动禁用一些函数，去除禁用函数即可。

- 7.网站安装好后,访问出现 `Warning: require(/www/wwwroot/blog/code/laravel_blog/vendor/autoload.php): failed to open stream: Operation not permitted in /www/wwwroot/blog/code/laravel_blog/public/index.php on line 24`的问题？

 > 是由于站点开启了防跨站攻击（open_basedir）的设置，关闭该设置后重启 PHP 服务即可。

- 8.上传文件出现 `stream_copy_to_stream(): read of 8192 bytes failed with errno=21 Is a directory` 报错？

 > 是由于 PHP 配置中默认上传文件大小为 2M，修改 php.ini 文件中 `upload_max_filesize = 2M` 的配置，调整到您需到的大小即可。
- 9.浏览器中网页标签中的icon无法显示，引用者策略: strict-origin-when-cross-origin，状态：Mixed Content？

 > Nginx站点配置中添加 `add_header Access-Control-Allow-Origin *;` 和 `add_header Content-Security-Policy upgrade-insecure-requests;`，修改配置后重启Nginx服务。


#### 执照

Laravel 诗词博客根据 [MIT许可证（MIT）](https://github.com/qqphp-com)获得许可。

#### 博客修复与调整日志

 - *2019年10月01日* 博客第一个版本正式上线与开源
 - *2019年11月07日* 新增七牛云存储文件上传功能与配置
 - *2020年01月03日* 修复文章详情刷新后内容不见BUG,修复视频详情刷新后无法再次播放问题。
 - *2020年09月09日* 修复顶级导航下无子导航时页面报错Bug,简化安装逻辑。
 - *2023年05月10日* 优化安装步骤描述。