คำอธิบายประกอบให้ข้อมูลเพิ่มเติมเกี่ยวกับส่วนใดส่วนหนึ่งของเอกสาร เราสามารถทำเครื่องหมายเอกสารด้วยคำติชมและบทวิจารณ์โดยใช้คำอธิบายประกอบ เราสามารถเพิ่มรูปภาพ ข้อคิดเห็น บันทึกย่อ หรือข้อสังเกตภายนอกประเภทอื่นๆ ลงในเอกสาร PDF เป็นคำอธิบายประกอบ ในบทความนี้ เราจะมาเรียนรู้วิธีการใส่คำอธิบายประกอบในเอกสาร PDF โดยใช้ REST API ใน PHP
หัวข้อต่อไปนี้จะครอบคลุมในบทความนี้:
- คำอธิบายประกอบ PDF REST API และ PHP SDK
- ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ REST API ใน PHP
- คำอธิบายประกอบพร้อมคำอธิบายประกอบลิงก์โดยใช้ PHP
- เพิ่มคำอธิบายประกอบรูปภาพโดยใช้ PHP
- เพิ่มคำอธิบายประกอบฟิลด์ข้อความโดยใช้ PHP
คำอธิบายประกอบ PDF REST API และ PHP SDK
สำหรับการใส่คำอธิบายประกอบในเอกสาร PDF เราจะใช้ API ของ PHP SDK of GroupDocs.Annotation Cloud อนุญาตให้เพิ่มคำอธิบายประกอบ การซ้อนทับลายน้ำ การแทนที่ข้อความ การแก้ไข และมาร์กอัปข้อความไปยัง รูปแบบเอกสารที่รองรับ โปรดติดตั้งโดยใช้คำสั่งต่อไปนี้ในคอนโซล:
composer require groupdocscloud/groupdocs-annotation-cloud
หลังการติดตั้ง โปรดใช้ autoload ของนักแต่งเพลงเพื่อใช้ SDK ดังที่แสดงด้านล่าง:
require_once('vendor/autoload.php');
โปรด รับรหัสลูกค้าและข้อมูลลับจากแดชบอร์ด ก่อนทำตามขั้นตอนดังกล่าว เมื่อคุณมี ID และรหัสลับของคุณแล้ว ให้เพิ่มรหัสตามที่แสดงด้านล่าง:
// ตัวอย่างรหัสนี้สาธิตวิธีการเพิ่มรหัสไคลเอนต์และรหัสลับในรหัส
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';
// กำลังเริ่มต้นการกำหนดค่า
$configuration = new GroupDocs\Annotation\Configuration();
// การตั้งค่าการกำหนดค่า
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);
ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ REST API ใน PHP
เราสามารถใส่คำอธิบายประกอบเอกสาร PDF บนคลาวด์ได้โดยทำตามขั้นตอนง่าย ๆ ด้านล่าง:
- อัปโหลด ไฟล์ PDF ไปยังคลาวด์
- ใส่คำอธิบายประกอบเอกสาร PDF
- ดาวน์โหลด ไฟล์คำอธิบายประกอบ
อัปโหลดเอกสาร
ประการแรก เราจะอัปโหลดไฟล์ PDF ไปยังคลาวด์โดยใช้ตัวอย่างโค้ดต่อไปนี้:
// ตัวอย่างโค้ดนี้สาธิตวิธีอัปโหลดไฟล์ PDF ไปยังระบบคลาวด์
// เริ่มต้นอินสแตนซ์ของ API
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);
// เส้นทางไฟล์
$file = "C:\\Files\\Annotation\\sample.pdf";
// สร้างคำขออัปโหลดไฟล์
$request = new GroupDocs\Annotation\Model\Requests\UploadFileRequest("sample.pdf", $file, self::$MyStorage, null);
// อัพโหลดไฟล์
$response = $apiInstance->uploadFile($request);
ด้วยเหตุนี้ ไฟล์ PDF ที่อัปโหลดจะอยู่ใน ส่วนไฟล์ ของแดชบอร์ดบนระบบคลาวด์
ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ PHP
ตอนนี้ เราจะเพิ่มคำอธิบายประกอบหลายรายการให้กับเอกสาร PDF ที่อัปโหลดโดยทางโปรแกรมโดยทำตามขั้นตอนด้านล่าง:
- ขั้นแรก สร้างอินสแตนซ์ของ AnnotateApi
- ถัดไป ตั้งค่าคุณสมบัติคำอธิบายประกอบ เช่น ตำแหน่ง ประเภท ข้อความ ฯลฯ
- จากนั้น ทำซ้ำขั้นตอนข้างต้นเพื่อเพิ่มคำอธิบายประกอบหลายรายการ
- ถัดไป ระบุเส้นทางไฟล์อินพุต
- จากนั้น เริ่มต้นวัตถุ AnnotateOptions และตั้งค่าพาธไฟล์เอาต์พุต
- หลังจากนั้น สร้าง AnnotateRequest โดยมี AnnotateOptions เป็นอาร์กิวเมนต์
- สุดท้าย ใส่คำอธิบายประกอบ PDF โดยใช้เมธอด AnnotateApi.annotate()
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบหลายรายการในเอกสาร PDF โดยใช้ REST API ใน PHP
// ตัวอย่างรหัสนี้สาธิตวิธีเพิ่มคำอธิบายประกอบหลายรายการใน PDF
// เริ่มต้นอินสแตนซ์ AnnotationAPI
$apiInstance = new GroupDocs\Annotation\คำอธิบายApi($configuration);
// เพิ่มคำอธิบายประกอบระยะทาง
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(100);
$box->setY(100);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setPenColor(1201033);
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setPenWidth(1);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_DISTANCE);
$a->setText("This is distance annotation");
$a->setCreatorName("Anonym A.");
// เพิ่มคำอธิบายประกอบพื้นที่
$a1 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(1);
$pt1->setY(1);
$a1->setAnnotationPosition($pt1);
$box1 = new GroupDocs\Annotation\Model\Rectangle();
$box1->setX(80);
$box1->setY(400);
$box1->setWidth(200);
$box1->setHeight(100);
$a1->setBox($box1);
$a1->setPageNumber(0);
$a1->setPenColor(1201033);
$a1->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a1->setPenWidth(1);
$a1->setOpacity(0.7);
$a1->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_AREA);
$a1->setText("This is area annotation");
$a1->setCreatorName("Anonym A.");
// เพิ่มคำอธิบายประกอบจุด
$a2 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(100);
$pt2->setY(100);
$a2->setAnnotationPosition($pt2);
$box2 = new GroupDocs\Annotation\Model\Rectangle();
$box2->setX(450);
$box2->setY(150);
$box2->setWidth(100);
$box2->setHeight(30);
$a2->setBox($box2);
$a2->setPageNumber(0);
$a2->setOpacity(0.7);
$a2->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_POINT);
$a2->setText("This is point annotation");
$a2->setCreatorName("Anonym A.");
// เพิ่มคำอธิบายประกอบลูกศร
$a3 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(1);
$pt3->setY(1);
$a3->setAnnotationPosition($pt3);
$box3 = new GroupDocs\Annotation\Model\Rectangle();
$box3->setX(350);
$box3->setY(350);
$box3->setWidth(200);
$box3->setHeight(100);
$a3->setBox($box3);
$a3->setPageNumber(0);
$a3->setPenColor(1201033);
$a3->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a3->setPenWidth(1);
$a3->setOpacity(0.7);
$a3->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_ARROW);
$a3->setText("This is arrow annotation");
$a3->setCreatorName("Anonym A.");
// เส้นทางไฟล์อินพุต
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// กำหนดตัวเลือกคำอธิบายประกอบ
$options = new GroupDocs\Annotation\Model\คำอธิบายOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a, $a1, $a2, $a3]);
$options->setOutputPath("MultipleAnnotation.pdf");
// สร้างคำขอคำอธิบายประกอบ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// คำอธิบาย
$result = $apiInstance->annotate($request);
echo "AddMultipleAnnotations: Multiple Annotations added: " . $result->getHref();
ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ PHP
คุณสามารถอ่านเพิ่มเติมเกี่ยวกับประเภทคำอธิบายประกอบที่รองรับได้ในส่วน การเพิ่มคำอธิบายประกอบ ในเอกสารประกอบ
ดาวน์โหลดไฟล์คำอธิบายประกอบ
ตัวอย่างโค้ดด้านบนจะบันทึกไฟล์ PDF ที่มีคำอธิบายประกอบไว้บนคลาวด์ สามารถดาวน์โหลดได้โดยใช้ตัวอย่างโค้ดต่อไปนี้:
// ตัวอย่างโค้ดนี้สาธิตวิธีดาวน์โหลดไฟล์ PDF จากระบบคลาวด์
// Intializing อินสแตนซ์ของ API
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);
// สร้างคำขอดาวน์โหลดไฟล์
$request = new GroupDocs\Annotation\Model\Requests\DownloadFileRequest("MultipleAnnotation.pdf", self::$MyStorage, null);
// ดาวน์โหลดไฟล์
$response = $apiInstance->downloadFile($request);
คำอธิบายประกอบพร้อมคำอธิบายประกอบลิงก์โดยใช้ PHP
นอกจากนี้ เรายังสามารถเพิ่มคำอธิบายประกอบไฮเปอร์ลิงก์ในเอกสาร PDF ได้โดยทำตามขั้นตอนด้านล่าง:
- ขั้นแรก สร้างอินสแตนซ์ของ AnnotateApi
- ถัดไป ตั้งค่าคุณสมบัติคำอธิบายประกอบ เช่น ตำแหน่ง ข้อความ เป็นต้น
- จากนั้น ตั้งค่าประเภทคำอธิบายประกอบเป็นลิงก์
- ถัดไป ระบุเส้นทางไฟล์อินพุต
- จากนั้น เริ่มต้นวัตถุ AnnotateOptions และตั้งค่าพาธไฟล์เอาต์พุต
- หลังจากนั้น สร้าง AnnotateRequest โดยมี AnnotateOptions เป็นอาร์กิวเมนต์
- สุดท้าย ใส่คำอธิบายประกอบ PDF โดยใช้เมธอด AnnotateApi.annotate()
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบไฮเปอร์ลิงก์ในเอกสาร PDF โดยใช้ REST API โปรดทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้เพื่ออัปโหลดและดาวน์โหลดไฟล์
// ตัวอย่างรหัสนี้สาธิตวิธีเพิ่มคำอธิบายประกอบลิงก์ไปยัง PDF
// เริ่มต้นอินสแตนซ์ AnnotationAPI
$apiInstance = new GroupDocs\Annotation\คำอธิบายApi($configuration);
// เพิ่มคำอธิบายประกอบลิงก์
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(80);
$pt1->setY(710);
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(240);
$pt2->setY(710);
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(80);
$pt3->setY(650);
$pt4 = new GroupDocs\Annotation\Model\Point();
$pt4->setX(240);
$pt4->setY(650);
$a->setPoints([$pt1, $pt2, $pt3, $pt4]);
$a->setUrl("https://www.groupdocs.com/");
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_LINK);
$a->setText("This is link annotation");
$a->setCreatorName("Anonym A.");
// เส้นทางไฟล์อินพุต
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// กำหนดตัวเลือกคำอธิบายประกอบ
$options = new GroupDocs\Annotation\Model\คำอธิบายOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddLinkAnnotation.pdf");
// สร้างคำขอคำอธิบายประกอบ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// คำอธิบาย
$result = $apiInstance->annotate($request);
echo "AddLinkAnnotation: Link Annotation added: " . $result->getHref();
คำอธิบายประกอบพร้อมคำอธิบายประกอบลิงก์โดยใช้ PHP
เพิ่มคำอธิบายประกอบรูปภาพโดยใช้ PHP
เราสามารถเพิ่มคำอธิบายประกอบรูปภาพในเอกสาร PDF โดยทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้ อย่างไรก็ตาม เราเพียงแค่ต้องตั้งค่าประเภทคำอธิบายประกอบเป็นภาพตามที่แสดงด้านล่าง:
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบรูปภาพในเอกสาร PDF โดยใช้ REST API ใน PHP โปรดทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้เพื่ออัปโหลดและดาวน์โหลดไฟล์
// ตัวอย่างรหัสนี้สาธิตวิธีเพิ่มคำอธิบายประกอบรูปภาพใน PDF
// เริ่มต้นอินสแตนซ์ AnnotationAPI
$apiInstance = new GroupDocs\Annotation\คำอธิบายApi($configuration);
// เพิ่มคำอธิบายประกอบรูปภาพ
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(200);
$box->setY(0);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setImagePath("groupdocs.png");
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);
$a->setText("This is image annotation");
$a->setCreatorName("Anonym A.");
// เส้นทางไฟล์อินพุต
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// กำหนดตัวเลือกคำอธิบายประกอบ
$options = new GroupDocs\Annotation\Model\คำอธิบายOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddImageAnnotation.pdf");
// สร้างคำขอคำอธิบายประกอบ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// คำอธิบาย
$result = $apiInstance->annotate($request);
echo "AddImageAnnotation: Image Annotation added: " . $result->getHref();
เพิ่มคำอธิบายประกอบรูปภาพโดยใช้ PHP
เพิ่มคำอธิบายประกอบฟิลด์ข้อความโดยใช้ PHP
เรายังสามารถเพิ่มคำอธิบายประกอบช่องข้อความในเอกสาร PDF โดยทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้ อย่างไรก็ตาม เราต้องตั้งค่าประเภทคำอธิบายประกอบเป็นฟิลด์ข้อความตามที่แสดงด้านล่าง:
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบช่องข้อความในเอกสาร PDF โดยใช้ REST API โปรดทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้เพื่ออัปโหลดและดาวน์โหลดไฟล์
// ตัวอย่างรหัสนี้สาธิตวิธีเพิ่มคำอธิบายประกอบช่องข้อความใน PDF
// เริ่มต้นอินสแตนซ์ AnnotationAPI
$apiInstance = new GroupDocs\Annotation\คำอธิบายApi($configuration);
// เพิ่มคำอธิบายประกอบ TextField
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(380);
$box->setY(300);
$box->setWidth(100);
$box->setHeight(50);
$a->setBox($box);
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setFontSize(12);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);
$a->setText("Text field text");
$a->setCreatorName("Anonym A.");
// เส้นทางไฟล์อินพุต
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// กำหนดตัวเลือกคำอธิบายประกอบ
$options = new GroupDocs\Annotation\Model\คำอธิบายOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddTextFieldAnnotation.pdf");
// สร้างคำขอคำอธิบายประกอบ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// คำอธิบาย
$result = $apiInstance->annotate($request);
echo "AddTextFieldAnnotation: Text Field Annotation added: " . $result->getHref();
เพิ่มคำอธิบายประกอบฟิลด์ข้อความโดยใช้ PHP
ลองออนไลน์
โปรดลองใช้เครื่องมือคำอธิบายประกอบ PDF ออนไลน์ฟรีต่อไปนี้ ซึ่งพัฒนาโดยใช้ API ข้างต้น https://products.groupdocs.app/annotation/pdf
บทสรุป
ในบทความนี้ เราได้เรียนรู้วิธีการ:
- เพิ่มคำอธิบายประกอบหลายรายการใน PDF โดยใช้ PHP
- ใส่คำอธิบายประกอบ PDF ด้วยลิงก์ รูปภาพ และคำอธิบายประกอบฟิลด์ข้อความใน PHP;
- อัปโหลดไฟล์ PDF ไปยังคลาวด์โดยทางโปรแกรม
- ดาวน์โหลดไฟล์ PDF ที่มีคำอธิบายประกอบจากคลาวด์
นอกจากนี้ คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ GroupDocs.Annotation Cloud API โดยใช้ เอกสารประกอบ เรายังมีส่วน API Reference ที่ช่วยให้คุณแสดงภาพและโต้ตอบกับ API ของเราได้โดยตรงผ่านเบราว์เซอร์ ในกรณีที่มีความคลุมเครือ โปรดติดต่อเราได้ที่ ฟอรัม