PHP에서 단계별 HTML을 XLSX로 변환하는 튜토리얼

HTML 보고서를 Excel 스프레드시트로 변환하는 것은 분석 또는 오프라인 검토를 위해 데이터를 내보내야 하는 PHP 기반 비즈니스 애플리케이션에서 자주 요구됩니다. GroupDocs.Conversion Cloud SDK for PHP는 HTML을 렌더링하고 XLSX 파일을 생성하는 무거운 작업을 처리하는 신뢰할 수 있는 API를 제공합니다. 이 튜토리얼에서는 PHP에서 HTML을 XLSX로 변환하는 방법, 프로세스를 안전하게 보호하는 방법 및 대형 문서에 대한 성능을 최적화하는 방법을 배웁니다.

PHP에서 HTML을 XLSX로 변환하는 단계

Conversion API 클라이언트 생성 - 클라이언트 자격 증명을 사용하여 ConversionApi 클래스를 초기화합니다.
- 예시: new \GroupDocs\Conversion\ConversionApi($config);
- 클래스 세부 정보는 API Reference를 참조하세요.
HTML 원본 파일 업로드 - UploadFile 엔드포인트를 사용하여 HTML 문서를 GroupDocs 스토리지에 전송합니다.
변환 옵션 구성 - 출력 형식을 XLSX로 설정하고 필요에 따라 페이지 크기, 워크시트 이름 또는 데이터 추출 설정을 조정합니다.
변환 실행 - ConvertDocument를 호출하여 소스 파일 ID와 구성된 옵션을 전달합니다.
XLSX 결과 다운로드 - 응답 URL 또는 스토리지 위치에서 생성된 파일을 가져옵니다.

GroupDocs를 사용한 HTML에서 XLSX 변환 - 전체 코드 예제

다음 예제는 인증부터 파일 다운로드까지 전체 엔드‑투‑엔드 변환 흐름을 보여줍니다.

이 예제에서는 GroupDocs.Conversion Cloud SDK for PHP를 사용하여 HTML 파일을 XLSX로 변환하는 방법을 보여줍니다.

<?php
require 'vendor/autoload.php';

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;
use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

// Replace with your actual credentials
$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';

// Configure the SDK
$config = new Configuration();
$config->setAppSid($clientId);
$config->setAppKey($clientSecret);

// Create API instance
$apiInstance = new ConversionApi($config);

// Paths to local files (can be absolute or relative)
$sourcePath = 'sample.html';
$targetPath = 'output.xlsx';

// Prepare conversion request
$request = new ConvertDocumentRequest(
    $sourcePath,          // Path to the source HTML file
    'XLSX',               // Desired output format
    null,                 // Optional conversion options (null for defaults)
    $targetPath           // Path where the XLSX will be saved
);

try {
    // Perform conversion
    $apiInstance->convertDocument($request);
    echo "Conversion successful. XLSX saved to {$targetPath}\n";
} catch (Exception $e) {
    echo 'Conversion failed: ', $e->getMessage(), "\n";
}
?>

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로(sample.html, output.xlsx)를 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL을 사용한 REST API를 통한 클라우드 기반 HTML에서 XLSX 변환

REST 호출을 직접 수행하여 변환할 수도 있습니다. 아래는 필요한 cURL 명령입니다.

먼저, 클라이언트 자격 증명을 사용하여 액세스 토큰을 얻으세요.

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"grant_type":"client_credentials","client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

HTML 파일을 스토리지 엔드포인트에 업로드합니다.

curl -X POST "https://api.groupdocs.cloud/v1.0/storage/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.html"

XLSX로 변환을 요청합니다.

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputPath": "sample.html",
           "outputPath": "output.xlsx",
           "outputFormat": "XLSX"
         }'

변환된 파일을 다운로드하십시오.

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/download?path=output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

요청 매개변수에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

PHP에서 설치 및 설정

Composer를 통해 SDK를 설치합니다:

composer require groupdocs-conversion-cloud

vendor 디렉터리를 확인하여 설치가 정상인지 확인합니다.
GroupDocs 포털에서 Client ID와 Client Secret을 얻습니다.
(선택 사항) 최신 패키지를 Download URL에서 수동으로 다운로드합니다.
PHP 버전이 SDK 요구 사항(PHP 7.4+)을 충족하는지 확인합니다.

PHP와 GroupDocs.Conversion을 사용한 HTML에서 XLSX 변환 튜토리얼

GroupDocs.Conversion Cloud는 형식별 로직을 추상화하는 통합 API를 제공합니다. HTML 문서를 전송하면, 서비스가 마크업을 파싱하고 표, 스타일 및 포함된 이미지를 렌더링한 뒤 이를 Excel 워크시트로 매핑합니다. 이 접근 방식은 서드파티 파서나 수동 CSV 생성을 필요 없게 하여 원본 HTML 레이아웃을 충실히 재현한 스프레드시트를 제공합니다.

