wula-module rest

wulacms/rest

RESTFul模块,提供RESTful风格的WEB SERVICE功能。

此模块提供RESTFul风格的接口，客户端可以通过HTTP协议进行访问，详见接口文档。, _(*1)

模块提供的触发器

触发器的处理器匀应快速返回，不适合做耗时处理。, _(*2)

1. rest\startCall[int $time, string $format]

开始请求时触发., _(*3)

参数:, _(*4)

• $time 时间戳
• $format 请求格式

如果要终止后续执行，可以在处理器中直接终止。, _(*5)

2. rest\callApi[string $api, int $time, array $args]

开始调用api时触发., _(*6)

参数:, _(*7)

• $api 要调用的api
• $time 时间戳
• $args 调用api的参数

如果要终止后续执行，可以在处理器中抛出rest\classes\RestException。, _(*8)

3. rest\endApi[string $api, int $time, array $args]

api调用结束时触发., _(*9)

参数:, _(*10)

• $api 要调用的api
• $time 时间戳
• $args 调用api的参数

4. rest\errApi[string $api, int $time, array $result]

api调用出错时触发., _(*11)

参数:, _(*12)

• $api 要调用的api
• $time 时间戳
• $result 返回值

5. rest\callError[int $time, array $result]

调用出错时触发, _(*13)

参数:, _(*14)

• $time 时间戳
• $result 返回值

6. rest\endCall[int $time, array $result]

调用结束时触发, _(*15)

参数:, _(*16)

• $time 时间戳
• $result 返回值

以上触发器的处理器匀应快速返回，不适合做耗时处理。, _(*17)

配置

conf/rest_config.php是其配置文件:, _(*18)

<?php
return [
    'dev'=>env('rest.dev',false),
    'domain'=>env('rest.domain',''),
    'expire'=>env('rest.expire',300),
    'store'=>env('rest.store'),
    'zipalign'=>env('rest.zipalign'),
    'download'=>env('rest.download')
];

说明如下:, _(*19)

1. dev 开发模式，不验签.
2. domain限定访问域名,接口调用只能通过此域名.
3. expire会话过期时间.
4. store 软件包存储路径
5. zipalign zipalign命令路径(用于压缩apk文件)
6. download 下载主机的URL.

云端配置

通过勾子rest\classes\form\AppCfgForm::onParseFields向系统注册云控项，具体可以参考FormTable::addField()。, _(*20)