萬盛學電腦網

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

PHP 實現百度 Ping 服務:XML-RPC 協定主動推送網頁收錄

百度 Ping 服務原理

百度提供 ping.baidu.com/ping/RPC2 XML-RPC 端點,支援 weblogUpdates.extendedPing 方法。網站發布新內容時主動推送,可加速收錄。核心參數:博客名稱、首頁 URL、新文章 URL、RSS URL。

現代化 Ping 客戶端實現

<?php
class BaiduPingClient
{
    private string $rpcEndpoint = 'https://ping.baidu.com/ping/RPC2';
    private int $timeout = 10;
    
    /** 
     * 發送 Ping
     * @param string $blogName 博客名稱
     * @param string $articleUrl 新文章完整 URL
     * @param string $blogHomepage 博客首頁 URL
     * @param string $rssUrl RSS Feed URL
     * @return array ['success' => bool, 'message' => string, 'raw_response' => string]
     */
    public function ping(string $blogName, string $articleUrl, string $blogHomepage, string $rssUrl): array
    {
        $xml = $this->buildXml($blogName, $articleUrl, $blogHomepage, $rssUrl);
        
        $ch = curl_init($this->rpcEndpoint);
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => $xml,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => $this->timeout,
            CURLOPT_HTTPHEADER => [
                'Content-Type: text/xml; charset=UTF-8',
                'User-Agent: BaiduPingClient/1.0 (PHP/' . PHP_VERSION . ')',
                'Host: ping.baidu.com',
            ],
            CURLOPT_SSL_VERIFYPEER => false, // HTTP 端點
        ]);
        
        $response = curl_exec($ch);
        $errno = curl_errno($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        
        if ($errno !== CURLE_OK) {
            return ['success' => false, 'message' => 'cURL error: ' . curl_error($ch), 'raw_response' => ''];
        }
        
        if ($httpCode !== 200) {
            return ['success' => false, 'message' => "HTTP $httpCode", 'raw_response' => $response];
        }
        
        // 解析 XML-RPC 回應
        $success = $this->parseResponse($response);
        return [
            'success' => $success,
            'message' => $success ? 'Ping 成功(返回 0 表示成功)' : 'Ping 失敗(返回非 0)',
            'raw_response' => $response,
        ];
    }
    
    private function buildXml(string $blogName, string $articleUrl, string $blogHomepage, string $rssUrl): string
    {
        // 使用 XMLWriter 確保正確編碼與結構
        $writer = new XMLWriter();
        $writer->openMemory();
        $writer->startDocument('1.0', 'UTF-8');
        $writer->startElement('methodCall');
        $writer->writeElement('methodName', 'weblogUpdates.extendedPing');
        $writer->startElement('params');
        
        $params = [
            $blogHomepage,
            $blogName,
            $articleUrl,
            $rssUrl,
        ];
        
        foreach ($params as $param) {
            $writer->startElement('param');
            $writer->startElement('value');
            $writer->writeElement('string', $param);
            $writer->endElement(); // value
            $writer->endElement(); // param
        }
        
        $writer->endElement(); // params
        $writer->endElement(); // methodCall
        $writer->endDocument();
        
        return $writer->outputMemory(true);
    }
    
    private function parseResponse(string $xml): bool
    {
        // 百度成功回應包含 0
        // 失敗包含 1 或 2 等錯誤代碼
        if (strpos($xml, '0') !== false) {
            return true;
        }
        
        // 更嚴謹解析
        $dom = new DOMDocument();
        if (@$dom->loadXML($xml)) {
            $xpath = new DOMXPath($dom);
            $intNodes = $xpath->query('//int');
            foreach ($intNodes as $node) {
                if ((int)$node->textContent === 0) return true;
            }
        }
        return false;
    }
}
?>

使用範例:發布文章時自動 Ping

<?php
// 在文章發布/更新後調用
function onArticlePublished(Article $article): void
{
    // 避免阻塞主請求,放入隊列異步執行
    dispatch(new PingBaiduJob($article));
}

