文档章节

【双12首发】终于等来了!PhalApi-iView-admin 开源后台框架

暗夜在火星
 暗夜在火星
发布于 2018/12/12 21:59
字数 886
阅读 266
收藏 5

PhalApi-iView-admin 开源后台框架

码云地址:https://gitee.com/dogstar/phalapi-iview-admin

Github地址:https://github.com/phalapi/phalapi-iview-admin

 

主要采用的技术:

本项目的最大特色:符合前后端分离的主流设计思想,结合了专注于接口领域的PhalApi框架,以及很火的iView。目前,使用的都是最新版本的技术,包括:PhalApi 2.4.2、iView-admin 2.3.0、PHP 7、Vue等。

欢迎大家一起参与开源维护!

 

在线访问

在线demo请访问:http://iview-admin.phalapi.net/

 

前端部分(iView界面)

 

安装

// install dependencies
npm install

 

运行

 

开发环境

本地开发调试时使用,

npm run dev

 

生产环境

打包发布时使用,

npm run build

更多帮助和说明,请前往iView-admin

 

后端部分(PHP接口)

 

安装

配置站点,如果使用的是Nginx,请参考以下配置。为了整合PhalApi与iView-admin,关键有两点:

  • 第1点、网站根目录需要定位到 dist 目录
  • 第2点、需要为接口配置重定向,以便前端能通过相对路径访问后端接口
server {
        listen 80;
        server_name iview-admin.phalapi.net;

        index index.html;
        root /path/to/phalapi-iview-admin/dist;

        # 接口重定向
        rewrite ^/api/(.*) /api.php?s=$1 last;

        location ~ \.php$ {
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                fastcgi_index index.php;
                include fastcgi_params;
                fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
        }

        access_log /var/log/nginx/iview-admin.phalapi.net.access;
        error_log /var/log/nginx/iview-admin.phalapi.net.error;
}

 

两个重要的访问链接

本地部署好后,就能开始访问了。假设当前配置的站点域名是:iview-admin.phalapi.net,两个重要的访问链接分别是:

 

接口模拟、接口请求、接口实现与接口文档

 

接口模拟

特别说明一下,针对接口的访问路径,之所以使用重定向,是了方便在前端本地开发调试时能很好模拟数据。例如:

在./src/mock/index.js文件中,设定需要模拟的接口:

Mock.mock(/\/api\/Message.Count/, messageCount)

在./src/mock/user.js文件中,就能返回模拟的数据:

 export const messageCount = () => {
  return 3
}

 

接口请求

对于在前端,需要请求接口时,可以参考./src/api/user.js 文件中的:

export const getUnreadCount = () => {
  return axios.request({
    url: 'api/Message.Count',
    method: 'get'
  })
}

如果请求的是真实的接口,例如请求的接口链接是:http://iview-admin.phalapi.net/api/Message.Count,那么返回的接口结果是:

{"ret":200,"data":3,"msg":""}

此时,在 ./src/libs/axios.js 底层已经兼容了开发与生产这两种模式。

 

接口实现

Message.Count对应的接口PHP源代码,则位于:./phalapi/src/app/Api/Message.php,相关代码片段如下:

 <?php
namespace App\Api;
use PhalApi\Api;

/**
 * 消息接口
 */
class Message extends Api {
    /**
     * 新消息数量
     */
    public function count() {
        return 3;
    }
}    

 

接口文档

自动生成的在线接口文档,访问链接是:http://iview-admin.phalapi.net/docs.php?service=App.Message.Count&detail=1&type=fold。 效果如下:

更多帮助和说明,请前往PhalApi

 

如何升级iView-admin?

可直接通过更新npm依赖包进行升级,即:

$ npm update

如果有其他更新,则根据需要相应覆盖源代码即可。

 

如何升级PhalApi?

如果PhalApi框架有更新,可直接进入phalapi目录进行升级。即:

$ cd phalapi
$ composer update

