PHPackages                             doododo/ocr - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. doododo/ocr

ActiveLibrary[Image & Media](/categories/media)

doododo/ocr
===========

ocr is a package for can be OCR image

1.0.0(6y ago)5772MITPHPPHP >=7.1

Since Dec 7Pushed 4y ago2 watchersCompare

[ Source](https://github.com/doododo/ocr)[ Packagist](https://packagist.org/packages/doododo/ocr)[ RSS](/packages/doododo-ocr/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (2)Used By (0)

Tencent AI image OCR
====================

[](#tencent-ai-image-ocr)

支持
==

[](#支持)

- [身份证识别](#id-card)
- [行驶证/驾驶证识别](#driver-license)
- [通用识别](#generic)
- [营业执照识别](#business-license)
- [银行卡识别](#credit-card)
- [手写体识别](#handwrite)
- [车牌识别](#plate-license)
- [名片识别](#business-card)

环境需求
====

[](#环境需求)

- PHP > 7.1
- [composer](https://getcomposer.org/)

安装
==

[](#安装)

```
composer require doododo/ocr
```

使用
==

[](#使用)

> 注册 [腾讯 AI 控制台](https://ai.qq.com) 后，可得到[APP\_ID 及 APP\_KEY](https://ai.qq.com/console/home)

基本使用
----

[](#基本使用)

**$image 参数支持**

- 文件路径（绝对路径）
- `SplFileInfo` 对象
- 在线图片地址

```
$ocr = new \Doododo\OCR\OCR([
    'app_id' => 'xxxx',
    'app_key' => 'xxxx'
]);

$ocr->idCard($image); // 注意绝对路径或URL
```

Laravel 使用
----------

[](#laravel-使用)

```
# 1. 创建 `ocr.php` 文件

return [
    'app_id' => 'xxxx',
    'app_key' => 'xxxx'
];

# 2. 修改 `AppServiceProvider.php` 的 `boot()` 添加
use Doododo\OCR\OCR;

$this->app->singleton(OCR::class, function () {
    return new OCR(config('ocr'));
});

$this->app->alias(OCR::class, 'ocr');

# 3. 使用
$ocr = app('ocr');
$ocr->idCard($image); // 注意绝对路径或URL
```

文档
==

[](#文档)

身份证识别
-----

[](#身份证识别)

```
// 身份证正面
$ocr->idCard($image);
// 身份证反面
$ocr->idCard($image, 1);
```

返回值（Array）

参数名称描述name姓名sex性别nation民族birth出生日期address住址id身份证号码authority发证机关valid\_date身份证有效期eg.

```
{
    "name": "艾米",
    "sex": "女",
    "nation": "汉",
    "birth": "1986/4/23",
    "address": "上海徐汇区田林路397号腾云大厦6F",
    "id": "310104198604230289",
    "authority": "",
    "valid_date": ""
}
```

行驶证/驾驶证识别
---------

[](#行驶证驾驶证识别)

```
// 行驶证
$ocr->driverLicense($image);
// 驾驶证
$ocr->driverLicense($image, 1);
```

行驶证返回值（Array）

参数名称描述plate\_no车牌号码owner所有人address住址use\_character使用性质model品牌型号vin识别代码engine\_no发动机号register\_date注册日期issue\_date发证日期stamp红章eg.

```
{
    "plate_no": "沪AA1234",
    "owner": "李明",
    "address": "上海市徐汇区田林路397号腾云大厦6F",
    "use_character": "非营运",
    "model": "大众汽车牌G4SVW71612RS",
    "vin": "ABCDEFGH123456789",
    "engine_no": "8B54321",
    "register_date": "2011-10-10",
    "issue_date": "2011-10-10",
    "stamp": "上海市公安局交通警察总队"
}
```

驾照返回值（Array）

参数名称描述driver\_no证号name姓名sex性别nationality国籍address住址brithday出生日期issue\_date领证日期class准驾车型start\_date起始日期end\_date有效日期stamp红章eg.

```
{
    "driver_no": "610333199012213125",
    "name": "艾米",
    "sex": "女",
    "nationality": "中国",
    "address": "深圳市南山区高新科技园科技中一路腾讯大厦",
    "brithday": "1990-12-21",
    "issue_date": "2015-01-01",
    "class": "C1",
    "start_date": "2015-01-01",
    "end_date": "2021-01-01",
    "stamp": "广东省深圳市公安局交通警察支队"
}
```

通用识别
----

[](#通用识别)

```
$ocr->generic('https://cdn.ai.qq.com/aiplat/static/ai-demo/large/o-1.jpg');
```

返回值（Array）

eg.

```
[
    "夏天的飞鸟，飞到我窗前唱歌，又飞去了。",
    "秋天的黄叶，它们没有什么可唱，只叹息一声，飞落在那里。",
    "Stray birds of summer come to my window to sing and fly away.",
    "And yellow leaves of autumn, which have no songs, futter and fall there with a sign.",
    "飞鸟集",
    "STRAY",
    "BIRDS"
]
```

营业执照识别
------

[](#营业执照识别)

```
$ocr->businessLicense('https://cdn.ai.qq.com/aiplat/static/ai-demo/large/odemo-pic-5.jpg');
```

返回值（Array）

参数名称描述card\_no注册号card\_type法定代表人card\_name公司名称bank地址card\_time营业期限eg.

```
{
    "business_license": "91440300708461136T",
    "legal_person": "马化腾",
    "company_code": "深圳市腾讯计算机系统有限公司",
    "company_address": "深圳市南山区深南大道10000号",
    "business_time": "1998年11月11日至长期"
}
```

银行卡识别
-----

[](#银行卡识别)

```
$ocr->businessLicense('https://cdn.ai.qq.com/aiplat/static/ai-demo/large/odemo-pic-5.jpg');
```

返回值（Array）

参数名称描述card\_no卡号card\_type卡类型card\_name卡名字bank银行信息card\_time有效期eg.

```
{
    "card_no": "6225760088888888",
    "card_type": "贷记卡",
    "card_name": "招商银行信用卡",
    "bank": "招商银行(03080000)",
    "card_time": "08/2022"
}
```

手写体识别
-----

[](#手写体识别)

```
$ocr->handwrite('https://cdn.ai.qq.com/ai/assets/ai-demo/large/hd-5-lg.jpg');
```

返回值（Array）

eg.

```
[
    "这个忧伤而明",
    "媚的三月，从我单",
    "薄的青春里打马",
    "而过，穿过紫堇穿",
    "过木棉。穿过时",
    "隐时现的悲喜和",
    "无常"
]
```

车牌识别
----

[](#车牌识别)

```
$ocr->plateLicense('https://cdn.ai.qq.com/ai/assets/ai-demo/large/plate-1-lg.jpg')
```

返回值（Array）

参数名称描述plate\_no车牌号eg.

```
{
    "plate_no": "京N0L9U8"
}
```

名片识别
----

[](#名片识别)

```
$ocr->businessCard('https://cdn.ai.qq.com/aiplat/static/ai-demo/large/odemo-pic-2.jpg');
```

返回值（Array）

参数名称描述name姓名position职位company公司address地址email邮箱mobile手机wechat微信eg.

```
{
    "name": "李明",
    "position": "产品经理",
    "company": "Tencent腾讯",
    "address": "深圳市南山区深南大道10000号腾讯大厦",
    "email": "8888asss@tencent.com",
    "mobile": "13888882222",
    "wechat": "limig"
}
```

MIT

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2399d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/962d447216dc4939bc8f381d95af28bbba60482689d49df6c9ed15d520727c5b?d=identicon)[saybye720](/maintainers/saybye720)

---

Top Contributors

[![doododo](https://avatars.githubusercontent.com/u/3202625?v=4)](https://github.com/doododo "doododo (2 commits)")[![botaoxuri](https://avatars.githubusercontent.com/u/76640216?v=4)](https://github.com/botaoxuri "botaoxuri (1 commits)")

---

Tags

imageOCRID Cardbusiness cardBusiness License

### Embed Badge

![Health badge](/badges/doododo-ocr/health.svg)

```
[![Health](https://phpackages.com/badges/doododo-ocr/health.svg)](https://phpackages.com/packages/doododo-ocr)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[alimranahmed/laraocr

Laravel Optical Character Reader(OCR) package using different OCR engines like Tesseract

17186.9k](/packages/alimranahmed-laraocr)[mohuishou/image-ocr

验证码识别

2722.9k1](/packages/mohuishou-image-ocr)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

252.5k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)