π框架从入门到放弃

什么是π框架？

全称Phalapi，是一个PHP轻量级开源接口框架，以下是他的优点：

免费：最好的往往是免费的；
不断更新：15年发布，到现在不断的更新和完善，现已达到2.X版本；
简单易学：新版本引入了命名空间和composer统一管理依赖包，相对有thinkphp5框架学习基础的人，很快就可以从入门到实战了；
提供很多接口服务：可用于快速搭建微服务、RESTful接口或Web Services；

2.X版本

使用了composer统一管理依赖包
引入了命名空间
遵循PSR-4规范

适用场景

为移动App（包括iOS、iPad、Android、Windowns Phone等终端）提供接口服务
用于搭建接口平台系统，提供聚合类接口服务，供其他后端系统接入使用
为前后端分离的H5混合页面应用，提供Ajax异步接口

入门

前面说了，phalapi框架新版本2.x与旧版本1.x传统的设计理念的不同，学过thinkphp5的人，半天就可以入门π框架，但如果没学过thinkphp5的人岂不是一脸懵逼？不用担心，下面小编带你简单的过一下学习的流程。

下载

从官网【https://www.phalapi.net/】上下载2.x版本的π框架，放到你wamp集成环境下可以访问位置（当然你单独用Nginx或Apache服务也行，集成环境只是图个方便），还有最好用火狐浏览器显示接口返回的json数据，（它会让数据结构更加清晰，方便你学习），最后建议一个编辑器那就是PhpStorm。

访问默认接口

安装完相应工具，你离成功就不远啦！在火狐浏览器输入：http://localhost/phalapi/public/（根据个人根目录的不同在访问），效果如下：

image.png

ps:与我不同的是，你没显示debug数据，可在config/sys.php修改debug为true

那么为什么会有数据显示呢？我们明明就没有写接口呀？因为这个默认接口服务，也可以说是example；

image.png

红框：入口文件
黄框：默认访问api类Site
篮框：默认访问接口服务

项目源代码放置在上图中的src文件，里面各个命名空间对应一个子目录，默认命名空间是app，里面主要有Api、Domain、Model这三个目录以及存放函数的functions.php文件。
当需要新增一个接口时，先要在Api层添加一个新的接口文件。例如对于Hello World示例，可以使用你喜欢的编辑器创建一个./src/app/Api/Hello.php文件，并在里面放置以下代码。（如图）

// 文件 ./src/app/Api/Hello.php
 'Hello World!');
    }
}

访问一个接口

通常情况下，建议可访问的根路径设为/path/to/PhalApi2/public。若未设置，此时接口访问的URL格式为：接口域名/public/?s=Namespace.Class.Action。其中，s参数用于指定待请求的接口服务，由三部分组成

组成部分	是否必须	默认值	说明
Namespace	可选	APP	Api命名空间前缀，多级命名空间时用下划线分割
Class	必须	无	待请求的接口类名，通常首字母大写
Action	必须	无	待请求的接口类方法名，通常首字母大写。若Class和Action均未指定时，默认为Site.Index

效果

image.png

PS：当响应成功时，http状态码应该为200，我在源代码里修改响应类ret为1

恭喜！你已顺便完成PhalApi 2.x 简单的接口开发了！