HeroQR

ห้องสมุด HeroQR

HeroQR เป็นไลบรารี PHP ขั้นสูงแบบโมดูลาร์ที่ออกแบบมาเพื่อทำให้การสร้าง การปรับแต่ง และการจัดการโค้ด QR ง่ายขึ้น ไม่ว่าคุณจะต้องการโค้ด QR พื้นฐานหรือโค้ดที่ปรับแต่งเองได้สูงพร้อมโลโก้และสีที่ฝังไว้ HeroQR ก็ช่วยคุณได้

คุณสมบัติ

• การปรับแต่งที่ไม่ตรงกัน:

  • ปรับขนาดโลโก้และเพิ่มโลโก้ลงในโค้ด QR
  • เพิ่มป้ายกำกับด้วยสี ขนาด การจัดตำแหน่งข้อความ และระยะขอบที่ปรับแต่งได้
  • รองรับรูปแบบการเข้ารหัสที่หลากหลาย เช่น UTF-8 และรูปแบบมาตรฐานอื่นๆ
  • เปลี่ยนสีของโค้ด QR พร้อมกับสีพื้นหลัง
  • ปรับเค้าโครงโค้ด QR และระยะขอบโดยอัตโนมัติ

• การเข้ารหัสข้อมูลหลายรูปแบบ : เข้ารหัส URL ข้อความ อีเมล นามบัตร และข้อมูลการชำระเงินได้อย่างง่ายดาย

• การตรวจสอบข้อมูล : ไลบรารีรองรับการตรวจสอบความถูกต้องของข้อมูลประเภทต่างๆ รวมถึง URL, ข้อความ, อีเมล, หมายเลขโทรศัพท์, IP และ Wi-Fi เพื่อให้มั่นใจถึงความถูกต้องของข้อมูลที่ป้อน

• ตัวเลือกการส่งออกที่ยืดหยุ่น : บันทึกรหัส QR ในหลายรูปแบบ รวมถึง PDF, SVG, PNG, ไบนารี, GIF, EPS และ WebP เพื่อให้มั่นใจว่าเข้ากันได้กับโครงการต่างๆ

• Framework Ready : ผสานรวมกับเฟรมเวิร์กอย่าง Laravel ได้อย่างราบรื่น ทำให้เหมาะอย่างยิ่งสำหรับแอปพลิเคชันสมัยใหม่

การติดตั้ง

ใช้ Composer เพื่อติดตั้งไลบรารี ตรวจสอบให้แน่ใจว่าคุณได้เปิดใช้งานและกำหนดค่าส่วนขยาย GD แล้วหากคุณต้องการสร้างภาพ

composer require amirezaeb/ HeroQR 

เริ่มต้นใช้งาน

1. การใช้งานขั้นพื้นฐาน

สร้างโค้ด QR ง่ายๆ ด้วยโค้ดเพียงไม่กี่บรรทัด:

ตัวอย่าง :

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. การปรับแต่งขั้นสูง

ปรับแต่งรูปลักษณ์และฟังก์ชันการทำงานของโค้ด QR ของคุณอย่างเต็มที่พร้อมรับประกันการตรวจสอบข้อมูล:

• ตัวเลือกการปรับแต่ง : คุณสามารถแก้ไขพารามิเตอร์ต่างๆ ได้ เช่น ขนาด สี โลโก้ และลักษณะภาพอื่นๆ
• การตรวจสอบข้อมูลอัตโนมัติ : ด้วยการใช้ DataType (เป็นทางเลือก) ไลบรารีจะตรวจสอบประเภทของข้อมูลที่ถูกเข้ารหัสโดยอัตโนมัติ (Url, อีเมล, โทรศัพท์, ตำแหน่ง, Wifi, ข้อความ)

ตัวอย่าง :

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

ด้วยตัวเลือกเหล่านี้ คุณสามารถสร้างโค้ด QR ที่ดึงดูดสายตาซึ่งสอดคล้องกับความต้องการในการออกแบบของคุณได้

