Download HeroQR - Download do código-fonte HeroQR

HeroQR

Outras categorias

v1.0.3

Baixar

Biblioteca HeroQR

HeroQR é uma biblioteca PHP avançada e modular projetada para simplificar a criação, personalização e gerenciamento de códigos QR. Se você precisa de um código QR básico ou altamente personalizado com logotipos e cores incorporados, HeroQR tem o que você precisa.

Características

Personalização incomparável:
- Ajuste o tamanho do logotipo e adicione logotipos ao código QR.
- Adicione etiquetas com cor, tamanho, alinhamento de texto e margem personalizáveis.
- Suporte para vários formatos de codificação, como UTF-8 e outros formatos padrão.
- Altere a cor do código QR junto com a cor de fundo.
- Ajuste automaticamente o layout e a margem do código QR.
Codificação de dados em vários formatos: codifique URLs, textos, e-mails, cartões de visita e informações de pagamento sem esforço.
Validação de dados: A biblioteca suporta validação para vários tipos de dados, incluindo URL, texto, e-mail, número de telefone, IP e Wi-Fi, garantindo a precisão dos dados de entrada.
Opções flexíveis de exportação: salve códigos QR em vários formatos, incluindo PDF, SVG, PNG, binário, GIF, EPS e WebP, garantindo compatibilidade com diferentes projetos.
Framework Ready: integra-se perfeitamente com frameworks como o Laravel, tornando-o perfeito para aplicações modernas.

Instalação

Use o Composer para instalar a biblioteca. Certifique-se também de ter habilitado e configurado a extensão GD se quiser gerar imagens.

composer require amirezaeb/ HeroQR

Começando

1. Uso Básico

Gere um código QR simples em apenas algumas linhas de código:

Exemplo :

HeroQRCoreQRCodeGenerator; $qrCodeManager = new QRCodeGenerator(); $qrCode = $qrCodeManager # Set the data to be encoded in the QR code ->setData('https://test.org') # Generate the QR code in PNG format ->generate('png') ; # Save the generated QR code to a file named 'qrcode.png' $qrCode->saveTo('qrcode'); ">

 require ' vendor/autoload.php ' ;

use HeroQR  Core  QRCodeGenerator ;

$ qrCodeManager = new QRCodeGenerator ();

$ qrCode = $ qrCodeManager
    # Set the data to be encoded in the QR code
    -> setData ( ' https://test.org ' ) 
    # Generate the QR code in PNG format
    -> generate ( ' png ' ) ;

# Save the generated QR code to a file named 'qrcode.png'
$ qrCode -> saveTo ( ' qrcode ' );

2. Personalização Avançada

Personalize totalmente a aparência e a funcionalidade do seu código QR, garantindo a validação dos dados:

Opções de personalização : você pode modificar vários parâmetros como tamanho, cor, logotipo e outros aspectos visuais.
Validação Automática de Dados : Ao usar DataType (opcional), a biblioteca valida automaticamente o tipo de dados que está sendo codificado (Url, Email, Telefone, Localização, Wifi, Texto).

Exemplo :

HeroQRDataTypesDataType; $qrCode = $qrCodeManager # Set the data to be encoded and validation Email ->setData('[email protected]', DataType::Email) # Set the background color ->setBackgroundColor('#000000') # Set the QR code's color ->setColor('#b434eb') # Set the size ->setSize(350) # Set the logo to be embedded at the center # Set the logo size default value is 40 ->setLogo('../assets/HeroExpert.png', 30 ) # Set the margin around ->setMargin(10) # Set the character encoding ->setEncoding('UTF-8') # Set the label ->setLabel( # Label Text label: 'My Email', # Label align textAlign: 'center', # Label text color textColor: '#a503fc', # Label size default value is 20 fontSize: 15, # Label margin default value is (0, 10, 10, 10) margin: [15, 15, 15, 15] ) # Generate the QR code in WebP format ->generate('webp'); # Save the generated QR code to a file $qrCode->saveTo('custom-qrcode'); ">

 use HeroQR  DataTypes  DataType ;

