249建站之家:Alpaca-Spa-Laravel后台管理系统-前后分离

Alpaca-Spa-Laravel 是用Alpaca-Spa + Laravel 前后端分离开发的一款后台管理系统的DEMO. 主要功能模块有登录、定时任务管理、用户管理、权限管理、个人信息管理等。在实际开发中可以根据具体的需求添加新的功能。 开发模式为前后分离开发,Alpaca-Spa负责实现前端功能,包括组织页面结构,渲染页面数据、样式,交互逻辑等,Laravel负责提供后台功能,访问数据库,处理业务逻辑,提供数据接口给前端,http://www.tkc8.com


Alpaca-Spa-Laravel 简介

Alpaca-Spa-Laravel 是 前后端分离 开发的一个后台管理系统的DEMO。Laravel用来实现后端功能,Alpaca-Spa用来实现前端功能,前后端之间通过Json交换数据。


示例中主要功能有:


 登录、注销

 用户管理

 权限管理

 个人信息管理

 定时任务管理

在实际开发中可以根据具体的需求添加新的功能。


大连249建站之家免费精品网站自助建设平台免费微信小程序

演示地址

内容 说明 地址

Alpaca-Spa 主页 http://www.tkc8.com

Alpaca-Spa-Laravel 后台管理端 http://full.tkc8.com

Alpaca-Spa-Sui 手机端sui http://full.tkc8.com/app

oschina 代码 http://git.oschina.net/cc-sponge/Alpaca-Spa-Laravel

github 代码 https://github.com/big-sponge/Alpaca-Spa-Laravel

后台管理端登录账号是一个测试帐号,权限只有浏览功能,没有编辑等修改功能。


安装方式 (一定要注意storage、bootstrap目录及其子目录、文件的权限)

    保证开发环境满足以下要求:


    PHP版本 >= 5.6.4

    PHP扩展:OpenSSL

    PHP扩展:PDO

    PHP扩展:Mbstring

    PHP扩展:Tokenizer

    PHP扩展:XML


    (详细参考:Laravel 5.4)


    下载好源码之后,你需要配置你的 Web 服务器的根目录为 public 目录。

    这个目录的  index.php 文件作为所有 HTTP 请求进入应用的前端处理器。


    你需要配置一些权限。

    storage 和 bootstrap 目录应该允许你的 Web 服务器写入,否则 Laravel 将无法写入。


    关于配置文件:


    下载好源码之后,请在在/config目录下创建 .env文件,当然你也可以复制.env.development重命名为.env。

    不建议将.env加入git版本控制,因为配置文件中可能保存着你个人的数据库访问账户。

    配置文件详情请参考文档中 “配置文件”一章节


    数据库脚本:

    /storage/sql/db_full.sql



    如果你只想在你本地查看前端功能,请将/public/admin/index.html中 g_url 的值设置为 "http://full.tkc8.com/"。


    <script>

            var g_baseUrl = "/";  //前端资源根路径(js,css等,在视图模版中使用)

            var g_url = "/";      //后端接口根路径

            $(document).ready(function () {

                g_baseUrl             = "http://" + window.location.host + "/admin/";

                // g_url                 = "http://" + window.location.host;

                g_url                 = "http://full.tkc8.com";

                Alpaca.Config.baseUrl = "/admin/"; //alpaca-spa根路径

                Alpaca.run("#/main/index/index");

            });

    </script>


    这样你就可以使用本地的前端,访问服务端(full.tkc8.com)提供的接口。


    假设你本地配置的域名为: 127.0.0.1

    访问: 127.0.0.1/admin

目录结构

|--app

|  --Common                  -- 用来放置一些公共的类、函数等

|  --Models                  -- 用来放置与数据库对应的实体类文件

|  --Modules                 -- 存放模块相关信息,里面包含控制器,业务逻辑等,

|     |--Manage               -- 后台管理模块儿后端(服务端)代码,前后分离开发,这里只返回Json格式的接口

|     |--Server               -- 用户前台模块儿后端(服务端)代码,同上,只返回Json格式的接口

|  ExceptionHandler.php      -- 异常处理配置

|  RouteProvider.php         -- 路由配置

|--bootstrap                  -- 是Laravel框架本身自带的一个目录,主要功能是提供应用初始化的一些相关功能,需要读写权限(含子目录)

|  --Console                 -- Laravel Cli

|   --builder                 -- 代码自动生成工具

|   --crontab                 -- 定时任务工具(非linux shell)

|--config                     -- 配置文件目录

|   .env                      -- 将原来Laravel在外层的.env也挪到了config目录下面

|--public                     -- 入口目录,配置服务器时,应该将网站根目录设置为public

|  --admin                   -- 后台管理模块儿的前端(客户端)部分(这里是前后分离开发,这里不含有任何php代码,也可以独立部署)

|   --app                     -- 用户前台模块儿的前端(客户端)部分(这里是前后分离开发,同上)

|   index.php                 -- php入口文件

|--storage                    -- 存放程序运行时的log、cache、session等文件,需要读写权限(含子目录)

|--vendor                     -- composer相关目录

|composer.json

|composer.lock

路由功能

推荐每一个模块拥有自己的一个路由配置文件


1 app/RouteProvider.php中可以配置整个系统的路由组织结构

