极光推送Jpush(v3)服务端PHP版本的api脚本类

  •   
  • 23127
  • PHP
  • 19
  • super_dodo
  • 2014/08/19

关于极光推送的上一篇文章已经说明了,此处就不多说了。使用v3版本的原因是v2使用到2014年年底就停止了。点击查看上一篇的地址 http://www.dodobook.net/php/777 欢迎移步浏览。

昨天才开始拿到极光推送的SDK下载文档。下载地址 http://docs.jpush.cn/display/dev/Server-SDKs 看了半天也看出眉目。安装example的方法试了,各种报错。还需要vendor/autoload.php composer的支持。

后来查找各种方法能实现了。但是感觉好庞大的一个包。且想封装成为一个类,几次尝试都失败。想想v2版本一个文件实现多好啊。

自己太笨了,网上找找到相关的文档。自己稍加改动,终于实现,一个类就在后端调用了。直接上代码:

//极光推送的类
//文档见: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;
	}
}

真理惟一可靠的标准就是永远自相符合。 —— 欧文