Descarga HeroQR - Descarga del código fuente HeroQR

HeroQR

Otras categorias

v1.0.3

Descargar

Biblioteca HeroQR

HeroQR es una biblioteca PHP modular y avanzada diseñada para simplificar la creación, personalización y gestión de códigos QR. Ya sea que necesite un código QR básico o uno altamente personalizado con logotipos y colores integrados, HeroQR lo tiene cubierto.

Características

Personalización inigualable:
- Ajuste el tamaño del logotipo y agregue logotipos al código QR.
- Agregue etiquetas con color, tamaño, alineación de texto y margen personalizables.
- Soporte para varios formatos de codificación como UTF-8 y otros formatos estándar.
- Cambia el color del código QR junto con el color de fondo.
- Ajuste automáticamente el diseño y el margen del código QR.
Codificación de datos multiformato: codifique sin esfuerzo URL, texto, correos electrónicos, tarjetas de presentación e información de pago.
Validación de datos: la biblioteca admite la validación de varios tipos de datos, incluidos URL, texto, correo electrónico, número de teléfono, IP y Wi-Fi, lo que garantiza la precisión de los datos de entrada.
Opciones de exportación flexibles: guarde códigos QR en múltiples formatos, incluidos PDF, SVG, PNG, binario, GIF, EPS y WebP, lo que garantiza la compatibilidad con diferentes proyectos.
Framework Ready: se integra perfectamente con frameworks como Laravel, lo que lo hace perfecto para aplicaciones modernas.

Instalación

Utilice Composer para instalar la biblioteca. También asegúrese de haber habilitado y configurado la extensión GD si desea generar imágenes.

composer require amirezaeb/ HeroQR

Empezando

1. Uso básico

Genere un código QR simple en solo unas pocas líneas de código:

Ejemplo :

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. Personalización avanzada

Personalice completamente la apariencia y funcionalidad de su código QR mientras garantiza la validación de datos:

Opciones de personalización : Puedes modificar varios parámetros como tamaño, color, logotipo y otros aspectos visuales.
Validación automática de datos : al utilizar DataType (opcional), la biblioteca valida automáticamente el tipo de datos que se codifican (URL, correo electrónico, teléfono, ubicación, Wifi, texto).

Ejemplo :

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 ' );

Con estas opciones, puede crear códigos QR visualmente atractivos que se ajusten a sus necesidades de diseño.

3. Opciones de salida avanzadas

HeroQR admite opciones de salida avanzadas para una mayor flexibilidad al generar códigos QR:

Salida de matriz : representa el código QR como una matriz (matriz 2D) de bits, donde cada bloque de la matriz corresponde a una parte específica de los datos codificados. Puede recuperar la matriz de dos formas:
- Como objeto Matrix .
- Como una matriz 2D, lo que facilita su manipulación o visualización directamente en algunas aplicaciones.
Codificación Base64 : genere el código QR como una cadena codificada en Base64, que es ideal para incrustarlo directamente en HTML, correos electrónicos u otros medios.
URI de datos : obtenga el código QR como URI de datos, que es una representación de cadena compacta de la imagen que se puede incrustar directamente en HTML.
Guardar en diferentes formatos : puede guardar el código QR en una variedad de formatos como PNG, SVG, GIF, WebP, EPS, PDF, binario y más. El formato se determina automáticamente en función del tipo de salida deseado.

Ejemplo :

 # 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 ' );

Estructura del proyecto

La estructura modular de HeroQR garantiza facilidad de uso y escalabilidad:

Contratos: define interfaces para los componentes principales, garantizando la coherencia en todo el sistema.
Núcleo: Contiene la lógica principal para generar y administrar códigos QR.
Tipos de datos: maneja definiciones para los distintos tipos de datos (ubicación, URL, correo electrónico, teléfono, texto) y realiza una validación automática para cada tipo, por lo que los usuarios no necesitan validar los datos manualmente.
Gestores: Gestiona la personalización y el procesamiento de códigos QR, proporcionando la máxima flexibilidad a los usuarios.