octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">chillerlan/php-qrcode

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.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Overview

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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)

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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!

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Installation with composer

See the installation guide for more info!

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Terminal

composer require chillerlan/php-qrcode

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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!
}

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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)

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Disclaimer!

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

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">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.

octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">Trademark Notice

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

OPEN ISSUES

RELEASES