**極光推送Jpush(v3)服務端PHP版本的api腳本類

關於極光推送的上一篇文章已經說明了，此處就不多說了。使用v3版本的原因是v2使用到2014年年底就停止了。點擊查看上一篇的地址 http://www.dodobook.net/php/777 歡迎移步瀏覽。

昨天才開始拿到極光推送的SDK下載文檔。下載地址 http://docs.jpush.cn/display/dev/Server-SDKs 看了半天也看出眉目。安裝example的方法試了，各種報錯。還需要vendor/autoload.php composer的支持。

后來查找各種方法能實現了。但是感覺好龐大的一個包。且想封裝成為一個類，幾次嘗試都失敗。想想v2版本一個文件實現多好啊。

自己太笨了，網上找找到相關的文檔。自己稍加改動，終於實現，一個類就在后端調用了。直接上代碼：

<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');

//極光推送的類
//文檔見：http://docs.jpush.cn/display/dev/Push-API-v3
 
/***使用示例
    $pushObj = new Jpush();
    //組裝需要的參數
    //$receive = 'all';     //全部
    //$receive = array('tag'=>array('2401','2588','9527'));      //標簽
    $receive = array('alias'=>array('93d78b73611d886a74*****88497f501'));    //別名
    $content = '這是一個測試的推送數據....測試....Hello World...';
    $m_type = 'http';
    $m_txt = 'http://www.iqujing.com/';
    $m_time = '600';        //離線保留時間
 
    //調用推送,並處理
    $result = $pushObj->push($receive,$content,$m_type,$m_txt,$m_time);
    if($result){
        $res_arr = json_decode($result, true);
        if(isset($res_arr['error'])){                       //如果返回了error則證明失敗
            echo $res_arr['error']['message'];          //錯誤信息
            echo $res_arr['error']['code'];             //錯誤碼
            return false;       
        }else{
            //處理成功的推送......
            echo '推送成功.....';
            return true;
        }
    }else{      //接口調用失敗或無響應
        echo '接口調用失敗或無響應';
        return false;
    }
***/
 
class Jpush{
  
    private $app_key = 'd7fd***********c3642fc';            //待發送的應用程序(appKey)，只能填一個。
    private $master_secret = 'a04**********4a80377';        //主密碼
    private $url = "https://api.jpush.cn/v3/push";      //推送的地址
 
    //若實例化的時候傳入相應的值則按新的相應值進行
    public function __construct($app_key=null, $master_secret=null,$url=null) {
        if ($app_key) $this->app_key = $app_key;
        if ($master_secret) $this->master_secret = $master_secret;
        if ($url) $this->url = $url;
    }
 
    /*  $receiver 接收者的信息
        all 字符串 該產品下面的所有用戶. 對app_key下的所有用戶推送消息
        tag(20個)Array標簽組(並集): tag=>array('昆明','北京','曲靖','上海');
        tag_and(20個)Array標簽組(交集): tag_and=>array('廣州','女');
        alias(1000)Array別名(並集): alias=>array('93d78b73611d886a74*****88497f501','606d05090896228f66ae10d1*****310');
        registration_id(1000)注冊ID設備標識(並集): registration_id=>array('20effc071de0b45c1a**********2824746e1ff2001bd80308a467d800bed39e');
    */
    //$content 推送的內容。
    //$m_type 推送附加字段的類型(可不填) http,tips,chat....
    //$m_txt 推送附加字段的類型對應的內容(可不填) 可能是url,可能是一段文字。
    //$m_time 保存離線時間的秒數默認為一天(可不傳)單位為秒
    public function push($receiver='all',$content='',$m_type='',$m_txt='',$m_time='86400'){
        $base64=base64_encode("$this->app_key:$this->master_secret");
        $header=array("Authorization:Basic $base64","Content-Type:application/json");
        $data = array();
        $data['platform'] = 'all';          //目標用戶終端手機的平台類型android,ios,winphone
        $data['audience'] = $receiver;      //目標用戶
         
        $data['notification'] = array(
            //統一的模式--標准模式
            "alert"=>$content,   
            //安卓自定義
            "android"=>array(
                "alert"=>$content,
                "title"=>"",
                "builder_id"=>1,
                "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
            ),
            //ios的自定義
            "ios"=>array(
                // "alert"=>$content,
                "badge"=>"1",
                "sound"=>"default",
                // "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
            ),
        );
 
               //蘋果自定義---為了彈出值方便調測
        $data['message'] = array(
            "msg_content"=>$content,
            "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
        );
 
        //附加選項
        $data['options'] = array(
            "sendno"=>time(),
            "time_to_live"=>$m_time, //保存離線時間的秒數默認為一天
            "apns_production"=>1,        //指定 APNS 通知發送環境：0開發環境，1生產環境。
        );
        $param = json_encode($data);
        $res = $this->push_curl($param,$header);
         
        if($res){       //得到返回值--成功已否后面判斷
            return $res;
        }else{          //未得到返回值--返回失敗
            return false;
        }
    }
 
