PHP 8.3 本身不支持 OCR，但可通过调用百度、腾讯、阿里等云 OCR 接口实现；需注意上传图片、构造请求、解析响应，并适配 PHP 8.3 的只读类、严格类型等新特性。
PHP 8.3 本身不直接具备图像 OCR 能力，但可以轻松调用主流 AI OCR 接口（如百度 OCR、腾讯云 OCR、阿里云 OCR 或开源模型 API）完成图片文字识别。关键在于：正确上传图片、构造合规请求、处理 JSON 响应、并注意 PHP 8.3 的新特性（如只读类、更严格的类型检查）带来的适配细节。
选择并注册一个支持 HTTP 调用的 OCR 服务
推荐优先考虑国内云厂商，因其文档完善、中文识别强、响应快，且多数提供免费额度：
-
百度智能云文字识别：控制台开通「文字识别」服务，获取
API Key和Secret Key，通过 OAuth2 获取access_token后调用/rest/2.0/ocr/v1/general_basic等接口 -
腾讯云 OCR：开通「通用印刷体识别」，使用 SecretId/SecretKey + 签名 v3（需生成 Authorization 头），调用
https://ocr.tencentcloudapi.com -
阿里云 OCR（OCR SDK for PHP）：官方提供
aliyun-openapi-php-sdk，兼容 PHP 8.3，支持 base64 或 URL 图片识别
用 cURL 发送带图片的 POST 请求（PHP 8.3 兼容写法）
PHP 8.3 废弃了 curl_setopt_array() 中部分旧参数别名，建议显式使用常量；同时推荐启用严格类型和只读数组保护。以下为百度 OCR 的 base64 方式示例：
<?php
declare(strict_types=1);
function recognizeImageWithBaidu(string $imagePath, string $accessToken): array
{
// 读取并转为 base64（注意：大图建议压缩或限制尺寸，避免超限）
$imageData = file_get_contents($imagePath);
if ($imageData === false) {
throw new RuntimeException("无法读取图片文件: {$imagePath}");
}
$imageBase64 = base64_encode($imageData);
$url = 'https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic' . '?access_token=' . urlencode($accessToken);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => ['image' => $imageBase64],
CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded'],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode !== 200) {
throw new RuntimeException("OCR 请求失败，HTTP 状态码: {$httpCode}");
}
$result = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
if (isset($result['error_msg'])) {
throw new RuntimeException("OCR 识别错误: {$result['error_msg']}");
}
return $result;
}
// 使用示例
try {
$accessToken = 'your_access_token_here';
$result = recognizeImageWithBaidu('/path/to/photo.jpg', $accessToken);
foreach ($result['words_result'] ?? [] as $item) {
echo $item['words'] . "\n";
}
} catch (Exception $e) {
echo "出错: " . $e->getMessage();
}
?>
处理常见问题（PHP 8.3 特别注意点）
对接过程中容易卡在几个细节，PHP 8.3 的严格性会让它们更早暴露：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
-
JSON 解析失败：务必加
JSON_THROW_ON_ERROR标志，避免静默返回null；响应非 UTF-8 编码时，先用mb_convert_encoding()转换 -
cURL SSL 验证失败：开发环境若遇证书问题，可临时加
CURLOPT_SSL_VERIFYPEER => false（上线必须关闭） -
大图上传超限：百度 OCR base64 图片上限 4MB，PHP 默认
post_max_size和upload_max_filesize可能不足，需在php.ini中调整（如设为8M） -
只读类误修改：若你封装了 OCR 客户端为只读类（
readonly class），切勿尝试赋值属性——改用不可变方式构造新实例
进阶：用 Guzzle HTTP Client（更现代、易测试）
如果你项目已用 Composer，推荐安装 guzzlehttp/guzzle:^7.8（完全兼容 PHP 8.3）：
composer require guzzlehttp/guzzle:^7.8
代码更简洁、异常统一、支持异步和中间件：
<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
function recognizeWithGuzzle(string $imagePath, string $accessToken): array
{
$client = new Client(['timeout' => 30]);
$imageData = file_get_contents($imagePath);
$base64 = base64_encode($imageData);
try {
$res = $client->post(
'https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic',
[
'query' => ['access_token' => $accessToken],
'form_params' => ['image' => $base64],
]
);
$body = $res->getBody()->getContents();
return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
} catch (GuzzleException $e) {
throw new RuntimeException('OCR 请求异常: ' . $e->getMessage());
}
}
不复杂但容易忽略：始终校验图片 MIME 类型（用 finfo_file()）、设置合理的超时、记录原始响应用于调试、对敏感 token 做环境变量隔离（如用 $_ENV['BAIDU_OCR_TOKEN']）。
