README

项目的路由,视图文件均在扩展包内,默认的后台请不要作改动啦,项目主要的优势在于API接口的开发,自动生成标准的API文件格式
普通web应用也能做,如果需要添加额外的路由,请直接在根目录下的 routes/web.php routes/api.php 里进行添加.
本项目的初衷是制作一个纯粹的扩展包,能安装即用,卸载即清.
演示站点正在搭建中, 手册什么的也在计划编写,请关注本项目,以便了解项目的最新动态. 大家可以积极提交 ISSUE
为方便大家交流,以及项目代码bug反馈,大家可以添加QQ群 : 195857398
演示地址

帐户 admin@admin.com 密码 123123

简介

基于 laravel 5.5
系统管理平台
商户管理平台
RBAC 用户权限管理
RESTful 接口
微信接口

安装步骤

设置composer.json,找到config元素配置地方更改为如下

"config": {
        "preferred-install": "dist",
        "sort-packages": true,
        "optimize-autoloader": true
 },"minimum-stability": "dev",
    "repositories": {
        "packagist": {
            "type": "composer",
            "url": "https://packagist.phpcomposer.com"
     }
 }

首先安装好laravel,并且设置好数据库连接

composer require dominator88/laravel-smart:dev-master
运行下面命令来发布资源,以及安装数据库

php artisan vendor:publish --provider="Smart\SmartServiceProvider"

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"

php artisan make:auth

配置 config/backend.php,这里可以设置初始化超级管理员帐户,也可使用默认默认(不作修改),在后面会提到默认配置的帐户名密码

php artisan smart:install

为权限认证添加模块,并设置为当前认证模型, 更改 confit/auth.php 文件

<?php

return [
'defaults' => [
    'guard' => 'admin',
    'passwords' => 'users',
],
'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        'admin' => [
            'driver' => 'session',
            'provider' => 'admin',
        ],

        'api' => [
            'driver' => 'token',
            'provider' => 'users',
        ],
    ],
    'providers' => [
            'users' => [
                'driver' => 'eloquent',
                'model' => App\Models\User::class,
            ],
            'admin' => [
                'driver' => 'eloquent',
                'model' => Smart\Models\SysUser::class,
            ],
    
            // 'users' => [
            //     'driver' => 'database',
            //     'table' => 'users',
            // ],
        ],
        'passwords' => [
                'users' => [
                    'provider' => 'users',
                    'table' => 'password_resets',
                    'expire' => 60,
                ],
            ],
        
        ];

图片上传设置

图片上传设置,需要运行如下命令,为图片的路径建立软链接,如果安装环境为docker,需要自行进入项目目录bash,将软链接设置正确

        php artisan storage:link

如此便可以进行访问：

后台地址: http:// sitename /backend/index/index

帐户名: sys_admin

密码: 123123

邮箱：admin@admin.com

从项目根目录进入 public 目录，执行命令：

npm update

在此请注意需要将 config/backend.php 里 baseUri 更改为当前域名 , 否则页面会出现样式错乱

不知道 npm 如何安装的可以在搜索引擎上查找。

创建模块

php artisan smart:install 模块名

创建模块后,需要在 .env 文件中将模块加入到 MODULE_EXT 配置中,以逗号分隔

执行上面命令后,会在app目录下生成对应模块

接口说明

接口uri <https:// sitename /api>

接口密钥 smart2_api_secret

header

名称	说明	描述
device	客户端系统类型	Apple iphone 7
device-os-version	客户端系统版本号	如: 10.0.2
timestamp	时间戳	如: 1476340001
signature	签名	如: 103ed1d081... 详见签名规则

body

所有键和值全部为字符串

{
  key1 : val1 ,
  key2 : val2,
  key2 : "[{k1 : v1} , { k2 : v2 }]" //用json字符串传输 数组
  ...
}

返回结果

单行数据

  {
    code : 0       // 0 表示成功 , 403 表示需要登录 , 其余为其他错误
    msg : "文字信息" ,
    data : {
      key1 : val1,
      key2 : val2,
      ...
    }
  }

多行数据

  {
    code : 0 
    msg : "文字信息" ,
    data : {
      rows : [
        {
          key01 : val01,
          key02 : val02,
          ...
        },
        {
          key11 : val11,
          key12 : val12,
          ...
        },
        ...
      ]
    },
    key : value 
  }

签名规则

假设要发送的数据 meta 为:

var meta = {
  token : "103ed1d0811212312" ,
  merId : "1",
}
签名密钥为 : smart_api_secret

将 timestamp 加入meta数据中 , 如

var signatureMeta = {
  token : "103ed1d0811212312" ,
  merId : "1",
  timestamp : 1476340001
}

signatureMeta 按key的字符正序排列 ,并转为 key1=val1&key2=val2... 类型的字符串,如:
```
var signatureString = merId=1&timestamp=1476340001&token=103ed1d0811212312
```

在字符串后加上签名密钥 ,如: "&secret=签名密钥"

var signatureString = merId=1&timestamp=1476340001&token=103ed1d0811212312&secret=smart2_api_secret

md5 signatureString 得到签名

dominator88 / laravel-smart

Maintainers

Details