php-qrcode

codemasher/php-qrcode

Info

This library is based on the QR code implementation by Kazuhiko Arase, namespaced, cleaned up, made extensible and PHP7 ready (among other stuff). The main intend is to use it along with a Google authenticator implementation.

Requirements

• PHP 5.6+, PHP 7

Documentation

Installation

Using composer

Terminal

composer require chillerlan/php-qrcode:dev-master

composer.json

{
	"require": {
		"php": ">=5.6.0",
		"chillerlan/php-qrcode": "dev-master"
	}
}

Manual installation

Download the desired version of the package from master or release and extract the contents to your project folder. Point the namespace chillerlan\QRCode to the folder src of the package.

Profit!

Usage

We want to encode this data into a QRcode image:

// 10 reasons why QR codes are awesome
$data = 'https://www.youtube.com/watch?v=DLzxrzFCyOs&t=43s';

// no, for serious, we want to display a QR code for a mobile authenticator
// https://github.com/codemasher/php-googleauth
$data = 'otpauth://totp/test?secret=B3JX4VCVJDVNXNZ5&issuer=chillerlan.net';

Quick and simple:

echo '<img src="'.(new QRCode($data, new QRImage))->output().'" />';

Wait, what was that? Please again, slower!

Advanced usage

Ok, step by step. You'll need a QRCode instance which needs to be invoked with the data and a Output\QROutputInterface as parameters.

// the built-in QROutputInterface classes
$outputInterface = new QRImage;
$outputInterface = new QRString;

// invoke a fresh QRCode instance
$qrcode = new QRCode($data, $outputInterface);

// and dump the output
$qrcode->output();

Have a look in this folder for some usage examples.

The QRCode and built-in QROutputInterface classes can be optionally invoked with a QROptions or a Output\QR...Options Object respectively.

// image -> QRImageOptions
$outputOptions = new QRImageOptions;
$outputOptions->type = QRCode::OUTPUT_IMAGE_GIF;
$outputInterface = new QRImage($outputOptions);

// string -> QRStringOptions
$outputOptions = new QRStringOptions;
$outputOptions->type = QRCode::OUTPUT_STRING_HTML;
$outputInterface = new QRString($outputOptions);

// QROptions
$qrOptions = new QROptions;
$qrOptions->errorCorrectLevel = QRCode::ERROR_CORRECT_LEVEL_L;

$qrcode = new QRCode($data, $outputInterface, $qrOptions);

You can reuse the QRCode object once created in case you don't need to change the output, and use the QRCode::setData() method instead.

$qrcode->setData($data);
$qrcode->setData($data, $qrOptions);

$qrcode->output();

In case you only want the raw array which represents the QR code matrix, just call QRCode::getRawData() - this method is also called internally from QRCode::output().

$matrix = $qrcode->getRawData();

foreach($matrix as $row){
	foreach($row as $dark){
		if($dark){
			// do stuff
		}
		else{
			// do other stuff
		}
	}
}

Custom output modules

But then again, instead of bloating your own code, you can simply create your own output module by extending QROutputAbstract.

$qrcode = new QRCode($data, new MyCustomOutput($myCustomOutputOptions), $qrOptions)

class MyCustomOutput extends QROutputAbstract{
	
	// inherited from QROutputAbstract
	protected $matrix; // array
	protected $pixelCount; // int
	protected $options; // MyCustomOutputOptions (if present)
	
	// optional constructor
	public function __construct(MyCustomOutputOptions $outputOptions = null){
		$this->options = $outputOptions;

		if(!$this->options){
			// MyCustomOutputOptions should supply default values
			$this->options = new MyCustomOutputOptions;
		}

	}

	public function dump(){
	
		$output = '';

		for($row = 0; $row < $this->pixelCount; $row++){
			for($col = 0; $col < $this->pixelCount; $col++){
				$output .= (string)(int)$this->matrix[$row][$col];
			}
		}

		return $output;
	}

}

QRCode public methods

method	return
__construct($data, QROutputInterface $output, QROptions $options = null)	-
setData($data, QROptions $options = null)	$this
output()	mixed QROutputInterface::dump()
getRawData()	array QRCode::$matrix

Properties of QROptions

property	type	default	allowed	description
$errorCorrectLevel	int	M	QRCode::ERROR_CORRECT_LEVEL_X	X = L, M, Q, H 7%, 15%, 25%, 30%
$typeNumber	int	null	QRCode::TYPE_XX	XX = 01 ... 10, null = auto

Properties of QRStringOptions

property	type	default	allowed	description
$type	int	HTML	QRCode::OUTPUT_STRING_XXXX	XXXX = TEXT, JSON, HTML
$textDark	string	'#'	*	string substitute for dark
$textLight	string	' '	*	string substitute for light
$textNewline	string	PHP_EOL	*	newline string
$htmlRowTag	string	'p'	*	the shortest available semanically correct row (block) tag to not bloat the output
$htmlOmitEndTag	bool	true	-	the closing tag may be omitted (moar bloat!)

Properties of QRImageOptions

property	type	default	allowed	description
$type	string	PNG	QRCode::OUTPUT_IMAGE_XXX	XXX = PNG, JPG, GIF, SVG
$base64	bool	true	-	wether to return the image data as base64 or raw like from file_get_contents()
$cachefile	string	null	*	optional cache file path, null returns the image data
$pixelSize	int	5	1 ... 25	size of a QR code pixel (25 is HUGE!)
$marginSize	int	5	0 ... 25	margin around the QR code
$transparent	bool	true	-	toggle transparency (no jpeg support)
$fgRed	int	0	0 ... 255	foreground red
$fgGreen	int	0	0 ... 255	foreground green
$fgBlue	int	0	0 ... 255	foreground blue
$bgRed	int	255	0 ... 255	background red
$bgGreen	int	255	0 ... 255	background green
$bgBlue	int	255	0 ... 255	background blue
$pngCompression	int	-1	-1 ... 9	imagepng() compression level, -1 = auto
$jpegQuality	int	85	0 - 100	imagejpeg() quality