    //推送的Curl方法
    public function push_curl($param="",$header="") {
        if (empty($param)) { return false; }
        $postUrl = $this->url;
        $curlPost = $param;
        $ch = curl_init();                                      //初始化curl
        curl_setopt($ch, CURLOPT_URL,$postUrl);                 //抓取指定網頁
        curl_setopt($ch, CURLOPT_HEADER, 0);                    //設置header
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);            //要求結果為字符串且輸出到屏幕上
        curl_setopt($ch, CURLOPT_POST, 1);                      //post提交方式
        curl_setopt($ch, CURLOPT_POSTFIELDS, $curlPost);
        curl_setopt($ch, CURLOPT_HTTPHEADER,$header);           // 增加 HTTP Header（頭）里的字段 
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);        // 終止從服務端進行驗證
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
        $data = curl_exec($ch);                                 //運行curl
        curl_close($ch);
        return $data;
    }
}

http://www.dodobook.net/php/780

---

極光推送Jpush(v3)服務端PHP版本集成（V3版本只調用推送API）

 因為版本升級，極光推送的API也有了V3，功能也更豐富了，但是對於我們有的用戶來說，我們還是只需要調用推送的API就夠了。

         下載了一份PHP服務端的SDK（下載地址：http://docs.jpush.io/resources/#sdk_1），然后我看蒙了。。。我們只需要推送，研究這個，花的時間也太長了一點吧！於是就到網上收集了看看有沒有人集成一個類來調用的，這個特別感謝DoDobook的一個哥們兒額，參考他的我小改動了一下 就ok了！（他的博文http://www.dodobook.net/php/780）

       這里特意提醒各位，測試成不成功記得看管理平台上面的統計信息，因為之前把apns_production參數設置成了生產環境，調用接口成功，可是卻沒有用戶，后來改為了開發環境，就成功了。

         

以下是代碼區域：

<?php
class Jpush_send extends MY_Model {
        private $app_key = ‘314**************60191‘;        //待發送的應用程序(appKey)，只能填一個。
        private $master_secret = ‘ab16a***********835c8862‘;    //主密碼
        private $url = "https://api.jpush.cn/v3/push";      //推送的地址
    
        //若實例化的時候傳入相應的值則按新的相應值進行
        public function __construct($app_key=null, $master_secret=null,$url=null) {
            if ($app_key) $this->app_key = $app_key;
            if ($master_secret) $this->master_secret = $master_secret;
            if ($url) $this->url = $url;
        }
        //極光推送的類
        //文檔見：http://docs.jpush.cn/display/dev/Push-API-v3
        
