PHP에서 HTML을 PNG로 변환하는 것은 썸네일, 이메일 미리보기 및 보고서를 만들 때 일반적인 필요입니다.
Aspose.HTML Cloud SDK for PHP는 서버 측 변환을 간단하게 해주는 강력한 라이브러리를 제공합니다.
이 가이드에서는 SDK 설정 방법, 변환 옵션 구성, 전체 코드 예제 실행, 그리고 자동화된 워크플로를 위한 cURL REST 호출로 동일 작업을 수행하는 방법을 배웁니다.

PHP에서 HTML을 PNG로 변환 - 단계별 가이드

  1. Composer를 통해 SDK 설치: 공식 Composer 명령을 사용하여 라이브러리를 프로젝트에 추가합니다.
composer require aspose-html-cloud
  1. Aspose Cloud 자격 증명을 구성합니다: Configuration 객체를 생성하고 AppSid와 AppKey를 설정합니다.
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. Convert API 초기화: 구성 객체를 사용하여 ConvertApi를 인스턴스화합니다.
$convertApi = new ConvertApi($config);
  1. 변환 옵션 설정: ConvertOptions를 사용하여 출력 형식, 크기, 품질 및 배경 색상을 정의합니다.
$options = new ConvertOptions();
$options->setOutputFormat('png');
$options->setWidth(1024);
$options->setHeight(0);               // Preserve aspect ratio
$options->setQuality(90);
$options->setBackgroundColor('#FFFFFF');
  1. 변환 수행: convertLocal를 호출하여 소스 HTML 파일과 대상 PNG 경로를 지정합니다.
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

자세한 클래스 및 메서드 정보는 API 참조를 참조하십시오.

PHP에서 HTML을 PNG로 변환 - 전체 코드 예제

이 예제는 Aspose.HTML Cloud SDK for PHP를 사용하여 로컬 HTML 파일을 PNG 이미지로 변환하는 방법을 보여줍니다.

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

use Aspose\HTML\Cloud\Configuration;
use Aspose\HTML\Cloud\Api\ConvertApi;
use Aspose\HTML\Cloud\Model\ConvertOptions;

// -----------------------------------------------------------------------------
// Configuration – replace with your actual Aspose Cloud credentials
// -----------------------------------------------------------------------------
$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

// -----------------------------------------------------------------------------
// Initialize the Convert API
// -----------------------------------------------------------------------------
$convertApi = new ConvertApi($config);

// -----------------------------------------------------------------------------
// Define source HTML and destination PNG paths (generic, adjust as needed)
// -----------------------------------------------------------------------------
$inputHtmlPath  = __DIR__ . '/sample.html';
$outputPngPath  = __DIR__ . '/sample.png';

// -----------------------------------------------------------------------------
// Set conversion options – adjust width/height, quality, and background color
// -----------------------------------------------------------------------------
$options = new ConvertOptions();
$options->setOutputFormat('png');      // Target format
$options->setWidth(1024);              // Desired width (pixels)
$options->setHeight(0);                // Height 0 preserves aspect ratio
$options->setQuality(90);              // PNG compression level (0‑100)
$options->setBackgroundColor('#FFFFFF'); // Optional background for transparent pages

// -----------------------------------------------------------------------------
// Perform the conversion
// -----------------------------------------------------------------------------
try {
    $convertApi->convertLocal($inputHtmlPath, $outputPngPath, $options);
    echo "Conversion successful: {$outputPngPath}\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

// -----------------------------------------------------------------------------
// No explicit cleanup required – SDK handles temporary resources internally
// -----------------------------------------------------------------------------
?>

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

cURL 및 REST API를 사용하여 HTML을 PNG로 변환

다음 cURL 명령은 Aspose.HTML Cloud REST API를 사용하여 동일한 HTML을 PNG로 변환하는 방법을 보여줍니다.

  1. 액세스 토큰 얻기 (자리 표시자를 클라이언트 자격 증명으로 교체하십시오).
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 소스 HTML 파일을 업로드 스토리지에.
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary "@sample.html"
  1. PNG로 변환 요청.
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png&width=1024&quality=90&backgroundColor=%23FFFFFF" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"sample.html","outputPath":"sample.png"}'
  1. 생성된 PNG 파일 다운로드.
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

전체 매개변수 목록 및 추가 옵션에 대해서는 공식 API 문서를 참조하십시오.

Aspose.HTML Cloud SDK for PHP에 대한 필수 조건 및 설정

시작하기 전에, 다음이 있는지 확인하십시오:

  • PHP 7.4 이상이 설치되어 있습니다.
  • 개발 머신에 Composer가 설치되어 있습니다.
  • 유효한 AppSid 및 AppKey가 있는 Aspose Cloud 계정.

Composer를 사용하여 SDK를 설치합니다:

composer require aspose-html-cloud

공식 릴리스 페이지에서 최신 패키지를 다운로드할 수 있습니다: Aspose.HTML Cloud SDK for PHP Release.

단계 섹션에 표시된 대로 자격 증명을 구성하면 HTML을 PNG로 변환할 준비가 됩니다.

결론

PHP에서 HTML을 PNG로 변환하는 작업이 Aspose.HTML Cloud SDK for PHP 덕분에 손쉽게 이루어집니다. 이 라이브러리는 서버 측에서 렌더링, 스케일링 및 이미지 최적화를 처리하여 브라우저나 외부 도구가 필요하지 않습니다. 단계별 가이드를 따라 하면 썸네일 생성, 이메일 렌더링 또는 보고서 생성 등 어떤 PHP 애플리케이션에도 고품질 PNG 생성을 통합할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보해야 함을 기억하세요; 가격 정보는 제품 페이지에서 확인할 수 있으며, 라이브러리를 평가하는 동안 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다.

자주 묻는 질문

  • HTML을 PNG로 변환하는 PHP는 브라우저 없이 어떻게 작동하나요?
    Aspose.HTML Cloud SDK for PHP는 자체 렌더링 엔진을 사용해 서버에서 HTML을 렌더링하므로 브라우저나 헤드리스 Chrome이 필요하지 않습니다.

  • 이미지 크기와 품질을 제어할 수 있나요?
    예. ConvertOptions 클래스를 사용하여 변환 API를 호출하기 전에 너비, 높이, 품질(0‑100) 및 배경 색상을 설정합니다.

  • 여러 HTML 파일을 한 번에 PNG로 변환할 수 있나요?
    물론입니다. 파일 목록을 순회하고 동일한 ConvertApi 인스턴스를 재사용하며 각 반복마다 입력 및 출력 경로를 조정하십시오.

  • 상업 프로젝트에 필요한 라이선스는 무엇인가요?
    제품 페이지에서 가격을 확인하고 임시 라이선스 페이지에서 임시 평가 라이선스를 얻을 수 있습니다.

더 읽기