Unduhan HeroQR - Unduhan kode Sumber HeroQR

HeroQR

Kategori lainnya

v1.0.3

Unduh

Perpustakaan HeroQR

HeroQR adalah perpustakaan PHP canggih dan modular yang dirancang untuk menyederhanakan pembuatan, penyesuaian, dan pengelolaan kode QR. Baik Anda memerlukan kode QR dasar atau kode QR yang sangat disesuaikan dengan logo dan warna tersemat, HeroQR siap membantu Anda.

Fitur

Kustomisasi Tak Tertandingi:
- Sesuaikan ukuran logo dan tambahkan logo ke kode QR.
- Tambahkan label dengan warna, ukuran, perataan teks, dan margin yang dapat disesuaikan.
- Dukungan untuk berbagai format pengkodean seperti UTF-8 dan format standar lainnya.
- Ubah warna kode QR beserta warna latar belakangnya.
- Secara otomatis menyesuaikan tata letak dan margin kode QR.
Pengkodean Data Multi-Format : Menyandikan URL, teks, email, kartu nama, dan informasi pembayaran dengan mudah.
Validasi Data : Perpustakaan mendukung validasi untuk berbagai jenis data, termasuk URL, teks, email, nomor telepon, IP, dan Wi-Fi, memastikan keakuratan data masukan.
Opsi Ekspor Fleksibel : Simpan kode QR dalam berbagai format, termasuk PDF, SVG, PNG, Biner, GIF, EPS, dan WebP, memastikan kompatibilitas dengan berbagai proyek.
Framework Ready : Terintegrasi secara mulus dengan kerangka kerja seperti Laravel, menjadikannya sangat cocok untuk aplikasi modern.

Instalasi

Gunakan Komposer untuk menginstal perpustakaan. Pastikan juga Anda telah mengaktifkan dan mengkonfigurasi ekstensi GD jika Anda ingin menghasilkan gambar.

composer require amirezaeb/ HeroQR

Memulai

1. Penggunaan Dasar

Hasilkan kode QR sederhana hanya dalam beberapa baris kode:

Contoh :

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. Kustomisasi Tingkat Lanjut

Sesuaikan sepenuhnya tampilan dan fungsionalitas kode QR Anda sambil memastikan validasi data:

Opsi Kustomisasi : Anda dapat mengubah berbagai parameter seperti ukuran, warna, logo, dan aspek visual lainnya.
Validasi Data Otomatis : Dengan menggunakan DataType (opsional), perpustakaan secara otomatis memvalidasi jenis data yang dikodekan (Url, Email, Telepon, Lokasi, Wifi, Teks).

Contoh :

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

Dengan opsi ini, Anda dapat membuat kode QR yang menarik secara visual dan sesuai dengan kebutuhan desain Anda.

3. Opsi Keluaran Tingkat Lanjut

HeroQR mendukung opsi keluaran lanjutan untuk fleksibilitas lebih besar saat membuat kode QR:

Keluaran Matriks : Mewakili kode QR sebagai matriks (array 2D) bit, di mana setiap blok matriks berhubungan dengan bagian tertentu dari data yang dikodekan. Anda dapat mengambil matriks dalam dua bentuk:
- Sebagai objek Matrix .
- Sebagai array 2D, yang memudahkan untuk memanipulasi atau menampilkannya secara langsung di beberapa aplikasi.
Pengkodean Base64 : Menghasilkan kode QR sebagai string berkode Base64, yang ideal untuk disematkan langsung di HTML, email, atau media lainnya.
URI Data : Dapatkan kode QR sebagai URI Data, yang merupakan representasi string ringkas dari gambar yang dapat disematkan langsung ke dalam HTML.
Menyimpan ke Format Berbeda : Anda dapat menyimpan kode QR dalam berbagai format seperti PNG, SVG, GIF, WebP, EPS, PDF, Biner, dan lainnya. Formatnya ditentukan secara otomatis berdasarkan jenis keluaran yang diinginkan.

Contoh :

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

Struktur Proyek

Struktur modular HeroQR memastikan kemudahan penggunaan dan skalabilitas:

Kontrak : Mendefinisikan antarmuka untuk komponen inti, memastikan konsistensi di seluruh sistem.
Inti : Berisi logika utama untuk menghasilkan dan mengelola kode QR.
DataTypes : Menangani definisi untuk berbagai tipe data (Lokasi, Url, Email, Telepon, Teks) dan melakukan validasi otomatis untuk setiap jenis, sehingga pengguna tidak perlu memvalidasi data secara manual.
Manajer : Mengelola penyesuaian dan pemrosesan kode QR, memberikan fleksibilitas maksimum bagi pengguna.

Berkontribusi

Kami menyambut kontribusi Anda! Inilah cara Anda dapat terlibat:

Cabangkan repositori.
Buat cabang fitur: git checkout -b feature-name .
Komit perubahan Anda dengan pesan yang jelas: git commit -m 'Add feature-name' .
Dorong cabang Anda: git push origin feature-name .
Buka permintaan tarik untuk ditinjau.