thiagoalessio/tesseract_ocr

A wrapper to work with Tesseract OCR inside PHP.

Tuesday, July 24, 2018
by thiagoalessio
Repository
100 Watchers
1311 Stars
344,248 Installations

PHP
5 Dependents
1 Suggesters
348 Forks
1 Open issues
38 Versions
7 % Grown

The README.md

Tesseract OCR for PHP

A wrapper to work with Tesseract OCR inside PHP., _(*1)

[][ci] ![Test Coverage][test_coverage_badge] br/ , _(*2)

Installation

Via Composer:, _(*3)

$ composer require thiagoalessio/tesseract_ocr

:bangbang: This library depends on Tesseract OCR, version 3.02 or later., _(*4)

br/, _(*5)

Note for Windows users

There are many ways to install Tesseract OCR on your system, but if you just want something quick to get up and running, I recommend installing the Capture2Text package with Chocolatey., _(*6)

choco install capture2text --version 3.9

:warning: Recent versions of Capture2Text stopped shipping the tesseract binary., _(*7)

br/, _(*8)

Note for macOS users

With MacPorts you can install support for individual languages, like so:, _(*9)

$ sudo port install tesseract-<langcode>

But that is not possible with Homebrew. It comes only with English support by default, so if you intend to use it for other language, the quickest solution is to install them all:, _(*10)

$ brew install tesseract tesseract-lang

br/, _(*11)

Usage

Basic usage

The quick brown fox jumps over the lazy dog. , _(*12)

use thiagoalessio\TesseractOCR\TesseractOCR;
echo (new TesseractOCR('text.png'))
    ->run();

The quick brown fox
jumps over
the lazy dog.

br/, _(*13)

Other languages

Bülowstraße , _(*14)

use thiagoalessio\TesseractOCR\TesseractOCR;
echo (new TesseractOCR('german.png'))
    ->lang('deu')
    ->run();

Bülowstraße

br/, _(*15)

Multiple languages

I eat すし y Pollo , _(*16)

use thiagoalessio\TesseractOCR\TesseractOCR;
echo (new TesseractOCR('mixed-languages.png'))
    ->lang('eng', 'jpn', 'spa')
    ->run();

I eat すし y Pollo

br/, _(*17)

Inducing recognition

8055 , _(*18)

use thiagoalessio\TesseractOCR\TesseractOCR;
echo (new TesseractOCR('8055.png'))
    ->allowlist(range('A', 'Z'))
    ->run();

BOSS

br/, _(*19)

Breaking CAPTCHAs

Yes, I know some of you might want to use this library for the noble purpose of breaking CAPTCHAs, so please take a look at this comment:, _(*20)

https://github.com/thiagoalessio/tesseract-ocr-for-php/issues/91#issuecomment-342290510, _(*21)

API

run

Executes a tesseract command, optionally receiving an integer as timeout, in case you experience stalled tesseract processes., _(*22)

$ocr = new TesseractOCR();
$ocr->run();

```php $ocr = new TesseractOCR(); $timeout = 500; $ocr->run($timeout);, _(*23)


### image

Define the path of an image to be recognized by `tesseract`.

```php
$ocr = new TesseractOCR();
$ocr->image('/path/to/image.png');
$ocr->run();

imageData

Set the image to be recognized by tesseract from a string, with its size. This can be useful when dealing with files that are already loaded in memory. You can easily retrieve the image data and size of an image object :, _(*24)

//Using Imagick
$data = $img->getImageBlob();
$size = $img->getImageLength();
//Using GD
ob_start();
// Note that you can use any format supported by tesseract
imagepng($img, null, 0);
$size = ob_get_length();
$data = ob_get_clean();

$ocr = new TesseractOCR();
$ocr->imageData($data, $size);
$ocr->run();

executable

Define a custom location of the tesseract executable, if by any reason it is not present in the $PATH., _(*25)

echo (new TesseractOCR('img.png'))
    ->executable('/path/to/tesseract')
    ->run();

version

Returns the current version of tesseract., _(*26)

echo (new TesseractOCR())->version();

availableLanguages

Returns a list of available languages/scripts., _(*27)

foreach((new TesseractOCR())->availableLanguages() as $lang) echo $lang;

More info: https://github.com/tesseract-ocr/tesseract/blob/master/doc/tesseract.1.asc#languages-and-scripts, _(*28)

tessdataDir

Specify a custom location for the tessdata directory., _(*29)

echo (new TesseractOCR('img.png'))
    ->tessdataDir('/path')
    ->run();

userWords

Specify the location of user words file., _(*30)

This is a plain text file containing a list of words that you want to be considered as a normal dictionary words by tesseract., _(*31)

Useful when dealing with contents that contain technical terminology, jargon, etc., _(*32)

$ cat /path/to/user-words.txt
foo
bar

echo (new TesseractOCR('img.png'))
    ->userWords('/path/to/user-words.txt')
    ->run();

userPatterns

Specify the location of user patterns file., _(*33)

If the contents you are dealing with have known patterns, this option can help a lot tesseract's recognition accuracy., _(*34)

$ cat /path/to/user-patterns.txt'
1-\d\d\d-GOOG-441
www.\n\\\*.com

echo (new TesseractOCR('img.png'))
    ->userPatterns('/path/to/user-patterns.txt')
    ->run();

lang

Define one or more languages to be used during the recognition. A complete list of available languages can be found at: https://github.com/tesseract-ocr/tesseract/blob/master/doc/tesseract.1.asc#languages, _(*35)

Tip from @daijiale: Use the combination ->lang('chi_sim', 'chi_tra') for proper recognition of Chinese., _(*36)

 echo (new TesseractOCR('img.png'))
     ->lang('lang1', 'lang2', 'lang3')
     ->run();

