Biblioteca PHP open sourceQR Code Generator

QR Codes com a cara da marca.

Biblioteca PHP para gerar QR Codes personalizados: formatos de módulo, marcadores de canto, logo central e saída em SVG, PNG, JPEG ou WebP.

Testar a demonstração Código-fonte

Ano: 2026
Papel: Arquitetura, implementação, testes, documentação e página de demonstração.
Stack: PHP 8.1+
SVG
GD
PHPUnit

O problema

As bibliotecas PHP de QR Code resolvem bem a codificação, mas quase não permitem controlar o visual. Quem precisa de um QR Code com a identidade da marca acaba recorrendo a ferramentas em JavaScript ou serviços externos.

Em números

5formatos de módulo prontos, além de formas próprias
4formatos de saída: SVG, PNG, JPEG e WebP
7camadas, da codificação à validação
0JavaScript necessário para estilizar

O que foi construído

A codificação fica com o bacon/bacon-qr-code; toda a parte visual (layout, formas, estilo e renderização) é da própria biblioteca, em camadas separadas.
Formatos quadrado, círculo, arredondado, losango e “classy rounded”, que analisa os módulos vizinhos para desenhar cantos contínuos.
Formas personalizadas via closure que retorna um path SVG, com validação de legibilidade.
Estilo independente para marcadores de canto, centros e cada tipo de módulo.
Logo central com área de respiro reservada e rejeição de tamanhos que comprometeriam a leitura.
Otimizador de path SVG, API fluente, factory e uma CLI de exemplo.

Na prática

<?php

use Tonsoo\QrCode\Styling\ModuleStyle;

$svg = qrCode('https://alysson-thoaldo.com.br')
    ->size(640)
    ->margin(32)
    ->foreground('#0f766e')
    ->modules(ModuleStyle::classyRounded(1.0))
    ->toSvg();

Telas

Gerador online: cada ajuste é renderizado pela biblioteca no servidor.

Resultado

Gera no servidor, em PHP puro, o mesmo tipo de QR Code estilizado que antes exigia JavaScript no navegador. Disponível no Packagist e com um gerador online para testar.