Yike.io

此项目为 https://yike.io 的后端 API，基于 Laravel 5 开发。

🏵前端源码：https://github.com/overtrue/yike.io

开源中国 Gitee 仓库：

运行环境要求

• Nginx 1.8+
• PHP 7.1+
• MySQL 5.7+
• Redis 3.0+

开发环境部署/安装

本项目代码使用 PHP 框架 Laravel 5 开发，本地开发环境使用 Laravel Homestead。

下文将在假定读者已经安装好了 Homestead 的情况下进行说明。如果您还未安装 Homestead，可以参照 Homestead 安装与设置 进行安装配置。

基础安装

克隆源代码

克隆源代码到本地：

> git clone [email protected]:overtrue/api.yike.io.git

配置本地的 Homestead 环境

1). 运行以下命令编辑 Homestead.yaml 文件：

homestead edit

2). 加入对应修改，如下所示：

folders:
    - map: ~/my-path/api.yike.io/ # 你本地的项目目录地址
      to: /home/vagrant/api.yike.io

sites:
    - map: api.yike.io.test
      to: /home/vagrant/api.yike.io/public

databases:
    - api_yike_io

3). 应用修改

修改完成后保存，然后执行以下命令应用配置信息修改：

homestead provision

随后请运行 homestead reload 进行重启。

安装扩展包依赖

composer install

生成配置文件

cp .env.example .env

你可以根据情况修改 .env 文件里的内容，如数据库连接、缓存、邮件设置等：

APP_URL=http://api.yike.io.test
...
DB_HOST=localhost
DB_DATABASE=api_yike_io
DB_USERNAME=homestead
DB_PASSWORD=secret

生成数据表及生成测试数据

在 Homestead 的网站根目录下运行以下命令

$ php artisan migrate --seed

初始的用户角色权限已使用数据迁移生成。

生成秘钥

$ php artisan key:generate

Passport 初始化

$ php artisan passport:install

将生成的 password grant 对应的 id 与 secret 记录下来，用于配置前端应用的 env 变量。

配置 hosts 文件

echo "192.168.10.10   api.yike.io.test" | sudo tee -a /etc/hosts

链接入口

• 首页地址：http://api.yike.io.test
• 管理后台：没做

管理员账号请自己添加 UserSeeder 创建。

至此, 安装完成 ^_^。

扩展包使用情况

扩展包	一句话描述	本项目应用场景
overtrue/easy-sms	多网关短信发送组件	发送验证码
overtrue/laravel-emoji	emoji 转换组件	帖子与评论 emoji 解析
overtrue/laravel-filesystem-qiniu	七牛 CDN SDK	帖子内容图片存储
overtrue/laravel-follow	Laravel 用户关系组件	用户关注与帖子订阅
overtrue/laravel-lang	Laravel 多语言	报错信息本地化
overtrue/laravel-mail-aliyun	阿里云邮件 SDK	发送通知邮件
overtrue/laravel-socialite	社交登录组件	用户使用第三方登录
overtrue/laravel-uploader	Laravel 上传功能封装	帖子内容图片上传
overtrue/laravel-query-logger	Laravel SQL 监听工具	开发环境查看 SQL 记录
Intervention/image	图片处理功能库	用于图片裁切
guzzlehttp/guzzle	HTTP 请求套件	我也记不得，反正就是要用
predis/predis	Redis 官方首推的 PHP 客户端开发包	缓存驱动 Redis 基础扩展包
mewebstudio/Purifier	用户提交的 Html 白名单过滤	帖子内容的 Html 安全过滤，防止 XSS 攻击
laravel/passport	用户授权	基于 Personal Access Token 的前后端用户认证
laravel/horizon	队列监控面板	监听队列使用情况
aravolt/avatar	生成用户头像	用户头像
sentry/sentry-laravel	Sentry 报错监控	监控系统错误
spatie/laravel-activitylog	用户行为记录	个人中心的用户动态
spatie/laravel-url-signer	URL 加密	用户激活链接
tamayo/laravel-scout-elastic	Laravel Scout ES 驱动	帖子搜索
tucker-eric/eloquentfilter	模型字段过滤	接口字段过滤
vinkla/hashids	HashID 实现	暂时好像没用到
beyondcode/laravel-self-diagnosis	Laravel 基础环境检查工具	检查配置是否正确

自定义 Artisan 命令

命令行名字	说明	Cron	代码调用
es:init	初始化 ES 模板	无	无

License

MIT