3. ตัวเลือกเอาต์พุตขั้นสูง

HeroQR รองรับตัวเลือกเอาต์พุตขั้นสูงเพื่อความยืดหยุ่นที่มากขึ้นเมื่อสร้างโค้ด QR:

• เอาต์พุตเมทริกซ์ : แสดงโค้ด QR เป็นเมทริกซ์ (อาร์เรย์ 2D) ของบิต โดยที่แต่ละบล็อกของเมทริกซ์สอดคล้องกับส่วนเฉพาะของข้อมูลที่เข้ารหัส คุณสามารถดึงข้อมูลเมทริกซ์ได้สองรูปแบบ:

  • เป็นวัตถุ Matrix
  • เป็นอาร์เรย์ 2 มิติ ซึ่งทำให้ง่ายต่อการจัดการหรือแสดงผลโดยตรงในบางแอปพลิเคชัน

• การเข้ารหัส Base64 : สร้างโค้ด QR เป็นสตริงที่เข้ารหัส Base64 ซึ่งเหมาะสำหรับการฝังโดยตรงใน HTML อีเมล หรือสื่ออื่นๆ

• URI ข้อมูล : รับโค้ด QR เป็น Data URI ซึ่งเป็นการแสดงสตริงขนาดกะทัดรัดของรูปภาพที่สามารถฝังลงใน HTML ได้โดยตรง

• การบันทึกเป็นรูปแบบต่างๆ : คุณสามารถบันทึกโค้ด QR ได้หลากหลายรูปแบบ เช่น PNG, SVG, GIF, WebP, EPS, PDF, Binary และอื่นๆ รูปแบบจะถูกกำหนดโดยอัตโนมัติตามประเภทเอาต์พุตที่ต้องการ

ตัวอย่าง :

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

โครงสร้างโครงการ

โครงสร้างแบบโมดูลาร์ของ HeroQR ช่วยให้มั่นใจในการใช้งานและความสามารถในการขยายขนาด:

• สัญญา : กำหนดอินเทอร์เฟซสำหรับส่วนประกอบหลัก เพื่อให้มั่นใจถึงความสอดคล้องกันทั่วทั้งระบบ
• แกนหลัก : ประกอบด้วยตรรกะหลักสำหรับการสร้างและจัดการโค้ด QR
• ประเภทข้อมูล : จัดการคำจำกัดความสำหรับข้อมูลประเภทต่างๆ (ตำแหน่ง URL อีเมล โทรศัพท์ ข้อความ) และดำเนินการตรวจสอบอัตโนมัติสำหรับแต่ละประเภท ดังนั้นผู้ใช้จึงไม่จำเป็นต้องตรวจสอบข้อมูลด้วยตนเอง
• ผู้จัดการ : จัดการการปรับแต่งและการประมวลผลรหัส QR ให้ความยืดหยุ่นสูงสุดแก่ผู้ใช้

มีส่วนร่วม

เรายินดีรับการมีส่วนร่วมของคุณ! คุณสามารถมีส่วนร่วมได้ดังนี้:

1. แยกพื้นที่เก็บข้อมูล
2. สร้างสาขาคุณลักษณะ: git checkout -b feature-name
3. ยอมรับการเปลี่ยนแปลงของคุณด้วยข้อความที่ชัดเจน: git commit -m 'Add feature-name'
4. พุชสาขาของคุณ: git push origin feature-name
5. เปิดคำขอดึงเพื่อตรวจสอบ

ใบอนุญาต

HeroQR ได้รับการเผยแพร่ภายใต้ใบอนุญาต MIT ซึ่งให้อิสระแก่คุณในการใช้ แก้ไข และแจกจ่าย

ติดต่อ

มีคำถามหรือข้อเสนอแนะ? มาเชื่อมต่อกัน:

• ผู้แต่ง : อามีร์เรซา เอบราฮิมี
• อีเมล์ : [email protected]
• GitHub : AmirrezaEb

---

พลิกโฉมโครงการของคุณด้วย HeroQR วันนี้!