readme.md

剑三壁纸后台管理系统

基于laravel框架，使用 dingo/api + jwt 开发的剑三壁纸后台管理系统，实现app壁纸数据增删改查管理和一些app配置管理，并提供api接口给app调用。

app仓库地址 jiansan-swift 。

运行环境

• Nginx 1.8+
• PHP 5.6+
• Mysql 5.7+

开发环境部署

本项目本地开发环境为 Laravel Homestead ，如果你还没有安装过 Homestead ，请参考 laravel-china-homestead 。

安装项目

1.克隆代码到本地

git clone https://github.com/6ag/jiansan-laravel.git

2.新建homestead站点

使用homestead新建站点，并解析域名到项目的 public 目录。首先进入虚拟机环境，新建站点：

注意： 这里的目录要根据自己安装的路径来写的，最终解析到 public 目录即可，别忘了修改本地 hosts 文件和重启 nginx 。

serve www.jiansan.com /home/vagrant/Code/jiansan-laralve-master/public

3.安装项目依赖包

composer install

4.拷贝环境配置文件

拷贝 .env 环境配置文件，并修改数据库配置信息。

cp .env.example .env

5.创建数据表

在创建数据表前，请先确保 .env 文件中的数据库配置正确，并数据库已经存在。

php artisan migrate

6.填充基础数据

添加分类数据和管理员信息，填充后默认管理员账号 admin ， 邮箱 [email protected] ，密码 123456 。

php artisan db:seed

7.注册管理员账号

访问 http://www.jiansan.com/ ，使用管理员账号登录即可。

API接口文档

本项目接口文档使用 apidoc 生成。

1.全局安装

安装前请确保已经安装了 node ，如果是使用 homestead 则默认已经安装有 node ，可直接执行下面命令进行安装 apidoc 。

npm install apidoc -g

2.更新文档

在项目根目录执行下面命令更新API文档，这里的 app/Http/Api/V1/Controllers 是需要解析的源文件目录，指定后会递归查找符合注释条件的方法，并生成对应的接口文档。 public/apidoc 是存放接口文档的目录，我这里放到 public 目录下的原因是上线后可以直接访问哈。

apidoc -i app/Http/Api/V1/Controllers -o public/apidoc/

3.注释格式

这个请自己去看 apidoc 文档，每次修改注释后，需要重新生成文档都可以执行上面的命令。然后 http://www.jiansan.com/apidoc 即可访问文档。

许可

MIT © 六阿哥