GroupDocs.Conversion 기능

Multiple input formats - HTML, DOCX, PDF, 및 기타.
High‑fidelity rendering - CSS 스타일링, 병합된 셀 및 이미지를 보존합니다.
Scalable cloud processing - 로컬 리소스 제한 없이 대용량 파일을 처리합니다.
Secure data handling - 모든 트래픽이 암호화되며 파일은 일시적으로 저장됩니다.
Extensible options - 워크시트 이름, 열 너비 및 데이터 추출 모드를 제어합니다.

PHP에서 HTML을 XLSX 변환하기 위한 성능 최적화

대용량 HTML 보고서를 변환할 때는 다음 팁을 고려하세요:

HTML 크기	평균 변환 시간	최대 메모리 사용량
100 KB	0.8 s	45 MB
500 KB	2.4 s	120 MB
1 MB	4.9 s	210 MB

권장 사항

HTML을 큰 청크로 나누어 섹션으로 나누고 순차적으로 변환합니다.
스트리밍 활성화를 위해 요청 옵션에서 useStreaming=true를 설정합니다.
API 클라이언트 재사용을 통해 여러 변환에서 반복 인증 오버헤드를 피합니다.

이러한 방법은 PHP에서 HTML을 XLSX로 변환하는 성능을 향상시키고 서버의 메모리 부담을 줄입니다.

HTML을 XLSX로 변환하기 위한 보안 모범 사례

자격 증명을 안전하게 저장 - 하드코딩 대신 환경 변수 또는 비밀 관리자를 사용하십시오.
HTML 입력 검증 - 업로드 전에 잠재적으로 위험한 스크립트나 외부 리소스를 제거하십시오.
HTTPS 사용 - 모든 API 엔드포인트는 TLS 1.2 이상을 요구합니다.
최소 권한 원칙 적용 - SDK에 필요한 저장소 범위만 부여하십시오.
사용량 모니터링 - 변환 활동을 추적하기 위해 GroupDocs 포털에서 감사 로그를 활성화하십시오.

Conclusion

HTML to XLSX 변환을 PHP에서 수행하는 것이 GroupDocs.Conversion Cloud SDK for PHP를 사용하면 간단해집니다. 여기서 제시한 단계, 코드 예제 및 보안 지침을 따르면 온프레미스든 클라우드든 풍부한 HTML 콘텐츠에서 Excel 파일을 안정적으로 생성할 수 있습니다. 프로덕션 배포를 위해서는 임시 라이선스 페이지에서 적절한 라이선스를 얻거나 제품 사이트에서 전체 가격 옵션을 확인하십시오.

자주 묻는 질문

PHP에서 HTML을 XLSX로 변환할 때 큰 HTML 파일을 어떻게 처리합니까?
문서를 더 작은 조각으로 나누고, 스트리밍 옵션을 사용하며 각 조각을 순차적으로 처리합니다. SDK의 useStreaming 플래그는 메모리 사용량을 줄이고 변환 속도를 높입니다.

HTML을 XLSX 변환을 위한 PHP에서 API 자격 증명을 보호하는 권장 방법은 무엇인가요?
YOUR_CLIENT_ID와 YOUR_CLIENT_SECRET를 환경 변수 또는 비밀 금고에 저장하고, 절대로 소스 제어에 커밋하지 마세요. SDK는 런타임에 이러한 값을 읽어옵니다.

Azure Functions 또는 AWS Lambda에서 HTML을 XLSX 변환을 실행할 수 있나요?
예. 클라우드 API는 HTTPS 요청을 할 수 있는 모든 환경에서 작동하며, Azure 및 AWS 서버리스 플랫폼도 포함됩니다. 필요에 따라 Composer를 통해 SDK를 포함하고 엔드포인트 URL을 구성하면 됩니다.

HTML을 사용자 정의 파싱 코드를 작성하지 않고 XLSX로 변환하는 방법이 있나요?
물론입니다. SDK의 ConvertDocument 메서드는 모든 파싱 및 매핑 로직을 추상화하여 단일 API 호출만으로 변환할 수 있게 해줍니다.

PHP에서 HTML을 XLSX로 변환하는 단계#

GroupDocs를 사용한 HTML에서 XLSX 변환 - 전체 코드 예제#

cURL을 사용한 REST API를 통한 클라우드 기반 HTML에서 XLSX 변환#

PHP에서 설치 및 설정#

PHP와 GroupDocs.Conversion을 사용한 HTML에서 XLSX 변환 튜토리얼#

GroupDocs.Conversion 기능#

PHP에서 HTML을 XLSX 변환하기 위한 성능 최적화#

HTML을 XLSX로 변환하기 위한 보안 모범 사례#

Conclusion#

자주 묻는 질문#

더 보기#