中國鐵路 12306 系統查詢涉及複雜的加密簽名、動態參數、驗證碼等機制。本文提供教學用途的靜態車站代碼對照表與查詢邏輯架構,實際生產環境需使用官方 API 或授權介面。
<?php
// name.php - 站名對應電報碼
return [
// 直轄市主要站
"北京北" => "VAP", "北京東" => "BOP", "北京" => "BJP",
"北京南" => "VNP", "北京西" => "BXP",
"上海" => "SHH", "上海虹橋" => "AOH", "上海南" => "SNH", "上海西" => "SXH",
"天津" => "TJP", "天津西" => "TXP", "天津北" => "TBP",
"重慶北" => "CUW", "重慶" => "CQW", "重慶南" => "CRW", "重慶西" => "CXW",
// 省會城市
"長春" => "CCT", "長春南" => "CET", "長春西" => "CRT",
"成都東" => "ICW", "成都南" => "CNW", "成都" => "CDW", "成都西" => "CFW",
"長沙" => "CSQ", "長沙南" => "CWQ",
"福州" => "FZS", "福州南" => "FUS",
"廣州" => "GZQ", "廣州東" => "GGQ", "廣州南" => "IZQ", "廣州北" => "GBQ",
"杭州" => "HZH", "杭州東" => "HGH", "杭州南" => "HNH",
// ... 完整表超過 5000 站,建議從 12306 官方 JS 解析獲取
];
?>
<?php
class Railway12306 {
private $stations;
private $httpClient;
public function __construct() {
$this->stations = require __DIR__ . '/name.php';
$this->httpClient = new HttpClient(); // 需支援 Cookie、重試、代理
}
/**
* 查詢餘票
* @param string $from 出發站中文名
* @param string $to 到達站中文名
* @param string $date 日期 Y-m-d
* @return array
*/
public function queryTickets(string $from, string $to, string $date): array {
$fromCode = $this->stations[$from] ?? null;
$toCode = $this->stations[$to] ?? null;
if (!$fromCode || !$toCode) {
throw new InvalidArgumentException("車站代碼不存在");
}
// 12306 查詢端點 (需模擬完整 Header、Cookie、加密參數)
$url = "https://kyfw.12306.cn/otn/leftTicket/queryZ";
$params = [
'leftTicketDTO.train_date' => $date,
'leftTicketDTO.from_station' => $fromCode,
'leftTicketDTO.to_station' => $toCode,
'purpose_codes' => 'ADULT',
];
// 實際請求極其複雜,涉及:
// - RAIL_DEVICEID / RAIL_EXPIRATION Cookie 生成
// - _json_att 參數加密
// - 驗證碼識別 (點選/滑塊)
// - 請求頻率限制與 IP 封鎖
// 本範例僅示意架構
$response = $this->httpClient->get($url, $params);
return $this->parseResponse($response);
}
private function parseResponse($response): array {
// 解析 JSON 回應,提取列車號、出發/到達時間、席別餘票、價格
// 回應結構極其複雜,需對應官方文件
return [];
}
public function getPrice(string $trainNo, string $fromCode, string $toCode, string $seatType): ?float {
// 價格查詢獨立端點,需列車號、站序、席別代碼
return null;
}
}
?>
本範例展示: