百度提供 ping.baidu.com/ping/RPC2 XML-RPC 端點,支援 weblogUpdates.extendedPing 方法。網站發布新內容時主動推送,可加速收錄。核心參數:博客名稱、首頁 URL、新文章 URL、RSS URL。
<?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;
}
}
?>
<?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'],
]);
}
}
?>
<?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 已停用傳統 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...';
}
}
?>
百度 Ping 仍是國內站點加速收錄的有效手段。現代實現應:使用 XMLWriter 構建標準 XML-RPC、異步隊列非阻塞、多引擎統一管理、記錄日誌可觀測。同時佈局 Google Indexing API、Bing URL Submission API 等現代主動推送介面,構建完整的搜尋引擎通知體系。