如何使用 PHP 调用 Moz API v2（URL Metrics 接口）-php教程-PHP中文网

如何使用 PHP 调用 Moz API v2（URL Metrics 接口）

本文详解如何通过 PHP 正确调用 Moz API v2 的 URL Metrics 接口，提供基于 cURL 的完整可运行示例，并指出原 file_get_contents 方案中常见的请求头、认证、数据格式等关键错误。

本文详解如何通过 php 正确调用 moz api v2 的 url metrics 接口，提供基于 curl 的完整可运行示例，并指出原 `file_get_contents` 方案中常见的请求头、认证、数据格式等关键错误。

Moz API v2 已弃用基础认证（Basic Auth）中的 Base64 编码凭据方式，而是要求直接使用 Access ID（用户名）与 Secret Key（密码）组合，并通过 CURLOPT_USERPWD 交由 cURL 自动处理认证流程——这是原 file_get_contents 实现失败的核心原因之一。此外，API 明确要求请求体为 JSON 格式，且必须设置 Content-Type: application/json 请求头；而原始代码中误设为 application/x-www-form-urlencoded，且将 content-length 和 content 错误地置于 http 上下文数组顶层（实际应由 cURL 自动计算并发送），导致服务端无法解析请求。

以下是推荐的、经验证的 PHP 实现方案（使用 cURL）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php // 替换为你的 Moz 账户凭证（可在 https://moz.com/products/api/ 获取）
$username = 'mozscape-xxxxxxxxxxxxxxxx'; // Access ID
$password = 'xxxxxxxxxxxxxxxxxxxxxxxx';   // Secret Key

$endpoint = 'https://lsapi.seomoz.com/v2/url_metrics';
$payload  = json_encode([
    'targets' => ['moz.com', 'google.com'] // 支持单个或多个域名（最多 10 个/请求）
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'User-Agent: Mozilla/5.0 (PHP-MozClient/1.0)'
]);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error    = curl_error($ch);
curl_close($ch);

if ($error) {
    throw new RuntimeException("cURL error: $error");
}

if ($httpCode !== 200) {
    echo "HTTP Error: $httpCode\n";
    echo $response;
} else {
    $data = json_decode($response, true);
    print_r($data);
}
?>

⚠️ 关键注意事项：

✅ 认证方式：必须使用 CURLOPT_USERPWD + CURLAUTH_BASIC，而非手动 Base64 编码 Authorization: Basic ...；Moz v2 不接受自构造的 Basic 头。
✅ Content-Type：必须为 application/json，且请求体 $payload 必须是合法 JSON 字符串（使用 json_encode() 生成）。
✅ Targets 格式："targets" 值必须是字符串数组（如 ["example.com"]），不可传入单个字符串。
⚠️ 速率限制：免费试用账户通常限 100 次/日；商用账户需按 Tier 配置配额，请监控响应头中的 X-RateLimit-Remaining。
⚠️ HTTPS 强制：仅支持 HTTPS，HTTP 请求将被拒绝。
❌ 避免 file_get_contents：其流上下文对复杂 HTTP 协议（如自动认证、JSON body、header 精确控制）支持薄弱，易出错且调试困难；cURL 是更可靠、标准的选择。