锋芒

只求做好自己,让比人说去吧

  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

PHP 接口开发注意事项

  1. 预先定义接口流程和逻辑,确认需求

    在开发前首先确定流程,复杂的接口可以绘制流程图,并确保流程与需求一致;

  2. 使用统一的变量定义

    无论是SDK还是Server均因同一变量的定义以及全局变量的设置。目的是方便维护

  3. 完善的异常处理机制

    接口是向外提供服务的,一旦出现异常影响较大,甚至影响系统的安全。因此需要一套完善的异常处理机制。如常见的网络连接超时等,对file_get_contents和fsocket之类的函数,需要使用@抑制错误输出

  4. 统一的提示信息输出格式

    统一格式的输出会很大程度上的方便使用者

  5. SDK的兼容性

    充分考虑SDK的兼容性问题,不是所有的使用者的环境都是5.3,不是所有的环境都支持curl。最坏的考虑是提示用户安装curl扩展。PHP版本的限制至少能在5.0以上,不要使用自己不熟悉的函数,尤其是对PHP版本有依赖的

  6. 友好的错误提示

    无论服务是否正常,都应该向用户数据优化的错误提示

  7. 安全机制

    对用户输入数据严格过滤,避免服务存在的安全隐患

  8. 服务高可用

    很多业务依赖服务接口,因此接口的高可用必不可少,应该建立监控接口,在服务所依赖的接口出现故障时及时发现和排除。





posted on 2014-08-26 10:07  kisay  阅读(566)  评论(0编辑  收藏  举报