풍부한 Word 문서를 웹 준비된 HTML 로 변환하는 것은 최신 PHP 애플리케이션에서 자주 필요한 작업입니다. GroupDocs.Conversion Cloud SDK for PHP는 클라우드에서 무거운 작업을 처리하는 강력한 API를 제공합니다. 이 튜토리얼에서는 SDK를 사용하여 PHP에서 DOCX 를 HTML 로 변환하는 방법을 보여줍니다. 라이브러리를 설정하고, 전체 코드 예제를 실행하며, cURL 호출을 사용하여 동일한 변환을 수행하는 방법을 배울 수 있습니다.
PHP에서 DOCX를 HTML로 변환하는 방법 - 단계별
- Composer를 통해 SDK 설치: 공식 Composer 명령으로 라이브러리를 프로젝트에 추가합니다.
composer require groupdocs-conversion-cloud
- 구성 초기화:
Configuration객체를 생성하고 App SID 및 App Key를 설정합니다.
$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
- HTML 변환 옵션 구성: 이미지 추출 및 페이지 번호 처리와 같은 설정을 조정합니다.
$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);
- Convert Settings 생성: 소스 파일, 대상 형식 및 HTML 옵션을 지정합니다.
$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);
- 변환 실행:
convertDocument메서드를 호출하고 결과를 처리합니다.
$convertApi = new GroupDocs\Conversion\Cloud\Api\ConvertApi($config);
try {
$result = $convertApi->convertDocument($convertSettings);
echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}
각 클래스와 메서드에 대한 자세한 내용은 API 참조를 참조하십시오.
전체 코드 예제: PHP에서 DOCX를 HTML로 변환
다음 예제는 SDK를 사용한 전체 엔드‑투‑엔드 변환을 보여줍니다.
<?php
require __DIR__ . '/vendor/autoload.php';
use GroupDocs\Conversion\Cloud\Configuration;
use GroupDocs\Conversion\Cloud\Api\ConvertApi;
use GroupDocs\Conversion\Cloud\Model\ConvertSettings;
use GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions;
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
$convertApi = new ConvertApi($config);
$inputFilePath = 'sample.docx';
$outputFilePath = 'output.html';
$htmlOptions = new HtmlConvertOptions();
$htmlOptions->setExtractImages(true); // extract images to separate files
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false); // generate plain HTML, not a zip archive
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);
$convertSettings = new ConvertSettings();
$convertSettings->setFilePath($inputFilePath);
$convertSettings->setOutputPath($outputFilePath);
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);
try {
$result = $convertApi->convertDocument($convertSettings);
echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}
참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로(
sample.docx,output.html)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 다음 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.
DOCX 파일을 cURL 및 REST API를 사용하여 HTML로 변환
SDK는 cURL을 사용하여 호출할 수 있는 REST 엔드포인트도 제공합니다. 아래는 일반적인 워크플로우입니다.
액세스 토큰 얻기
YOUR_CLIENT_ID와YOUR_CLIENT_SECRET를 귀하의 자격 증명으로 교체하십시오.curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \ -H "Content-Type: application/json" \ -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'DOCX 파일 업로드
이전 단계에서 받은 토큰을 사용합니다.curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/storage/file/sample.docx" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@sample.docx"변환 시작
HTML로 변환을 요청합니다.curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "filePath": "sample.docx", "outputPath": "output.html", "format": "html", "options": { "extractImages": true, "zipOutput": false } }'결과 HTML 다운로드
curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/storage/file/output.html" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -o output.html
전체 매개변수 목록은 공식 API 문서를 참조하십시오.
PHP용 GroupDocs.Conversion Cloud SDK 설치 및 구성
composer require groupdocs-conversion-cloud
최신 패키지를 릴리스 페이지에서 다운로드하십시오. SDK는 PHP 7.4 이상이 필요하며, 유효한 자격 증명이 있는 활성 GroupDocs Cloud 계정이 필요합니다.
require __DIR__ . '/vendor/autoload.php';
use GroupDocs\Conversion\Cloud\Configuration;
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID'); // obtain from your GroupDocs Cloud dashboard
$config->setAppKey('YOUR_APP_KEY');
GroupDocs.Conversion Cloud SDK for PHP DOCX를 HTML로 변환하는 기능
- 이미지 추출 -
extractImages를 사용하면 삽입된 그림을 별도의 파일로 추출하여 레이아웃 정확성을 유지할 수 있습니다. - 페이지 번호 제어 -
preserveOriginalPageNumbers를 비활성화하면 연속적인 HTML 흐름을 생성할 수 있습니다. - 일반 HTML 출력 -
zipOutput를 false로 설정하면 ZIP 아카이브 대신 단일 HTML 파일이 생성되어 후속 처리 작업이 간소화됩니다. - 숨겨진 텍스트 처리 -
showHiddenText는 숨겨진 콘텐츠가 최종 HTML에 표시될지 여부를 결정합니다. - 단일 페이지 렌더링 -
renderToSinglePage를 사용하면 모든 페이지를 하나의 HTML 문서로 결합하여 삽입을 용이하게 할 수 있습니다.
모든 기능은 문서에 설명되어 있습니다.
결론
PHP에서 DOCX를 HTML로 변환하는 것이 GroupDocs.Conversion Cloud SDK for PHP를 사용하면 간단해집니다. 이 라이브러리는 서버에 Microsoft Office를 설치하지 않고도 복잡한 서식, 이미지 추출 및 페이지 관리를 처리합니다.
위 단계들을 따라 하면, 네이티브 SDK 호출이든 RESTful cURL 요청이든 관계없이 DOCX를 HTML로 변환하는 작업을 모든 PHP 기반 워크플로에 통합할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 획득해야 함을 기억하세요; 가격 세부 정보는 임시 라이선스 페이지에서 확인할 수 있습니다. 오늘 바로 변환을 시작하고 풍부하고 웹에 최적화된 콘텐츠를 사용자에게 제공하세요.
FAQs
추가 소프트웨어를 설치하지 않고 PHP에서 DOCX를 HTML로 구현하려면 어떻게 해야 하나요?
클라우드 기반 SDK는 모든 처리를 GroupDocs 서버에서 수행하므로 PHP 라이브러리와 자격 증명만 있으면 됩니다.한 번의 요청으로 여러 DOCX 파일을 변환할 수 있나요?
API는 코드에서 파일을 반복하면서 배치 변환을 지원합니다; 각 호출은 자체 HTML 결과를 반환합니다.DOCX 파일 내부의 이미지들은 어떻게 처리되나요?
extractImages가 활성화되면, 이미지는 별도의 파일로 저장되고 생성된 HTML에서 참조되어 직접 제공할 수 있습니다.생성된 HTML 레이아웃을 사용자 정의할 수 있는 방법이 있나요?
HTML 출력물을 후처리하거나renderToSinglePage와 같은 변환 옵션을 조정하여 구조에 영향을 줄 수 있습니다.