php怎么调用腾讯云慧眼人脸核身_php如何验证用户真实身份信息-php教程-PHP中文网

腾讯云慧眼 PHP SDK 初始化失败主因是未单独安装 faceid 包（需 composer require tencentcloud/faceid）且类名含 V20180301；签名错误多因服务器时间偏差超5分钟或时区设置不当；回调验签须用 php://input 读取原始 body 并按指定格式拼接字符串。

php怎么调用腾讯云慧眼人脸核身_php如何验证用户真实身份信息

腾讯云慧眼 PHP SDK 初始化失败或报 Class not found

直接原因通常是没装对 SDK 或自动加载没生效。腾讯云官方 PHP SDK（tencentcloud-sdk-php）本身不带慧眼（faceid）模块，得单独 require 对应产品包。

必须执行 composer require tencentcloud/faceid，不是 tencentcloud/sdk
确认 vendor/autoload.php 已引入，且没被路径或命名空间覆盖干扰
类名是 TencentCloud\Faceid\V20180301\FaceidClient，手写 new 时别漏掉 V20180301 这层版本目录
如果用 Laravel，注意某些版本会缓存 autoload，改完 composer.json 后要跑 composer dump-autoload

调用 `DetectFaceAttributes` 或 `GetDetectInfo` 返回签名错误（`InvalidParameter.SignatureExpire`）

慧眼所有接口都走 POST + 签名，时间戳偏差超过 5 分钟就会拒收。PHP 默认用系统时间，但服务器若未同步 NTP，极易出问题。

上线前务必运行 ntpdate -u ntp.tencent.com 或启用 systemd-timesyncd
不要手动拼 Timestamp 参数——SDK 会自动生成，但前提是你的 date_default_timezone_set() 没乱设（推荐设为 "Asia/Shanghai" 或 "UTC"）
检查 SecretId / SecretKey 是否含空格或换行（尤其从环境变量读取时），可用 trim() 包一层
测试时先用腾讯云 API Explorer 生成签名串比对，确认本地和云端时间差

人脸核身结果里 `Result` 是 `FAIL`，但 `Description` 显示 “证件照片与公安库不一致”

这不是调用逻辑问题，而是业务侧数据准备不当。慧眼的 CompareFace 接口只做“人像比对”，不查身份证真伪或联网核查——它需要你提前传入用户上传的身份证正反面照片、以及现场拍摄的人脸照。

腾讯云通用票据识别（高级版）

腾讯云通用票据识别高级版(VatInvoiceOCR)接口调用技能。当用户需要识别发票图片中增值税专用发票、增值税普通发票、增值税电子专票、增值税电子普票、电子发票（普通/增值税专用）的全字段信息时,应使用此技能。支持识别发票图片中的发票代码、发票号码、开票日期、合计金额、校验码、税率、合计税额、价税合计、购买方...

下载

务必确保三张图都是 JPEG/PNG、尺寸 ≥ 480×640、人脸居中清晰、无遮挡反光
传参时 ImageBase64 必须是原始二进制 base64 编码（不能是 URL-safe 变种），且不含 data:image/jpeg;base64, 前缀
公安库比对失败常见于：用户身份证刚办理/挂失/补办，或港澳台/外籍人士暂未入库；这时需 fallback 到人工审核流程
别依赖单次调用结果做最终判定——慧眼返回的 Similarscore 建议阈值设在 70~90 之间，低于 70 强制拦截，70~90 记录日志+人工复核

Laravel 或 ThinkPHP 中异步回调验签失败（`SignatureDoesNotMatch`）

慧眼核身后会向你配置的回调地址发 POST 请求，但它的签名方式和主调用接口不同：用的是 HMAC-SHA256 + HTTP body raw data，且 key 是 SecretKey（不是 SecretId）。

PHP 接收时不能用 $_POST——它会自动解析 form-data 或 urlencoded，破坏原始 body。必须用 file_get_contents("php://input")
验签字符串拼接顺序固定：HTTPMethod + \n + Path + \n + CanonicalQueryString + \n + CanonicalHeaders + \n + SignedHeaders + \n + HexEncode(Hash(RequestPayload))，其中 CanonicalHeaders 只包含 content-type 和 host
腾讯云文档里给的 PHP 验签示例有坑：hash_hmac('sha256', $stringToSign, $secretKey, true) 的第三个参数必须是原始 SecretKey 字符串，不能是 base64_decode 后的二进制
生产环境务必校验 X-Tencent-Request-Id 和 X-Tencent-Date 头，防止重放攻击