在 PHP 中将 PPT 和 PPTX 转换为 PDF（包含高级功能）

概述

在 PHP 中将 PowerPoint 演示文稿（PPT、PPTX、ODP 等）转换为 PDF 格式具有多种优势，包括跨设备兼容性以及保持演示文稿的布局和格式。本指南演示了如何将演示文稿转换为 PDF 文档，使用各种选项控制图像质量，包含隐藏幻灯片，为 PDF 文件设置密码，检测字体替换，选择特定幻灯片进行转换，以及对输出文档应用合规标准。

PowerPoint 转 PDF 转换

使用 Aspose.Slides，您可以将以下格式的演示文稿转换为 PDF：

• PPT
• PPTX
• ODP

要将演示文稿转换为 PDF，请将文件名作为参数传递给 Presentation 类，然后使用 save 方法将演示文稿保存为 PDF。Presentation 类公开了通常用于将演示文稿转换为 PDF 的 save 方法。

注意

Aspose.Slides for PHP via Java 会在输出文档中插入其 API 信息和版本号。例如，在将演示文稿转换为 PDF 时，Aspose.Slides 会在 Application 字段填入 “Aspose.Slides"，在 PDF Producer 字段填入 “Aspose.Slides v XX.XX” 形式的值。注意，您无法指示 Aspose.Slides 更改或删除这些信息。

Aspose.Slides 允许您转换：

• 整个演示文稿为 PDF
• 演示文稿中的特定幻灯片为 PDF

Aspose.Slides 将演示文稿导出为 PDF，确保生成的 PDF 与原始演示文稿高度匹配。转换过程中元素和属性会被准确渲染，包括：

• 图像
• 文本框和形状
• 文本格式
• 段落格式
• 超链接
• 页眉和页脚
• 项目符号
• 表格

将 PowerPoint 转换为 PDF

标准的 PowerPoint 转 PDF 转换过程使用默认选项。在这种情况下，Aspose.Slides 会尝试使用最佳设置和最高质量级别将提供的演示文稿转换为 PDF。

下面的代码展示了如何将演示文稿（PPT、PPTX、ODP 等）转换为 PDF：

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("PowerPoint.pptx");
try {
    # 将演示文稿保存为 PDF。
    $presentation->save("PPT-to-PDF.pdf", SaveFormat::Pdf);
} finally {
    $presentation->dispose();
}

Aspose 提供了一个免费在线的 PowerPoint 转 PDF 转换器，演示了演示文稿到 PDF 的转换过程。您可以使用该转换器进行测试，以实时实现本文所述的过程。

使用选项将 PowerPoint 转换为 PDF

Aspose.Slides 提供自定义选项——位于 PdfOptions 类下的属性——允许您自定义生成的 PDF、为 PDF 设置密码，或指定转换过程的执行方式。

使用自定义选项将 PowerPoint 转换为 PDF

通过自定义转换选项，您可以为光栅图像定义首选的质量设置，指定元文件的处理方式，为文本设置压缩级别，配置图像的 DPI 等。

下面的代码示例演示了如何使用多个自定义选项将 PowerPoint 演示文稿转换为 PDF：

# 实例化 PdfOptions 类。
$pdfOptions = new PdfOptions();

# 设置 JPG 图像的质量。
$pdfOptions->setJpegQuality(90);

# 设置图像的 DPI。
$pdfOptions->setSufficientResolution(300);

# 设置元文件的处理方式。
$pdfOptions->setSaveMetafilesAsPng(true);

# 设置文本内容的压缩级别。
$pdfOptions->setTextCompression(PdfTextCompression::Flate);

