php介面規范

1. php---APP介面02

JSON&XML

XML: 是一種標記語言，設計的宗旨是傳輸數據

JSON： 輕量級的數據交換格式

APP介面主要是用JSON輸出格式

APP介面輸出格式三要素：

1. code:：錯誤碼

2. msg：錯誤碼對應的描述

3. data：介面返回的數據

誰有許可權調用APP介面，客戶端需要帶著憑證來調用APP介面

JWT的原理：

服務端認證之後，生成一個JSON對象，返回給用戶。後續客戶端所有請求都會帶上這個JSON對象。服務端依靠這個JSON對象來認定用戶身份。

組成: Header, Payload, Signature

1. Header

說一下我是什麼

header通常包含了兩部分：類型和加密演算法

{

    "alg": "HS256",

    "typ": "JWT"

}

header需要經過Base64Url編碼後作為IWT的第一部分。

2. Payload

payload包含了claim, 三種類型reserved, public, private

reserved這些claim是JWT預先定義的，不強制使用，常用的有：

1). iss: 簽發者

2). exp: 過期的時間戳

3). sub: 面向的用戶

4). aud: 接收方

5). iat: 簽發時間

{

    "sub":  "1234567890",

    "name":  "John Doe",

    "admin": true

}

payload需要經過Base64Url編碼後作為JWT的第二部分。

3. Signature

創建簽名使用編碼後的header和payload以及一個密匙，使用header中指定的簽名演算法進行簽名

HMACSHA256(

base64UrlEncode(header) + "." +

base64UrlEncode(payload),

secret

)

簽名是在服務端進行的，客戶端並不知道，所以是安全的。

2. 怎麼在PHP中定義和使用介面interface

1、介面的定義：
介面：一種成員屬性為抽象的特殊抽象類，在程序中同為規范的作用
2、其實他們的作用很簡單，當有很多人一起開發一個項目時，可能都會去調用別人寫的一些類，那你就會問，我怎麼知道他的某個功能的實現方法是怎麼命名的呢，這 個時候PHP介面類interface就起到作用了，當我們定義了一個介面類時，它裡面的方式是下面的子類必須實現的，比如 :
interface Shop
{
public function buy($gid);
public function sell($gid);
public function view($gid);
}
我聲明一個shop介面類，定義了三個方法：買(buy),賣(sell),看(view),那麼繼承此類的所有子類都必須實現這3個方法少一個都 不行，如果子類沒有實現這些話，就無法運行。實際上介面類說白了，就是一個類的模板，一個類的規定，如果你屬於這類，你就必須遵循我的規定，少一個都不 行，但是具體你怎麼去做，我不管，那是你的事，如：
class BaseShop implements Shop { public function buy($gid) { echo('你購買了ID為 :'.$gid.'的商品'); } public function sell($gid) { echo('你賣了ID為 :'.$gid.'的商品'); } public function view($gid) { echo('你查看了ID為 :'.$gid.'的商品'); } }
結論 ： PHP介面類interface就是一個類的領導者，指明方向，子類必須完成它指定方法。這樣不同的開發者就不要去了解別人怎麼命名相應的方法。
3、php中使用介面(interface)實現多重繼承:
我們都知道PHP中的類(class)是單繼承的，那是不是就沒有辦法實現多重繼承了呢?答案是否定的.我們可以通過其它特殊的方式實現類的多重 繼承，比如使用介面(interface)實現，只要把類的特徵抽象為介面，並通過實現介面的方式讓對象有多重身份，通過這樣就可以模擬多重繼承了。
下面是一個用介面(interface)實現多重繼承的例子，源代碼如下：
<?php
interface UserInterface{ //定義User的介面
function getname();
}
interface TeacherInterface{ //teacher相關介面
function getLengthOfService();
}
class User implements UserInterface { //實現UserInterface介面
private $name = "tom";
public function getName(){
return $this->name;
}
}
class Teacher implements TeacherInterface { //實現TeacherInterface介面
private $lengthOfService = 5; // 工齡
public function getLengthOfService(){
return $this->lengthOfService;
}
}
// 繼承自User類,同時實現了TeacherInterface介面.
class GraateStudent extends User implements TeacherInterface {
private $teacher ;
public function __construct(){
$this->teacher = new Teacher();
}
public function getLengthOfService(){
return $this->teacher->getLengthOfService();
}
}
class Act{
//注意這里的類型提示改成了介面類型
public static function getUserName(UserInterface $_user){
echo "Name is " . $_user->getName() ."<br>";
}
//這里的類型提示改成了TeacherInterface類型.
public static function getLengthOfService(TeacherInterface $_teacher){
echo "Age is " .$_teacher->getLengthOfService() ."<br>";
}
}
$graateStudent = new GraateStudent();
Act::getUserName($graateStudent);
Act::getLengthOfService($graateStudent);
//結果正如我們所要的,實現了有多重身份的一個對象.
?>
示例運行結果如下：
Name is tom
Age is 5
4、介面類和抽象類的區別
抽象類 :1.類中至少有一個抽象方法
2.前面加abstract
介面: 1.成員屬性為常量const
2.前面不用加abstract
3.類中全部為抽象方法,介面抽象方法為public
5、介面類和抽象類 共同點:
1.本身不能被實例化，必須繼承或者引用
2.繼承和引用後，抽象方法必須重載才能實例化
關鍵字 interface.引用關鍵字 implements

