首页
/ Apple Push Notification Server 技术文档

Apple Push Notification Server 技术文档

2024-12-20 12:56:18作者:曹令琨Iris

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 订阅,传递 feedUrlfeedEnable 参数。
    • 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 和贡献 :)

登录后查看全文
热门项目推荐