PHP에서 프레젠테이션 저장
개요
Open Presentations in PHP 은 프레젠테이션을 여는 방법을 설명합니다. Presentation 클래스를 사용합니다. 이 문서에서는 프레젠테이션을 만들고 저장하는 방법을 설명합니다. Presentation 클래스는 프레젠테이션의 내용을 포함합니다. 처음부터 프레젠테이션을 만들든 기존 프레젠테이션을 수정하든 작업이 끝나면 저장해야 합니다. Aspose.Slides for PHP를 사용하면 파일 또는 스트림에 저장할 수 있습니다. 이 문서에서는 프레젠테이션을 저장하는 다양한 방법을 설명합니다.
파일에 프레젠테이션 저장
프레젠테이션을 파일에 저장하려면 Presentation 클래스의 save 메서드를 호출합니다. 메서드에 파일 이름과 저장 형식을 전달합니다. 다음 예제는 Aspose.Slides를 사용하여 프레젠테이션을 저장하는 방법을 보여줍니다.
// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
$presentation = new Presentation();
try {
// 여기서 작업을 수행합니다...
// 프레젠테이션을 파일에 저장합니다.
$presentation->save("Output.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
스트림에 프레젠테이션 저장
출력 스트림을 Presentation 클래스의 save 메서드에 전달하여 프레젠테이션을 스트림에 저장할 수 있습니다. 프레젠테이션은 다양한 스트림 유형에 기록될 수 있습니다. 아래 예제에서는 새 프레젠테이션을 생성하고 파일 스트림에 저장합니다.
// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
$presentation = new Presentation();
try {
$fileStream = new Java("java.io.FileOutputStream", "Output.pptx");
try {
// 프레젠테이션을 스트림에 저장합니다.
$presentation->save($fileStream, SaveFormat::Pptx);
} finally {
$fileStream->close();
}
} finally {
$presentation->dispose();
}
미리 정의된 보기 유형으로 프레젠테이션 저장
Aspose.Slides를 사용하면 생성된 프레젠테이션이 열릴 때 PowerPoint가 사용하는 초기 보기를 ViewProperties 클래스를 통해 설정할 수 있습니다. ViewType 열거형의 값을 사용하여 setLastView 메서드를 사용합니다.
$presentation = new Presentation();
try {
$presentation->getViewProperties()->setLastView(ViewType::SlideMasterView);
$presentation->save("SlideMasterView.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Strict Office Open XML 형식으로 프레젠테이션 저장
Aspose.Slides를 사용하면 프레젠테이션을 Strict Office Open XML 형식으로 저장할 수 있습니다. 저장할 때 PptxOptions 클래스를 사용하고 해당 conformance 속성을 설정합니다. Conformance.Iso29500_2008_Strict를 설정하면 출력 파일이 Strict Office Open XML 형식으로 저장됩니다.
아래 예제는 프레젠테이션을 생성하고 Strict Office Open XML 형식으로 저장합니다.
$options = new PptxOptions();
$options->setConformance(Conformance::Iso29500_2008_Strict);
// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
$presentation = new Presentation();
try {
// 프레젠테이션을 Strict Office Open XML 형식으로 저장합니다.
$presentation->save("StrictOfficeOpenXml.pptx", SaveFormat::Pptx, $options);
} finally {
$presentation->dispose();
}
Zip64 모드로 Office Open XML 형식에 프레젠테이션 저장
Office Open XML 파일은 ZIP 압축 파일로, 압축되지 않은 파일 크기, 압축된 파일 크기 및 전체 아카이브 크기에 각각 4GB(2^32 바이트) 제한을 두고, 아카이브에 포함될 수 있는 파일 수를 65,535(2^16-1)개로 제한합니다. ZIP64 포맷 확장은 이러한 제한을 2^64까지 확장합니다.
PptxOptions.setZip64Mode 메서드를 사용하면 Office Open XML 파일을 저장할 때 ZIP64 포맷 확장을 사용할 시점을 선택할 수 있습니다.
이 메서드는 다음 모드와 함께 사용할 수 있습니다:
- IfNecessary 은 프레젠테이션이 위 제한을 초과할 경우에만 ZIP64 포맷 확장을 사용합니다. 기본 모드입니다.
- Never 은 ZIP64 포맷 확장을 전혀 사용하지 않습니다.
- Always 은 항상 ZIP64 포맷 확장을 사용합니다.
다음 코드는 ZIP64 포맷 확장이 활성화된 상태로 PPTX 파일로 프레젠테이션을 저장하는 방법을 보여줍니다:
$pptxOptions = new PptxOptions();
$pptxOptions->setZip64Mode(Zip64Mode::Always);
$presentation = new Presentation("Sample.pptx");
try {
$presentation->save("OutputZip64.pptx", SaveFormat::Pptx, $pptxOptions);
} finally {
$presentation->dispose();
}
압축 수준을 지정해 Office Open XML 형식으로 프레젠테이션 저장
대용량 프레젠테이션을 다룰 때 파일 크기와 처리 시간을 균형 있게 맞추기 위해 압축 수준을 조정할 수 있습니다. 요구 사항에 따라 더 빠른 처리 또는 더 작은 출력 파일을 선호할 수 있습니다.
Aspose.Slides는 PptxOptions.setCompressionLevel 메서드를 제공하며, 이를 통해 Office Open XML 형식으로 프레젠테이션을 저장할 때 사용할 압축 수준을 지정할 수 있습니다.
다음 압축 수준을 사용할 수 있습니다:
- None: 압축이 적용되지 않습니다. 파일이 있는 그대로 저장됩니다.
- Level1: 가장 낮은 압축 비율로 가장 빠른 압축을 수행합니다.
- Level2: Level1 보다 약간 더 나은 압축 비율로 더 빠른 압축을 수행합니다.
- Level3: Level2 보다 더 나은 압축을 제공하지만 처리 시간에 중간 정도 영향을 줍니다.
- Level4: Level3 보다 더 나은 압축을 제공합니다.
- Level5: Level4 보다 개선된 압축을 제공하지만 추가적인 처리 시간이 필요합니다.
- Level6: 처리 속도와 파일 크기의 균형이 좋은 표준 압축이며 기본 압축 수준 입니다.
- Level7: Level6 보다 더 나은 압축을 제공하지만 처리 속도가 느립니다.
- Level8: Level7 보다 더 나은 압축을 제공합니다.
- Level9: 최대 압축으로 가장 작은 파일 크기를 만들지만 가장 긴 처리 시간이 소요됩니다.
다음 예제는 압축 없이 PPTX 파일로 프레젠테이션을 저장하는 방법을 보여줍니다:
$pptxOptions = new PptxOptions();
$pptxOptions->setCompressionLevel(CompressionLevel::None);
$presentation = new Presentation("Sample.pptx");
try {
$presentation->save("Sample-out.pptx", SaveFormat::Pptx, $pptxOptions);
} finally {
$presentation->dispose();
}
다음 예제는 최대 압축으로 PPTX 파일에 프레젠테이션을 저장하는 방법을 보여줍니다:
$pptxOptions = new PptxOptions();
$pptxOptions->setCompressionLevel(CompressionLevel::Level9);
$presentation = new Presentation("Sample.pptx");
try {
$presentation->save("Sample-level9.pptx", SaveFormat::Pptx, $pptxOptions);
} finally {
$presentation->dispose();
}
썸네일을 새로 고치지 않고 프레젠테이션 저장
PptxOptions.setRefreshThumbnail 메서드는 PPTX로 프레젠테이션을 저장할 때 썸네일 생성을 제어합니다:
true로 설정하면 저장 중에 썸네일이 새로 고쳐집니다. 기본값입니다.false로 설정하면 현재 썸네일이 보존됩니다. 프레젠테이션에 썸네일이 없으면 썸네일이 생성되지 않습니다.
아래 코드에서는 썸네일을 새로 고치지 않고 PPTX로 프레젠테이션을 저장합니다.
$pptxOptions = new PptxOptions();
$pptxOptions->setRefreshThumbnail(false);
$presentation = new Presentation("Sample.pptx");
try {
$presentation->save("Output.pptx", SaveFormat::Pptx, $pptxOptions);
}
finally {
$presentation->dispose();
}
Info
이 옵션은 PPTX 형식으로 프레젠테이션을 저장하는 데 걸리는 시간을 줄이는 데 도움이 됩니다.백분율로 저장 진행 상황 업데이트
저장 진행 상황 보고는 SaveOptions 및 그 하위 클래스의 setProgressCallback 메서드를 통해 구성됩니다. IProgressCallback 인터페이스를 구현하는 Java 프록시를 제공하면 내보내기 중에 콜백이 주기적인 백분율 업데이트를 받습니다.
다음 코드 스니펫은 IProgressCallback 사용 방법을 보여줍니다.
class ExportProgressHandler {
function reporting($progressValue) {
// 여기서 진행률 퍼센트 값을 사용합니다.
$progress = java("java.lang.Double")->valueOf($progressValue)->intValue();
echo($progress . "% of the file has been converted.");
}
}
$progressHandler = java_closure(new ExportProgressHandler(), null, java("com.aspose.slides.IProgressCallback"));
$saveOptions = new PdfOptions();
$saveOptions->setProgressCallback($progressHandler);
$presentation = new Presentation("Sample.pptx");
try {
$presentation->save("Output.pdf", SaveFormat::Pdf, $saveOptions);
} finally {
$presentation->dispose();
}
Info
Aspose는 자체 API를 활용한 무료 PowerPoint Splitter 앱 을 개발했습니다. 이 앱을 사용하면 선택한 슬라이드를 새 PPTX 또는 PPT 파일로 저장하여 프레젠테이션을 여러 파일로 분할할 수 있습니다.FAQ
“Fast Save”(증분 저장)가 지원되어 변경된 부분만 기록되나요?
아니요. 저장할 때마다 전체 대상 파일이 새로 생성되며, 증분 “Fast Save"는 지원되지 않습니다.
여러 스레드에서 동일한 Presentation 인스턴스를 저장하는 것이 스레드 안전한가요?
아니요. Presentation 인스턴스는 스레드 안전하지 않으며; 단일 스레드에서 저장해야 합니다.
저장 시 하이퍼링크와 외부 연결 파일은 어떻게 처리되나요?
Hyperlinks 은 그대로 유지됩니다. 외부 연결 파일(예: 상대 경로를 사용하는 비디오)은 자동으로 복사되지 않으므로, 참조 경로가 계속 접근 가능하도록 해야 합니다.
문서 메타데이터(작성자, 제목, 회사, 날짜)를 설정/저장할 수 있나요?
예. 표준 문서 속성 을 지원하며, 저장 시 파일에 기록됩니다.