FCM Token 验证与失效处理：构建可靠的推送通知系统

<?php

use Kreait\Firebase\Factory;
use Kreait\Firebase\Contract\Messaging;
use Kreait\Firebase\Exception\MessagingException;
use Kreait\Firebase\Exception\FirebaseException;

class FCMTokenValidator {

    private Messaging $messaging;

    /**
     * 构造函数
     */
    public function __construct() {
        $factory = (new Factory)->withServiceAccount(getenv('GOOGLE_APPLICATION_CREDENTIALS'));
        $this->messaging = $factory->createMessaging();
    }

    /**
     * 验证设备注册 ID.
     *
     * @param string|string[] $token 要验证的 Token，可以是单个字符串或字符串数组
     * @return array|bool|Exception|MessagingException|FirebaseException 验证结果
     */
    public function validateFCMToken( string|array $token=[] ): bool|Exception|MessagingException|array|FirebaseException {
        if ($token == null || is_array($token) && (sizeof($token) === 0 || sizeof($token) > 500)) {
            return false; // Token 为空或数量超出限制
        } elseif (is_string($token)) {
            $token = [ $token ]; // 将单个 Token 转换为数组
        }

        try {
            return $this->messaging->validateRegistrationTokens($token);
        } catch ( MessagingException | FirebaseException $e ) {
            return $e; // 捕获并返回异常
        }
    }
}

// 使用示例：
$validator = new FCMTokenValidator();
$tokens = [
    'valid_token_1',
    'invalid_token_1',
    'valid_token_2',
    'invalid_token_2',
    // ... up to 500 tokens
];

$validationResult = $validator->validateFCMToken($tokens);

if (is_array($validationResult)) {
    // 处理验证结果
    if (isset($validationResult['invalid'])) {
        $invalidTokens = $validationResult['invalid'];
        // 从数据库中删除这些无效 Token
        foreach ($invalidTokens as $invalidToken) {
            // 数据库删除逻辑
            echo "Invalid token: " . $invalidToken . PHP_EOL;
        }
    }

    if (isset($validationResult['valid'])) {
        $validTokens = $validationResult['valid'];
        // 可以选择更新这些有效 Token 的最后活跃时间
        foreach ($validTokens as $validToken) {
            // 数据库更新逻辑
            echo "Valid token: " . $validToken . PHP_EOL;
        }
    }

    if (isset($validationResult['unknown'])) {
        $unknownTokens = $validationResult['unknown'];
        // 对于未知状态的 Token，可以进行重试或进一步调查
        foreach ($unknownTokens as $unknownToken) {
            echo "Unknown token: " . $unknownToken . PHP_EOL;
        }
    }

} else {
    // 处理异常
    echo "Error: " . $validationResult->getMessage() . PHP_EOL;
}

?>