Startseite>PHP-Quellcode>Andere Kategorien
Herunterladen

HeroQR -Bibliothek

HeroQR ist eine fortschrittliche und modulare PHP-Bibliothek, die die Erstellung, Anpassung und Verwaltung von QR-Codes vereinfacht. Egal, ob Sie einen einfachen QR-Code oder einen hochgradig individuellen Code mit eingebetteten Logos und Farben benötigen, HeroQR hat alles, was Sie brauchen.

Merkmale

  • Unübertroffene Anpassung:

    • Passen Sie die Logogröße an und fügen Sie Logos zum QR-Code hinzu.
    • Fügen Sie Etiketten mit anpassbarer Farbe, Größe, Textausrichtung und Rand hinzu.
    • Unterstützung für verschiedene Kodierungsformate wie UTF-8 und andere Standardformate.
    • Ändern Sie die Farbe des QR-Codes zusammen mit der Hintergrundfarbe.
    • Passen Sie das Layout und den Rand des QR-Codes automatisch an.

  • Multiformat-Datenkodierung: Müheloses Kodieren von URLs, Texten, E-Mails, Visitenkarten und Zahlungsinformationen.

  • Datenvalidierung: Die Bibliothek unterstützt die Validierung verschiedener Datentypen, einschließlich URL, Text, E-Mail, Telefonnummer, IP und WLAN, und stellt so die Genauigkeit der Eingabedaten sicher.

  • Flexible Exportoptionen: Speichern Sie QR-Codes in mehreren Formaten, einschließlich PDF, SVG, PNG, Binär, GIF, EPS und WebP, um die Kompatibilität mit verschiedenen Projekten sicherzustellen.

  • Framework Ready: Lässt sich nahtlos in Frameworks wie Laravel integrieren und eignet sich somit perfekt für moderne Anwendungen.

Installation

Verwenden Sie Composer, um die Bibliothek zu installieren. Stellen Sie außerdem sicher, dass Sie die GD-Erweiterung aktiviert und konfiguriert haben, wenn Sie Bilder generieren möchten. 

composer require amirezaeb/ HeroQR

Erste Schritte

1. Grundlegende Verwendung

Generieren Sie einen einfachen QR-Code in nur wenigen Codezeilen:

Beispiel :

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. Erweiterte Anpassung

Passen Sie das Erscheinungsbild und die Funktionalität Ihres QR-Codes vollständig an und stellen Sie gleichzeitig die Datenvalidierung sicher:

  • Anpassungsoptionen : Sie können verschiedene Parameter wie Größe, Farbe, Logo und andere visuelle Aspekte ändern.
  • Automatische Datenvalidierung : Mithilfe von DataType (optional) validiert die Bibliothek automatisch die Art der kodierten Daten (URL, E-Mail, Telefon, Standort, WLAN, Text).

Beispiel :

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

Mit diesen Optionen können Sie optisch ansprechende QR-Codes erstellen, die Ihren Designanforderungen entsprechen.

3. Erweiterte Ausgabeoptionen

HeroQR unterstützt erweiterte Ausgabeoptionen für mehr Flexibilität bei der Generierung von QR-Codes:

  • Matrixausgabe : Stellen Sie den QR-Code als Matrix (2D-Array) von Bits dar, wobei jeder Block der Matrix einem bestimmten Teil der codierten Daten entspricht. Sie können die Matrix in zwei Formen abrufen:

    • Als Matrix .
    • Als 2D-Array, was die Bearbeitung oder direkte Anzeige in einigen Anwendungen erleichtert.

  • Base64-Kodierung : Generieren Sie den QR-Code als Base64-kodierte Zeichenfolge, die sich ideal zum direkten Einbetten in HTML, E-Mails oder andere Medien eignet.

  • Daten-URI : Erhalten Sie den QR-Code als Daten-URI, eine kompakte Zeichenfolgendarstellung des Bildes, die direkt in HTML eingebettet werden kann.

  • Speichern in verschiedenen Formaten : Sie können den QR-Code in verschiedenen Formaten wie PNG, SVG, GIF, WebP, EPS, PDF, Binär und mehr speichern. Das Format wird automatisch basierend auf dem gewünschten Ausgabetyp bestimmt.

Beispiel : 

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

Projektstruktur

Der modulare Aufbau von HeroQR sorgt für Benutzerfreundlichkeit und Skalierbarkeit:

  • Verträge: Definiert Schnittstellen für die Kernkomponenten und sorgt so für Konsistenz im gesamten System.
  • Kern: Enthält die Hauptlogik zum Generieren und Verwalten von QR-Codes.
  • DataTypes: Verarbeitet Definitionen für die verschiedenen Datentypen (Standort, URL, E-Mail, Telefon, Text) und führt eine automatische Validierung für jeden Typ durch, sodass Benutzer die Daten nicht manuell validieren müssen.
  • Manager: Verwaltet die Anpassung und Verarbeitung von QR-Codes und bietet Benutzern maximale Flexibilität.

Mitwirken

Wir freuen uns über Ihre Beiträge! So können Sie mitmachen:

  1. Forken Sie das Repository.
  2. Erstellen Sie einen Feature-Zweig: git checkout -b feature-name .
  3. Übernehmen Sie Ihre Änderungen mit klaren Nachrichten: git commit -m 'Add feature-name' .
  4. Pushen Sie Ihren Zweig: git push origin feature-name .
  5. Öffnen Sie eine Pull-Anfrage zur Überprüfung.

Lizenz

HeroQR wird unter der MIT-Lizenz veröffentlicht und gibt Ihnen die Freiheit, es zu verwenden, zu ändern und zu verbreiten.

Kontakt

Haben Sie Fragen oder Anregungen? Lassen Sie uns verbinden:

Verwandeln Sie Ihre Projekte noch heute mit HeroQR !

Expandieren
Zusätzliche Informationen
Ähnliche Anwendungen
Empfohlen für Sie
Ähnliche Nachrichten Alle