phalapi-入门篇2(把它玩起来)

#phalapi-入门篇1(把它玩起来)#

##前言## 先在这里感谢phalapi框架创始人@dogstar,为我们提供了这样一个优秀的开源框架.

这一小节主要是在搭建好的环境下,先把这个框架运行起来,和数据库交互起来(这里用的是mysql),对整个框架的结构进行最简单的一些介绍,以及点出一些新手长遇到的一些问题和一些小技巧.

附上:

官网地址:http://www.phalapi.net/

开源中国Git地址:http://git.oschina.net/dogstar/PhalApi/tree/release

##1. 运行起来吧PhalApi##

不用说首先当然是下载项目文件咯.

推荐使用git工具(如果不会使用Git 可以直接去开源中国下载源码):

使用git把https://git.oschina.net/dogstar/PhalApi.git克隆下来

然后切换到1.2.1分支上面(注:这里使用的是当前最新版本)

现在我们能看到真正的源码了 我们先来分析一下目录结构其实在项目里面有一个文件README.md里面已经有介绍了(我在补充一点)

│
├── PhalApi         //PhalApi框架,后期可以整包升级(尽量小的改动,大改动会影响框架的迭代)
│
│
├── Public          //对外访问目录,建议隐藏PHP实现(增加安全性)
│   └── demo        //Demo服务访问入口(我认为是所谓的项目名)
│
│
├── Config          //项目接口公共配置,主要有:app.php, sys.php, dbs.php(配置文件不多说)
├── Data            //项目接口公共数据(也就是从一开始的数据库sql文件以及后面结构有任何变化的sql文件都存放这里,方便自己查找,好习惯之一)
├── Language        //项目接口公共翻译(需要国际化的话很有用,让返回更优雅高可用)
├── Runtime         //项目接口运行文件目录,用于存放日记,可软链到别的区(主要是日志,一定要有写的权限不然会报错)
│
│
└── Demo            //应用接口服务,名称自取,可多组(项目文件所谓真正实现业务的地方)
    ├── Api             //接口响应层(主要用于接收请求,返回结果,把一块大的业务分发成一块块小的业务)
    ├── Domain          //接口领域层(我觉得可以叫做逻辑层容易理解一点,分成的各个小的业务在这里进行处理)
    ├── Model           //接口持久层(实现最简单的数据库操作,不要有任何逻辑因为是高可用)
    └── Tests           //接口单元测试(不用多说)

然后我们把项目文件放到网站的根目录然后我们运行http://localhost/Public/(localhost请自行替换)我们可以获得以下结果:

强烈推荐使用json解析工具(这里使用的chorme插件json-handle附上下载地址json-handle)

这样第一步运行PhalApi就已经完成了

注:有些童鞋可能运行起来是一片白(这点请大家特别注意,有很多人问我怎么自己写了一个模块调用一直是一片白,其实是php报错了只是你没有打开php报错)解决方法是修改php.ini文件中的两个参数

error_reporting=E_ALL
display_errors=ON

##2. 他是如何运行起来的##

先说说为什么会有上面这一串返回,有php基础的人都知道访问了Public目录默认是访问到了Index.php这个文件我们来看看它的代码

<?php
/**
 * $APP_NAME 统一入口
 */
require_once dirname(__FILE__) . '/init.php';                     //引入初始化文件我们以后再讲
//装载你的接口						
DI()->loader->addDirs('Demo');									  //这个就是定义了你接口所在的目录
/** ---------------- 响应接口请求 ---------------- **/
$api = new PhalApi();											  
$rs = $api->response();											  //执行你的接口
$rs->output();													  //返回结果

大家要是进入到$api->response();里面就会发现有这样一条语句

$service = DI()->request->get('service', 'Default.Index');

也就是当你没有定义访问莫个接口的时候,它会指向到Default模块下的Index接口

所以http://localhost/Public/等同于http://localhost/Public/?service=Default.Index试一试会得到一样的结果

机智的小伙伴一定发现了在项目中的Demo/Api里面有Default.php这样一个文件而恰巧里面有一个index方法,没错就是通过service=Default.Index找到了Default模块中的index方法

实现这一机制的语句是:

$rs->setData(call_user_func(array($api, $action)));

有兴趣的童鞋可以研究研究

##3. 数据库操作##

Demo下面的Api文件除了上面所调用的Default.php还有一个User.php没错就是User模块里面分别有两个接口可供调用 getBaseInfo,getMultiBaseInfo那我们直接调用getBaseInfo看看结果http://localhost/Public/?service=User.getBaseInfo

