yoimhere / pushok_none_intl
Apple Push Notification Service (APNs) 的 PHP 客户端 - 使用基于令牌(JWT 与 p8 私钥)或证书的认证发送推送通知到 iOS,利用新的 APNs HTTP/2 协议
0.10.5
2020-03-28 16:12 UTC
Requires
- php: ^7.2
- ext-curl: *
- ext-json: *
- ext-openssl: *
- ext-xml: *
- lib-curl: >=7.46.0
- lib-openssl: >=1.0.2.5
- web-token/jwt-key-mgmt: ^2.0
- web-token/jwt-signature-algorithm-ecdsa: ^2.0
Requires (Dev)
- ext-xdebug: *
- php-coveralls/php-coveralls: ^2.0
- phpunit/phpunit: ^8.4
- squizlabs/php_codesniffer: ^3.4
README
Pushok 是一个简单的 PHP 库,用于向 APNs 发送推送通知。
特性
- 使用新的 Apple APNs HTTP/2 连接
- 支持基于 JWT 的认证
- 支持基于证书的认证
- 支持新的 iOS 10 特性,如折叠 ID、子标题和可变通知
- 使用并发请求到 APNs
- 已在 APNs 生产环境中测试并工作
要求
- PHP >= 7.2
- lib-curl >= 7.46.0(启用 http/2 支持)
- lib-openssl >= 1.0.2e
满足要求的 Docker 镜像可以在此找到这里。或者您可以根据这篇教程创建自己的带有 HTTP/2 支持的 Docker 镜像。
安装
通过 Composer
$ composer require yoimhere/pushok_none_intl
入门指南
<?php require __DIR__ . '/vendor/autoload.php'; use Pushok\AuthProvider; use Pushok\Client; use Pushok\Notification; use Pushok\Payload; use Pushok\Payload\Alert; $options = [ 'key_id' => 'AAAABBBBCC', // The Key ID obtained from Apple developer account 'team_id' => 'DDDDEEEEFF', // The Team ID obtained from Apple developer account 'app_bundle_id' => 'com.app.Test', // The bundle ID for app obtained from Apple developer account 'private_key_path' => __DIR__ . '/private_key.p8', // Path to private key 'private_key_secret' => null // Private key secret ]; $authProvider = AuthProvider\Token::create($options); $alert = Alert::create()->setTitle('Hello!'); $alert = $alert->setBody('First push notification'); $payload = Payload::create()->setAlert($alert); //set notification sound to default $payload->setSound('default'); //add custom value to your notification, needs to be customized $payload->setCustomValue('key', 'value'); $deviceTokens = ['<device_token_1>', '<device_token_2>', '<device_token_3>']; $notifications = []; foreach ($deviceTokens as $deviceToken) { $notifications[] = new Notification($payload,$deviceToken); } $client = new Client($authProvider, $production = false); $client->addNotifications($notifications); $responses = $client->push(); // returns an array of ApnsResponseInterface (one Response per Notification) foreach ($responses as $response) { $response->getApnsId(); $response->getStatusCode(); $response->getReasonPhrase(); $response->getErrorReason(); $response->getErrorDescription(); }
测试
$ composer test
安全性
如果您发现任何与安全相关的问题,请通过电子邮件edamov@gmail.com联系,而不是使用问题跟踪器。
致谢
许可
MIT 许可证(MIT)。有关更多信息,请参阅许可文件。