HTML 웹페이지의 DOC 또는 DOCX 파일을 클라우드에서 프로그래밍 방식으로 쉽게 렌더링할 수 있습니다. 원본 파일을 공유하지 않고 모든 브라우저에서 Word 문서를 보는 데 유용할 수 있습니다. 이 기사에서는 PHP에서 REST API를 사용하여 HTML 페이지에 Word 문서를 표시하는 방법을 배웁니다.
이 문서에서는 다음 항목을 다룹니다.
- Word to HTML Viewer REST API 및 PHP SDK
- PHP에서 REST API를 사용하여 HTML 페이지에 Word 문서 표시
- 기존 HTML 페이지에 Word 문서 포함
- PHP를 사용하여 워터마크가 있는 HTML로 Word 문서 표시
Word to HTML Viewer REST API 및 PHP SDK
Word 문서를 HTML로 렌더링하기 위해 GroupDocs.Viewer Cloud의 PHP SDK API를 사용합니다. 프로그래밍 방식으로 지원되는 문서 및 이미지 파일 형식을 렌더링하고 볼 수 있습니다. 콘솔에서 다음 명령을 사용하여 설치하십시오.
composer require groupdocscloud/groupdocs-viewer-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\Viewer\Configuration();
// 구성 설정
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);
PHP에서 REST API를 사용하여 HTML 페이지에 Word 문서 표시
아래 주어진 간단한 단계에 따라 Word 문서의 내용을 HTML로 표시할 수 있습니다.
- 업로드 DOCX 파일을 클라우드로
- HTML 페이지에 Word 문서 표시
- 다운로드 렌더링된 파일
문서 업로드
먼저 아래 제공된 코드 샘플을 사용하여 DOCX 파일을 클라우드에 업로드합니다.
// 이 코드 예제는 DOCX 파일을 클라우드에 업로드하는 방법을 보여줍니다.
// API 초기화
$apiInstance = new GroupDocs\Viewer\FileApi($configuration);
// 입력 파일 경로
$file = "C:\\Files\\Viewer\\input.docx";
// 파일 요청 업로드
$request = new GroupDocs\Viewer\Model\Requests\uploadFileRequest("input.docx", $file);
// 파일 업로드
$response = $apiInstance->uploadFile($request);
결과적으로 업로드된 파일은 클라우드 대시보드의 파일 섹션에서 사용할 수 있습니다.
PHP를 사용하여 HTML 페이지에 Word 문서 표시
이제 아래 단계에 따라 HTML 페이지에 업로드된 Word 문서의 내용을 렌더링하거나 표시합니다.
- 먼저 ViewAPI 인스턴스를 생성합니다.
- 다음으로 ViewOptions의 인스턴스를 만듭니다.
- 그런 다음 입력 파일 경로를 제공하십시오.
- 또한 ViewFormat을 “HTML"로 설정합니다.
- 다음으로 HtmlOptions 개체를 초기화합니다.
- 그런 다음 IsResponsive, ForPrinting 등과 같은 다양한 속성을 설정합니다.
- 그런 다음 ViewOptions를 인수로 사용하여 CreateViewRequest를 생성합니다.
- 마지막으로 createView() 메서드를 사용하여 Word를 HTML로 렌더링합니다.
다음 코드 샘플은 PHP에서 REST API를 사용하여 HTML로 Word 파일을 표시하는 방법을 보여줍니다.
// 이 코드 예제는 DOCX를 HTML로 렌더링하는 방법을 보여줍니다.
// API 초기화
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
// 보기 옵션 정의
$viewOptions = new Model\ViewOptions();
// 입력 파일 경로
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// 보기 형식 설정
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// HTML 옵션 정의
$renderOptions = new Model\HtmlOptions();
// 반응형으로 설정
$renderOptions->setIsResponsive(true);
// 인쇄용으로 설정
$renderOptions->setForPrinting(true);
// 렌더링 옵션 할당
$viewOptions->setRenderOptions($renderOptions);
// 보기 요청 만들기
$request = new Requests\CreateViewRequest($viewOptions);
// 보기 만들기
$response = $apiInstance->createView($request);
// 완료
echo "HtmlViewerResponsiveLayout completed: ", count($response->getPages());
echo "\n";
PHP에서 REST API를 사용하여 HTML 페이지에 Word 문서를 표시합니다.
다음 옵션을 적용하여 Word를 HTML로 렌더링하는 것을 사용자 정의할 수 있습니다.
- 특정 범위의 페이지 렌더링
// Pass specific range of page numbers to render.
// This will render all pages from starting from page 1 to 3.
$renderOptions->setStartPageNumber(1);
$renderOptions->setCountPagesToRender(3);
- 선택한 페이지만 렌더링
// Pass specific page numbers to render.
// This will render only page number 1 and 3.
$renderOptions->setPagesToRender([1, 3]);
- 특정 순서로 페이지 보기
// Pass page numbers in the order you want to render them
$renderOptions->setPagesToRender([2, 1]);
- 주석이 있는 문서 렌더링
$renderOptions->setRenderComments(true);
HTML 페이지 다운로드
위의 코드 샘플은 렌더링된 HTML 페이지를 클라우드에 저장합니다. 다음 코드 샘플을 사용하여 다운로드할 수 있습니다.
// 이 코드 예제는 클라우드에서 렌더링된 HTML 페이지를 다운로드하는 방법을 보여줍니다.
$fileApi = new GroupDocs\Viewer\FileApi($configuration);
// 모든 페이지 가져오기
$pages = $response->getPages();
// 페이지를 하나씩 저장
foreach ($pages as $page)
{
// 다운로드 파일 요청 생성
$downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");
// 파일 다운로드
$file = $fileApi->DownloadFile($downloadFileRequest);
echo "$page downloaded!";
echo "\n";
}
기존 HTML 페이지에 Word 문서 포함
아래 단계에 따라 Word 문서를 기존 HTML 페이지에 삽입할 수도 있습니다.
- 먼저 ViewAPI 및 FileAPI의 인스턴스를 생성합니다.
- 다음으로 ViewOptions의 인스턴스를 만듭니다.
- 그런 다음 입력 파일 경로를 제공하십시오.
- 또한 ViewFormat을 “HTML"로 설정합니다.
- 다음으로 HtmlOptions 개체를 초기화합니다.
- 그런 다음 IsResponsive, ForPrinting 등과 같은 다양한 속성을 설정합니다.
- 그런 다음 ViewOptions를 인수로 사용하여 CreateViewRequest를 생성합니다.
- 그런 다음 createView() 메서드를 사용하여 Word를 HTML로 렌더링합니다.
- 다음으로 기존 HTML 파일을 로드하고 body 태그의 요소를 가져옵니다.
- 그런 다음 각 페이지의 HTML을 읽고 body 태그에 추가합니다.
- 그런 다음 saveHTML() 메서드를 사용하여 업데이트된 HTML을 저장합니다.
- 마지막으로 file\put\contents() 메서드를 사용하여 HTML 파일을 저장합니다.
다음 코드 샘플은 PHP에서 REST API를 사용하여 기존 HTML 페이지에 Word 문서를 포함하는 방법을 보여줍니다.
// 이 코드 예제는 DOCX를 HTML로 렌더링하는 방법을 보여줍니다.
// API 초기화
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
$fileApi = new GroupDocs\Viewer\FileApi($configuration);
// 보기 옵션 정의
$viewOptions = new Model\ViewOptions();
// 입력 파일 경로
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// 보기 형식 설정
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// HTML 옵션 정의
$renderOptions = new Model\HtmlOptions();
// 반응형으로 설정
$renderOptions->setIsResponsive(true);
// 인쇄 설정
$renderOptions->setForPrinting(true);
// 렌더링 옵션 할당
$viewOptions->setRenderOptions($renderOptions);
// 보기 요청 만들기
$request = new Requests\CreateViewRequest($viewOptions);
// 보기 만들기
$response = $apiInstance->createView($request);
// 기존 HTML 파일 로드
$domDoc = new DOMDocument();
$domDoc->loadHTMLFile("C:\Files\Viewer\Sample.html");
$body = $domDoc->GetElementsByTagName('body')->item(0);
// 페이지 가져오기
$pages = $response->getPages();
// 렌더링된 모든 HTML 페이지를 기존 HTML의 본문 태그에 포함
foreach ($pages as $page)
{
// 다운로드 파일 요청 생성
$downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");
// 변환된 페이지 다운로드
$file = $fileApi->DownloadFile($downloadFileRequest);
// 다운로드 파일에서 HTML 읽기
$html = file_get_contents($file->getRealPath());
//프래그먼트에 콘텐츠 추가
$fragment = $domDoc->createDocumentFragment();
$fragment->appendXML("<div>$html</div>");
// 요소를 본문에 추가
$body->appendChild($fragment);
}
// 업데이트된 HTML 저장
$output = $domDoc->saveHTML();
// 파일 저장
file_put_contents("C:\Files\Viewer\Sample.html", $output);
기존 HTML 페이지에 Word 문서를 포함합니다.
PHP를 사용하여 워터마크가 있는 HTML로 Word 문서 표시
아래 단계에 따라 프로그래밍 방식으로 Word 문서를 HTML 페이지로 렌더링하는 동안 워터마크 텍스트를 추가할 수 있습니다.
- 먼저 ViewAPI의 인스턴스를 생성합니다.
- 다음으로 ViewOptions의 인스턴스를 만듭니다.
- 그런 다음 입력 파일 경로를 제공하십시오.
- 또한 ViewFormat을 “HTML"로 설정합니다.
- 다음으로 워터마크 인스턴스를 생성하고 할당합니다.
- 그런 다음 워터마크 크기와 텍스트를 설정합니다.
- 그런 다음 ViewOptions를 인수로 사용하여 CreateViewRequest를 생성합니다.
- 마지막으로 createView() 메서드를 사용하여 Word를 HTML로 렌더링합니다.
다음 코드 샘플은 PHP에서 REST API를 사용하여 워터마크가 있는 HTML의 Word 문서를 표시하는 방법을 보여줍니다.
// 이 코드 예제는 워터마크를 사용하여 HTML에서 Word를 렌더링하는 방법을 보여줍니다.
// API 초기화
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
// 보기 옵션 정의
$viewOptions = new Model\ViewOptions();
// 입력 파일 경로
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");
$viewOptions->setFileInfo($fileInfo);
// 보기 형식 설정
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);
// 워터마크 정의
$watermark = new Model\Watermark();
$watermark->setText("This is sample text watermark!");
$watermark->setSize(100);
$watermark->setColor("Red");
$viewOptions->setWatermark($watermark);
// 보기 요청 만들기
$request = new Requests\CreateViewRequest($viewOptions);
// 보기 만들기
$response = $apiInstance->createView($request);
// 완료
echo "AddWatermark completed: ", count($response->getPages());
echo "\n";
PHP를 사용하여 워터마크가 있는 HTML로 Word 문서를 표시합니다.
온라인 시도
위의 API를 사용하여 개발된 다음 무료 온라인 DOCX 렌더링 도구를 사용해 보십시오. https://products.groupdocs.app/viewer/docx
결론
이 문서에서는 다음 방법을 배웠습니다.
- PHP를 사용하여 브라우저 지원 HTML 웹 페이지에서 Word 문서를 봅니다.
- Word를 HTML로 렌더링 사용자 지정
- Word 문서를 기존 HTML 웹 페이지에 삽입합니다.
- 워터마크가 있는 HTML로 Word 파일의 내용을 봅니다.
- 프로그래밍 방식으로 DOCX 파일을 클라우드에 업로드합니다.
- 클라우드에서 렌더링된 HTML 파일을 다운로드합니다.
또한 문서를 사용하여 GroupDocs.Viewer Cloud API에 대해 자세히 알아볼 수 있습니다. 또한 브라우저를 통해 직접 API를 시각화하고 상호 작용할 수 있는 API 참조 섹션을 제공합니다. 모호한 점이 있으면 언제든지 포럼에 문의해 주십시오.