README

一个完整的开源PHP类集，用于与iPhone、iPad和iPod Touch的Apple推送通知服务进行交互。

• PHP推送代码示例
• PHP反馈代码示例
• PHP服务器代码示例
• Objective-C设备代码示例
• 完整API文档
• 如何生成推送通知证书并下载Entrust根授权证书

新闻

• 2016年6月1日，首次实现HTTP/2协议，请下载此包（请检查您的PHP版本是否内置了支持HTTP2的CURL，并生成新的证书，您不能使用与二进制版本相同的证书：创建通用的推送通知客户端SSL证书）。
• 2015年9月29日，此README.md的一些统计信息，感谢Badge Poser。
• 2015年5月12日，ApnsPHP已迁移到github上的Immobiliare Labs组织。
• 2015年5月7日，ApnsPHP已将默认的有效负载大小增加到2048，现在默认使用TLS协议而不是旧的SSL。来自苹果的新闻：https://developer.apple.com/news/?id=10222014a
• 2012年10月26日，项目源代码已迁移到github。
• 2011年6月18日，请使用ApnsPHP Google Group来请求帮助或讨论此项目。要报告问题，请使用问题。谢谢！
• 2010年12月18日，完全支持APNs消息：消息正文、本地化操作按钮、本地化消息带有参数替换和自定义启动图像。
• 2010年12月15日，提交了第一个版本的Objective-C演示项目，支持未运行、前台运行和后台运行的应用程序状态。
• 2010年12月14日，添加了对多个自定义属性的支持。
• 2010年8月28日，添加了对新的APNs增强格式的支持，该格式解决了一些简单格式的问题：通知过期和错误响应。
• 2010年2月28日，ApnsPHP源代码现在可用。

Packagist

https://packagist.org.cn/packages/duccio/apns-php

感谢@jbender！

架构

• 自动加载系统，仅显式包含Autoload.php，所有类都在需要时加载。
• 消息类，用于构建通知有效负载。
• 推送类，用于向Apple推送通知服务推送一个或多个消息。
• 反馈类，用于查询Apple反馈服务以获取损坏的设备令牌列表。
• 推送服务器类，用于创建一个具有一个或多个（派生）进程从公共消息队列读取的推送服务器。
• 日志类/接口，用于记录到标准输出或用于自定义日志记录。
• Objective-C演示项目，支持未运行、前台运行和后台运行的应用程序状态。

类层次结构

详细信息

在Apple推送通知二进制协议中，没有关于推送至服务器的通知正确性的实时反馈。因此，每次写入服务器后，Push类都会等待“读取流”改变状态（或至少N微秒）；如果发生这种情况，并且客户端套接字从服务器接收到“文件结束”信号，则推送至服务器的通知已损坏，Apple服务器已关闭连接，客户端需要重新连接以发送消息队列中仍存在的其他通知。

为了加快发送活动，可以使用Push Server类创建一个具有多个进程的推送通知服务器，这些进程读取一个公共消息队列并并行发送推送通知。

所有客户端-服务器活动都基于“出错时重试”的模式，具有可定制的超时、重试次数和重试间隔。

要求

PHP 5.3.0或更高版本，支持OpenSSL、PCNTL、System V共享内存和信号量。

./configure --with-openssl[=PATH] --enable-pcntl --enable-sysvshm --enable-sysvsem

如果您计划只使用推送和反馈提供程序而不使用服务器部分，则只需OpenSSL（无需PCNTL、System V共享内存或信号量）。

./configure --with-openssl[=PATH]

通常，OpenSSL是内置在标准的PHP Linux发行版软件包中的。随Mac OS X Snow Leopard一起提供的标准PHP 5.3.0即可正常工作。

请...

...如果您在App Store上使用ApnsPHP发布应用程序，请发条消息！谢谢 :-)