PhalApi 2.7 开发快速上手（PhalApi phpstudy）

PhalApi是一款国人制作的PHP纯后端框架。它的开发相当简单，同时也具备文档生成等特色功能。下面，我通过简单的几点，让你可以快速入门使用该框架的开发。
建议使用PHPStorm作为IDE，代码提示相当完全。由于PHP的热更新特性，修改过的PHP文件保存后立即生效，无需编译，无需重启服务器。

什么是PhalApi

PhalApi是一个轻量级的PHP接口框架。有别于传统的框架，它只面向后端接口的开发。
官网：https://phalapi.net
官方文档：http:/https://p.download-x.com/docs.phalapi.net/#/v2.0/

安装PhalApi

Composer是PHP的包管理器（类似于Java的Maven、node的npm）。
Composer的安装请参考https://pkg.phpcomposer.com/#how-to-install-composer，不要在英文官网直接下载安装包。
Composer安装后请立即切换到国内源https:/https://p.download-x.com/developer.aliyun.com/composer。
Phar是PHP界的Jar包，可以像Jar包一样引入即用。
在项目目录下执行composer create-project phalapi/phalapi即可创建PhalApi项目，项目路径为./phalapi。
若需要安装阿里云OSS的SDK，则在项目路径下（注意cd到phalapi目录）按https://help.aliyun.comhttps://p.download-x.com/document_detail/85580.html说明调用Composer。

composer require aliyuncs/oss-sdk-php
composer install

PhalApi提供了再封装的PhalApi-OSS阿里云OSS包（https://github.com/vivlong/phalapi-aliyun-oss），也可以考虑使用

本地调试环境配置

建议使用傻瓜式一体化软件XAMPP搭建本地的调试环境。
修改XAMPP中Apache的配置文件，找到这两行：

DocumentRoot "X:/XAMPP/htdocs"
<Directory "X:/XAMPP/htdocs">

将引号内目录修改到PhalApi项目的public目录，注意使用左斜杠替换右斜杠、
修改后启动Apache，则项目在localhost:80上启动。如需修改端口请参考Apache配置文件的其他配置项。

更优雅的接口地址

默认的接口网址为类似于http://xxx.com/?s=App.User.Login（?s后为接口全限定名），不够美观。开启URI路由匹配后可以实现http://xxx.com/User/Login的接口路径，比较美观。（App字段可以省略）
开启方式：

1. 在./config/sys.php修改enable_uri_match配置为true
2. 撰写服务器Rewrite规则。若使用Nginx服务器，请直接参考官方文档示例（http:/https://p.download-x.com/docs.phalapi.net/#/v2.0/how-to-request?id=开启uri路由匹配）。
   若使用Apache服务器：
   • 在./public目录下新建规则文件.htaccess

   • 写入下列内容（即将所有404请求转发到index.php，作为一个controller）

     RewriteEngine on
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteCond %{REQUEST_FILENAME} !-d
     RewriteRule ^(.*)$ index.php

   • 重启Apache服务器

PhalApi的ADM三层模型

有别于软件开发领域常用的MVC三层模型，在后端纯接口开发中，View层显然没有任何意义。所以PhalApi采用了创新的ADM三层模型。

Api接口

三层模型所有的代码均在./src/app目录下。Api、Domain、Model目录下默认生成了一些demo，可以删除。
在Api目录下新建php类，假设为MyClass.php。注意下列要求：

即若类文件在Api目录下发生了层叠，则需要加入下划线分隔，而不是一直用斜杠。
下面介绍如何在Api层获取和处理请求参数。

