KOHA与PHP应用对接的cURL接口实现及Bye响应异常排查

原代码核心问题定位 #

• 错误开启GET请求：代码中curl_setopt($ch, CURLOPT_POST, 0) 强制接口走GET请求，而KOHA的OAuth令牌接口仅接受POST请求，收到不符合要求的请求会直接返回拦截响应（即出现的"Bye"）
• 缺失必要的授权参数：仅携带Basic Auth凭证未满足OAuth2协议要求，令牌接口需要明确传入授权类型参数才能完成认证流程

修正后可直接运行的实现代码 #

<?php
// 替换为实际KOHA站点的令牌接口地址
$url = "http://opac.example.com/api/v1/oauth/token";
// 注意：此处为KOHA后台【OAuth2客户端管理】中生成的 客户端ID:客户端密钥，非普通用户登录账密
$clientAuth = "你的客户端ID:你的客户端密钥";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Basic Auth传递客户端凭证
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, $clientAuth);
// 强制使用POST请求
curl_setopt($ch, CURLOPT_POST, 1);
// 携带OAuth2要求的授权类型参数
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'grant_type' => 'client_credentials'
]));
// 规范请求头，兼容不同服务器解析规则
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_HEADER, 0);

$result = curl_exec($ch);
// 增加错误捕获能力，方便排查异常
if (curl_errno($ch)) {
    echo "请求异常：" . curl_error($ch);
} else {
    $tokenResult = json_decode($result, true);
    print_r($tokenResult);
}
curl_close($ch);
?>

对接校验注意事项 #

• 凭证匹配：确认填入的客户端ID、密钥和KOHA后台生成的内容完全一致，错配会直接触发接口拦截
• 接口连通性排查：如果代码运行后仍返回"Bye"，可先通过命令行执行curl -X POST -u "客户端ID:密钥" -d "grant_type=client_credentials" 你的接口地址 排除网络、权限层面的问题
• 权限配置：确认对应OAuth2客户端在KOHA后台已开通目标接口的访问权限，未授权的客户端请求会被直接拦截
• 路径校验：确认令牌接口路径和当前使用的KOHA版本匹配，部分历史版本的OAuth接口路径存在差异

内容的提问来源于stack exchange，提问作者Abiudeko