psm

Specify the Page Segmentation Method, which instructs tesseract how to interpret the given image., _(*37)

More info: https://github.com/tesseract-ocr/tesseract/wiki/ImproveQuality#page-segmentation-method, _(*38)

echo (new TesseractOCR('img.png'))
    ->psm(6)
    ->run();

oem

Specify the OCR Engine Mode. (see tesseract --help-oem), _(*39)

echo (new TesseractOCR('img.png'))
    ->oem(2)
    ->run();

dpi

Specify the image DPI. It is useful if your image does not contain this information in its metadata., _(*40)

echo (new TesseractOCR('img.png'))
    ->dpi(300)
    ->run();

allowlist

This is a shortcut for ->config('tessedit_char_whitelist', 'abcdef....')., _(*41)

echo (new TesseractOCR('img.png'))
    ->allowlist(range('a', 'z'), range(0, 9), '-_@')
    ->run();

configFile

Specify a config file to be used. It can either be the path to your own config file or the name of one of the predefined config files: https://github.com/tesseract-ocr/tesseract/tree/master/tessdata/configs, _(*42)

echo (new TesseractOCR('img.png'))
    ->configFile('hocr')
    ->run();

setOutputFile

Specify an Outputfile to be used. Be aware: If you set an outputfile then the option withoutTempFiles is ignored. Tempfiles are written (and deleted) even if withoutTempFiles = true., _(*43)

In combination with configFile you are able to get the hocr, tsv or pdf files., _(*44)

echo (new TesseractOCR('img.png'))
    ->configFile('pdf')
    ->setOutputFile('/PATH_TO_MY_OUTPUTFILE/searchable.pdf')
    ->run();

digits

Shortcut for ->configFile('digits')., _(*45)

echo (new TesseractOCR('img.png'))
    ->digits()
    ->run();

hocr

Shortcut for ->configFile('hocr')., _(*46)

echo (new TesseractOCR('img.png'))
    ->hocr()
    ->run();

pdf

Shortcut for ->configFile('pdf')., _(*47)

echo (new TesseractOCR('img.png'))
    ->pdf()
    ->run();

quiet

Shortcut for ->configFile('quiet')., _(*48)

echo (new TesseractOCR('img.png'))
    ->quiet()
    ->run();

tsv

Shortcut for ->configFile('tsv')., _(*49)

echo (new TesseractOCR('img.png'))
    ->tsv()
    ->run();

txt

Shortcut for ->configFile('txt')., _(*50)

echo (new TesseractOCR('img.png'))
    ->txt()
    ->run();

tempDir

Define a custom directory to store temporary files generated by tesseract. Make sure the directory actually exists and the user running php is allowed to write in there., _(*51)

echo (new TesseractOCR('img.png'))
    ->tempDir('./my/custom/temp/dir')
    ->run();

withoutTempFiles

Specify that tesseract should output the recognized text without writing to temporary files. The data is gathered from the standard output of tesseract instead., _(*52)

echo (new TesseractOCR('img.png'))
    ->withoutTempFiles()
    ->run();

Other options

Any configuration option offered by Tesseract can be used like that:, _(*53)

echo (new TesseractOCR('img.png'))
    ->config('config_var', 'value')
    ->config('other_config_var', 'other value')
    ->run();

Or like that:, _(*54)

echo (new TesseractOCR('img.png'))
    ->configVar('value')
    ->otherConfigVar('other value')
    ->run();

More info: https://github.com/tesseract-ocr/tesseract/wiki/ControlParams, _(*55)

Thread-limit

Sometimes, it may be useful to limit the number of threads that tesseract is allowed to use (e.g. in this case). Set the maxmium number of threads as param for the run function:, _(*56)

echo (new TesseractOCR('img.png'))
    ->threadLimit(1)
    ->run();

How to contribute

You can contribute to this project by:, _(*57)

Opening an Issue if you found a bug or wish to propose a new feature;
Placing a Pull Request with code that fix a bug, missing/wrong documentation or implement a new feature;

Just make sure you take a look at our Code of Conduct and Contributing instructions., _(*58)

License

tesseract-ocr-for-php is released under the MIT License., _(*59)

_{Made with in Berlin}, _(*60)

The Versions

24/07 2018

dev-master

9999999-dev

A wrapper to work with Tesseract OCR inside PHP.

library tesseract_ocr

A wrapper to work with Tesseract OCR inside PHP.

thiagoalessio/tesseract_ocr

The README.md

Tesseract OCR for PHP

Installation

Note for Windows users

Note for macOS users

Usage

Basic usage

Other languages

Multiple languages

Inducing recognition

Breaking CAPTCHAs

API

run

imageData

executable

version

availableLanguages

tessdataDir

userWords

userPatterns

lang

psm

oem

dpi

allowlist

configFile

setOutputFile

digits

hocr

pdf

quiet

tsv

txt

tempDir

withoutTempFiles

Other options

Thread-limit

How to contribute

License

The Versions

dev-master

The Requires

The Development Requires

by thiagoalessio

by Thiago Alessio Pereira

2.6.3

The Requires

The Development Requires

by thiagoalessio

dev-issue-138

The Requires

The Development Requires

by thiagoalessio

dev-issue-139

The Requires

The Development Requires

by thiagoalessio

2.6.2

The Requires

The Development Requires

by thiagoalessio

2.6.1

The Requires

The Development Requires

by thiagoalessio

2.6.0

The Requires

The Development Requires

by thiagoalessio

2.5.0

The Requires

The Development Requires

by thiagoalessio

2.4.0

The Requires

The Development Requires

by thiagoalessio