开源接口框架 PhalApi 2.7.0 - 接口，从简单开始！

PhalApi 2.7.0 - 接口，从简单开始！

一、开发文档

专为PHPer准备的优雅而详细的开发文档，请看：PhalApi 2.x 开发文档。

二、在线示例

• 默认接口服务：demo.phalapi.net/?s=App.Site…
• 在线接口文档：demo.phalapi.net/docs.php
• 接口详情文档（以默认接口为例）：demo.phalapi.net/docs.php?se…
• PhalApi创新项目-小白接口（免费、免开发、直接可用的的云端API）：www.okayapi.com/

三、快速安装

composer一键安装

使用composer建立项目的命令，可实现一键安装。

$ composer create-project phalapi/phalapi
复制代码

舒适提示：关于composer的使用，请参考Composer 中文网 / Packagist 中国全量镜像。

手动下载安装

或者，也能够进行手动安装。将此Git项目代码下载解压后，进行可选的composer更新，即：

$ composer update
复制代码

四、使用

调用接口

在PhalApi，你能够经过service参数（短名字是s参数）指定须要调用的接口服务。例如，访问默认接口服务。

• 默认接口：http://localhost/phalapi/public/?s=App.Site.Index

舒适提示：推荐将访问根路径指向/path/to/phalapi/public。

对应执行的PHP代码在./src/app/Api/Site.php文件，源码片断以下：

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

/** * 默认接口服务类 * @author: dogstar <chanzonghuang@gmail.com> 2014-10-04 */
class Site extends Api {
    public function getRules() {
        return array(
            'index' => array(
                'username'  => array('name' => 'username', 'default' => 'PhalApi', 'desc' => '用户名'),
            ),
        );
    }

    /** * 默认接口服务 * @desc 默认接口服务，当未指定接口服务时执行此接口服务 * @return string title 标题 * @return string content 内容 * @return string version 版本，格式：X.X.X * @return int time 当前时间戳 * @exception 400 非法请求，参数传递错误 */
    public function index() {
        return array(
            'title' => 'Hello ' . $this->username,
            'version' => PHALAPI_VERSION,
            'time' => $_SERVER['REQUEST_TIME'],
        );
    }
}
复制代码

接口请求后结果输出相似以下：

{
    "ret": 200,
    "data": {
        "title": "Hello PhalApi",
        "version": "2.4.2",
        "time": 1501079142
    },
    "msg": ""
}
复制代码

运行效果，截图以下：

查看在线接口文档

PhalApi会根据你编写的接口的参数配置和代码注释，自动实时生成在线接口文档。在线接口文档连接为：

• 在线接口文档：http://localhost/phalapi/public/docs.php

浏览效果相似以下：

五、一张图告诉你如何使用PhalApi 2.x

六、子项目

• phalapi/kernal
• phalapi/notorm

七、还有问题，怎么办？

如发现问题，或者任何问题，欢迎提交Issue到这里，或进入PhalApi开源社区。
若是喜欢，请帮忙在Github或码云给个Star，也能够对PhalApi进行捐赠哦 ^_^。