PHP에서 프레젠테이션 저장

이 페이지의 내용

Aspose.Slides와 함께 PHP에서 PowerPoint 및 OpenDocument 프레젠테이션을 파일이나 스트림으로 저장하고, PPTX 출력 및 진행 보고를 구성합니다.

개요

프레젠테이션을 만든 후 혹은 기존 프레젠테이션 열기, Presentation::save 메서드를 사용하여 결과를 기록합니다. Aspose.Slides for PHP via Java는 PowerPoint, OpenDocument, PDF 및 기타 형식으로 프레젠테이션을 파일 또는 스트림에 저장할 수 있습니다. 다음 섹션에서는 표준 저장 작업과 PPTX 출력에 사용할 수 있는 옵션을 다룹니다.

프레젠테이션을 파일에 저장

프레젠테이션을 파일에 저장하려면 출력 경로와 SaveFormat 값을 Presentation::save 메서드에 전달합니다. 형식 값은 Aspose.Slides가 생성하는 파일 유형을 결정합니다.

다음 예제는 프레젠테이션을 생성하고 이를 PPTX 파일로 저장합니다:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    // 여기에 프레젠테이션 콘텐츠를 추가하거나 수정하십시오.

    $presentation->save("Output.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

원본 형식으로 프레젠테이션 저장

파일 및 스트림 감지 예제, 새로 만든 프레젠테이션의 동작, 그리고 소스 형식과 출력 형식 간 구분에 대해서는 원본 프레젠테이션 형식 확인을 참조하십시오.

배치 처리 애플리케이션에서는 입력 형식을 사전에 알 수 없는 경우가 많습니다. 파일을 로드한 후 Presentation::getSourceFormat 메서드에서 원본 형식을 읽어옵니다. 얻은 SourceFormat 값을 SlideUtil::toSaveFormat 에 전달하여 해당 SaveFormat 값을 얻은 다음, Presentation::save 으로 수정된 프레젠테이션을 기록합니다.

다음 완전한 예제는 입력 디렉터리의 모든 파일을 처리하고 제목을 업데이트한 뒤, 로드된 형식 그대로 출력 디렉터리에 저장합니다:

use aspose\slides\Presentation;
use aspose\slides\SlideUtil;

$inputDirectory = __DIR__ . DIRECTORY_SEPARATOR . "Input";
$outputDirectory = __DIR__ . DIRECTORY_SEPARATOR . "Output";

if (!is_dir($outputDirectory) && !mkdir($outputDirectory, 0777, true)) {
    echo("Cannot create the output directory." . PHP_EOL);
}

$inputFiles = is_dir($inputDirectory) ? scandir($inputDirectory) : false;
if ($inputFiles !== false && is_dir($outputDirectory)) {
    foreach ($inputFiles as $fileName) {
        $inputPath = $inputDirectory . DIRECTORY_SEPARATOR . $fileName;
        if (!is_file($inputPath)) {
            continue;
        }

        $presentation = null;
        $presentationLoaded = false;
        try {
            $presentation = new Presentation($inputPath);
            $presentationLoaded = true;
            $saveFormat = SlideUtil::toSaveFormat($presentation->getSourceFormat());
            $presentation->getDocumentProperties()->setTitle("Processed by the batch application");

            $outputPath = $outputDirectory . DIRECTORY_SEPARATOR . $fileName;
            $presentation->save($outputPath, $saveFormat);
        } catch (\Throwable $exception) {
            echo("Cannot process '" . $inputPath . "': " . $exception->getMessage() . PHP_EOL);
        } finally {
            if ($presentationLoaded) {
                $presentation->dispose();
            }
        }
    }
}

SlideUtil::toSaveFormat 은 PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP 및 PowerPoint XML 을 해당 프레젠테이션 저장 형식에 매핑합니다. 이 매핑은 프레젠테이션 소스 형식에만 적용되며, PDF, HTML, TIFF 또는 이미지와 같은 내보내기 형식을 선택하기 위한 것이 아닙니다. 지원되지 않거나 잘못된 SourceFormat 값을 전달하면 IllegalArgumentException 이 발생합니다.

레거시 PPT, PPS 및 POT 파일은 동일한 바이너리 컨테이너를 사용합니다. 파일 확장자 없이 스트림에서 이러한 프레젠테이션을 로드하면 PPS 또는 POT 파일이 PPT 로 식별될 수 있습니다. 이러한 레거시 하위 유형을 보존해야 하는 경우 원본 파일 이름이나 형식 메타데이터를 별도로 유지하고 출력 파일 이름 및 형식을 선택할 때 사용하십시오.

프레젠테이션을 스트림에 저장

최종 파일 경로에 의존하지 않고 프레젠테이션을 기록하려면 쓰기 가능한 스트림과 SaveFormat 값을 Presentation::save 메서드에 전달합니다. 이 접근 방식은 출력이 웹 서비스에서 반환되거나 데이터베이스에 저장되거나 메모리에서 처리되어야 할 때 유용합니다.

다음 예제는 새 프레젠테이션을 파일 스트림에 저장합니다:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $outputStream = new Java("java.io.FileOutputStream", "Output.pptx");
    try {
        $presentation->save($outputStream, SaveFormat::Pptx);
    } finally {
        $outputStream->close();
    }
} finally {
    $presentation->dispose();
}

