Apple Push Notification Server 技术文档

1. 安装指南

环境要求

• PHP 5.x
• mySQL
• 需要开放端口 2195 和 2196 与 APNS 服务器通信。

安装步骤

1. 创建 mySQL 数据库：

   • 创建一个新的 mySQL 数据库。

2. 导入数据库表结构：

   • 运行 resources/APNS.sql 文件以创建数据库表。

3. 配置文件：

   • 根据需要自定义 config.php 文件。

4. 设置应用：

   • 将你的 ck.pem 证书文件复制到 certificates 文件夹中。
   • 在 mySQL 的 Apps 表中添加一个应用条目。
   • 在 mySQL 的 Certificates 表中添加一个证书条目。
   • 在 CertificateServer 表中添加一个条目。

2. 项目使用说明

基本使用

1. 注册新设备：

   • 你的 iPhone 应用可以通过调用以下 URL 来注册新设备：

     http://YOURDOMAIN.COM/registerDevice.php?appId=YOURAPPId&deviceToken=YOURDEVICETOKEN
     

2. 提交消息到队列：

   • 使用以下 URL 提交消息到订阅的设备：

     http://YOURDOMAIN.COM/subscriptionForm.php
     

3. 从消息队列发送消息：

   • 使用以下 URL 从消息队列发送消息到设备：

     http://YOURDOMAIN.COM/processMessageQueue.php
     

4. 处理反馈：

   • 使用以下 URL 处理反馈信息：

     http://YOURDOMAIN.COM/processFeedback.php
     

高级使用

• RSS 订阅：

  • 通过 registerDevice.php 脚本注册 RSS 订阅，传递 feedUrl 和 feedEnable 参数。
  • processFeeds.php 应作为 cron 任务或计划任务运行。

• 多订阅管理：

  • 通过传递 appSubscriptionId 参数来注册应用内的多个订阅。

调度任务

• processMessageQueue.php 脚本应作为 cron 任务或计划任务运行。
• 运行 processMessageQueue.php 后，应运行 processFeedback.php 以获取不再安装应用的设备通知。

3. 项目 API 使用文档

设备注册 API

• URL: http://YOURDOMAIN.COM/registerDevice.php
• 参数:
  • appId: 应用 ID
  • deviceToken: 设备令牌

消息提交 API

• URL: http://YOURDOMAIN.COM/subscriptionForm.php
• 参数:
  • 通过表单提交消息内容

消息队列处理 API

• URL: http://YOURDOMAIN.COM/processMessageQueue.php
• 说明: 从消息队列发送消息到设备

反馈处理 API

• URL: http://YOURDOMAIN.COM/processFeedback.php
• 说明: 处理 APNS 反馈信息

4. 项目安装方式

手动安装

1. 下载项目代码。
2. 按照上述安装指南进行配置和设置。
3. 确保服务器环境满足要求，并开放所需端口。

自动化安装（可选）

• 可以通过编写脚本自动化执行数据库创建、表结构导入和配置文件设置。

安全注意事项

• 请将这些脚本存储在安全目录中，以防止未经授权的用户访问。

希望你能享受这些脚本！欢迎 fork 和贡献 :)