README

This is a PHP wrapper for zbar-tools - (only zbarimg at the moment). See http://zbar.sourceforge.net/.

Requirements

zbar-tools - To install on Ubuntu it's as easy as sudo apt-get install zbar-tools. See their project page for more platforms.
ImageMagick - It's required by Zbar, I'm not sure if they bundle it or not so make sure you have it

Installation

Install this package through Composer.

Add this to your composer.json dependencies:

"require": {
   "orlyapps/zbar-qrdecoder": "^2.0"
}

Run composer install to download the required files.

Usage

require_once('vendor/autoload.php');

$ZbarDecoder = new RobbieP\ZbarQrdecoder\ZbarDecoder();

# Optionally change the path of the zbarimg executable if you need to (default: /usr/bin)
$ZbarDecoder->setPath('/usr/local/bin');

# Decode the image
$result = $ZbarDecoder->make('/a/path/to/image_with_barcode.jpg');

echo $result; // Outputs the decoded text
echo $result->getFormat(); // Outputs the barcode's format
echo $result->getText(); // 200 if it decoded a barcode OR 400 if it couldn't find a barcode.

If you're using it in Laravel...

I've included a ServiceProvider class and a config if you need to change any options. Yyou need to add the ServiceProvider to config/app.php

'providers' => array(
    ...
    'RobbieP\ZbarQrdecoder\ZbarQrdecoderServiceProvider'
)

You may need to publish the config php artisan vendor:publish

Now you can use Zbar QR Decoder in your Laravel application!

Usage (in Laravel)

# Decode the image
$result = ZbarDecoder::make('/a/path/to/image_with_barcode.png');

echo $result; // Outputs the decoded text
echo $result->format; // Outputs the barcode's format

Other barcodes supported

EAN_13 / ISBN
CODE_39
CODE_128

Contributing

Fork it
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request

orlyapps / zbar-qrdecoder

Maintainers

Details