        /**組裝需要的參數
            $receive = ‘all‘;//全部
            $receive = array(‘tag‘=>array(‘2401‘,‘2588‘,‘9527‘));//標簽
            $receive = array(‘alias‘=>array(‘93d78b73611d886a74*****88497f501‘));//別名
            $content = ‘這是一個測試的推送數據....測試....Hello World...‘;
            $m_type = ‘http‘;
            $m_txt = ‘http://www.iqujing.com/‘;
            $m_time = ‘600‘;        //離線保留時間
        **/
        //調用推送方法
        public function send_pub($receive,$content,$m_type,$m_txt,$m_time){
            $m_type = ‘http‘;//推送附加字段的類型
            $m_txt = ‘http://www.groex.cn/‘;//推送附加字段的類型對應的內容(可不填) 可能是url,可能是一段文字。
            $m_time = ‘86400‘;//離線保留時間
            
            $message="";//存儲推送狀態
            $result = $this->push($receive,$content,$m_type,$m_txt,$m_time);
            if($result){
                $res_arr = json_decode($result, true);
                if(isset($res_arr[‘error‘])){                       //如果返回了error則證明失敗
                    echo $res_arr[‘error‘][‘message‘];          //錯誤信息
                    $error_code=$res_arr[‘error‘][‘code‘];             //錯誤碼
                        switch ($error_code) {
                            case 200:
                                $message= ‘發送成功！‘;
                                break;
                            case 1000:
                                $message= ‘失敗(系統內部錯誤)‘;
                                break;
                            case 1001:
                                $message = ‘失敗(只支持 HTTP Post 方法，不支持 Get 方法)‘;
                                break;
                            case 1002:
                                $message= ‘失敗(缺少了必須的參數)‘;
                                break;
                            case 1003:
                                $message= ‘失敗(參數值不合法)‘;
                                break;
                            case 1004:
                                $message= ‘失敗(驗證失敗)‘;
                                break;
                            case 1005:
                                $message= ‘失敗(消息體太大)‘;
                                break;
                            case 1008:
                                $message= ‘失敗(appkey參數非法)‘;
                                break;
                            case 1020:
                                $message= ‘失敗(只支持 HTTPS 請求)‘;
                                break;
                            case 1030:
                                $message= ‘失敗(內部服務超時)‘;
                                break;
                            default:
                                $message= ‘失敗(返回其他狀態，目前不清楚額，請聯系開發人員！)‘;
                                break;
                        }
                }else{
                    $message="發送成功！";
                }
            }else{      //接口調用失敗或無響應
                $message=‘接口調用失敗或無響應‘;
            }
            echo  "<script>alert(‘推送信息:{$message}‘)</script>";
        }
        
    
        /*  $receiver 接收者的信息
         all 字符串 該產品下面的所有用戶. 對app_key下的所有用戶推送消息
        tag(20個)Array標簽組(並集): tag=>array(‘昆明‘,‘北京‘,‘曲靖‘,‘上海‘);
        tag_and(20個)Array標簽組(交集): tag_and=>array(‘廣州‘,‘女‘);
        alias(1000)Array別名(並集): alias=>array(‘93d78b73611d886a74*****88497f501‘,‘606d05090896228f66ae10d1*****310‘);
        registration_id(1000)注冊ID設備標識(並集): registration_id=>array(‘20effc071de0b45c1a**********2824746e1ff2001bd80308a467d800bed39e‘);
        */
        //$content 推送的內容。
        //$m_type 推送附加字段的類型(可不填) http,tips,chat....
        //$m_txt 推送附加字段的類型對應的內容(可不填) 可能是url,可能是一段文字。
        //$m_time 保存離線時間的秒數默認為一天(可不傳)單位為秒
        public function push($receiver=‘all‘,$content=‘‘,$m_type=‘‘,$m_txt=‘‘,$m_time=‘86400‘){
            $base64=base64_encode("$this->app_key:$this->master_secret");
            $header=array("Authorization:Basic $base64","Content-Type:application/json");
            $data = array();
            $data[‘platform‘] = ‘all‘;          //目標用戶終端手機的平台類型android,ios,winphone
            $data[‘audience‘] = $receiver;      //目標用戶
             
            $data[‘notification‘] = array(
                    //統一的模式--標准模式
                    "alert"=>$content,
                     //安卓自定義
                    "android"=>array(
                            "alert"=>$content,
                            "title"=>"",
                            "builder_id"=>1,
                            "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
                    ),
                    //ios的自定義
                    "ios"=>array(
                             "alert"=>$content,
                            "badge"=>"1",
                            "sound"=>"default",
                             "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
                    )
            );
    
            //蘋果自定義---為了彈出值方便調測
            $data[‘message‘] = array(
                    "msg_content"=>$content,
                    "extras"=>array("type"=>$m_type, "txt"=>$m_txt)
            );
    
            //附加選項
            $data[‘options‘] = array(
                    "sendno"=>time(),
                    "time_to_live"=>$m_time, //保存離線時間的秒數默認為一天
                    "apns_production"=>false, //布爾類型   指定 APNS 通知發送環境：0開發環境，1生產環境。或者傳遞false和true
            );
            $param = json_encode($data);
            $res = $this->push_curl($param,$header);
             
            if($res){       //得到返回值--成功已否后面判斷
                return $res;
            }else{          //未得到返回值--返回失敗
                return false;
            }
        }
    
        //推送的Curl方法
        public function push_curl($param="",$header="") {
            if (empty($param)) { return false; }
            $postUrl = $this->url;
            $curlPost = $param;
            $ch = curl_init();                                      //初始化curl
            curl_setopt($ch, CURLOPT_URL,$postUrl);                 //抓取指定網頁
            curl_setopt($ch, CURLOPT_HEADER, 0);                    //設置header
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);            //要求結果為字符串且輸出到屏幕上
            curl_setopt($ch, CURLOPT_POST, 1);                      //post提交方式
            curl_setopt($ch, CURLOPT_POSTFIELDS, $curlPost);
            curl_setopt($ch, CURLOPT_HTTPHEADER,$header);           // 增加 HTTP Header（頭）里的字段
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);        // 終止從服務端進行驗證
            curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
            $data = curl_exec($ch);                                 //運行curl
            curl_close($ch);
            return $data;
        }
    
}
?>