The Best Image OCR SDK For BAT.
项目地址 https://github.com/godruoyi/ocr
今天是星期二，是发布轮子的好日子。@overtrue
Feature
- 自定义缓存支持；
- 符合 PSR 标准，可以很方便的与你的框架结合；
- 命名不那么乱七八糟；
- 支持目前市面多家服务商
Support
Requirement
- PHP > 5.6
- composer
Installation
composer require godruoyi/ocr
Usage
基本使用（以百度OCR为例）
use Godruoyi\OCR\Application;
$app = new Application([
'ocrs' => [
'baidu' => [
'app_key' => 'app_key',
'secret_key' => 'secret_key'
],
]
]);
//身份证识别
$result = $app->baidu->idcard($filePath);
返回结果
{
"log_id": 530427582,
"image_status": "normal",
"words_result_num": 6,
"words_result": {
"住址": {
"words": "上海市闵行区华漕镇红卫村宗家巷1号"
},
"出生": {
"words": "19870723"
},
"姓名": {
"words": "鹿晗"
},
"公民身份号码": {
"words": "123456789123456132X"
},
"性别": {
"words": "男"
},
"民族": {
"words": "汉"
}
}
}
各平台支持的方法
详情请参考官方文档
所有平台支持的方法中，都满足以下结构：
$app->platform->$method($files, $options = [])
$files 的值可以为
- 文件路径（完整）
-
SplFileInfo对象 Resource- 在线图片地址（部分服务商不支持）
- Array
注：
options的值都是可选的
<a name="baidu-ocr"></a>
百度OCR
目前采用 AccessToken 作为 API 认证方式，查看鉴权认证机制
<a name="baidu-generalBasic"></a>
通用文字识别
$app->baidu->generalBasic($file, [
'language_type' => 'CHN_ENG', //支持的语言，默认为CHN_ENG（中英文混合）
'detect_direction' => false, //是否检测图像朝向
'detect_language' => false, //是否检测语言，默认不检测
'probability' => false, //是否返回识别结果中每一行的置信度
]);
<a name="baidu-accurateBasic"></a>
通用文字识别（高精度版）
$app->baidu->accurateBasic($file, [
'detect_direction' => false, //是否检测图像朝向
'probability' => false, //是否返回识别结果中每一行的置信度
]);
<a name="baidu-general"></a>
通用文字识别（含位置信息版）
$app->baidu->general($file, [
'recognize_granularity' => 'big', //是否定位单字符位置
'language_type' => 'CHN_ENG', //CHN_ENG：中英文混合；默认为CHN_ENG
'detect_direction' => false, //是否检测图像朝向
'detect_language' => false, //是否检测语言，默认不检测
'vertexes_location' => false, //是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
'probability' => false, //是否返回识别结果中每一行的置信度
]);
<a name="baidu-accurate"></a>
通用文字识别（含位置高精度版）
$app->baidu->accurate($file, [
'recognize_granularity' => 'big', //是否定位单字符位置
'detect_direction' => false, //是否检测图像朝向
'vertexes_location' => false, //是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
'probability' => false, //是否返回识别结果中每一行的置信度
]);
<a name="baidu-generalEnhanced"></a>
通用文字识别（含生僻字版）
$app->baidu->generalEnhanced($file, [
'language_type' => 'CHN_ENG', //CHN_ENG：中英文混合；默认为CHN_ENG
'detect_direction' => false, //是否检测图像朝向
'vertexes_location' => false, //是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
'probability' => false, //是否返回识别结果中每一行的置信度
]);
<a name="baidu-webimage"></a>
网络图片文字识别
$app->baidu->webimage($file, [
'detect_direction' => false, //是否检测图像朝向
'detect_language' => false, //是否检测语言，默认不检测
]);
<a name="baidu-idcard"></a>
身份证识别
$app->baidu->idcard($file, [
'detect_direction' => false, //是否检测图像朝向
'id_card_side' => 'front', //front：身份证正面；back：身份证背面 （注意，该参数必选）
'detect_risk' => false, //是否开启身份证风险类型功能，默认false
]);
<a name="baidu-bankcard"></a>
银行卡识别
$app->baidu->bankcard($file, [
]);
<a name="baidu-drivingLicense"></a>
驾驶证识别
$app->baidu->drivingLicense($file, [
'detect_direction' => false, //是否检测图像朝向
]);
<a name="baidu-vehicleLicense"></a>
行驶证识别
$app->baidu->vehicleLicense($file, [
'detect_direction' => false, //是否检测图像朝向
'accuracy' => 'normal' // normal 使用快速服务，1200ms左右时延,缺省或其它值使用高精度服务，1600ms左右时延
]);
<a name="baidu-licensePlate"></a>
车牌识别
$app->baidu->licensePlate($file, [
'multi_detect' => false, //是否检测多张车牌，默认为false
]);
<a name="baidu-businessLicense"></a>
营业执照识别
$app->baidu->businessLicense($file, [
]);
<a name="baidu-receipt"></a>
通用票据识别
$app->baidu->receipt($file, [
'recognize_granularity' => 'big', //是否定位单字符位置
'probability' => false, //是否返回识别结果中每一行的置信度
'accuracy' => 'normal' // normal 使用快速服务，1200ms左右时延,缺省或其它值使用高精度服务，1600ms左右时延
'detect_direction' => false, //是否检测图像朝向
]);
<a name="aliyun-ocr"></a>
Aliyun OCR
目前采用 APPCODE 作为 API 认证方式，查看我的APPCODE
use Godruoyi\OCR\Application;
$app = new Application([
'ocrs' => [
'aliyun' => [
'appcode' => '40bc103c7fe6417b87152f6f68bead2f',
]
]
]);
阿里云OCR不支持在线图片地址
<a name="aliyun-idcard"></a>
身份证识别
$app->aliyun->idcard($file, [
'side' => 'face', //身份证正反面类型:face/back
]);
<a name="aliyun-vehicle"></a>
行驶证识别
$app->aliyun->vehicle($file, [
]);
<a name="aliyun-driverLicense"></a>
驾驶证识别
$app->aliyun->driverLicense($file, [
'side' => 'face', //驾驶证首页/副页:face/back
]);
<a name="aliyun-shopSign"></a>
门店识别
$app->aliyun->shopSign($file, [
]);
<a name="aliyun-english"></a>
英文识别
$app->aliyun->english($file, [
]);
<a name="aliyun-businessLicense"></a>
营业执照识别
$app->aliyun->businessLicense($file, [
]);
<a name="aliyun-bankCard"></a>
银行卡识别
$app->aliyun->bankCard($file, [
]);
<a name="aliyun-businessCard"></a>
名片识别
$app->aliyun->businessCard($file, [
]);
<a name="aliyun-trainTicket"></a>
火车票识别
$app->aliyun->trainTicket($file, [
]);
<a name="aliyun-vehiclePlate"></a>
车牌识别
$app->aliyun->vehiclePlate($file, [
'multi_crop' => false, //当设成true时,会做多crop预测，只有当多crop返回的结果一致，并且置信度>0.9时，才返回结果
]);
<a name="aliyun-general"></a>
通用文字识别
$app->aliyun->general($file, [
'min_size' => 16, //图片中文字的最小高度，
'output_prob' => false, //是否输出文字框的概率，
]);
<a name="tencent-ocr"></a>
Tencent OCR
use Godruoyi\OCR\Application;
$app = new Application([
'ocrs' => [
'tencent' => [
'app_id' => '1254032478',
'secret_id' => 'AKIDzODdB1nOELz0T8CEjTEkgKJOob3t2Tso',
'secret_key' => '6aHHkz236LOYu0nRuBwn5PwT0x3km7EL',
'bucket' => 'test1'
],
]
]);
Tencent OCR 暂不支持在线图片地址
<a name="tencent-namecard"></a>
名片识别
$app->tencent->namecard($file, [
'ret_image' => 0, //0 不返回图片，1 返回图片，
]);
<a name="tencent-idcard"></a>
身份证识别
$app->tencent->idcard($file, [
'card_type' => 0, //0 为身份证有照片的一面，1为身份证有国徽的一面
]);
<a name="tencent-drivingLicence"></a>
行驶证驾驶证识别
$app->tencent->drivingLicence($file, [
'type' => 0, //识别类型，0表示行驶证，1表示驾驶证，
]);
<a name="tencent-general"></a>
通用印刷体识别
$app->tencent->general($file, [
]);
