chillerlan PHP-QRCode Manual

User manual for chillerlan/php-qrcode [stable]. Updated on Mar 30, 2026.

The phpDocumentor API documentation can be found at chillerlan.github.io/php-qrcode.

This work is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) License.

Usage

• Overview
  • Features
  • Requirements
  • Framework Integration
  • Shameless advertising
• Installation
  • Installation with Composer
    • composer.json
    • Terminal
  • Manual installation
    • Can I use this library without using composer?
  • Supported PHP versions & extension requirements
  • ImageMagick
• Quickstart
  • Import the library
  • Create your first QR Code
    • Configuration
  • Notes
• Advanced usage
  • Configuration via QROptions
    • Supply an iterable of options
    • Load and save options from/to JSON
    • Extending the QROptions class
  • QRCode methods
    • Render a QRMatrix instance
    • Mixed mode
  • Common output options
    • Save to file
    • Base64 URI output
    • Return the image resource
• Configuration settings
  • version
  • versionMin
  • versionMax
  • eccLevel
  • maskPattern
  • addQuietzone
  • quietzoneSize
  • outputInterface
  • returnResource
  • cachefile
  • outputBase64
  • eol
  • bgColor
  • invertMatrix
  • drawLightModules
  • drawCircularModules
  • circleRadius
  • keepAsSquare
  • connectPaths
  • excludeFromConnect
  • moduleValues
  • addLogoSpace
  • logoSpaceWidth
  • logoSpaceHeight
  • logoSpaceStartX
  • logoSpaceStartY
  • scale
  • imageTransparent
  • transparencyColor
  • quality
  • gdImageUseUpscale
  • imagickFormat
  • cssClass
  • svgAddXmlHeader
  • svgDefs
  • svgPreserveAspectRatio
  • svgUseFillAttributes
  • textLineStart
  • jsonFlags
  • fpdfMeasureUnit
  • xmlStylesheet
  • readerUseImagickIfAvailable
  • readerGrayscale
  • readerInvertColors
  • readerIncreaseContrast
• Reading QR Codes
  • Basic usage
  • The LuminanceSourceInterface
  • The Decoder
  • General considerations
• Logos and logo space
  • Info
  • Adding a logo space

Customizing output

• Module values
  • Basics
  • Assigning values
  • Handling in your own QROutputInterface
    • Setting module values
    • Using the module values
• QROutputAbstract
  • Properties
    • $options and $matrix
    • $moduleCount, $scale and $length
    • $moduleValues
    • Copies of QROptions values
  • Methods
    • setModuleValues()
    • moduleValueIsValid()
    • prepareModuleValue()
    • getDefaultModuleValue()
    • getModuleValue() and getModuleValueAt()
    • setMatrixDimensions()
    • getOutputDimensions()
    • collectModules()
    • saveToFile() and toBase64DataURI()
• Custom QROutputInterface
  • Class skeleton
  • Module values
  • Transform the output
  • Run the custom output
  • Summary

Built-In Output Classes

• QREps
  • Example
  • Additional methods
  • Options that affect this class
• QRFpdf
  • Example
  • Additional methods
  • Options that affect this class
• QRGdImage
  • Example
  • Additional methods
  • Options that affect this class
• QRImagick
  • Example
  • Additional methods
  • Options that affect this class
• QRInterventionImage
  • Example
  • Additional methods
  • Options that affect this class
• QRMarkupHTML
  • Example
  • Additional methods
  • Options that affect this class
• QRMarkupSVG
  • Example
  • Additional methods
  • Options that affect this class
• QRMarkupXML
  • Example
  • Additional methods
  • Options that affect this class
• QRStringJSON
  • Example
  • Previous functionality
  • Additional methods
  • Options that affect this class
• QRStringText
  • Example
  • Additional methods
  • Options that affect this class

Appendix

• Terminology
  • QR Code
  • Matrix
    • Module
    • Version
  • Function Patterns
    • Finder Pattern
    • Alignment Pattern
    • Timing Pattern
    • Separators
    • Quiet Zone
  • Encoding Region
    • Data
    • Version Information
    • Format Information
    • Darkmodule
  • Mode
    • Segment
    • Extended Channel Interpretation (ECI)
    • Mixed Mode
  • ECC (Error Correction Coding)
    • ECC Level
    • Maximum data capacity
  • Data masking
    • Evaluation
    • Mask pattern
  • Reflectance
• Popular content and URI schemes
  • URL https
  • E-Mail mailto
  • Phone numbers tel
  • Geo Coordinates geo
  • Mobile Authenticators otpauth
  • Wireless Network configuration
  • Contact information: vCard
  • Calendar Events: vCalendar and iCalendar
  • Credit Transfer
    • SEPA (European Payments Council)
    • Pix (Banco Central do Brasil)
  • See also
• Performance considerations
  • Version
  • Ecc level
  • Data mode
  • Mask pattern
  • Output
• How to contribute
  • Questions and issues
  • Bug reports
  • Pull requests and bug fixes
  • Documentation
• License