php-qrcode

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.

Attention: there is now also a javascript port on NPM: @chillerlan/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
    • ECI support
  • 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 (raster graphics: avif, bmp, gif, jpeg, png, webp)
  • ImageMagick (multiple supported image formats)
  • 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 8.4+
  • ext-mbstring
  • optional:
    • ext-gd for QRGdImage based output
    • ext-imagick with ImageMagick installed
    • ext-fileinfo required by QRImagick output
    • setasign/fpdf for the PDF output module
    • intervention/image for alternative GD/ImageMagick output

For the QR Code 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 the QROptions container is here: chillerlan/php-settings-container
• Benchmark results can be found in the benchmark branch

Important: Please use the examples from the branch that matches your installed php-qrcode version ( v5.x, v6.x, dev-main )!
The main (default) branch is the active development for future major versions, and it is most likely incompatible with the latest release versions.

Installation with composer

See the installation guide for more info!

Terminal

composer require chillerlan/php-qrcode

composer.json

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

Note: replace dev-main with a version constraint, e.g. ^6.0 - 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 '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.

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

Anti clanker clause

If your issue reports and pull requests are LLM generated, keep them. I'll prefer to keep my bugs then. I don't want anything to do with the water guzzling, air polluting, brain cooking, confidently lying fascist plagiarism machines. Use your human brain and hands instead.