首页 > 代码库 > PHP苹果推送实现(APNS)
PHP苹果推送实现(APNS)
以下资料网上收集整理得来
1、在ios dev center制作相关证书和文件用客户端实现(不再赘述,网上很多,)
网上教程:
http://blog.csdn.net/lizhenning87/article/details/8259270
官方文档:
https://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/ProvisioningDevelopment/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194-CH104-SW1
2、制作好后下载下来,双击导入。然后在钥匙串访问处找到刚导入的证书,展开可看到钥匙,选中证书,导出.p12文件,由于PHP不好处理这种格式,所以要转换成.pem文件,方法如下,在终端执行:
openssl pkcs12 -in CertificateName.p12 -out CertificateName.pem -nodes(将文伯拖入终端可以免去自己写路径),分别制作一个production,development证书
4、服务端,创建测试文件apns.php,并将CertificateName.pem放到同一目录,
正式地址:gateway.push.apple.com, port 2195(使用正式证书)
测试地址:gateway.sandbox.push.apple.com, port 2195(使用测试证书)
//接收到设备发来的token,这里我手动填上。$deviceToken = "015c5a2377ac146830f8ed09059b82bb91ed7190ebf74b633809bc2245da95ee";//构造消息体$body = array("aps" => array("alert" => ‘测试测试测试‘, "badge" => 1, "sound" => ‘received5.caf‘));$ctx = stream_context_create();stream_context_set_option($ctx, "ssl", "local_cert", "CertificateName.pem");//建立socket连接$fp = stream_socket_client("ssl://gateway.sandbox.push.apple.com:2195", $err, $errstr, 60, STREAM_CLIENT_CONNECT, $ctx);if (!$fp) { print "Failed to connect $err $errstrn"; return; }print "Connection OK";$payload = json_encode($body);$msg = chr(0) . pack("n",32) . pack("H*", $deviceToken) . pack("n",strlen($payload)) . $payload;print "sending message :" . $payload . "\n";fwrite($fp, $msg);fclose($fp);
5、服务器返馈
当用户将我们的应用删除时,我们应该停止对这台机器推送,这个SSL地址是:
正式机:feedback.push.apple.com, port 2196
测试机:feedback.sandbox.push.apple.com, port 2196
具本见
https://developer.apple.com/library/mac/#documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingWIthAPS/CommunicatingWIthAPS.html
php如下:
$certFile = ‘apns-dev.pem‘;while(true){$ctx = stream_context_create();stream_context_set_option($ctx, ‘ssl‘, ‘local_cert‘, $certFile);//stream_context_set_option($ctx, ‘ssl‘, ‘passphrase‘, $this->certPass);echo "try to open stream\n";$fp = stream_socket_client(‘ssl://feedback.sandbox.push.apple.com:2196‘, $err, $errstr, 5, STREAM_CLIENT_CONNECT, $ctx);if (!$fp) {print "Failed to connect". $err . $errstr. "\n";exit();}else{echo ‘Connected to feedback sandbox...‘;while(($in = fread($fp, 1024)) != EOF){echo ‘read ‘. $in . "\n";}socket_close($fp);fclose($fp);}sleep(2000);}
注意,要将你的APP删除后,再发一个推送,才可能返回数据
开发状态服务器地址 gateway.sandbox.push.apple.com 2195
产品状态服务器地址 gateway.push.apple.com 2195
Development和Production两个版本对应的apns device token是不同的,前者是develop的mobileprovision下获取的。后者是production的mobileprovision获取的。
Development和Production两个版本可以共用一个App ID(不推荐。共用时每次调试前都要删除设备上的app,重新打包生成。而且公用appid会经常抓狂,早上行,下午就不行了。所以不推荐),但是不能共用一个mobileprovision,所以要单独生成Distribution的证书供production版本使用。
注:Distribution的版本是无法在设备上debug调试的!
Development和Production两个版本的code sign是不同的,前者是iPhone Developer,后者是iPhone Distribution。注意不能搞错。
无论是Development Push SSLCertificate还是Production Push SSL Certificate 都有过期时间的。Development Push SSL Certificate有效期大概四个月左右,而ProductionPush SSL Certificate的有效期是一年。需要注意在过期之前生成新的证书,以免影响使用。
openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12
openssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-cert.p12
openssl rsa -in apns-dev-key.pem -out apns-dev-key-noenc.pem
cat apns-dev-cert.pem apns-dev-key-noenc.pem > apns-dev.pem
在Mac上生成 Apple推送通知SSL许可证:
1. 登录到 iPhone Developer Connection Portal 并点击 App IDs
2. 创建一个不使用通配符的 App ID 。通配符 ID 不能用于推送通知服务。例如,我们的iPhone程序ID像这样: AB123346CD.com.serverdensity.iphone
3. 点击App ID旁的“Configure”,然后按下按钮生产 推送通知许可证。根据“向导”指导的步骤生成一个签名并上传,最后下载生成的许可证。此步骤在 Apple文档中 也有谈到。
4. 通过双击.cer文件将你的 aps_developer_identity.cer 引入Keychain中。
5. 在Mac上启动 Keychain助手,然后在login keychain中选择 Certificates分类。你将看到一个可扩展选项“Apple Development Push Services”
6. 扩展此选项然后右击“Apple Development Push Services” > Export “Apple Development Push Services ID123”。保存为 apns-dev-cert.p12 文件。
7. 扩展“Apple Development Push Services” 对“Private Key”做同样操作,保存为 apns-dev-key.p12 文件。
8. 需要通过终端命令将这些文件转换为PEM格式:
openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12
9. 转换得到key的pem:
openssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-cert.p12
10. 如果你想要移除密码,要么在导出/转换时不要设定或者执行:
openssl rsa -in apns-dev-key.pem -out apns-dev-key-noenc.pem
11. 最后,你需要将键和许可文件合成为apns-dev.pem文件,此文件在连接到APNS时需要使用:
cat apns-dev-cert.pem apns-dev-key-noenc.pem > apns-dev.pem
将此文件保存为一个易记的名字,你有可能以后会用到它。上述步骤同样适合于生成产品许可证。
检验证书是否正确的方法:
$ telnet gateway.sandbox.push.apple.com 2195
Trying 17.172.232.226…
Connected to gateway.sandbox.push-apple.com.akadns.net.
Escape character is ‘^]’.
它将尝试发送一个规则的,不加密的连接到APNS服务。如果你看到上面的反馈,那说明你的MAC能够到达APNS。按下Ctrl+C 关闭连接。如果得到一个错误信息,那么你需要确保你的防火墙允许2195端口。
然后再次连接,这次用我们的SSL证书和私钥来设置一个安全的连接:
$ openssl s_client -connect gateway.sandbox.push.apple.com:2195
-cert PushChatCert.pem -key PushChatKey.pem
Enter pass phrase for PushChatKey.pem:
你会看到一个完整的输出,让你明白OpenSSL在后台做什么。如果连接是成功的,你可以键入一些字符。当你按下回车后,服务就会断开连接。如果在建立连接时有问题,OpenSSL将会给你一个错误消息,但是你不得不向上翻输出LOG,来找到它。
当然上面要测试prodution版本是否正确的话,把gateway.sandbox.push.apple.com换成gateway.push.apple.com就好。
客户端很好做,申请证书,复制代码,就行了。
服务器端,如果是php的,那必须使用.pem的证书,如果是java的,那必须使用.p12的证书。(很可能还需要双击证书进行安装!)
服务器端发出的json包是有大小限制的,最大256字节,包括自定义字典集。
aps中的alert字符串里是可以添加"\n"做换行的。
json包中除了alert,badge,sound之外,还是是可以自定值的。
额外的自定义值:
$payload[‘aps‘] = array(‘alert‘ => ‘This is the alert text‘, ‘badge‘ => 1, ‘sound‘ => ‘default‘);
$payload[‘server‘] = array(‘serverId‘ => $serverId, ‘name‘ => $name);
$output = json_encode($payload);
当用户按下“View”后,自定义server值将被传递到设备中的程序。JSON 值如下:
{
"aps" :
{ "alert" :
{
"action-loc-key" : "显示" ,
"body" : "This is the alert text"
},
"badge" : 1,
"sound" : "default" },
"server" : { "serverId" : 1, "name" : "Server name")
}
256字节的限制适用于整个payload,包括自定义字典集。
原生接口
在Server Density中,一旦产生了一条提示,将建立一个payload并插入队列中。因此有必要时我们可以同时发送多个payload。
Apple推荐使用这种方法,因为如果你在发送各payload时频繁连接和断开,APNS有可能会封锁你的IP。
如Apple 描述:
原生接口使用原生socket,具有二进制内容,采用数据流技术,不产生回馈。
高人的总结:
APPLE推送通知服务教程 PART-1
APPLE推送通知服务教程 PART-2
APPLE推送通知服务教程 PART-3
apns php版本:
https://code.google.com/p/apns-php/wiki/CertificateCreation
IOS7之前,苹果对于一个设备上的多个APP,生成相同的DeviceToken。
IOS7以及之后,苹果对于一个设备上的多个APP,生成不同的DeviceToken。
这种新改变导致APNS上创建了一张新老token的映射表,如果你一直用老的token,那没问题,但是,一旦服务器使用新的DeviceToken,映射表中的记录就会被删除,这意味着,老的DeviceToken就不能用了,必然发送失败。
待验证:IOS5和IOS6,APP永远可以获取DeviceToken,除此之外的系统,如果用户拒绝了,或者关闭了推送,那么无法获取DeviceToken,走失败回调。
原文出处:https://support.urbanairship.com/customer/portal/articles/1321513-how-ios-7-handles-push-differently
http://stackoverflow.com/questions/6652242/does-the-device-token-ever-change-once-created
生成证书需要注意事项:
苹果开发者账号分好几种角色
Agent:代理人,拥有最高权限,可以访问iTunes Connect。
Admin:管理员,拥有管理成员、维护设备列表,维护APPID以及证书列表权限。
Member:普通成员,只读权限。
备注:3013.9.11经过测试,我发现前段时间苹果网站下线期间更新了证书生成机制。以前,利用钥匙串生成一个CSR文件,可以一直用。但是,现在每当你要生成证书,做generate的时候都需要提前重新生成一个CSR文件,否则你生成的证书都是无效的,假证书,尤其是PUSH的,服务端使用这种证书根本无法和APNS建立连接,这种诡异的问题超难跟踪的!希望看到这段话的人都能避免走弯路,不用谢了!
在使用PushMeBaby中也遇到各种问题。首先,虽然工程中已经使用了.cer的公钥证书,但是本地钥匙串中必须有带私钥的证书,否则连接无法成功建立。而且需要注意的是,证书最好放在“登录”分组中,否则程序也是找不到私钥的。其次,原始的工程中在scanString的时候会死循环,需要修改为如下代码:
NSUInteger count = 0;
while(![scanner isAtEnd]) {
[scanner scanHexInt:&value];
value = http://www.mamicode.com/htonl(value);
[deviceTokenData appendBytes:&value length:sizeof(value)];
if (++count >= [self.deviceToken length]-1) {
break;
}
}