摘要：我看可以發(fā)現(xiàn)小米推送目錄結(jié)構(gòu)是這樣的其中是底層的網(wǎng)絡(luò)庫(kù)，主要是封裝了的和方法請(qǐng)求遠(yuǎn)程的服務(wù)器并利用提供的類來(lái)接收服務(wù)器返回的數(shù)據(jù)，代碼十分優(yōu)雅，我們可以看看。

近期因?yàn)橛行枰晕⒖戳艘幌滦∶淄扑偷?php 版本服務(wù)端框架，這個(gè)推送平臺(tái)免費(fèi)的，我們只需要告訴小米平臺(tái)我們要推什么設(shè)備，它會(huì)自己幫我們推，而且還會(huì)統(tǒng)計(jì)很多信息給我們分析，如抵達(dá)率和點(diǎn)擊率等等，當(dāng)然客戶端也要用小米平臺(tái)提供的 sdk 來(lái)注冊(cè)設(shè)備。我感覺這個(gè)代碼寫得挺優(yōu)雅的，故分享一下我的看法。你可以去官網(wǎng)下載 sdk, 詳細(xì)的文檔在 這里。
我看可以發(fā)現(xiàn)小米推送目錄結(jié)構(gòu)是這樣的：

├── xmpush
?? ├── Builder.php
?? ├── Constants.php
?? ├── DevTools.php
?? ├── ErrorCode.php
?? ├── Feedback.php
 ? ├── HttpBase.php
?? ├── IOSBuilder.php
?? ├── Message.php
?? ├── Result.php
?? ├── Sender.php
?? ├── Stats.php
?? ├── Subscription.php
?? ├── TargetedMessage.php
?? └── Tracer.php

其中 HttpBase.php 是底層的網(wǎng)絡(luò)庫(kù)，主要是封裝了 HTTP 的 POST 和 GET 方法請(qǐng)求遠(yuǎn)程的服務(wù)器并利用 Result.php 提供的類來(lái)接收服務(wù)器返回的數(shù)據(jù)，代碼十分優(yōu)雅，我們可以看看。

//發(fā)送請(qǐng)求，獲取result，帶重試
    public function postResult($url,$fields,$retries){
        $result = new Result($this->postReq($url, $fields));
        if($result->getErrorCode() == ErrorCode::Success){
            return $result;
        }
        //重試
        for($i=0;$i<$retries;$i++){
            $result = new Result($this->postReq($url, $fields));
            if($result->getErrorCode() == ErrorCode::Success){
                break;
            }
        }
        return $result;
    }
    
    //post方式發(fā)送請(qǐng)求
    public function postReq($url,$fields,$timeout=10){
        $headers = array("Authorization: key=" . $this->appSecret, 
        "Content-Type: application/x-www-form-urlencoded");
        // Open connection
        $ch = curl_init();
    
        // Set the url, number of POST vars, POST data
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt ( $ch, CURLOPT_CONNECTTIMEOUT, $timeout );
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($fields));
        print_r("HTTP Params 
 ".urldecode(http_build_query($fields)));
        echo"
";
        // Execute post
        $result = curl_exec($ch);
            
        // Close connection
        curl_close($ch);
        return $result;
    }

從名字就可以看出，上面是利用 POST 方法請(qǐng)求小米服務(wù)器，返回值用result包裝了一下，如果返回碼不為 0，那么久重試一下。在發(fā)送請(qǐng)求的時(shí)候把發(fā)送的 field 打印出來(lái)，讓開發(fā)者能看到請(qǐng)求的內(nèi)容。雖然代碼很簡(jiǎn)單，但是值得新手區(qū)學(xué)習(xí)這樣的代碼規(guī)范。有時(shí)候你自己寫框架的時(shí)候也可以借鑒這種方式。

builder.php 實(shí)現(xiàn)的實(shí)例繼承了 message 可以承載著我們的發(fā)送給服務(wù)端的消息數(shù)據(jù)，這就是我們消息體，所有數(shù)據(jù)承載的地方。

ErrorCode.php 是存放狀態(tài)碼的文件，我們?cè)诎诉@個(gè)文件后，可以通過(guò) ErrorCode::Success 來(lái)訪問(wèn)我們定義狀態(tài)碼。

Sender.php 是一個(gè)發(fā)送文件，和發(fā)送相關(guān)的函數(shù)都會(huì)在這個(gè)文件上，內(nèi)部會(huì)調(diào)用底層的網(wǎng)絡(luò)庫(kù)。

Result.php 是一個(gè)存放服務(wù)器返回結(jié)果的文件。

Constants.php 是一個(gè)存放常量和靜態(tài)變量的地方。

大致上最有用的就是上面描述的文件。

因?yàn)樾∶淄扑椭С趾芏喾N推送方式，比如按 alias 推送，account 推送，全量推送，按標(biāo)簽推送（客戶端訂閱的方式）。這里僅僅介紹全量推送。
首先你需要在Constant類中配置好從小米平臺(tái)上注冊(cè)的 app 的包名和 secret

$secret = "your app secret";
$package = "your app packagename";

// 常量設(shè)置必須在new Sender()方法之前調(diào)用
Constants::setPackage($package);
Constants::setSecret($secret);

如果有多個(gè)應(yīng)用，你可以在一個(gè)新的 config 類中存放好配置信息。
然后開始構(gòu)建消息體。

$message = new Builder();
$message->title($title);
$message->description($desc);
$message->notifyType(1);
$message->passThrough($passThrough);
$message->payload($payload);
$message->extra(Builder::notifyEffect, 1);
$message->notifyId(1);
$message->timeToSend($timeToSend);
$message->build();

然后你可以設(shè)置創(chuàng)建一個(gè)發(fā)送類，并調(diào)用全量推送的接口。

$sender = new Sender();
$res = $sender->broadcastAll($message);
print_r($res->getRaw());                  // 查看返回的數(shù)據(jù)

你看，是不是很簡(jiǎn)單，輕輕松松實(shí)現(xiàn)小米推送，僅需要10分鐘左右的時(shí)間，但是一定要注意返回值得錯(cuò)誤檢查。不要讓程序崩了，也不要讓程序返回一些人類很難看懂的字符和錯(cuò)誤碼，養(yǎng)成良好的編程習(xí)慣，有助于提高開發(fā)效率。
返回的數(shù)組用 json_encode 函數(shù)轉(zhuǎn)為 json 格式

{
    "result": "ok",
    "trace_id": "Xcm56b094851588122700z",
    "code": 0,
    "data": {
        "id": "tcm56b09485158812276t8"
    },
    "description": "成功",
    "info": "Received push messages for 1 TOPIC"
}

如果有同學(xué)在使用小米推送平臺(tái)的過(guò)程遇到問(wèn)題的歡迎提出來(lái)大家一起交流！