رمز الاستجابة السريعة (رمز الاستجابة السريعة) هو نوع من الباركود المصفوف المقروء آليًا في شكل مصفوفة من المربعات السوداء والبيضاء. إنه ملصق بصري يحتوي على معلومات يمكن قراءتها باستخدام قارئ QR. يمكننا إنشاء رموز QR برمجيًا وتوقيع المستندات والصور على السحابة. في هذه المقالة ، سوف نتعلم كيفية إنشاء رمز QR لتوقيع مستندات PDF باستخدام REST API في PHP.
سيتم تناول الموضوعات التالية في هذه المقالة:
- QR Code Generator REST API و PHP SDK
- قم بإنشاء QR Code لتسجيل PDF في PHP
- أنشئ Aztec QR Code لتسجيل PDF في PHP
- قم بإنشاء كود QR DataMatrix لتسجيل PDF في PHP
- تحقق من تواقيع رمز الاستجابة السريعة في PHP
QR Code Generator REST API و PHP SDK
لإنشاء رموز QR لتوقيع مستندات PDF ، سنستخدم PHP SDK من GroupDocs.Signature Cloud API. يسمح بإنشاء أنواع مختلفة من التوقيعات والتحقق منها والبحث عنها مثل الصور والباركود ورمز الاستجابة السريعة والتوقيعات النصية والرقمية والتوقيعات. يدعم أنواع أكواد QR التالية:
- كود ازتيك
- كود DataMatrix
- GS1 DataMatrix
- GS1 ر
- ريال قطري
الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:
composer require groupdocscloud/groupdocs-signature-cloud
بعد التثبيت ، يرجى استخدام التحميل التلقائي للملحنين لاستخدام SDK كما هو موضح أدناه:
require_once('vendor/autoload.php');
يرجى الحصول على معرف العميل والسرية من لوحة التحكم قبل اتباع الخطوات المذكورة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:
// يوضح مثال الرمز هذا كيفية إضافة معرّف العميل والسر في الرمز.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';
// تهيئة التكوين
$configuration = new GroupDocs\Signature\Configuration();
// ضبط التكوينات
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);
قم بإنشاء QR Code لتوقيع PDF باستخدام REST API في PHP
يمكننا إنشاء رمز الاستجابة السريعة لتوقيع مستندات PDF على السحابة باتباع الخطوات البسيطة المذكورة أدناه:
- تحميل ملف PDF إلى السحابة
- قم بإنشاء QR Code لتوقيع PDF
- تحميل الملف الموقع
قم بتحميل المستند
أولاً ، سنقوم بتحميل مستند PDF إلى السحابة باستخدام نموذج الرمز الوارد أدناه:
// يوضح مثال الرمز هذا كيفية تحميل ملف PDF إلى السحابة.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Signature\FileApi($configuration);
// مسار ملف الإدخال
$file = "C:\\Files\\Signature\\sample.pdf";
// طلب رفع الملف
$request = new GroupDocs\Signature\Model\Requests\UploadFileRequest("sample.pdf", $file, self::$MyStorage, null);
// رفع ملف
$response = $apiInstance->uploadFile($request);
نتيجة لذلك ، سيكون ملف PDF الذي تم تحميله متاحًا في قسم الملفات من لوحة المعلومات على السحابة.
قم بإنشاء QR Code لتسجيل PDF في PHP
يمكننا إنشاء رمز الاستجابة السريعة برمجيًا وتوقيع مستند PDF الذي تم تحميله باتباع الخطوات الموضحة أدناه:
- أولاً ، قم بإنشاء مثيل SignApi.
- بعد ذلك ، قم بتوفير مسار ملف PDF للإدخال.
- ثم قم بتعيين مسار ملف الإخراج.
- بعد ذلك ، قم بتهيئة كائن SignQRCodeOptions.
- ثم قم بتعيين QRCodeType على “QR”. علاوة على ذلك ، قم بتعيين النص وموقعه.
- اختياريًا ، قم بتعيين الخيارات مثل Page و RotationAngle و HorizontalAlignment و Border و Padding وما إلى ذلك.
- بعد ذلك ، أنشئ طلب createSignaturesRequest باستخدام SignSettings المحددة.
- أخيرًا ، احصل على النتائج عن طريق استدعاء طريقة createSignatures().
يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء رمز QR وتوقيع مستند PDF باستخدام REST API في PHP.
// يوضح مثال الرمز هذا كيفية إنشاء رمز الاستجابة السريعة لتوقيع وثيقة PDF.
// مثيل SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد SignSettings
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);
// حدد SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);
// تحديد خيارات تسجيل رمز الاستجابة السريعة
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);
$options->setQRCodeType("QR");
$options->setText("This is sample QR.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);
// لون
$color = new GroupDocs\Signature\Model\لون();
$color->setWeb("Black");
// حدود
$border = new GroupDocs\Signature\Model\حدودLine();
$border->setلون($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setحدود($border);
// حشوة
$padding = new GroupDocs\Signature\Model\حشوة();
$padding->setAll(5);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);
$settings->setOptions([$options]);
// إنشاء طلب التوقيع
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);
// إنشاء التوقيعات
$response = $apiInstance->createSignatures($request);
echo "Response: ", $response->getFileInfo();
قم بإنشاء QR Code لتوقيع PDF باستخدام REST API في PHP.
قم بتنزيل ملف PDF الموقع برمز الاستجابة السريعة
نموذج الكود أعلاه سيحفظ ملف PDF الموقع على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:
// يوضح مثال الرمز هذا كيفية تنزيل ملف PDF من السحابة.
// قم بتهيئة واجهة برمجة التطبيقات
$apiInstance = new GroupDocs\Signature\FileApi($configuration);
// طلب تحميل الملف
$request = new GroupDocs\Signature\Model\Requests\DownloadFileRequest("Aztec_QR_out.pdf", self::$MyStorage, null);
// تحميل الملف
$response = $apiInstance->downloadFile($request);
قم بإنشاء Aztec Code لتسجيل PDF في PHP
رمز Aztec هو رمز QR ثنائي الأبعاد (2D) سهل الطباعة والمسح الضوئي. يمكننا إنشاء كود Aztec لتوقيع مستند PDF الذي تم تحميله باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى ضبط QRCodeType على “Aztec”.
يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء كود Aztec وتوقيع مستند PDF باستخدام REST API في PHP.
// يوضح مثال الكود هذا كيفية إنشاء كود Aztec في PHP.
// مثيل SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد SignSettings
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);
// حدد SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);
// تحديد خيارات تسجيل رمز الاستجابة السريعة
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);
$options->setQRCodeType("Aztec");
$options->setText("This is a sample Aztec QR code.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);
// لون
$color = new GroupDocs\Signature\Model\لون();
$color->setWeb("Black");
// حدود
$border = new GroupDocs\Signature\Model\حدودLine();
$border->setلون($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setحدود($border);
// حشوة
$padding = new GroupDocs\Signature\Model\حشوة();
$padding->setAll(2);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);
$settings->setOptions([$options]);
// إنشاء طلب التوقيع
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);
// إنشاء التوقيعات
$response = $apiInstance->createSignatures($request);
echo "Response: ", $response->getFileInfo();
قم بإنشاء Aztec Code لتسجيل PDF في PHP.
قم بإنشاء كود DataMatrix لتسجيل PDF في PHP
يمكننا أيضًا إنشاء كود DataMatrix باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى ضبط QRCodeType على “DataMatrix”.
يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء كود DataMatrix وتوقيع مستند PDF باستخدام REST API في PHP.
// يوضح مثال الكود هذا كيفية إنشاء كود DataMatrix في PHP.
// مثيل SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد SignSettings
$settings = new GroupDocs\Signature\Model\SignSettings();
$settings->setFileInfo($fileInfo);
// حدد SaveOptions
$saveOptions = new GroupDocs\Signature\Model\SaveOptions();
$saveOptions->setOutputFilePath("QR_out.pdf");
$settings->setSaveOptions($saveOptions);
// تحديد خيارات تسجيل رمز الاستجابة السريعة
$options = new GroupDocs\Signature\Model\SignQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);
$options->setQRCodeType("DataMatrix");
$options->setText("This is a sample DataMatrix QR code.");
$options->setLeft(260);
$options->setTop(350);
$options->setWidth(100);
$options->setHeight(100);
// لون
$color = new GroupDocs\Signature\Model\لون();
$color->setWeb("Black");
// حدود
$border = new GroupDocs\Signature\Model\حدودLine();
$border->setلون($color);
$border->setVisible(true);
$border->setWeight(12);
$options->setحدود($border);
// حشوة
$padding = new GroupDocs\Signature\Model\حشوة();
$padding->setAll(2);
$options->setMargin($padding);
$options->setMarginMeasureType(GroupDocs\Signature\Model\SignTextOptions::MARGIN_MEASURE_TYPE_PIXELS);
$settings->setOptions([$options]);
// إنشاء طلب التوقيع
$request = new GroupDocs\Signature\Model\Requests\createSignaturesRequest($settings);
// إنشاء التوقيعات
$response = $apiInstance->createSignatures($request);
echo "Response: ", $response->getFileInfo();
قم بإنشاء كود DataMatrix لتسجيل PDF في PHP.
تحقق من تواقيع رمز الاستجابة السريعة في PHP
يمكنك بسهولة التحقق من توقيعات رمز الاستجابة السريعة التي تم إنشاؤها باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل SignApi.
- قم بتعيين مسار ملف PDF.
- حدد VerifyQRCodeOptions.
- قدم نوع التوقيع والنص والرمز.
- حدد VerifySettings وقم بتعيين VerifyQRCodeOptions إلى VerifySettings.
- بعد ذلك ، قم بإنشاء VerifySignatureRequest باستخدام VerifySettings.
- أخيرًا ، احصل على النتائج عن طريق استدعاء طريقة checkSignatures().
يوضح نموذج التعليمات البرمجية التالي كيفية التحقق من توقيعات رمز الاستجابة السريعة باستخدام واجهة برمجة تطبيقات REST في PHP.
// يوضح مثال الرمز هذا كيفية التحقق من توقيعات رمز الاستجابة السريعة.
// مثيل SignatureAPI
$apiInstance = new GroupDocs\Signature\SignApi($configuration);
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Signature\Model\FileInfo();
$fileInfo->setFilePath("QR_out.pdf");
// تحديد التحقق من الإعدادات
$settings = new GroupDocs\Signature\Model\VerifySettings();
$settings->setFileInfo($fileInfo);
// تحديد خيارات التحقق من رمز الاستجابة السريعة
$options = new GroupDocs\Signature\Model\VerifyQRCodeOptions();
$options->setPage(1);
$options->setAllPages(false);
$options->setSignatureType(GroupDocs\Signature\Model\OptionsBase::SIGNATURE_TYPE_QR_CODE);
$options->setQRCodeType("QR");
$options->setText("This is sample QR.");
$settings->setOptions([$options]);
// التحقق من طلب التوقيعات
$request = new GroupDocs\Signature\Model\Requests\VerifySignaturesRequest($settings);
// تحقق من التوقيعات
$response = $apiInstance->verifySignatures($request);
echo "Response: ", $response;
جرب عبر الإنترنت
يرجى تجربة أداة توقيع PDF المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/signature/pdf
خاتمة
في هذه المقالة ، تعلمنا كيفية:
- إنشاء رمز الاستجابة السريعة في PHP ؛
- قم بتوقيع مستند PDF باستخدام رمز الاستجابة السريعة في PHP ؛
- التحقق من التوقيعات الإلكترونية في PHP ؛
- تحميل ملف PDF برمجيًا إلى السحابة ؛
- قم بتنزيل ملف PDF الموقع من السحابة.
بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Signature Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.