相信大家一眼就能看出来是缺少了传参我们在试试带上参数会怎么样http://localhost/Public/?service=User.getBaseInfo&user_id=1

当然这个是因为没有配置数据库引起的如何配置?当然是在配置文件里面配置,大家打开Config目录下的 dbs文件key看到以下类容

'db_demo' => array(                             //服务器标记
        'host'      => 'localhost',             //数据库域名
        'name'      => 'phalapi',               //数据库名字
        'user'      => 'root',                  //数据库用户名
        'password'  => '',	                    //数据库密码
        'port'      => '3306',                  //数据库端口
        'charset'   => 'UTF8',                  //数据库字符集
    ),

我们把它配置好然后再运行,可能有些人还是看到的和上面的情况是一样的,要不就是数据库不通要不就是没有创建phalapi数据库(自行创建)

当我们保证数据库能够联通,phalapi数据库也存在的情况下再去链接可能会出现类似于Warning: mkdir(): Permission denied in PhalApi/PhalApi/Logger/File.php on line 45这类错误,这是应为没有创建文件权限造成的,windows下面基本不会应为读写权限出问题,liunx下面要注意这点

当我们给目录赋予权限之后在运行可能会出现一个很长的报错PDOException大概的意思就是找不到tbl_user表

其实sql文件已经在Data文件夹里面了phalapi_test.sql

我们把sql文件运行一下创建好的效果是这样的(phalapi_test库名改成phalapi)

让我们再次运行那么结果就出来了

这样我们就已经把框架自带的例子跑了起来

##4. 总结##

这一小节主要是把phalapi的一些基本的机制做了一些简单的介绍,以及把框架自带的实例运行了起来,下一小节会着重介绍一下框架自带的请求验证,返回结果和自动生成的接口文档!

注:笔者能力有限有说的不对的地方希望大家能够指出,也希望多多交流!

官网QQ交流群:421032344 欢迎大家的加入!

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏专注数据中心高性能网络技术研发

linux查看系统信息

---- 1.uname uname命令用于打印当前系统相关信息(内核版本号、硬件架构、主机名称和操作系统类型等) -a或--all:显示全部的信息; -m或-...

3235
来自专栏木可大大

Linux监控指令

说到监控CPU,目前主要是监控CPU的使用率,以及每一个进程占用CPU资源,Linux系统中主要使用 top、vmstat、pstree 三个命令。

1342
来自专栏IMWeb前端团队

自制前端脚手架

前言 新建项目是很繁琐的一项工作, 要考虑项目目录结构,基础库的配置等等。 前段时间因为需求使用了几款前端脚手架,包括yeoman、imweb-cli, 他们...

3648
来自专栏云计算教程系列

如何在Ubuntu 14.04上使用Cassandra运行多节点群集数据库

Apache Cassandra是一个高度可扩展的开源数据库系统,在多节点设置上实现了出色的性能。

1232
来自专栏C/C++基础

Linux下使用gdb调试core文件

当程序运行过程中出现Segmentation fault (core dumped)错误时,程序停止运行,并产生core文件。core文件是程序运行状态的内存映...

1803
来自专栏轮子工厂

你真的了解Linux系统吗?

现在很多公司项目部署都使用的是 Linux 服务器,互联网公司更是如此。对于大一些的互联网公司,系统可能会非常复杂,本地无法启动,一般都会采用专门的开发机给开发...

1044
来自专栏SDNLAB

ONOS集群原理及流程分析

一、ONOS集群原理简介 ONOS是一个分布式的控制器,为了提高数据的读写效率,采用自实现的基于In-Memory的Key-Value数据存储系统。针对实际的需...

3658
来自专栏开源优测

性能测试必备监控技能jvm之jdk命令行工具篇16

前言 对于JVM的性能监控,主要注意以下关键参数,通过jdk自带的命令行工具,即可查看相关参数,从而分析系统或目标服务程序中存在的性能瓶颈 jps JVM Pr...

29212
来自专栏MYSQL轻松学

你了解的max_allowed_packet

Error updating database. Cause: com.mysql.jdbc.MysqlDataTruncation: Data trun...

4007
来自专栏Golang语言社区

Linux命令行:find的26个用法示例

作者 | Wray 来自 | http://www.codebelief.com/ Linux系统中的 find 命令在查找文件时非常有用而且方便。它可以根...

36013

扫码关注云+社区