更新前,需要先确保./phalapi/composer.json配置中的PhalApi版本号是最新的。如果有其他更新,则根据需要相应覆盖源代码即可。

 

许可

本项目以iView-admin的开源协议为主,即MIT协议。

© 著作权归作者所有

暗夜在火星

暗夜在火星

粉丝 168
博文 177
码字总数 326789
作品 1
广州
程序员
私信 提问
暗夜在火星/phalapi-iview-admin

PhalApi-iView-admin 开源后台框架 主要采用的技术: PhalApi 开源接口框架 iView-admin 基于iView的管理系统模板 本项目的最大特色:符合前后端分离的主流设计思想,结合了专注于接口领域的...

暗夜在火星
2018/12/13
0
0
ApiAdmin v3.0.3 发布,Vue+TP5完美诠释前后分离

站在巨人的肩膀上,并不是高的表现,反而使自己变得渺小~只有吸收了巨人的营养,茁壮自己才是真正的高大! --笔者 ApiAdmin 前端页面 ApiAdmin3.0是一个前后端完全分离的项目,前端采用Vue构...

ZHXI
2018/02/26
6.2K
6
PhalApi三周年庆典纪念活动

前言: PhalApi是一个PHP轻量级开源接口框架,致力于快速开发接口服务。支持HTTP/SOAP/RPC等协议,可用于搭建接口/微服务/RESTful接口/Web Services,目前在码云平台上深受广大开发人员的喜欢...

暗夜在火星
2017/06/08
2
0
PhalApi官网发布和开源团队招募

官网发布 怀着激动的心情,我们的PhalApi官网终于上线了!虽然暂时还是比较简单的,而且网址也是IP(因为国外的服务器还在购买中),但这些都是暂时的!因为在不远的将来,我们会在www.phala...

暗夜在火星
2015/02/12
376
8
PhalApi 1.3.5 贺岁发布,PHP 轻量接口框架

[前言] 借春节来临之际, PhalApi(π框架)在此发布v1.3.5幺鸡贺岁小版本,同时祝愿各位同学新春快乐、万事如意! 基于老版本开发的应用可以无缝升级到v1.3.5版本,直接覆盖核心文件PhalApi...

暗夜在火星
2017/01/06
835
6

没有更多内容

加载失败,请刷新页面

加载更多

OSChina 周日乱弹 —— 别问,问就是没空

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @tom_tdhzz :#今日歌曲推荐# 分享容祖儿/彭羚的单曲《心淡》: 《心淡》- 容祖儿/彭羚 手机党少年们想听歌,请使劲儿戳(这里) @wqp0010 :周...

小小编辑
今天
312
7
golang微服务框架go-micro 入门笔记2.1 micro工具之micro api

micro api micro 功能非常强大,本文将详细阐述micro api 命令行的功能 重要的事情说3次 本文全部代码https://idea.techidea8.com/open/idea.shtml?id=6 本文全部代码https://idea.techidea8....

非正式解决方案
今天
5
0
Spring Context 你真的懂了吗

今天介绍一下大家常见的一个单词 context 应该怎么去理解,正确的理解它有助于我们学习 spring 以及计算机系统中的其他知识。 1. context 是什么 我们经常在编程中见到 context 这个单词,当...

Java知其所以然
昨天
5
0
Spring Boot + Mybatis-Plus 集成与使用(二)

前言: 本章节介绍MyBatis-Puls的CRUD使用。在开始之前,先简单讲解下上章节关于Spring Boot是如何自动配置MyBatis-Plus。 一、自动配置 当Spring Boot应用从主方法main()启动后,首先加载S...

伴学编程
昨天
8
0
用最通俗的方法讲spring [一] ──── AOP

@[TOC](用最通俗的方法讲spring [一] ──── AOP) 写这个系列的目的(可以跳过不看) 自己写这个系列的目的,是因为自己是个比较笨的人,我曾一度怀疑自己的智商不适合干编程这个行业.因为在我...

小贼贼子
昨天
8
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部