3. 如何利用Thinkphp框架開發移動端介面詳解

方案一：給原生APP提供api介面

使用TP框架時 放在common文件夾下文件名就叫function.php

<?php
/**
*Createdbyzhangkx
*Email:[email protected]
*Date:2015/8/1
*Time:23:15
*/

/******api開發輔助函數*******/

/**
*@paramnull$msg返回正確的提示信息
*@paramflagsuccessCURD操作成功
*@paramarray$data具體返回信息
*Functiondescript:返回帶參數，標志信息，提示信息的json數組
*
*/
functionreturnApiSuccess($msg=null,$data=array()){
$result=array(
'flag'=>'Success',
'msg'=>$msg,
'data'=>$data
);
printjson_encode($result);
}

/**
*@paramnull$msg返回具體錯誤的提示信息
*@paramflagsuccessCURD操作失敗
*Functiondescript:返回標志信息『Error'，和提示信息的json數組
*/
functionreturnApiError($msg=null){
$result=array(
'flag'=>'Error',
'msg'=>$msg,
);
printjson_encode($result);
}

/**
*@paramnull$msg返回具體錯誤的提示信息
*@paramflagsuccessCURD操作失敗
*Functiondescript:返回標志信息『Error'，和提示信息，當前系統繁忙，請稍後重試；
*/
functionreturnApiErrorExample(){
$result=array(
'flag'=>'Error',
'msg'=>'當前系統繁忙，請稍後重試！',
);
printjson_encode($result);
}

/**
*@paramnull$data
*@returnarray|mixed|null
*Functiondescript:過濾post提交的參數；
*
*/

functioncheckDataPost($data=null){
if(!empty($data)){
$data=explode(',',$data);
foreach($dataas$k=>$v){
if((!isset($_POST[$k]))||(empty($_POST[$k]))){
if($_POST[$k]!==0&&$_POST[$k]!=='0'){
returnApiError($k.'值為空！');
}
}
}
unset($data);
$data=I('post.');
unset($data['_URL_'],$data['token']);
return$data;
}
}

/**
*@paramnull$data
*@returnarray|mixed|null
*Functiondescript:過濾get提交的參數；
*
*/
functioncheckDataGet($data=null){
if(!empty($data)){
$data=explode(',',$data);
foreach($dataas$k=>$v){
if((!isset($_GET[$k]))||(empty($_GET[$k]))){
if($_GET[$k]!==0&&$_GET[$k]!=='0'){
returnApiError($k.'值為空！');
}
}
}
unset($data);
$data=I('get.');
unset($data['_URL_'],$data['token']);
return$data;
}
}


