萬盛學電腦網

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

PHP 實作 12306 火車票餘票與價格查詢 (教學範例)

中國鐵路 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;
    }
}
?>

⚠️ 重要法律與技術警告

❌ 禁止用於生產環境的爬蟲行為

  • 12306 嚴格反爬:IP 封鎖、驗證碼、請求頻率限制、法律追究
  • 車票資訊屬鐵路部門商業機密,未授權爬取違反《計算機信息網絡國際聯網管理暫行規定》
  • 第三方搶票軟體多被起訴判刑案例 (如 2019 年「搶票軟體」案)

✅ 合法替代方案

  1. 官方開放平台:鐵路 12306 企業版 API (需資質審核)
  2. 授權代理商:攜程、飛豬、同程等合法代理
  3. 用戶授權:用戶主動提供 Cookie/Token 的輔助工具 (灰色地帶)

學習價值

本範例展示:

  • 大型系統站點代碼映射設計
  • HTTP 客戶端封裝與錯誤處理
  • 複雜參數構建與回應解析架構
  • 法律合規意識的重要性
copyright © 萬盛學電腦網 all rights reserved