萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 打造 iOS 推播服務端:從憑證準備到發送封包組裝

前置準備清單

  1. Device Token:App 向 APNs 註冊取得,64 字元 hex 字串 (無空格)。
  2. APNs 憑證:Apple Developer 建立「Apple Push Notification service SSL (Sandbox/Production)」,匯出 .p12 轉 .pem:
    openssl pkcs12 -in cert.p12 -out ck.pem -nodes -clcerts
  3. Passphrase:匯出 .p12 時設定的密碼。
  4. 端點:Sandbox ssl://gateway.sandbox.push.apple.com:2195,Production ssl://gateway.push.apple.com:2195。

完整發送腳本 (testpush.php)

<?php
// 設定
$deviceToken = '6ad7b13fb05e6137a46a60ea421e50164b701671cc176f7033bb9ef438a8aef9'; // 無空格
$pass = 'jetson';
$message = 'A test message!';
$badge = 4;
$sound = 'Duck.wav';

// 組裝 Payload (aps 為必填)
$body = ['aps' => ['alert' => $message]];
if ($badge) $body['aps']['badge'] = $badge;
if ($sound) $body['aps']['sound'] = $sound;
$body['id'] = '4f94d38e7d9704f15c000055'; // 自訂欄位

$payload = json_encode($body);
echo "Payload length: " . strlen($payload) . "<br/>"; // 需 < 4096 bytes

// SSL 串流上下文
$ctx = stream_context_create();
stream_context_set_option($ctx, 'ssl', 'local_cert', 'ck.pem');
stream_context_set_option($ctx, 'ssl', 'passphrase', $pass);
// 測試環境可關閉驗證,正式請啟用
stream_context_set_option($ctx, 'ssl', 'verify_peer', false);
stream_context_set_option($ctx, 'ssl', 'verify_peer_name', false);

// 連線
$fp = stream_socket_client(
    'ssl://gateway.sandbox.push.apple.com:2195',
    $err, $errstr, 60,
    STREAM_CLIENT_CONNECT | STREAM_CLIENT_PERSISTENT,
    $ctx
);
if (!$fp) {
    die("連線失敗: $err $errstr");
}
echo "Connection OK<br/>";

// 組裝二進位封包 (Binary Protocol)
// Command(1=0) | Token Length(2=32) | Token(32) | Payload Length(2) | Payload
$tokenBin = pack('H*', $deviceToken);
$msg = chr(0) . pack('n', 32) . $tokenBin . pack('n', strlen($payload)) . $payload;

// 發送
$result = fwrite($fp, $msg);
fclose($fp);

if ($result) {
    echo "發送成功: $payload";
} else {
    echo '發送失敗';
}
?>

常見坑點與排查

現象原因解決
Connection refused防火牆封鎖 2195/2196 埠開放出站 TCP 2195, 2196
SSL handshake failed憑證路徑錯誤、密碼錯誤、.pem 格式不對檢查 openssl x509 -in ck.pem -text -noout 驗證
Invalid token sizeToken 長度非 64 hex chars / 含空格str_replace(' ', '', $token) 確認 64 字元
Payload too largeJSON 超過 4KB精簡 alert、移除非必要欄位

現代化建議:HTTP/2 APNs API

Apple 2021 年起推薦 HTTP/2 端點 https://api.push.apple.com/3/device/{token},使用 JWT (ES256) 驗證,支援多主題、即時回應碼、無需持久連線。PHP 可用 guzzlehttp/guzzle + lcobucci/jwt 實作,或直接採用成熟套件 php-apn/php-apn。

copyright © 萬盛學電腦網 all rights reserved