PHP开发APP接口全过程（一）
1、学习要点：
服务器端 –> 数据库|缓存 –>调用接口 –>客户端
2、APP接口介绍：（PHP开发APP接口）
PHP面向对象的接口：抽象类，interface定义 ==>interface.php
===>1.很规范
APP接口（通信接口）：通过接口得到数据，将数据填充到APP中
—>APP开发人员关注：请求APP地址（接口地址）+返回数据
APP（通信）接口定义：
1.接口地址：http://app.com/api.php?format=xml
2.接口文件：app.php处理一些业务逻辑
3.接口数据
3.客户端APP通信：
APP是如何进行通信的：
C （接口地址：http://app.com/api.php?format=xml/json） S
客户端APP ------------------------------> 服务器
<-----------------------------
返回数据
4.客户端APP通信格式区别
1.xml：扩展标记语言（1.用来标记数据，定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言，xml格式统一，跨平台和语言，非常适合数据传输和通信，早已成为业界公认的标准）
<item>
<title>测试title>
<test id="1">
<description>测试oendescription>
<address>深圳address>
item>
2.json:一种清凉级别的数据交换格式，具有良好的可读和便于快速编写的特性，可在不同平台证件进行数据交换，JSON采用兼容性很高的，完全独立于语言文本格式。这种特性使JSON成为理想的数据交换语言。
XML的可读性要好，JSON的生成数据性 （json_encode(数组)） 传输速度方面要好
5.APP接口做的那些事:
获取数据：从数据库中或缓存中获取数据，然后通过接口数据返回客户端
提交数据：通过接口提交数据给服务器，然后通过服务器入库处理，或者其他处理
6.JSON方式封装通信接口
PHP生成json数据：json_encode($arr);
注释：该函数只能接受UTF-8编码的数据，如果传递其他格式的数据该函数会返回null
通信数据标注格式：
code 状态码（200 400等）
message 提示信息（邮箱格式不正确；数据返回成功等）
data 返回相应的数据
—————————-
-JSON
code : 200
message ：”数据返回成功”
-data
id ：1
name : “测试”
实例：
某个server中：
public function json($code,$message = '',$data = array())
{
if (!is_numeric($code)){
return '错误';
}
$result = array(
'code' => $code,
'message' => $message,
'data' => $data
);
echo json_encode($result);
exit;
}
某个Controller:
public function jsonsAction()
{
$arr = array(
'id' => 1,
'name' => 'jiang'
);
$k = wei()->zhwCategory()->json(200,'成功咯',$arr);
return $k;
}浏览器：http://127.0.0.1/admin/zhw-categorys/jsons
{"code":200,"message":"\u6210\u529f\u54af","data":{"id":1,"name":"jiang"}}
7.PHP生成XML数据：
7.1PHP生成XML数据
1.组装字符串
2.使用系统类：DomDocument
XMLWriter
SimpleXML
如用DomDocument:
$dom = new DomDocument('1.0','utf-8');
$element = $dom->createElement('test','This id root element');
$dom->appendChild($element);
echo $dom->saveXML();
?> ====>结果：
<test>This is the root elementtest>使用组装字符串的简单实例性：
public static function xml()
{
header("Content-Type:text/html");
$xml = "\n";
$xml .= "\n" ;
$xml .= "200\n";
$xml .= "数据返回成功 \n";
$xml .= "\n";
$xml .="1 \n";
$xml .="测试 \n";
$xml .="\n";
$xml .="" ;
echo $xml;
} 7.2封装XML数据方法：
封装方法：xmlEncode($code,$message='',$data = array());
data数据分析：
1.array('index' => 'api');
2.array(1,7.89);
具体：
server模块下：
public function xmlEncode($code,$message = '',$data=array())
{
if(!is_numeric($code)){
return "错误";
}
$result = array(
'code' => $code,
'message' => $message,
'data' => $data,
);
header("Content-Type:text/xml");
$xml = "\n";
$xml .= "\n" ;
$xml .=self::xmlToEncode($result);
$xml .="";
echo $xml;
} //对数据再处理
public function xmlToEncode($data){
$xml = $attr ="";
foreach ($data as $key=>$value){
if(is_numeric($key)){
$attr = "id='{$key}'";
$key = "item";
}
$xml .= "<{$key} {$attr}>"; //它们{$key} {$attr}之间要有一个小空格
$xml .=is_array($value) ? self::xmlToEncode($value):$value;
$xml .="\n";
}
return $xml;
}某个Controller:
public function xmlsAction()
{
$arr = array(
'id' => 1,
'name' => 'jiang',
'type' =>array(4,5,6),
'test' =>array(1,45,67=>array(1,2,3)),
);
$k = wei()->zhwCategory()->xmlEncode(200,'成功咯',$arr);
return $k;
}8.综合方式封装通信数据方法：
封装方法：show($code,$message,$data=array(),$type='json/xml')
最终页面：
server:
namespace Miaoxing\Zhw\Service;
use miaoxing\plugin\BaseModel;
class ZhwCategory extends BaseModel
{
const JSON = "json";
/**
* 按x综合方式输出通信数据
* @param integer $code 状态码
* @param string $message 提示信息
* @param array $data 数据
* @param string $type 数据类型
* return string
*/
public function show($code,$message='',$data=array(),$type = self::JSON)
{
if (!is_numeric($code)){
return "错误编码";
}
$result = array(
'code' => $code,
'message' => $message,
'data' => $data,
);
if($type == 'json'){
self::json($code,$message,$data);
exit;
}elseif($type == 'array'){
var_dump($result);
}elseif ($type == 'xml'){
self::xmlEncode($code,$message,$data);
exit;
}else{
//TODO
}
}
/**
* 按json方式输出通信数据
* @param integer $code 状态码
* @param string $message 提示信息
* @param array $data 数据
* return string
*/
public function json($code,$message = '',$data = array())
{
if (!is_numeric($code)){
return '错误';
}
$result = array(
'code' => $code,
'message' => $message,
'data' => $data
);
echo json_encode($result);
exit;
}
/**
* 按xml方式输出通信数据
* @param integer $code 状态码
* @param string $message 提示信息
* @param array $data 数据
* return string
*/
public function xmlEncode($code,$message = '',$data=array())
{
if(!is_numeric($code)){
return "错误";
}
$result = array(
'code' => $code,
'message' => $message,
'data' => $data,
);
header("Content-Type:text/xml");
$xml = "\n";
$xml .= "\n" ;
$xml .=self::xmlToEncode($result);
$xml .="";
echo $xml;
}
//对数据再处理
public function xmlToEncode($data){
$xml = $attr ="";
foreach ($data as $key=>$value){
if(is_numeric($key)){
$attr = "id='{$key}'";
$key = "item";
}
$xml .= "<{$key} {$attr}>";
$xml .=is_array($value) ? self::xmlToEncode($value):$value;
$xml .="\n";
}
return $xml;
}
}
Controller:
public function jsonsAction()
{
$arr = array(
'id' => 1,
'name' => 'jiang'
);
$k = wei()->zhwCategory()->json(200,'成功咯',$arr);
return $k;
}
public function xmlsAction()
{
$arr = array(
'id' => 1,
'name' => 'jiang',
'type' =>array(4,5,6),
'test' =>array(1,45,67=>array(1,2,3)),
);
$k = wei()->zhwCategory()->xmlEncode(200,'成功咯',$arr);
return $k;
}
public function showAction()
{
$arr = array(
'id' => 1,
'name' => 'jiang',
'type' =>array(4,5,6),
'test' =>array(1,45,67=>array(1,2,3)),
);
$k = wei()->zhwCategory()->show(200,'成功咯',$arr,'json');
return $k;
}