查詢單個果品詳細信息
/**
*發布模塊
*
*獲取信息單個果品詳細信息
*
*/
(){
//檢查是否通過post方法得到數據
checkdataPost('id');
$where['id']=$_POST['id'];
$field[]='id,fruit_name,high_price,low_price,address,size,weight,fruit_pic,remark';
$releaseInfo=$this->release_obj->findRelease($where,$field);
$releaseInfo['remark']=mb_substr($releaseInfo['remark'],0,49,'utf-8').'...';
//多張圖地址按逗號截取字元串，截取後如果存在空數組則需要過濾掉
$releaseInfo['fruit_pic']=array_filter(explode(',',$releaseInfo['fruit_pic']));
$fruit_pic=$releaseInfo['fruit_pic'];unset($releaseInfo['fruit_pic']);
//為圖片添加存儲路徑
foreach($fruit_picas$k=>$v){
$releaseInfo['fruit_pic'][]='http://'.$_SERVER['HTTP_HOST'].'/Uploads/Release/'.$v;
}
if($releaseInfo){
returnApiSuccess('',$releaseInfo);
}else{
returnApiError('什麼也沒查到(+_+)！');
}
}


findRelease()方法的model
/**
*查詢一條數據
*/
publicfunctionfindRelease($where,$field){
if($where['status']==''||empty($where['status'])){
$where['status']=array('neq','9');
}
$result=$this->where($where)->field($field)->find();
return$result;
}


app端接收到的數據（解碼json之後）
{
"flag":"success",
"message":"",
"responseList":{
"id":"2",
"fruit_name":"蘋果",
"high_price":"8.0",
"low_price":"5.0",
"address":"天津小白樓水果市場",
"size":"2.0",
"weight":"2.0",
"remark":"急需...",
"fruit_pic":[
"http://fruit.txunda.com/Uploads/Release/201508/55599e7514815.png",
"http://fruit.txunda.com/Uploads/Release/201508/554f2dc45b526.jpg"
]
}
}


app端接收到的數據（原生json串）
代碼如下:

{"flag":"success","message":"","responseList":{"id":"2","fruit_name":"u82f9u679c","high_price":"8.0","low_price":"5.0","address":"","size":"2.0","weight":"2.0","remark":"u6025u9700...","fruit_pic":["http://fruit.txunda.com/Uploads/Release/201508/55599e7514815.png","http://fruit.txunda.com/Uploads/Release/201508/554f2dc45b526.jpg"]}}

方案二：另外我們還可以通過ThinkPHP實現移動端訪問自動切換主題模板，這樣也可以做到移動端訪問

ThinkPHP的模板主題機制，如果只是在PC，只要需修改 DEFAULT_THEME （新版模板主題默認是空，表示不啟用模板主題功能）配置項就可以方便的實現多模板主題切換。

但對於移動端與PC端，也許你會設計完全不同的主題風格，且針對不同的來路提供不同的渲染方式，其中一種比較流行的方法是「響應式設計」，但就本人經歷而言，要實現完全的「響應式設計」並不是那麼容易，且解決兼容問題也是個難題，假設是大型站點，比如：淘寶、網路、拍拍這些，響應式設計肯定是滿足不了需求的，而是需要針對手機訪問用戶提供單獨的手機網站。

ThinkPHP 完全能夠實現，而且非常的簡單。與TPM的智能模版切換引擎相同，只要對來路進行判斷處理就行了。

一、將 ismobile() 加入到｛項目/Common/common.php｝