$ qrCode = $ qrCodeManager
    # Set the data to be encoded and validation Email
    -> setData ( ' [email protected] ' , DataType::Email)  
    # Set the background color
    -> setBackgroundColor ( ' #000000 ' )
    # Set the QR code's color
    -> setColor ( ' #b434eb ' )
    # Set the size
    -> setSize ( 350 )
    # Set the logo to be embedded at the center
    # Set the logo size default value is 40
    -> setLogo ( ' ../assets/HeroExpert.png ' , 30 )
    # Set the margin around
    -> setMargin ( 10 )
    # Set the character encoding
    -> setEncoding ( ' UTF-8 ' )
    # Set the label 
    -> setLabel (
        # Label Text
        label: ' My Email ' ,
        # Label align
        textAlign: ' center ' ,
        # Label text color
        textColor: ' #a503fc ' ,
        # Label size default value is 20
        fontSize: 15 ,
        # Label margin default value is (0, 10, 10, 10)
        margin: [ 15 , 15 , 15 , 15 ] 
    )
    # Generate the QR code in WebP format
    -> generate ( ' webp ' );

# Save the generated QR code to a file
$ qrCode -> saveTo ( ' custom-qrcode ' );

Com essas opções, você pode criar códigos QR visualmente atraentes que se alinham às suas necessidades de design.

3. Opções avançadas de saída

HeroQR oferece suporte a opções de saída avançadas para maior flexibilidade ao gerar códigos QR:

Saída da matriz : representa o código QR como uma matriz (matriz 2D) de bits, onde cada bloco da matriz corresponde a uma parte específica dos dados codificados. Você pode recuperar a matriz de duas formas:
- Como um objeto Matrix .
- Como uma matriz 2D, o que facilita a manipulação ou exibição direta em alguns aplicativos.
Codificação Base64 : Gere o código QR como uma string codificada em Base64, que é ideal para incorporar diretamente em HTML, e-mails ou outras mídias.
URI de dados : obtenha o código QR como um URI de dados, que é uma representação de string compacta da imagem que pode ser incorporada diretamente no HTML.
Salvando em diferentes formatos : você pode salvar o código QR em vários formatos, como PNG, SVG, GIF, WebP, EPS, PDF, binário e muito mais. O formato é determinado automaticamente com base no tipo de saída desejado.

Exemplo :

 # Get the QR code as a string representation
$ string = $ qrCode -> getString ();

# Get the QR code as a matrix object
$ matrix = $ qrCode -> getMatrix ();

# Get the matrix as a 2D array
$ matrixArray = $ qrCode -> getMatrixAsArray ();

# Get the QR code as Base64 encoding for embedding in HTML
$ dataUri = $ qrCode -> getDataUri ();

# Save the QR code to a file in the desired format (WebP, GIF, Binary, Esp, PNG, SVG, PDF)
$ qrCode -> saveTo ( ' qr_code_output ' );

Estrutura do Projeto

A estrutura modular do HeroQR garante facilidade de uso e escalabilidade:

Contratos: define interfaces para os componentes principais, garantindo consistência em todo o sistema.
Core: Contém a lógica principal para geração e gerenciamento de códigos QR.
DataTypes: trata das definições dos diversos tipos de dados (Local, Url, Email, Telefone, Texto) e realiza a validação automática de cada tipo, para que os usuários não precisem validar os dados manualmente.
Gerentes: Gerencia a customização e processamento de códigos QR, proporcionando máxima flexibilidade aos usuários.

Contribuindo

Agradecemos suas contribuições! Veja como você pode se envolver:

Bifurque o repositório.
Crie uma ramificação de recursos: git checkout -b feature-name .
Confirme suas alterações com mensagens claras: git commit -m 'Add feature-name' .
Envie seu branch: git push origin feature-name .
Abra uma solicitação pull para revisão.