在 PHP 中管理演示文稿 BLOB 以实现高效内存使用

关于 BLOB

BLOB (Binary Large Object) 通常是以二进制格式保存的大型项目（照片、演示文稿、文档或媒体）。

Aspose.Slides for PHP via Java 允许您以降低内存消耗的方式在处理大型文件时使用 BLOB。

Info

为规避在与流交互时的某些限制，Aspose.Slides 可能会复制流的内容。通过流加载大型演示文稿会导致复制演示文稿内容并引起加载缓慢。因此，当您计划加载大型演示文稿时，强烈建议使用演示文稿文件路径而不是其流。

使用 BLOB 减少内存消耗

通过 BLOB 将大文件添加到演示文稿

Aspose.Slides for Java 允许您通过 BLOB 过程添加大文件（此示例为大视频文件），以降低内存消耗。

此 Java 示例展示了如何通过 BLOB 过程将大视频文件添加到演示文稿：

  $pathToVeryLargeVideo = "veryLargeVideo.avi";
  # 创建一个新演示文稿，以添加视频
  $pres = new Presentation();
  try {
    $fileStream = new Java("java.io.FileInputStream", $pathToVeryLargeVideo);
    try {
      # 将视频添加到演示文稿 - 我们选择 KeepLocked 行为，因为我们
      # 不打算访问 "veryLargeVideo.avi" 文件。
      $video = $pres->getVideos()->addVideo($fileStream, LoadingStreamBehavior->KeepLocked);
      $pres->getSlides()->get_Item(0)->getShapes()->addVideoFrame(0, 0, 480, 270, $video);
      # 保存演示文稿。虽然生成大型演示文稿，内存消耗
      # 在 pres 对象的整个生命周期中保持低水平
      $pres->save("presentationWithLargeVideo.pptx", SaveFormat::Pptx);
    } finally {
      if (!java_is_null($fileStream)) {
        $fileStream->close();
      }
    }
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

通过 BLOB 从演示文稿导出大文件

Aspose.Slides for PHP via Java 允许您通过 BLOB 过程从演示文稿导出大文件（例如音频或视频文件）。例如，您可能需要从演示文稿中提取大型媒体文件，但不希望该文件加载到计算机内存中。通过 BLOB 过程导出文件，可保持低内存消耗。

以下代码演示了上述操作：

  $hugePresentationWithAudiosAndVideosFile = "LargeVideoFileTest.pptx";
  $loadOptions = new LoadOptions();
  # 锁定源文件且不将其加载到内存中
  $loadOptions->getBlobManagementOptions()->setPresentationLockingBehavior(PresentationLockingBehavior->KeepLocked);
  # 创建 Presentation 实例，并锁定 "hugePresentationWithAudiosAndVideos.pptx" 文件。
  $pres = new Presentation($hugePresentationWithAudiosAndVideosFile, $loadOptions);
  try {
    # 将每个视频保存到文件。为防止内存使用过高，我们需要一个缓冲区，用于
    # 将演示文稿的视频流数据传输到新创建的视频文件的流中。
    $Array = new JavaClass("java.lang.reflect.Array");
    $Byte = new JavaClass("java.lang.Byte");
    $buffer = $Array->newInstance($Byte, 8 * 1024);
    # 遍历所有视频
    for($index = 0; $index < java_values($pres->getVideos()->size()) ; $index++) {
      $video = $pres->getVideos()->get_Item($index);
      # 打开演示文稿的视频流。请注意，我们有意避免访问属性
      # 如 video.BinaryData ——因为该属性返回包含完整视频的字节数组，这将
      # 导致字节被加载到内存中。我们使用 video.GetStream，它返回 Stream ——且不会
      # 要求我们将整个视频加载到内存中。
      $presVideoStream = $video->getStream();
      try {
        $outputFileStream = new Java("java.io.FileOutputStream", "video" . $index . ".avi");
        try {
          $bytesRead;
          while ($bytesRead = $presVideoStream->read($buffer, 0, java_values($Array->getLength($buffer))) > 0) {
            $outputFileStream->write($buffer, 0, $bytesRead);
          } 
        } finally {
          $outputFileStream->close();
        }
      } finally {
        $presVideoStream->close();
      }
      # 无论视频或演示文稿大小如何，内存消耗都将保持在低水平。
    }
    # 如有必要，您可以对音频文件执行相同的操作。
  } catch (JavaException $e) {
  } finally {
    $pres->dispose();
  }

将图像作为 BLOB 添加到演示文稿

使用 IImageCollection 接口和 ImageCollection 类的方法，您可以将大图像作为流添加，从而将其视为 BLOB。

此 PHP 代码展示了如何通过 BLOB 过程添加大图像：

  $pathToLargeImage = "large_image.jpg";
  # 创建一个新演示文稿，将向其添加图像。
  $pres = new Presentation();
  try {
    $fileStream = new Java("java.io.FileInputStream", $pathToLargeImage);
    try {
      # 将图像添加到演示文稿 - 我们选择 KeepLocked 行为，因为我们
      # 不打算访问 "largeImage.png" 文件。
      $img = $pres->getImages()->addImage($fileStream, LoadingStreamBehavior->KeepLocked);
      $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 0, 0, 300, 200, $img);
      # 保存演示文稿。虽然生成大型演示文稿，内存消耗
      # 在整个 pres 对象的生命周期中保持低水平
      $pres->save("presentationWithLargeImage.pptx", SaveFormat::Pptx);
    } finally {
      if (!java_is_null($fileStream)) {
        $fileStream->close();
      }
    }
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

内存与大型演示文稿

通常，加载大型演示文稿时，计算机需要大量临时内存。演示文稿的所有内容都会被加载到内存中，而加载来源的文件则不再被使用。

考虑一个包含 1.5 GB 视频文件的大型 PowerPoint 演示文稿（large.pptx）。以下 PHP 代码演示了标准加载方法：

  $pres = new Presentation("large.pptx");
  try {
    $pres->save("large.pdf", SaveFormat::Pdf);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

但此方法会消耗约 1.6 GB 的临时内存。

将大型演示文稿作为 BLOB 加载

通过 BLOB 过程，您可以在使用很少内存的情况下加载大型演示文稿。以下 PHP 代码描述了使用 BLOB 过程加载大型演示文稿文件（large.pptx）的实现：

  $loadOptions = new LoadOptions();
  $loadOptions->getBlobManagementOptions()->setPresentationLockingBehavior(PresentationLockingBehavior->KeepLocked);
  $loadOptions->getBlobManagementOptions()->setTemporaryFilesAllowed(true);
  $pres = new Presentation("large.pptx", $loadOptions);
  try {
    $pres->save("large.pdf", SaveFormat::Pdf);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

更改临时文件夹

使用 BLOB 过程时，计算机会在默认的临时文件夹中创建临时文件。如果希望临时文件保存在其他文件夹，可以使用 TempFilesRootPath 更改存储设置：

  $loadOptions = new LoadOptions();
  $loadOptions->getBlobManagementOptions()->setPresentationLockingBehavior(PresentationLockingBehavior->KeepLocked);
  $loadOptions->getBlobManagementOptions()->setTemporaryFilesAllowed(true);
  $loadOptions->getBlobManagementOptions()->setTempFilesRootPath("temp");

Info

使用 TempFilesRootPath 时，Aspose.Slides 不会自动创建用于存放临时文件的文件夹。您需要手动创建该文件夹。

常见问题

在 Aspose.Slides 演示文稿中，哪些数据会被视为 BLOB 并受 BLOB 选项控制？

图像、音频和视频等大型二进制对象会被视为 BLOB。整个演示文稿文件在加载或保存时也涉及 BLOB 处理。这些对象受 BLOB 策略管理，您可以控制内存使用并在需要时转存到临时文件。

在哪里配置演示文稿加载期间的 BLOB 处理规则？

使用 LoadOptions 配合 BlobManagementOptions。在此可以设置 BLOB 的内存上限，是否允许临时文件，临时文件根路径以及源锁定行为。

BLOB 设置会影响性能吗，如何在速度与内存之间取得平衡？

会。将 BLOB 保留在内存中可提升速度但会增加 RAM 消耗；降低内存上限会将更多工作转移到临时文件，从而降低 RAM 使用，但会产生额外的 I/O。使用 setMaxBlobsBytesInMemory 方法可针对您的工作负载和环境找到合适的平衡点。

在打开极大的演示文稿（例如数 GB）时，BLOB 选项有帮助吗？

有。BlobManagementOptions 专为此类场景设计：启用临时文件并使用源锁定可显著降低峰值 RAM 使用，并使处理极大文件更加稳定。

可以在从流而非磁盘文件加载时使用 BLOB 策略吗？

可以。相同的规则适用于流：演示文稿实例可以拥有并锁定输入流（取决于选择的锁定模式），并在允许的情况下使用临时文件，从而在处理期间保持可预测的内存使用。