php 8.6服务端应用可按oauth2客户端凭据流程,用专用client_id和client_secret向令牌端点请求access token,再把bearer令牌用于允许的资源接口。该流程仅适用于能保密的服务端客户端,不用于把客户端密钥放入浏览器,也不代表获得用户个人授权。

PHP手册中的PHP: curl_setopt_array - Manual
准备已注册客户端和固定HTTPS端点
安装cURL,通过OAUTH_CLIENT_ID和OAUTH_CLIENT_SECRET注入凭据。把代码中的两个example.invalid地址替换为服务商文档指定的真实令牌及资源端点,并核对是否支持client_credentials、client_secret_basic和read范围;示例域名不会提供真实服务。

PHP手册中的PHP: curl_getinfo - Manual
限定请求并分别处理令牌和资源响应
<?php function request(string $url,array $options):array {
$ch=curl_init($url);
if (!curl_setopt_array($ch,$options+[
CURLOPT_RETURNTRANSFER=>true,CURLOPT_FOLLOWLOCATION=>false,
CURLOPT_CONNECTTIMEOUT=>5,CURLOPT_TIMEOUT=>20,
CURLOPT_SSL_VERIFYPEER=>true,CURLOPT_SSL_VERIFYHOST=>2,
])) throw new RuntimeException('cURL选项配置失败');
$body=curl_exec($ch);
if ($body===false) throw new RuntimeException('HTTPS请求失败');
return [(int)curl_getinfo($ch,CURLINFO_RESPONSE_CODE),$body];
}
$id=getenv('OAUTH_CLIENT_ID'); $secret=getenv('OAUTH_CLIENT_SECRET');
if (!is_string($id)||$id===''||!is_string($secret)||$secret==='') {
throw new RuntimeException('客户端凭据缺失');
}
$basic=base64_encode(urlencode($id).':'.urlencode($secret));
[$status,$raw]=request('https://auth.example.invalid/oauth/token',[
CURLOPT_POST=>true,
CURLOPT_HTTPHEADER=>['Authorization: Basic '.$basic,
'Content-Type: application/x-www-form-urlencoded','Accept: application/json'],
CURLOPT_POSTFIELDS=>http_build_query(
['grant_type'=>'client_credentials','scope'=>'read'],'','&',PHP_QUERY_RFC1738),
]);
if ($status!==200) throw new RuntimeException('令牌端点未接受请求');
$data=json_decode($raw,true,32,JSON_THROW_ON_ERROR);
if (!is_array($data)) throw new UnexpectedValueException('令牌响应须为对象');
$token=$data['access_token']??null;
if (!is_string($token)||$token===''||strpbrk($token,"\r\n")!==false
|| strcasecmp((string)($data['token_type']??''),'Bearer')!==0) {
throw new RuntimeException('令牌响应不符');
}
[$apiStatus,$apiBody]=request('https://api.example.invalid/v1/profile',[
CURLOPT_HTTPHEADER=>['Authorization: Bearer '.$token,'Accept: application/json'],
]);
if ($apiStatus===401) throw new RuntimeException('资源端点拒绝认证');
if ($apiStatus===403) throw new RuntimeException('资源权限不足');
if ($apiStatus=300) throw new RuntimeException('资源请求失败');
$result=json_decode($apiBody,true,32,JSON_THROW_ON_ERROR);
echo json_encode($result,JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR);
不要重复混用认证方式
客户端ID和密钥先按表单编码后组成Basic值;同一个令牌请求不再额外把client_secret放进URL或请求体。令牌响应和Authorization头不能进入普通日志,资源接口也不应无条件跟随重定向泄露Bearer值。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
缓存和失败策略按服务商约定增加
示例每次运行取得令牌,没有实现跨进程缓存。需要缓存时,依据有效expires_in留出时钟余量并保护存储;client_credentials通常不使用刷新令牌。401不一定只有过期原因,403也不能通过不断重取令牌解决,不自动无限重试有副作用请求。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










