crazy-goat/qrcode-ext

Native PHP extension backing crazy-goat/scanmephp — the C++ QR encoder behind NativeEncoder

v0.5.2 2026-08-26 04:31 UTC

Requires

• php: >=8.2

Suggests

• crazy-goat/scanmephp: The PHP API this extension accelerates; on its own the extension exposes only NativeEncoderCore, which builds a CrazyGoat\ScanMePHP\Matrix and therefore needs the library loaded

MIT

• generator
• extension
• barcode
• qrcode
• qr
• simd

Published on Packagist.org on 2026-08-26 04:31 UTC

Extension name: ext-scanmeqr

Supports Zend Thread Safety (ZTS): ✅

Supports non-Thread Safe mode (NTS): ✅

Supported operating systems: bsd, darwin, solaris, linux, unknown

Configure flags:

• --with-scanmeqr-clib=<value> Directory holding the C++ core as src/ and include/. Only meaningful when building from a ScanMePHP checkout; this package carries the sources and ignores it.

README

The native QR encoder behind ScanMePHP, installable with PIE. Extension version 0.5.2.

This repository is generated. The sources live in crazy-goat/ScanMePHP under php-ext/ and clib/, and every release overwrites this mirror with a single commit — issues and pull requests belong there.

Installing

composer require crazy-goat/scanmephp
pie install crazy-goat/qrcode-ext

Both halves are needed. The extension exposes a single internal class, CrazyGoat\ScanMePHP\NativeEncoderCore, and its encodeMatrix() builds a CrazyGoat\ScanMePHP\Matrix — so without the library loaded it can only throw. The library in turn detects the extension and routes NativeEncoder through it automatically; with neither the extension nor an FFI binary present it falls back to the pure-PHP encoder, so installation is an optimisation and never a requirement.

Building needs a C++20 compiler (GCC 10+ / Clang 12+) and takes a few seconds. There is nothing else to install: the C++ core is compiled into the extension rather than linked against a separate shared library.

What you get

The encoder runs about 10× faster than the pure-PHP path. On x86-64 the mask-penalty pass is built three times over — a portable kernel plus AVX2 and AVX-512 variants — and the right one is chosen at load time from the CPU's own feature bits, so one binary stays correct on any machine that can run it. arm64 gets the portable kernel, which the compiler vectorises to NEON.

Prebuilt binaries for the common platforms are attached to every ScanMePHP release if you would rather not compile at all.

MIT.