تنزيل HeroQR - تنزيل رمز مصدر HeroQR

HeroQR

فئات أخرى

v1.0.3

تنزيل

مكتبة HeroQR

HeroQR هي مكتبة PHP معيارية ومتقدمة مصممة لتبسيط إنشاء رموز QR وتخصيصها وإدارتها. سواء كنت بحاجة إلى رمز QR أساسي أو رمز مخصص للغاية يحتوي على شعارات وألوان مضمنة، HeroQR يلبي احتياجاتك.

سمات

تخصيص لا مثيل له:
- ضبط حجم الشعار وإضافة الشعارات إلى رمز الاستجابة السريعة.
- أضف تسميات ذات لون وحجم ومحاذاة النص والهامش قابلة للتخصيص.
- دعم تنسيقات الترميز المختلفة مثل UTF-8 والتنسيقات القياسية الأخرى.
- تغيير لون رمز QR مع لون الخلفية.
- ضبط تخطيط رمز الاستجابة السريعة والهامش تلقائيًا.
ترميز البيانات متعدد التنسيقات: يمكنك تشفير عناوين URL والنصوص ورسائل البريد الإلكتروني وبطاقات العمل ومعلومات الدفع بسهولة.
التحقق من صحة البيانات: تدعم المكتبة التحقق من صحة أنواع البيانات المختلفة، بما في ذلك عنوان URL والنص والبريد الإلكتروني ورقم الهاتف وIP وWi-Fi، مما يضمن دقة بيانات الإدخال.
خيارات تصدير مرنة: احفظ رموز QR بتنسيقات متعددة، بما في ذلك PDF وSVG وPNG وBinary وGIF وEPS وWebP، مما يضمن التوافق مع المشاريع المختلفة.
جاهزية الإطار: يتكامل بسلاسة مع أطر عمل مثل Laravel، مما يجعله مناسبًا تمامًا للتطبيقات الحديثة.

تثبيت

استخدم Composer لتثبيت المكتبة. تأكد أيضًا من تمكين وتكوين امتداد GD إذا كنت تريد إنشاء صور.

HeroQR">

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. التخصيص المتقدم

قم بتخصيص مظهر ووظيفة رمز الاستجابة السريعة الخاص بك بشكل كامل مع ضمان التحقق من صحة البيانات:

خيارات التخصيص : يمكنك تعديل العديد من المعلمات مثل الحجم واللون والشعار والجوانب المرئية الأخرى.
التحقق التلقائي من صحة البيانات : باستخدام 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:

إخراج المصفوفة : تمثيل رمز الاستجابة السريعة كمصفوفة (صفيف ثنائي الأبعاد) من البتات، حيث تتوافق كل كتلة من المصفوفة مع جزء معين من البيانات المشفرة. يمكنك استرجاع المصفوفة في شكلين:
- ككائن Matrix .
- كمصفوفة ثنائية الأبعاد، مما يسهل التعامل معها أو عرضها مباشرة في بعض التطبيقات.
ترميز Base64 : قم بإنشاء رمز الاستجابة السريعة كسلسلة مشفرة بـ Base64، وهو مثالي للتضمين مباشرة في HTML أو رسائل البريد الإلكتروني أو الوسائط الأخرى.
URI للبيانات : احصل على رمز الاستجابة السريعة باعتباره URI للبيانات، وهو عبارة عن تمثيل سلسلة مضغوطة للصورة التي يمكن تضمينها مباشرة في HTML.
الحفظ بتنسيقات مختلفة : يمكنك حفظ رمز الاستجابة السريعة بتنسيقات متنوعة مثل 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، مما يوفر أقصى قدر من المرونة للمستخدمين.