QR 코드(빠른 응답 코드)는 검은색과 흰색 사각형의 배열 형태로 기계 판독이 가능한 매트릭스 바코드 유형입니다. QR 리더를 사용하여 읽을 수 있는 정보를 담은 광학 라벨입니다. 프로그래밍 방식으로 QR 코드를 생성하고 클라우드에서 문서와 이미지에 서명할 수 있습니다. 이 기사에서는 PHP에서 REST API를 사용하여 PDF 문서에 서명하기 위해 QR 코드를 생성하는 방법을 배웁니다.
이 문서에서는 다음 항목을 다룹니다.
- QR 코드 생성기 REST API 및 PHP SDK
- PHP에서 PDF에 서명하기 위한 QR 코드 생성
- PHP에서 PDF에 서명하기 위해 Aztec QR 코드 생성
- PHP에서 PDF에 서명하기 위한 DataMatrix QR 코드 생성
- PHP에서 QR 코드 서명 확인
QR 코드 생성기 REST API 및 PHP SDK
PDF 문서에 서명하기 위한 QR 코드를 생성하기 위해 GroupDocs.Signature Cloud의 PHP SDK API를 사용합니다. 이미지, 바코드, QR코드, 텍스트 기반, 디지털, 스탬프 서명 등 다양한 형태의 서명을 생성, 검증, 조회할 수 있습니다. 다음 QR 코드 유형을 지원합니다.
- 아즈텍 코드
- 데이터매트릭스 코드
- GS1 데이터매트릭스
- GS1 QR
- QR
콘솔에서 다음 명령을 사용하여 설치하십시오.
composer require groupdocscloud/groupdocs-signature-cloud
설치 후 아래와 같이 Composers의 자동 로드를 사용하여 SDK를 사용하십시오.
require_once('vendor/autoload.php');
언급된 단계를 따르기 전에 대시보드에서 클라이언트 ID와 암호를 가져오십시오. ID와 시크릿이 있으면 아래와 같이 코드를 추가합니다.
// 이 코드 예제는 코드에 클라이언트 ID와 시크릿을 추가하는 방법을 보여줍니다.
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);
PHP에서 REST API를 사용하여 PDF에 서명하기 위한 QR 코드 생성
아래에 언급된 간단한 단계에 따라 클라우드에서 PDF 문서에 서명하는 QR 코드를 생성할 수 있습니다.
- 업로드 PDF를 클라우드로
- PDF 서명을 위한 QR 코드 생성
- 다운로드 서명된 파일
문서 업로드
먼저 아래 제공된 코드 샘플을 사용하여 PDF 문서를 클라우드에 업로드합니다.
// 이 코드 예제는 PDF 파일을 클라우드에 업로드하는 방법을 보여줍니다.
// API 초기화
$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 파일은 클라우드 대시보드의 파일 섹션에서 사용할 수 있습니다.
PHP에서 PDF에 서명하기 위한 QR 코드 생성
프로그래밍 방식으로 QR 코드를 생성하고 아래 단계에 따라 업로드된 PDF 문서에 서명할 수 있습니다.
- 먼저 SignApi의 인스턴스를 만듭니다.
- 다음으로 입력 PDF 파일 경로를 제공합니다.
- 그런 다음 출력 파일 경로를 설정합니다.
- 다음으로 SignQRCodeOptions 개체를 초기화합니다.
- 그런 다음 QRCodeType을 “QR"로 설정합니다. 또한 텍스트와 위치를 설정합니다.
- 선택적으로 Page, RotationAngle, HorizontalAlignment, Border, Padding 등과 같은 옵션을 설정합니다.
- 그런 다음 정의된 SignSettings로 createSignaturesRequest를 생성합니다.
- 마지막으로 createSignatures() 메서드를 호출하여 결과를 얻습니다.
다음 코드 샘플은 QR 코드를 생성하고 PHP에서 REST API를 사용하여 PDF 문서에 서명하는 방법을 보여줍니다.
// 이 코드 예제는 QR 코드를 생성하여 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);
// 서명 QR 코드 옵션 정의
$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 코드로 서명된 PDF 다운로드
위의 코드 샘플은 서명된 PDF 파일을 클라우드에 저장합니다. 다음 코드 샘플을 사용하여 다운로드할 수 있습니다.
// 이 코드 예제는 클라우드에서 PDF 파일을 다운로드하는 방법을 보여줍니다.
// API 초기화
$apiInstance = new GroupDocs\Signature\FileApi($configuration);
// 파일 요청 다운로드
$request = new GroupDocs\Signature\Model\Requests\DownloadFileRequest("Aztec_QR_out.pdf", self::$MyStorage, null);
// 파일 다운로드
$response = $apiInstance->downloadFile($request);
PHP에서 PDF에 서명하기 위한 Aztec 코드 생성
Aztec 코드는 인쇄와 스캔이 가장 쉬운 2차원(2D) QR 코드입니다. 앞에서 언급한 단계에 따라 업로드된 PDF 문서에 서명하는 Aztec 코드를 생성할 수 있습니다. 그러나 QRCodeType을 “Aztec"으로 설정하기만 하면 됩니다.
다음 코드 샘플은 Aztec 코드를 생성하고 PHP에서 REST API를 사용하여 PDF 문서에 서명하는 방법을 보여줍니다.
// 이 코드 예제는 PHP에서 Aztec 코드를 생성하는 방법을 보여줍니다.
// 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);
// 서명 QR 코드 옵션 정의
$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();
PHP에서 PDF 서명을 위한 DataMatrix 코드 생성
앞에서 언급한 단계에 따라 DataMatrix 코드를 생성할 수도 있습니다. 그러나 QRCodeType을 “DataMatrix"로 설정하기만 하면 됩니다.
다음 코드 샘플은 DataMatrix 코드를 생성하고 PHP에서 REST API를 사용하여 PDF 문서에 서명하는 방법을 보여줍니다.
// 이 코드 예제는 PHP에서 DataMatrix 코드를 생성하는 방법을 보여줍니다.
// 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);
// 서명 QR 코드 옵션 정의
$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();
PHP에서 QR 코드 서명 확인
아래 단계에 따라 생성된 QR 코드 서명을 쉽게 확인할 수 있습니다.
- 먼저 SignApi의 인스턴스를 만듭니다.
- PDF 파일 경로를 설정합니다.
- VerifyQRCodeOptions를 정의합니다.
- 서명 유형, 텍스트 및 코드를 제공합니다.
- VerifySettings를 정의하고 VerifyQRCodeOptions를 VerifySettings에 할당합니다.
- 그런 다음 VerifySettings를 사용하여 VerifySignatureRequest를 생성합니다.
- 마지막으로 verifySignatures() 메서드를 호출하여 결과를 얻습니다.
다음 코드 샘플은 PHP에서 REST API를 사용하여 QR 코드 서명을 확인하는 방법을 보여줍니다.
// 이 코드 예제는 QR 코드 서명을 확인하는 방법을 보여줍니다.
// 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);
// QR 코드 확인 옵션 정의
$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;
온라인 시도
위의 API를 사용하여 개발된 다음 무료 온라인 PDF 서명 도구를 사용해 보십시오. https://products.groupdocs.app/signature/pdf
결론
이 문서에서는 다음 방법을 배웠습니다.
- PHP에서 QR 코드 생성;
- PHP에서 QR 코드로 PDF 문서에 서명하십시오.
- PHP에서 전자 서명을 확인합니다.
- 프로그래밍 방식으로 PDF 파일을 클라우드에 업로드합니다.
- 클라우드에서 서명된 PDF 파일을 다운로드합니다.
그 외에도 문서를 사용하여 GroupDocs.Signature Cloud API에 대해 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼에 문의해 주십시오.