2 app/Modules/Manage/router.php配置Manage模块的相关路由

3 app/Modules/Server/router.php配置Server模块的相关路由

4 bootstrap/builder/router.php配置代码生成工具的路由

5 bootstrap/crontab/router.php配置定时任务工具的路由

配置文件

1 配置文件存放在config目录中,与原Laravel的规则一样


2 处理与系统环境相关的配置。


  如果设置了环境变量MOD_ENV = DEVELOPMENT,系统会加载.env.development配置文件

  如果设置了环境变量MOD_ENV = PRODUCTION,系统会加载.env.production配置文件

  如果设置了环境变量MOD_ENV = TEST,系统会加载.env.test配置文件

  否则会默认加载.envt配置文件

权限控制

1 实现权限功能,需要在数据库中存在5张表:


  用户表、角色表、权限表、用户角色关系表、角色权限关系表。


  这样建立用户-角色-权限的对应关系。


2 登录权限控制


  1)如果当前控制器下的某一个动作不需要登录权限:


      protected function noLogin()

      {

          // 以下Action不需要登录权限

          return ['action1','action2'];

      }

      这样 action1 与 action2 就不需要登录也可以访问


  2)如果当前控制器下的所有动作都不需要登录权限:


      protected function noLogin()

      {

          this->isNoLogin =true;

      }

     这样当前控制器下的所有动作都不需要登录权限就可以直接访问


3 角色权限控制


  1)如果当前控制器下的某一个动作不需要角色权限控制:


      protected function noAuth()

      {

          // 以下Action不需要登录权限

          return ['action1','action2'];

      }

     这样 action1 与 action2 不需要角色权限也可以访问


  2)如果当前控制器下的所有动作都不需要登录权限:


      protected function noAuth()

      {

          this->isNoAuth =true;

      }

     这样当前控制器下的所有动作都不需要登录权限就可以直接访问


  3)重写当前控制器下某一个动作的角色权限


      protected function noAuth()

      {

          return [

                'actionName'=>function($result){

                     if($_GET['id'] == 1){

                        return true;

                     }

                 },

          ];

      }


     可以通过为action指定一个函数来自定义动作的角色权限控制功能,


     函数有一个参数$result,


     如果$result为true表示系统默认的角色权限控制判断当前动作有权限访问,false为没有权限访问,

定时任务功能

    示例中提供了PHP实现定时任务(非linux-shell方式,与操作系统无关)功能。


    适用于定时精确时间不低于1秒。web服务重启、或者php重启。该定时任务不会自动重启。

    可以用来处理大部分定时任务的结局方案,商城定时自动收货,关闭评论,订单回滚;定时发送邮件,数据备份等


    实现原理及更详细的内容请参考下面这篇文章:

    https://my.oschina.net/u/3381391/blog/1510260



前端功能

    public\admin中存放前端代码,

    public\admin\index.html是前端入口文件,

    public\admin\main\controller存放前端main模块的控制器,

    public\admin\main\view存放前端main模块的视图页面,

自动生成代码

项目中提供了生成代码的工具:Alpaca-Builder


目的用来快速的编写代码,减少一些重复的工作,主要功能是根据输入的数据库表名声生成一下内容:


1 生成后端实体类

2 生成后端控制器

3 生成后端路由

4 生成前端JS控制器

5 生成前端编辑页面

6 生成前端列表页面

7 生成配置接口url

8 选择是否复制到对应页面



访问方式,浏览器中输入地址:你的域名\builder


(注意: 只有当配置文件中APP_ENV=local时,才容许访问)


运行WebSocket

需要在linux环境下,项目根目录


#debug运行

php artisan ws start

#常驻后台运行

php artisan ws start --d

开发流程

    后端(服务端)部分:


    1 建立数据表

    2 编写模型类,放在/app/Models

    3 编写控制器类,放在模块的Controllers目录下面,例如: /app/Modules/Manage/Controllers/{name}Controller.php

    4 *(可选)如果有比较复杂的业务逻辑需要处理,可以加一个Service层,放在模块的Service目录下面

    5 路由配置:路由一般放在当前模块目录下面,例如:/app/Modules/Manage/router.php


    前端(客户端)部分:


    项目采用前后分离开发,因此前端代码会更独立,html文件中不含有任何php代码

    1 编写列表显示页面(两个html)

       /public/admin/view/{name}/{name}ListView.html       页面主体

       /public/admin/view/{name}/{name}ListDisplay.html    页面table部分

    2 编写编辑页面(新增和修改用一个)

       /public/admin/view/{name}/{name}EditView.html

    3 编写前端控制器,实现与后端数据交互, :

       路径:/public/admin/controller/{name}.js

       一般有三个方法:

       {name}ListView方法,        显示列表页面,调用后台数据接口查找列表数据

       {name}ListDisplay方法,     渲染显示数据

       {name}EditView方法          显示编辑页面,调用后台接口

    4 配置菜单:

        路径:/public/admin/view/layout/part/pageSidebar.html

    5 配置后端接口,建议是把后端地址写在配置文件里面:

        路径:/public/admin/main/main.js 中的API变量


推荐

  • QQ空间

  • 新浪微博

  • 人人网

  • 豆瓣

取消