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.接口数据

（推荐学习：PHP视频教程）

3.客户端APP通信： 

APP是如何进行通信的：

      C   （接口地址：http://app.com/api.php?format=xml/json）     S
   客户端APP            ------------------------------>             服务器
                      <-----------------------------                                    
                         返回数据

4.客户端APP通信格式区别

1.xml：扩展标记语言（1.用来标记数据，定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言，xml格式统一，跨平台和语言，非常适合数据传输和通信，早已成为业界公认的标准）

<?xml version="1.0" encoding="UTF-8"?>
    <item>
        <title>测试</title>
        <test id="1">
        <description>测试oen</description>
        <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:

    <?php 
                     $dom = new DomDocument('1.0','utf-8');
                     $element = $dom->createElement('test','This id root element');
                     $dom->appendChild($element);
                     echo $dom->saveXML();
              ?>

====>结果：

           <?xml version="1.0" encoding="utf-8"?>
           <test>This is the root element</test>

使用组装字符串的简单实例性：

    public static function xml()
            {
                  header("Content-Type:text/html");
                  $xml = "<?xml version='1.0' encoding='UTF-8'?>\n";
                  $xml .= "<root>\n";
                  $xml .= "<code>200</code>\n";
                  $xml .= "<message>数据返回成功</message>\n";
                  $xml .= "<data>\n";
                  $xml .="<id>1</id>\n";
                  $xml .="<name>测试</name>\n";
                  $xml .="</data>\n";
                  $xml .="<root>";
                  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 = "<?xml version='1.0' encoding='UTF-8'?>\n";
                 $xml .= "<root>\n";
                 $xml .=self::xmlToEncode($result);
                 $xml .="</root>";
                 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 .="</{$key}>\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:

<?php

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 = "<?xml version='1.0' encoding='UTF-8'?>\n";
        $xml .= "<root>\n";
        $xml .=self::xmlToEncode($result);
        $xml .="</root>";
        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 .="</{$key}>\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;
    }

Atas ialah kandungan terperinci PHP开发APP接口全过程（一）. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!