PHP中Restful api 错误提示返回值实现思路
发布:smiling 来源: PHP粉丝网 添加日期:2021-07-28 15:28:47 浏览: 评论:0
REST是Representational State Transfer的缩写,翻译为“表现层状态转化”。表现层其实就是资源,因此可以理解为“资源状态转化”。接下来通过本文给大家介绍Restful api 错误提示返回值实现思路,感兴趣的朋友一起学习吧
RESTful架构是一种流行的互联网软件架构,它结构清晰,符合标准,易于理解,扩展方便。
REST是Representational State Transfer的缩写,翻译为“表现层状态转化”。表现层其实就是资源,因此可以理解为“资源状态转化”。
网络应用上的任何实体都可以看作是一种资源,通过一个URI(统一资源定位符)指向它。
序言
不管是微博还是淘宝,他们都有自己的错误返回值格式规范,以及错误代码说明,这样不但手机端用起来方便,给人的感觉也清晰明了,高大上。遇到问题先找母本,大公司的规范就是我们参照的母本。为此,我仿照了淘宝的错误返回值格式,根据微博错误代码制定的标准自定了自己的错误代码,然后在Restful api 上进行测试。下面我将实现思路以及测试结果分享给大家。
实现思路
我利用抽象工厂模式去实现这样的一个错误返回值。选择这种模式是因为考虑到了这种模式可以提供一个创建一系列相关或相互依赖对象的接口,与我的需求很接近。
代码分析
1、按这个路径common\hint,我新建了个error文件夹存放我的错误提示程序文件。这文件夹中主要有这几个文件:
2、Hint.php入口文件,定义一个抽象类,里边只写一个方法。
- interface Hint {
- function Error($_errors,$code);
- }
3、Template.php 实现Hint这个接口,错误返回值的格式就在这里定义。
- class Template implements Hint{
- function Error($_errors,$code) {
- if (emptyempty($_errors)) {
- print_r(json_encode([]));
- } else {
- $errors['error']['name'] = 'Not Found';
- $errors['error']['message'] = $_errors;
- $errors['error']['error_code'] = $code;
- print_r(json_encode($errors));
- }
- }
- }
4、createMsg.php 再创建一个createMsg抽象类,将对象的创建抽象成一个接口。
- interface createMsg {
- function Msg();
- }
5、用FactoryMsg 类去实现createMsg接口,返回实例化的Template。
- class FactoryMsg implements createMsg{
- function Msg() {
- return new Template;
- }
- }
6、ErrorMsg.php 给Template里边的Error方法传参。
- class ErrorMsg {
- // 抽象工厂里的静态方法
- public static function Info($_errors) {
- $Factory = new FactoryMsg;
- $result = strstr($_errors,Yii::t('yii','Not exist')); //数据不存在 20001
- $result1 = strstr($_errors,Yii::t('yii','Null')); //参数不能为空 20002
- $result2 = strstr($_errors,Yii::t('yii','Fail')); //新增、更新、删除失败 20003
- $result3 = strstr($_errors,Yii::t('yii','Not right')); //XX不正确 20004
- $result4 = strstr($_errors,Yii::t('yii','Robc')); //XX无权限 20005
- //数据不存在 20001
- if(!emptyempty($result)){
- $M = $Factory->Msg();
- $M->Error($_errors,'20001');die;
- }
- //参数不能为空 20002
- if(!emptyempty($result1)){
- $M = $Factory->Msg();
- $M->Error($_errors,'20002');die;
- }
- //新增、更新、删除失败 20003
- if(!emptyempty($result2)){
- $M = $Factory->Msg();
- $M->Error($_errors,'20003');die;
- }
- //XX不正确 20004
- if(!emptyempty($result3)){
- $M = $Factory->Msg();
- $M->Error($_errors,'20004');die;
- }
- //XX无权限 20005
- if(!emptyempty($result4)){
- $M = $Factory->Msg();
- $M->Error($_errors,'20005');die;
- }
- //默认类型 21000
- $M = $Factory->Msg();
- $M->Error($_errors,'21000');
- }
- }
7、调用方式。
use common\hint\error\ErrorMsg;
ErrorMsg::Info(Yii::t('yii','failure'));
8、测试结果。
- {
- "error": {
- "name": "Not Found",
- "message": "操作失败",
- "error_code": "20003"
- }
- }
完成,整个实现过程我采用语言包的形式,这样有利于后期多语言的切换。
常见问题
1、采用这种字符串模糊搜索很泛,无法达到具体错误类型返回对应具体代码的要求。如有更好的建议,欢迎大家提议。
$result = strstr($_errors,Yii::t('yii','Not exist'));
2、实现过程中没有考虑到今后多语言切换的问题,然后直接用传统的方式传提示语。比如:ErrorMsg::Info("操作失败");这样是无法实现多语言切换的,建议大家用语言包的方式传参。
Tags: Restful api
- 上一篇:PHP给文字内容中的关键字进行套红处理
- 下一篇:PHP序列化/对象注入漏洞分析
相关文章
- ·PHP实现自动识别Restful API的返回内容类型(2021-05-10)
- ·PHP编写RESTful接口的方法(2021-07-10)
- ·PHP编写RESTful接口(2021-07-10)
- ·淘宝API返回的json数据无法用json_decode的问题(2013-12-05)
- ·PHP实现百度、网易、新浪短网址服务的API接口调用(2014-06-27)
- ·利用google api生成二维码名片例子(2014-06-28)
- ·淘宝IP地址库API接口(PHP)通过ip获取地址信息(2014-07-02)
- ·php实现新浪短链接调用API代码(2014-08-26)
- ·分享淘宝API辅助函数-适用CI框架(2014-08-27)
- ·php google api 接口程序(2014-09-10)
- ·php有道翻译api调用方法(2014-09-22)
- ·php利用百度api计算两地距离的代码(2015-04-15)
- ·PHP版微信红包API接口程序(2015-05-09)
- ·微信自动获取收货地址api程序(2016-08-18)
- ·微信支付api.mch.weixin.qq.com域名解析慢原因是什么问题(2018-10-31)
- ·docker提供api访问的方法介绍(2020-02-08)
推荐文章
热门文章
最新评论文章
- 写给考虑创业的年轻程序员(10)
- PHP新手上路(一)(7)
- 惹恼程序员的十件事(5)
- PHP邮件发送例子,已测试成功(5)
- 致初学者:PHP比ASP优秀的七个理由(4)
- PHP会被淘汰吗?(4)
- PHP新手上路(四)(4)
- 如何去学习PHP?(2)
- 简单入门级php分页代码(2)
- php中邮箱email 电话等格式的验证(2)