Composer在线学习地址：学习地址
正当我为这些繁琐的推送逻辑焦头烂额时，我通过Composer发现了ctwillie/expo-server-sdk-php这个宝藏库。它为PHP开发者提供了一套优雅的解决方案，极大地简化了与Expo服务器的交互。
使用 Composer 引入解决方案
首先，要使用这个库，我们当然是通过PHP的包管理器Composer来安装。打开你的终端，进入项目根目录，然后执行以下命令：
立即学习“PHP免费学习笔记（深入）”；
composer require ctwillie/expo-server-sdk-php
仅仅这一行命令，ctwillie/expo-server-sdk-php就轻松地被引入到你的项目中，为你后续的推送通知功能打下了坚实的基础。
告别繁琐，拥抱简洁的推送流程
ctwillie/expo-server-sdk-php库的核心优势在于它将Expo推送的复杂性抽象化，提供了简洁易用的API。
1. 轻松构建推送消息
告别手动拼接JSON的时代！这个库提供了一个ExpoMessage类，让你以面向对象的方式构建推送消息：
use ExpoSDK\ExpoMessage;
$message = (new ExpoMessage())
->setTitle('新消息通知') // 设置消息标题
->setBody('您有一条新的未读消息，请点击查看。') // 设置消息内容
->setData(['type' => 'chat', 'id' => 123]) // 携带自定义数据
->setChannelId('default') // 指定通知渠道ID
->setBadge(1) // 设置应用图标上的未读数
->playSound(); // 播放通知声音通过链式调用，你可以清晰地定义消息的各个属性，可读性极强。
2. 一键发送推送通知
构建好消息后，发送就变得异常简单了。无论是发送给单个设备还是多个设备，Expo类都能轻松搞定：
use ExpoSDK\Expo;
use ExpoSDK\ExpoMessage;
$recipients = [
'ExponentPushToken[xxxx-xxxx-xxxx]', // 设备的Expo Push Token
'ExponentPushToken[yyyy-yyyy-yyyy]'
];
// 可以发送单个消息给多个默认接收者
(new Expo())->send($message)->to($recipients)->push();
// 也可以一次性发送多个消息，每个消息可以有自己的接收者
$messagesToSend = [
(new ExpoMessage(['title' => 'Hello', 'to' => 'ExponentPushToken[aaaa-aaaa-aaaa]'])),
(new ExpoMessage(['title' => 'World', 'body' => 'From PHP!'])) // 如果没有'to'，会使用默认接收者
];
(new Expo())->send($messagesToSend)->to($recipients)->push();是不是非常直观？你无需关心底层的HTTP客户端、请求头、请求体，库已经帮你处理好了一切。
3. 强大的频道订阅功能
对于需要向特定用户群体发送通知的场景（例如新闻订阅、活动通知），ctwillie/expo-server-sdk-php的频道订阅功能简直是神来之笔。它允许你将设备Token订阅到特定的频道，然后直接向频道发送消息。更棒的是，它可以在本地文件（或其他驱动）中持久化这些订阅关系，你无需自己管理数据库表：
use ExpoSDK\Expo;
// 使用文件驱动来持久化订阅信息
$expo = Expo::driver('file');
$channelName = 'newsletter-subscribers';
$newSubscribers = [
'ExponentPushToken[zzzz-zzzz-zzzz]',
'ExponentPushToken[wwww-wwww-wwww]'
];
// 订阅设备到频道
$expo->subscribe($channelName, $newSubscribers);
// 向频道发送消息
$channelMessage = (new ExpoMessage())->setTitle('最新简报')->setBody('本周重要新闻已发布！');
$expo->send($channelMessage)->toChannel($channelName)->push();
// 随时可以取消订阅
$expo->unsubscribe($channelName, ['ExponentPushToken[zzzz-zzzz-zzzz]']);这极大地简化了群发通知的逻辑，让你的代码更加清晰。
4. 智能处理未注册设备
设备Token失效是一个常见问题，如果不对其进行清理，不仅会浪费带宽，还可能影响推送服务的效率。ctwillie/expo-server-sdk-php提供了一个回调机制，让你可以在发送后轻松处理这些“僵尸”Token：
use ExpoSDK\Expo;
Expo::addDevicesNotRegisteredHandler(function ($unregisteredTokens) {
// 收到一个包含所有未注册Token的数组
foreach ($unregisteredTokens as $token) {
// 在你的数据库中删除这些Token，避免再次发送
echo "Token {$token} 已失效，请从数据库中移除。\n";
}
});
// 之后所有的Expo实例发送消息时，都会触发这个回调
(new Expo())->send($message)->to($recipients)->push();这个功能简直是开发者福音，帮助你维护一个健康的设备Token列表。
5. 获取推送回执
发送通知后，你可能需要知道消息是否真正送达。库也提供了获取推送回执（receipts）的功能：
$response = (new Expo())->send($message)->to($recipients)->push(); $ticketIds = $response->getData(); // 第一次发送会返回ticket IDs // 稍后根据ticket IDs查询回执 $receiptsResponse = (new Expo())->getReceipts($ticketIds); $receiptsData = $receiptsResponse->getData(); // 解析 receiptsData 来了解每个消息的最终状态
这对于需要精确跟踪消息投递状态的业务场景至关重要。
总结与实际应用效果
使用ctwillie/expo-server-sdk-php后，我感受到了以下显著优势：
- 开发效率大幅提升： 告别了手动构建HTTP请求和JSON的繁琐，我可以将更多精力投入到核心业务逻辑的开发上。
- 代码简洁易读： 优雅的API设计让推送逻辑一目了然，降低了维护成本。
- 错误处理更健壮： 内置的未注册设备处理机制，帮助我自动清理失效Token，保证了推送服务的质量。
- 功能强大全面： 从单条消息到批量发送，从自定义数据到频道订阅，几乎涵盖了所有Expo推送的常见需求。
如果你也正在使用Expo开发App，并且需要从PHP后台发送推送通知，那么ctwillie/expo-server-sdk-php绝对是你不可错过的利器。它将复杂的推送集成任务变得简单、高效、可靠，让你的项目开发体验更上一层楼。强烈推荐你立即通过Composer安装并体验它带来的便利！