미리 정의된 보기 유형으로 프레젠테이션 저장

PowerPoint 가 저장된 프레젠테이션을 처음 열 때 사용할 보기를 지정할 수 있습니다. 저장하기 전에 ViewProperties::setLastView 메서드와 ViewType 값을 사용하십시오.

다음 예제는 슬라이드 마스터 보기를 초기 보기로 설정합니다:

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ViewType;

$presentation = new Presentation();
try {
    $presentation->getViewProperties()->setLastView(ViewType::SlideMasterView);
    $presentation->save("SlideMasterView.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Strict Office Open XML 형식으로 프레젠테이션 저장

Strict 프로필의 Office Open XML 에 부합하는 PPTX 파일을 만들려면 PptxOptions 인스턴스를 생성하고, 해당 인스턴스의 PptxOptions::setConformance 메서드에 Conformance::Iso29500_2008_Strict 값을 전달합니다. 그런 다음 옵션을 Presentation::save 메서드에 전달합니다.

use aspose\slides\Conformance;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$options = new PptxOptions();
$options->setConformance(Conformance::Iso29500_2008_Strict);

$presentation = new Presentation();
try {
    $presentation->save("StrictOfficeOpenXml.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

Zip64 모드에서 Office Open XML 형식으로 프레젠테이션 저장

표준 ZIP 아카이브는 각 항목의 압축 및 비압축 크기, 전체 아카이브 크기 및 항목 수에 제한을 둡니다. PPTX 파일은 ZIP 아카이브이므로 매우 큰 프레젠테이션은 이러한 제한을 초과할 수 있습니다. ZIP64 확장은 적용 가능한 크기 및 항목 수 제한을 확대합니다.

PptxOptions::setZip64Mode 메서드를 사용하여 Aspose.Slides 가 ZIP64 확장을 쓸지 제어합니다:

IfNecessary 은 프레젠테이션이 표준 ZIP 제한을 초과할 때만 ZIP64 를 사용합니다. 기본 모드입니다.
Never 은 ZIP64 확장을 사용하지 않습니다.
Always 은 항상 ZIP64 확장을 씁니다.

다음 예제는 출력 프레젠테이션에 대해 ZIP64 확장을 항상 활성화합니다:

use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\Zip64Mode;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setZip64Mode(Zip64Mode::Always);

    $presentation->save("OutputZip64.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

Warning

Zip64Mode::Never 을 사용하고 프레젠테이션이 표준 ZIP 제한에 맞지 않으면 저장 작업이 PptxException 을 발생시킵니다.

압축 수준으로 Office Open XML 형식으로 프레젠테이션 저장

PPTX 출력에 대해 PptxOptions::setCompressionLevel 메서드를 사용하여 저장 속도와 파일 크기를 균형 있게 조정할 수 있습니다. CompressionLevel 클래스는 다음 값을 제공합니다:

None 은 압축 없이 데이터를 저장합니다.
Level1 은 가장 빠른 압축과 가장 큰 압축 결과물을 제공합니다.
Level2 부터 Level5 까지는 저장 속도보다 작은 출력 파일을 우선합니다.
Level6 은 저장 속도와 파일 크기의 균형을 맞춥니다. 기본 수준입니다.
Level7 와 Level8 은 저장 속도보다 작은 출력을 더욱 우선합니다.
Level9 은 가장 강력한 압축을 제공하지만 가장 많은 처리 시간이 필요합니다.

다음 예제는 압축 없이 프레젠테이션을 저장합니다:

use aspose\slides\CompressionLevel;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setCompressionLevel(CompressionLevel::None);

    $presentation->save("OutputNoCompression.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

다음 예제는 최대 압축 수준을 사용합니다:

use aspose\slides\CompressionLevel;
use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setCompressionLevel(CompressionLevel::Level9);

    $presentation->save("OutputMaximumCompression.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

썸네일 새로 고침 없이 프레젠테이션 저장

프레젠테이션을 PPTX 로 저장할 때 PptxOptions::setRefreshThumbnail 메서드가 문서 썸네일을 제어합니다:

true 은 저장 중에 썸네일을 다시 생성합니다. 기본값입니다.
false 은 기존 썸네일을 보존합니다. 프레젠테이션에 썸네일이 없으면 Aspose.Slides 가 새로 생성하지 않습니다.

다음 예제는 썸네일을 새로 고치지 않고 프레젠테이션을 저장합니다:

use aspose\slides\PptxOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("Sample.pptx");
try {
    $options = new PptxOptions();
    $options->setRefreshThumbnail(false);

    $presentation->save("Output.pptx", SaveFormat::Pptx, $options);
} finally {
    $presentation->dispose();
}

Note

썸네일 새로 고침을 비활성화하면 PPTX 파일 저장에 필요한 시간을 줄일 수 있습니다.

백분율로 저장 진행 상황 업데이트

저장 작업을 모니터링하려면 IProgressCallback 인터페이스를 구현한 Java 프록시를 제공하고, 해당 프록시를 SaveOptions::setProgressCallback 메서드에 전달합니다. Aspose.Slides 는 내보내기 동안 진행 값을 포함한 IProgressCallback::reporting 메서드를 호출합니다.

다음 예제는 PDF 내보내기 진행률을 콘솔에 출력합니다:

use aspose\slides\PdfOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

class ExportProgressHandler {
    function reporting($progressValue) {
        $progress = java("java.lang.Double")->valueOf($progressValue)->intValue();
        echo($progress . "% of the file has been converted." . PHP_EOL);
    }
}

$progressHandler = java_closure(new ExportProgressHandler(), null, java("com.aspose.slides.IProgressCallback"));

$options = new PdfOptions();
$options->setProgressCallback($progressHandler);

$presentation = new Presentation("Sample.pptx");
try {
    $presentation->save("Output.pdf", SaveFormat::Pdf, $options);
} finally {
    $presentation->dispose();
}

Note

Aspose는 Aspose.Slides API 로 구축된 무료 PowerPoint Splitter 를 제공합니다. 이 도구는 프레젠테이션에서 선택한 슬라이드를 별도의 PPT 또는 PPTX 파일로 저장합니다.

FAQ

Aspose.Slides 가 증분 저장 또는 “빠른 저장”을 지원합니까?

아니요. 각 저장 작업은 변경된 부분만 업데이트하는 것이 아니라 전체 출력 파일을 새로 씁니다.

여러 스레드가 동일한 Presentation 인스턴스를 저장할 수 있습니까?

아니요. Presentation 인스턴스는 스레드 안전하지 않음 입니다. 각 인스턴스는 한 번에 하나의 스레드만 접근하고 저장해야 합니다.

프레젠테이션을 저장할 때 하이퍼링크와 외부 연결 파일은 어떻게 처리됩니까?

Hyperlinks 은 프레젠테이션에 그대로 남아 있습니다. Aspose.Slides 는 외부 연결 파일을 복사하지 않으므로 저장된 프레젠테이션은 여전히 해당 위치에 접근할 수 있어야 합니다.

작성자, 제목, 회사, 생성 날짜와 같은 문서 메타데이터를 저장할 수 있습니까?

네. 저장하기 전에 적절한 문서 속성 을 설정하면 Aspose.Slides 가 이를 출력 파일에 기록합니다.

PHP에서 프레젠테이션을 다중 형식으로 변환 PHP에서 슬라이드 쇼 관리