// Job 類
class PingBaiduJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    
    public function __construct(public Article $article) {}
    
    public function handle(): void
    {
        $client = new BaiduPingClient();
        $result = $client->ping(
            blogName: config('app.name'),
            articleUrl: $article->getAbsoluteUrl(),
            blogHomepage: config('app.url'),
            rssUrl: config('app.url') . '/rss.xml'
        );
        
        Log::info('Baidu Ping 結果', [
            'article_id' => $this->article->id,
            'success' => $result['success'],
            'message' => $result['message'],
        ]);
        
        // 記錄到資料庫供後台查看
        PingLog::create([
            'article_id' => $this->article->id,
            'target' => 'baidu',
            'success' => $result['success'],
            'response' => $result['raw_response'],
        ]);
    }
}
?>

多引擎 Ping 統一介面(Google/百度/必應/其他)

<?php
interface PingServiceInterface
{
    public function ping(string $blogName, string $articleUrl, string $blogHomepage, string $rssUrl): array;
    public function getName(): string;
}

class PingManager
{
    /** @var PingServiceInterface[] */
    private array $services = [];
    
    public function register(PingServiceInterface $service): void
    {
        $this->services[$service->getName()] = $service;
    }
    
    public function pingAll(string $blogName, string $articleUrl, string $blogHomepage, string $rssUrl): array
    {
        $results = [];
        foreach ($this->services as $name => $service) {
            try {
                $results[$name] = $service->ping($blogName, $articleUrl, $blogHomepage, $rssUrl);
            } catch (Throwable $e) {
                $results[$name] = ['success' => false, 'message' => $e->getMessage(), 'raw_response' => ''];
            }
        }
        return $results;
    }
}

// 註冊多個服務
$manager = new PingManager();
$manager->register(new BaiduPingClient());
$manager->register(new GooglePingClient());    // 需實現
$manager->register(new BingPingClient());      // 需實現
$manager->register(new BlogSearchPingClient()); // 等

// 一鍵推送所有
$results = $manager->pingAll($blogName, $articleUrl, $blogHomepage, $rssUrl);
?>

Google Indexing API(現代替代方案)

Google 已停用傳統 Ping 服務,改用 Indexing API(需 Google Cloud 專案、服務帳號、OAuth 2.0):

<?php
class GoogleIndexingClient
{
    private string $serviceAccountJson;
    private string $endpoint = 'https://indexing.googleapis.com/v3/urlNotifications:publish';
    
    public function __construct(string $serviceAccountJsonPath)
    {
        $this->serviceAccountJson = file_get_contents($serviceAccountJsonPath);
    }
    
    public function notify(string $url, string $type = 'URL_UPDATED'): array
    {
        // 1. 獲取 Access Token (JWT + OAuth)
        $token = $this->getAccessToken();
        
        // 2. 發送通知
        $ch = curl_init($this->endpoint);
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode(['url' => $url, 'type' => $type]),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Content-Type: application/json',
                'Authorization: Bearer ' . $token,
            ],
        ]);
        
        $response = curl_exec($ch);
        curl_close($ch);
        
        return json_decode($response, true) ?? ['error' => 'Invalid response'];
    }
    
    private function getAccessToken(): string
    {
        // 使用 google/auth 库或手動簽署 JWT
        // 此處省略,建議用 google/apiclient
        return 'YA29...';
    }
}
?>

注意事項與最佳實踐

  1. 頻率限制:百度建議單站點每小時不超過 50 次,避免被封禁
  2. 去重:同一 URL 短時間內重複 Ping 無意義,記錄最近 Ping 時間
  3. 內容品質:Ping 只加速發現,收錄仍取決於內容質量
  4. HTTPS:百度 Ping 端點仍為 HTTP,但推送的 URL 建議全站 HTTPS
  5. RSS 必備:RSS URL 幫助百度發現更多內容,務必維護有效 RSS

總結

百度 Ping 仍是國內站點加速收錄的有效手段。現代實現應:使用 XMLWriter 構建標準 XML-RPC、異步隊列非阻塞、多引擎統一管理、記錄日誌可觀測。同時佈局 Google Indexing API、Bing URL Submission API 等現代主動推送介面,構建完整的搜尋引擎通知體系。

copyright © 萬盛學電腦網 all rights reserved