前置準備
- 裝置 Token:iOS App 向 APNs 註冊取得,64 字元十六進位字串 (無空格)。
- 憑證:Apple Developer 後台建立 APNs 憑證,匯出
.p12 再轉 .pem (openssl pkcs12 -in cert.p12 -out ck.pem -nodes -clcerts)。
- 伺服器端點:
- 測試 (Sandbox):
ssl://gateway.sandbox.push.apple.com:2195
- 正式:
ssl://gateway.push.apple.com:2195
- PHP 需啟用
openssl、sockets 擴展。
完整推播腳本
<?php
// 設定
$apnsCert = 'ck.pem'; // 憑證路徑
$pass = '123456'; // 憑證密碼
$server = 'ssl://gateway.sandbox.push.apple.com:2195';
$deviceToken = 'a8fcd4aa8943b223d4ebcd54fe168a8b99b3f24c63dbc0612db25a8c0a588675'; // 64 hex chars
// 承載
$message = $_GET['message'] ?? 'Hello!';
$badge = (int)($_GET['badge'] ?? 2);
$sound = $_GET['sound'] ?? 'default';
$body = ['aps' => ['alert' => $message, 'badge' => $badge, 'sound' => $sound]];
$payload = json_encode($body);
// 建立 SSL 串流上下文
$ctx = stream_context_create();
stream_context_set_option($ctx, 'ssl', 'local_cert', $apnsCert);
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($server, $err, $errstr, 60, STREAM_CLIENT_CONNECT | STREAM_CLIENT_PERSISTENT, $ctx);
if (!$fp) {
die("連線失敗: $errstr ($err)");
}
echo "Connection OK<br/>";
// 組裝二進位封包 (APNs 二進位協定格式)
// Command(1) + Token Length(2) + Token(32) + Payload Length(2) + Payload
$tokenBin = pack('H*', str_replace(' ', '', $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 '發送失敗';
}
?>
關鍵細節
- Token 格式:必須移除空格、轉小寫、用
pack('H*', ...) 轉二進位。
- Payload 大小:APNs 限制 4KB (iOS 8+) / 2KB (舊版),超過會被拒絕。
- 錯誤回饋:正式環境需另建立
feedback.push.apple.com:2196 連線定期讀取失效 Token。
- HTTP/2 協定:Apple 2021 年後推薦使用 HTTP/2 API (
api.push.apple.com),支援 JWT 驗證、多主題、即時回應,建議新專案直接用 HTTP/2 程式庫 (如 php-apn)。