README

A PHP QR Code generator based on the implementation by Kazuhiko Arase, namespaced, cleaned up, improved and other stuff.
It also features a QR Code reader based on a PHP port of the ZXing library.

Hi! Please check out the v5.0-beta release and leave your feedback in this discussion thread. Thanks!

Attention: there is now also a javascript port: chillerlan/js-qrcode.

Overview

Features

Creation of Model 2 QR Codes, Version 1 to 40
ECC Levels L/M/Q/H supported
Mixed mode support (encoding modes can be combined within a QR symbol). Supported modes:
- numeric
- alphanumeric
- 8-bit binary
- 13-bit double-byte:
  - kanji (Japanese, Shift-JIS)
  - hanzi (simplified Chinese, GB2312/GB18030) as defined in GBT18284-2000
Flexible, easily extensible output modules, built-in support for the following output formats:
- GdImage
- ImageMagick
- Markup types: SVG, HTML, etc.
- String types: JSON, plain text, etc.
- Encapsulated Postscript (EPS)
- PDF via FPDF
QR Code reader (via GD and ImageMagick)

Requirements

PHP 7.4+
- ext-mbstring
- optional:
  - ext-fileinfo (required by QRImagick output)
  - ext-gd
  - ext-imagick with ImageMagick installed
  - setasign/fpdf for the PDF output module

For the QRCode reader, either ext-gd or ext-imagick is required!

Documentation

The user manual is at https://php-qrcode.readthedocs.io/ (sources)
An API documentation created with phpDocumentor can be found at https://chillerlan.github.io/php-qrcode/
The documentation for QROptions container can be found here: chillerlan/php-settings-container

Installation with composer

See the installation guide for more info!

Terminal

composer require chillerlan/php-qrcode

composer.json

{
	"require": {
		"php": "^7.4 || ^8.0",
		"chillerlan/php-qrcode": "dev-main#<commit_hash>"
	}
}

Note: replace dev-main with a version constraint, e.g. ^4.3 - see releases for valid versions.

Quickstart

We want to encode this URI for a mobile authenticator into a QRcode image:

$data = 'otpauth://totp/test?secret=B3JX4VCVJDVNXNZ5&issuer=chillerlan.net';

// quick and simple:
echo '<img src="'.(new QRCode)->render($data).'" alt="QR Code" />';

Wait, what was that? Please again, slower! See Advanced usage in the manual. Also, have a look in the examples folder for some more usage examples.

Reading QR Codes

Using the built-in QR Code reader is pretty straight-forward:

// it's generally a good idea to wrap the reader in a try/catch block because it WILL throw eventually
try{
	$result = (new QRCode)->readFromFile('path/to/file.png'); // -> DecoderResult

	// you can now use the result instance...
	$content = $result->data;
	$matrix  = $result->getMatrix(); // -> QRMatrix

	// ...or simply cast it to string to get the content:
	$content = (string)$result;
}
catch(Throwable $e){
	// oopsies!
}

Shameless advertising

Hi, please check out some of my other projects that are way cooler than qrcodes!

js-qrcode - a javascript port of this library
php-authenticator - a Google Authenticator implementation (see authenticator example)
php-httpinterface - a PSR-7/15/17/18 implemetation
php-oauth-core - an OAuth 1/2 client library along with a bunch of providers
php-database - a database client & querybuilder for MySQL, Postgres, SQLite, MSSQL, Firebird
php-tootbot - a Mastodon bot library (see @dwil)

Disclaimer!

I don't take responsibility for molten CPUs, misled applications, failed log-ins etc.. Use at your own risk!

License notice

Parts of this code are ported to PHP from the ZXing project and licensed under the Apache License, Version 2.0.
The documentation is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) License.

Trademark Notice

The word "QR Code" is a registered trademark of DENSO WAVE INCORPORATED
https://www.qrcode.com/en/faq.html#patentH2Title

chillerlan / php-qrcode

Maintainers

Details

Add Maintainer

Remove Maintainer