# 定义 PDF 合规模式。
$pdfOptions->setCompliance(PdfCompliance::Pdf15);

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("PowerPoint.pptx");
try {
    # 将演示文稿保存为 PDF 文档。
    $presentation->save("PowerPoint-to-PDF.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

使用隐藏幻灯片将 PowerPoint 转换为 PDF

如果演示文稿包含隐藏幻灯片，您可以使用 PdfOptions 类中的 setShowHiddenSlides 方法将隐藏幻灯片作为页面包含在生成的 PDF 中。

下面的代码展示了如何在转换为 PDF 时包含隐藏幻灯片：

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("PowerPoint.pptx");
try {
    # 实例化 PdfOptions 类。
    $pdfOptions = new PdfOptions();

    # 添加隐藏幻灯片。
    $pdfOptions->setShowHiddenSlides(true);

    # 将演示文稿保存为 PDF。
    $presentation->save("PowerPoint-to-PDF.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

将 PowerPoint 转换为受密码保护的 PDF

下面的代码演示了如何使用 PdfOptions 类的保护参数，将 PowerPoint 演示文稿转换为受密码保护的 PDF：

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("PowerPoint.pptx");
try {
    # 实例化 PdfOptions 类。
    $pdfOptions = new PdfOptions();

    # 设置 PDF 密码和访问权限。
    $pdfOptions->setPassword("password");
    $pdfOptions->setAccessPermissions(PdfAccessPermissions::PrintDocument | PdfAccessPermissions::HighQualityPrint);

    # 将演示文稿保存为 PDF。
    $presentation->save("PPTX-to-PDF.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

检测字体替换

Aspose.Slides 在 PdfOptions 类下提供了 setWarningCallback 方法，使您能够在演示文稿转 PDF 的过程中检测字体替换。

下面的代码展示了如何检测字体替换：

class FontSubstitutionHandler {
    function warning($warning)
    {
        if (java_values($warning->getWarningType()) == WarningType::DataLoss &&
        $warning->getDescription()->startsWith("Font will be substituted")) {
            echo("Font substitution warning: " . $warning->getDescription());
        }

        return ReturnAction::Continue;
    }
}

// 设置 PDF 选项中的警告回调。
$pdfOptions = new PdfOptions();
$warningCallback = java_closure(new FontSubstitutionHandler(), null, java("com.aspose.slides.IWarningCallback"));
$pdfOptions->setWarningCallback($warningCallback);

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("sample.pptx");
try {
    // 将演示文稿保存为 PDF。
    $presentation->save("output.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

有关字体替换的更多信息，请参阅 字体替换 文章。

将 PowerPoint 中选定的幻灯片转换为 PDF

下面的代码演示了如何仅将 PowerPoint 演示文稿中的特定幻灯片转换为 PDF：

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("PowerPoint.pptx");
try {
    # 设置幻灯片编号数组。
    $slides = array(1, 3);

    # 将演示文稿保存为 PDF。
    $presentation->save("PPTX-to-PDF.pdf", $slides, SaveFormat::Pdf);
} finally {
    $presentation->dispose();
}

使用自定义幻灯片尺寸将 PowerPoint 转换为 PDF

下面的代码演示了如何使用指定的幻灯片尺寸将 PowerPoint 演示文稿转换为 PDF：

$slideWidth = 612.0;
$slideHeight = 792.0;

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("SelectedSlides.pptx");

# 创建一个具有调整后幻灯片大小的新演示文稿。
$resizedPresentation = new Presentation();

try {
    # 设置自定义幻灯片大小。
    $resizedPresentation->getSlideSize()->setSize($slideWidth, $slideHeight, SlideSizeScaleType::EnsureFit);

    # 从原始演示文稿克隆第一张幻灯片。
    $slide = $presentation->getSlides()->get_Item(0);
    $resizedPresentation->getSlides()->insertClone(0, $slide);

    # 将调整大小的演示文稿保存为带备注的 PDF。
    $resizedPresentation->save("PDFnotes_out.pdf", SaveFormat::Pdf);
} finally {
    $resizedPresentation->dispose();
    $presentation->dispose();
}

在备注幻灯片视图下将 PowerPoint 转换为 PDF

下面的代码演示了如何将包含备注的 PowerPoint 演示文稿转换为 PDF：

# 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
$presentation = new Presentation("SelectedSlides.pptx");
try {
    # 使用备注布局配置 PDF 选项。
    $notesOptions = new NotesCommentsLayoutingOptions();
    $notesOptions->setNotesPosition(NotesPositions::BottomFull);
    $pdfOptions = new PdfOptions();
    $pdfOptions->setSlidesLayoutOptions($notesOptions);

    # 将演示文稿保存为带备注的 PDF。
    $presentation->save("PDF_with_notes.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

PDF 的可访问性和合规标准

Aspose.Slides 允许您使用符合 Web Content Accessibility Guidelines (WCAG) 的转换过程。您可以使用以下任意合规标准将 PowerPoint 文档导出为 PDF：PDF/A1a、PDF/A1b 和 PDF/UA。

下面的代码演示了一个基于不同合规标准生成多个 PDF 的 PowerPoint 转 PDF 过程：

$presentation = new Presentation("pres.pptx");
try {
    $pdfOptions = new PdfOptions();

    $pdfOptions->setCompliance(PdfCompliance::PdfA1a);
    $presentation->save("pres-a1a-compliance.pdf", SaveFormat::Pdf, $pdfOptions);

    $pdfOptions->setCompliance(PdfCompliance::PdfA1b);
    $presentation->save("pres-a1b-compliance.pdf", SaveFormat::Pdf, $pdfOptions);

    $pdfOptions->setCompliance(PdfCompliance::PdfUa);
    $presentation->save("pres-ua-compliance.pdf", SaveFormat::Pdf, $pdfOptions);
} finally {
    $presentation->dispose();
}

注意

Aspose.Slides 支持 PDF 转换操作，允许您将 PDF 文件转换为常用格式。您可以执行 PDF 转 HTML、PDF 转图像、PDF 转 JPG、和 PDF 转 PNG 转换。其他到专用格式的 PDF 转换操作——PDF 转 SVG、PDF 转 TIFF、以及 PDF 转 XML——也受到支持。

注意： 在导出为 PDF/UA 时，Aspose.Slides 将 SmartArt、图表和公式等复杂图形视为单个图形。单独的路径元素不会保留为独立内容，可能会标记为伪影；仅为整个图形提供替代文本。

常见问题解答

能否批量将多个 PowerPoint 文件转换为 PDF？
是的，Aspose.Slides 支持批量将多个 PPT 或 PPTX 文件转换为 PDF。您可以遍历文件并以编程方式应用转换过程。

是否可以为转换后的 PDF 设置密码保护？
当然。使用 PdfOptions 类在转换过程中设置密码并定义访问权限。

如何在 PDF 中包含隐藏幻灯片？
在 PdfOptions 类中使用 setShowHiddenSlides 方法即可在生成的 PDF 中包含隐藏幻灯片。

Aspose.Slides 能否在 PDF 中保持高图像质量？
可以，您可以使用 setJpegQuality 和 setSufficientResolution 等方法在 PdfOptions 类中控制图像质量，确保 PDF 中的图像保持高质量。

Aspose.Slides 是否支持 PDF/A 合规标准？
是的，Aspose.Slides 允许您导出符合多种标准的 PDF，包括 PDF/A1a、PDF/A1b 和 PDF/UA，确保文档满足可访问性和存档要求。

其他资源

• Aspose.Slides for PHP via Java 文档
• Aspose.Slides for PHP via Java API 参考
• Aspose 免费在线转换器