• 重写public function getRules()方法，

  public function getRules() {
    return array(
      '[FUNCTION NAME]' => array(
      '[PARAM NAME]' => array('name' => '...', 'require' => ..., 'type' => '...', 'source' => '...', 'desc' => '...', 'min' => ..., 'max' => ...)
    );
  }

  返回一个关联数组，键为该Api类下的函数名称（即接口），值又是一个关联数组，键为参数名，值又是一个关联数组，用于进行该参数的配置，具体配置项可参考http:/https://p.download-x.com/docs.phalapi.net/#/v2.0/api-params。下面介绍几个常用的：

  • name：string，前端请求时用的参数名
  • require：boolean，是否必须
  • type：参数类型，可以用string、int等
  • source：string, 参数源，可以用post、get（注意小写）等
  • desc：参数说明，该说明会出现在自动文档中
  • min和max（均可选）：当type是int时，可以起到后端参数校验的作用

• 在接口对应函数的代码中取参数：

$param_var = $this->[PARAM NAME]

取好参数，发给Domain层的对应函数，获取返回值，发送响应给服务器端。这就是Api层做的事。
一般来说，需要在头部use一下App\Domain下的对应的Domain，然后在需要时new一个domain对象来使用。

Model模型

在Model目录下新建php类，假设为User.php。通常的开发习惯是，数据库一张表对应一个Model类，这样可以实现对表的描述（类似于Mybatis与POJO的配合）。以MySQL为例，注意下列要求：

首先要通过$this->getORM()获取NotORM实例，然后组织相关SQL关键字即可。
值得一提的是，NotORM的功能非常的强大（起到了SQL语句Builder的作用，极大地避免了直接组织SQL语句），它甚至可以接收关联数组为参数进行各种智能的INSERT、UPDATE等操作。具体使用请参考http:/https://p.download-x.com/docs.phalapi.net/#/v2.0https://p.download-x.com/database-usage，靠这里的一两句话是说不清道不明的。
如果有需要，NotORM也支持执行原生SQL语句。

Domain领域

在Domian领域下新建php类，假设为User.php。对于Domain类，要求比较简单：

• namespace App\Domain\; - 你懂的
• 没了。

Domain类不要求use框架内部的类，也不要求定义的类继承相关类。
在User类下写相关业务函数即可。一般来说，此处函数的参数是Api层请求需要的所有参数。
在业务函数中，调用Model层中封装好的有关CURD函数，完成业务逻辑。一般来说，需要在User.php头部use一下App\Model下的对应的User的model，在进行CURD操作时，new一个model对象来使用。

全局配置文件

在./config目录下的app.php、dbs.php、di.php、sys.php就是四大全局配置文件。
如何在./src中脚本的任意位置取出其中配置的键值对？PhalApi用了依赖注入（DI）和反射的功能，实现了看起来非常Java的方式来获取。
例如在app.php中配置了如下内容：

'token' => array( 'SALT' => 'imsalt', 'expire' => 7200)

要取盐值，则取法为\PhalApi\DI()->config->get('app.token.SALT')。

即对于这四大配置文件，均用\PhalApi\DI()->config->get来访问，参数为配置项的全限定名。

这四大配置文件的作用是：

• app.php - 用户自定义的相关配置均追加于此
• dbs.php - 数据库相关配置
• di.php - 依赖注入相关配置，当有新组件插入时需要修改
• sys.php - 系统级配置，例如是否调试、URI匹配等

全局功能函数

如何定义一个在./src中任何位置都可以调用的功能函数？把这个函数的实现写在./src/functions.php中即可。在需要调用时，使用\App\[FUNCTION NAME]来调用。

自动接口文档

不同于Swagger的高侵入性，PhalApi的自动接口文档系统非常的简单优雅。不仅方便前端阅读，还具备自解释性，利于后续后端的维护。和JavaDoc类似，它全部依靠多行注释完成。并且，多行注释内允许使用基本的HTML标签，如<b></b>来加粗等等。

注意，合法的多行注释格式如下，首行有两个星号。

/**
 *
 */

这样使用：

若一切配置无误，则可以在http://xxx.comhttps://p.download-x.com/docs.php阅读到自动生成的接口文档。

接口文档网页还可以进行定制：

• 修改./publichttps://p.download-x.com/docs.php中的$projectName，可以修改左上角LOGO处的标题。
• 如果需要公共说明（如图中的统一说明），则在./publichttps://p.download-x.com/docs.php末尾添加php脚本闭标签（?>）后，可以书写HTML代码。由于该页面布局的原因，不建议将公共说明写在头部。

前端请求方式

• 对于PHP后端，前端在发送POST请求前必须设置如下请求头，否则后端收不到数据：

header: {'content-type': "application/x-www-form-urlencoded; charset=UTF-8"}

​ GET请求没有类似限制。

• 前端用axios来POST时，data为Object，无需stringify

• 前端收到的响应作res.data后即为如下结构的Object:

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

​ ret为http状态码，msg为错误提示信息（当状态码非200时才有），data为业务数据

• 在自动接口文档中，形如App.X_Y.Z的接口请求地址为http://xxx.com/X_Y/Z（如果配置了URI匹配）

开发实例

系统日志

PhalApi提供了一个简单日志系统。它将日志等级分类三级：error、info、debug。

保存目录：./runtime/log

调用方式：\PhalApi\DI()->logger->error/infohttps://p.download-x.com/debug([日志内容], [上下文描述（可选）])

MySQL数据库

MySQL数据库需要在./confighttps://p.download-x.com/dbs.php内配置。

PhalApi支持实现多库集群、分库分表。具体请参考：

• http:/https://p.download-x.com/docs.phalapi.net/#/v2.0https://p.download-x.com/database-connect
• http:/https://p.download-x.com/docs.phalapi.net/#/v2.0https://p.download-x.com/database-multi
• http:/https://p.download-x.com/docs.phalapi.net/#/v2.0https://p.download-x.com/database-other

服务端请求CUrl

如果有需要在服务器端利用服务器发送HTTP请求（例如小程序开发中的code2session），PhalApi为我们封装了CUrl库来实现，非常简单。参考http:/https://p.download-x.com/docs.phalapi.net/#/v2.0/curl。

缓存体系

此处用常用的Redis说明。

• 在./confighttps://p.download-x.com/di.php中向$di注入Redis依赖：

$redis_config = array('host' => '127.0.0.1', 'port' => 6379);
$di->cache = new PhalApi\Cache\RedisCache($redis_config);

• 之后，在需要使用Redis的地方利用\PhalApi\DI()->cache->set/gethttps://p.download-x.com/delete等等即可

CORS跨域

利用跨域插件https://github.com/gongshunkai/phalapi-cors，配置相当简单。

RESTful

由于PHP只是Apache/Nginx上的插件，HTTP服务是由它们提供的，所以若要实现严格的RESTful API，必须借助它们的支持。例如Apache，需要对.htaccess文件进行配置，来转发/重定向请求，将RESTful的请求转化为传统的。

具体可参考这个实践：https://ctolib.com/luyuanxun-phalapi-restful.html

上线部署

PHP项目的部署非常简单，上传代码就完事了！将整个phalapi目录上传到服务器上，然后确保你在远端服务器上也进行了全文开头的操作：

• Apache默认文档路径指向./public
• 配置好了Rewrite规则

此刻，你的接口就部署完成了。当然，你应该考虑一下：

• 真实上线，文档不能让别人随意看到！请备份后删除./publichttps://p.download-x.com/docs.php
• 删除无用的./sdk和./tests目录

【全文终，谢谢您的阅读！】

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。