直接调用华为云OCR官方PHP SDK最稳，需用huaweicloud-sdk-php-ocr（≥3.0.28），显式指定Region（如cn-north-4），图片base64须带正确MIME前缀，身份证识别返回中仅result.name等字段稳定可用。
华为云OCR SDK的RecognizeIdCard和RecognizeBankCard怎么调用
直接调用官方PHP SDK最稳，别自己拼HTTP请求——签名、时间戳、AK/SK加签逻辑容易出错，SDK已封装好。确认你用的是 huaweicloud-sdk-php-ocr（不是通用服务SDK），版本 >= 3.0.28（低版本不支持v3 API）。
常见错误现象：401 Unauthorized（签名失败）、400 Bad Request（图片base64缺前缀或超长）、ServiceUnavailable（region没选对）。
- 必须用
Region::valueByCode("cn-north-4")显式指定区域，不能靠默认值；身份证识别只支持cn-north-4和cn-east-2，银行卡仅cn-north-4 - 图片必须是 base64 编码字符串，且带前缀：
data:image/jpeg;base64,...（JPEG/PNG都行，但前缀必须匹配实际格式） -
RecognizeIdCardRequest的side参数填"front"或"back"字符串，不是布尔值；不传会报错
PHP读取本地身份证图片并转成base64传给RecognizeIdCard
别用 file_get_contents 直接读图再base64_encode——如果图片路径含中文或空格，file_get_contents 可能静默失败；也别用 base64_encode(file_get_contents(...)) 后手动拼前缀，漏了逗号就返回空结果。
正确做法是先验证文件存在且可读，再严格按MIME类型拼前缀：
立即学习“PHP免费学习笔记（深入）”；
if (!is_readable($path)) {
throw new InvalidArgumentException("图片不可读: {$path}");
}
$mimeType = mime_content_type($path);
$base64 = 'data:' . $mimeType . ';base64,' . base64_encode(file_get_contents($path));
注意：mime_content_type() 在某些PHP环境可能被禁用，可降级用 finfo_file(finfo_open(FILEINFO_MIME_TYPE), $path) 替代。
RecognizeIdCard返回字段里哪些是真实可用的
华为云返回的JSON结构看着多，但真正稳定可用的字段很少——很多字段（如name_confidence、number_confidence）在测试中经常为null，不能作为业务判断依据。
- 必有且可信的只有：
result.name、result.number、result.sex、result.birth、result.nation、result.address（正面）；result.issue、result.expiry（背面） -
result.side是识别结果推测的正/反面，不是你传的side参数值，别拿它做流程分支 - 银行卡识别只返回
result.bank_card_number和result.bank_name，其他字段（如有效期）目前不支持
为什么本地调试总卡在curl_exec超时或SSL报错
不是代码问题，大概率是PHP cURL底层配置没对。华为云OCR接口强制HTTPS，且证书链要求完整。
- 检查
php.ini中curl.cainfo是否指向有效的CA证书路径（如/etc/ssl/certs/ca-certificates.crt），Windows下需手动下载curl-ca-bundle.crt并配置 - 别设
CURLOPT_TIMEOUT小于15秒——OCR识别本身要几百毫秒，网络抖动时容易超时，建议设30秒 - 开发机若走代理，SDK默认不继承系统代理，得手动在
HttpConfig里配proxy参数，否则请求根本发不出去
真要绕过证书校验（仅限测试），必须显式设 CURLOPT_SSL_VERIFYPEER => false 和 CURLOPT_SSL_VERIFYHOST => 0，但上线前务必删掉——华为云会拒绝不校验证书的请求。