functionismobile(){
//如果有HTTP_X_WAP_PROFILE則一定是移動設備
if(isset($_SERVER['HTTP_X_WAP_PROFILE']))
returntrue;

//此條摘自TPM智能切換模板引擎，適合TPM開發
if(isset($_SERVER['HTTP_CLIENT'])&&'PhoneClient'==$_SERVER['HTTP_CLIENT'])
returntrue;
//如果via信息含有wap則一定是移動設備,部分服務商會屏蔽該信息
if(isset($_SERVER['HTTP_VIA']))
//找不到為flase,否則為true
returnstristr($_SERVER['HTTP_VIA'],'wap')?true:false;
//判斷手機發送的客戶端標志,兼容性有待提高
if(isset($_SERVER['HTTP_USER_AGENT'])){
$clientkeywords=array(
'nokia','sony','ericsson','mot','samsung','htc','sgh','lg','sharp','sie-','philips','panasonic','alcatel','lenovo','iphone','ipod','blackberry','meizu','android','netfront','symbian','ucweb','windowsce','palm','operamini','operamobi','openwave','nexusone','cldc','midp','wap','mobile'
);
//從HTTP_USER_AGENT中查找手機瀏覽器的關鍵字
if(preg_match("/(".implode('|',$clientkeywords).")/i",strtolower($_SERVER['HTTP_USER_AGENT']))){
returntrue;
}
}
//協議法，因為有可能不準確，放到最後判斷
if(isset($_SERVER['HTTP_ACCEPT'])){
//如果只支持wml並且不支持html那一定是移動設備
//如果支持wml和html但是wml在html之前則是移動設備
if((strpos($_SERVER['HTTP_ACCEPT'],'vnd.wap.wml')!==false)&&(strpos($_SERVER['HTTP_ACCEPT'],'text/html')===false||(strpos($_SERVER['HTTP_ACCEPT'],'vnd.wap.wml')<strpos($_SERVER['HTTP_ACCEPT'],'text/html')))){
returntrue;
}
}
returnfalse;
}

二、在｛項目/Lib/｝創建一個 CommonAction.php，假設你的項目已公共控制器，則無需創建，直接加在裡面就行了。

{
Publicfunction_initialize(){
//移動設備瀏覽，則切換模板
if(ismobile()){
//設置默認默認主題為Mobile
C('DEFAULT_THEME','Mobile');
}
//............你的更多代碼.......
}
}

4. PHP 的API介面

使用PHP寫api介面是經常做的，PHP寫好介面後，前台就可以通過鏈接獲取介面提供的數據，而返回的數據一般分為兩種情況，xml和json,在這個過程中，伺服器並不知道，請求的來源是什麼，有可能是別人非法調用我們的介面，獲取數據，因此就要使用安全驗證

原理

從圖中可以看得很清楚，前台想要調用介面，需要使用幾個參數生成簽名。

時間戳：當前時間

隨機數：隨機生成的隨機數

口令：前後台開發時，一個雙方都知道的標識，相當於暗號

演算法規則：商定好的運算規則，上面三個參數可以利用演算法規則生成一個簽名。前台生成一個簽名，當需要訪問介面的時候，把時間戳，隨機數，簽名通過URL傳遞到後台。後台拿到時間戳，隨機數後，通過一樣的演算法規則計算出簽名，然後和傳遞過來的簽名進行對比，一樣的話，返回數據。

演算法規則

在前後台交互中，演算法規則是非常重要的，前後台都要通過演算法規則計算出簽名，至於規則怎麼制定，看你怎麼高興怎麼來。

我這個演算法規則是

• 時間戳，隨機數，口令按照首字母大小寫順序排序

• 然後拼接成字元串

• 進行sha1加密

• 再進行MD5加密

• 轉換成大寫。

5. php 寫介面一般遵循什麼規范,或者標准。

interface面向對象編程的一個重要思想介面是一個類的抽象 在介面中只定義方法卻不是先方法interface Ibook {function ready();function weite();} 累如果要實現介面就必須 寫出介面中所有的方法class myBook implements Ibook{function ready(){echo "ready()";}function write(){echo "write()";}}介面在代碼中起規范代碼作用但是php中對介面的支持沒有java C#等完全面向對象語言的強大