发布于 2016-01-10 00:27:24 | 185 次阅读 | 评论: 0 | 来源: 网友投递
PhalApi 轻量级PHP后台接口开发框架
PhalApi是一个PHP轻量级后台接口开发框架。我们致力于将PhalApi维护成像恒星一样不断更新，保持生气；为接口负责，为开源负责！让后台接口开发更简单！
#PhalApi-v1.3.2 (一周年纪念版)发布，PHP轻量级开源接口框架#
##[前言]##
时隔一年PhalApi已经一岁了,从无到有在到活跃人数350+的社区,到28+落地项目,实用拓展17+,一切都离不开各位小伙伴的一同的努力以及对开源精神的热情,那么小编今天为大家带来PhalApi最新一期的更新v1.3.2的具体内容:
##[升级注意]##
**基于老版本开发的应用升级到v1.3.2版本,为了更好的体验,本次升级请注意如下几点**
只需直接**覆盖核心文件PhalApi**即可使用新版功能(涉及到有个人修改部分需要自行调整)
此次更新涉及到关键文件修改在次做特别说明:
1. 初始化文件**init.php**简化，并默认装载扩展类库**Library**目录
//默认装载扩展类库Library目录(可在index.php中去除对Library的加载)
$loader = new PhalApi_Loader(API_ROOT, 'Library');
2. listAllApis.php在线接口列表，追加对“更多说明”的使用支持，即使用注释@desc
此项更新需要覆盖**listAllApis.php**文件
3. 修正install可视化安装中对listAllApis.php 和 checkApiParams.php 文件中的项目名称
此项更新需要获取install文件内容
##[重要更新]##
1. 修改notorm使用sql语句使用:和?替换执行sql时,对于int,bool,null进行单独处理
修复之前应为使用如下代码会提示sql语句limit中的值被sql中被添加单引号问题,并且支持bool以及null的处理
$sql = 'select * from example LIMIT :start,:num';
$params = array(':start' => $start, ':num' => $num);
$rs= DI()->notorm->example->queryAll($sql, $params);
特别注意:请保证使用的$start,$num是int类型可以使用如下方式保证
$sql = 'select * from example LIMIT :start,:num';
$params = array(':start' => (int)$start, ':num' => (int)$num);
$rs= DI()->notorm->example->queryAll($sql, $params);
2. 优化了PhalApi_Request_Formatter_File,支持了对文件上传类型验证增加了ext后缀名验证
在需要对上传的文件进行过滤、接收和处理时，可以使用文件类型，如：
array(
'name' => 'upfile',
'type' => 'file',
'min' => 0,
'max' => 1024 * 1024,
'range' => array('image/jpeg', 'image/png') ,
'ext' => array('txt','xml')
)
其中,ext是对文件后缀名进行验证,当如果上传文件后缀名不匹配时将抛出异常。文件扩展名的过滤可以类似这样进行配置：
//单个后缀名 - 数组形式
'ext' => array('jpg')
//单个后缀名 - 字符串形式
'ext' => 'jpg'
//多个后缀名 - 数组形式
'ext' => array('jpg', 'jpeg', 'png', 'bmp')
//多个后缀名 - 字符串形式（以英文逗号分割）
'ext' => 'jpg,jpeg,png,bmp'
##[不兼容的升级]##
1. 默认采用以数组的形式返回结果集,老版本兼容升级请见[http://qa.phalapi.net/?/article/26](http://qa.phalapi.net/?/article/26)
此项变动会对老版本产生影响,但是为了更好的用户体验我们依然选择做出改变,对不兼容造成的影响希望各位童鞋能够多多体谅.
##[亮点更新]##
1、提供CHM格式的wiki文档
2、添加Object-C的SDK包XSHttpTool，感谢 **@garden！** 提供
3、添加PhalApi基础教程到官方wiki，感谢 **@喵了个咪** 提供
4、修复一些轻量bugfixed 感谢**@scott** 反馈
5、新增图片上传拓展UCloud 感谢 **@Summer** 提供
6、新增第三方支付拓展Pay 感谢 **@Summer** 提供
7、新增图片压缩水印拓展Image 感谢 **@喵了个咪** 提供
##[其他更新]##
1、官方wiki修复bugfixed 感谢**@小艾** 反馈
##[致谢]##
**相关链接：**
[PhalApi在线文档](http://www.phalapi.net/wikis/ "PhalApi在线文档")：http://www.phalapi.net/wikis/
[PhalApi免费下载](http://git.oschina.net/dogstar/PhalApi "PhalApi免费下载")：http://git.oschina.net/dogstar/PhalApi
在本次版本更新中，需要特别感谢以下同学的努力与贡献（顺序不分先后）：
**@scott、@喵了个咪、@小艾、@Summer、@dogstar**
再次感谢，开源的路上，**@开源中国**和大家一直以来对PhalApi的关注和肯定，谢谢！
**PhalApi开源，依然在路上！**