#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开源,依然在路上!** PhalApi-v1.3.2,一周年纪念版,轻量级接口框架下载地址