Reader : Option to not load images (#850)

Author: Progi1984

docs/changes/1.2.0.md

@@ -9,6 +9,7 @@
 - Added support for PHP 8.4 by [@Progi1984](https://github.com/Progi1984) in [#839](https://github.com/PHPOffice/PHPPresentation/pull/839)
 - `phpoffice/phpspreadsheet`: Allow version 3.0 by [@Progi1984](https://github.com/Progi1984) fixing [#836](https://github.com/PHPOffice/PHPPresentation/pull/836) in [#839](https://github.com/PHPOffice/PHPPresentation/pull/839)
 - `createAutoShape` : Add method to create geometric shapes by [@mhasanshahid](https://github.com/mhasanshahid) & [@Progi1984](https://github.com/Progi1984) in [#848](https://github.com/PHPOffice/PHPPresentation/pull/848)
+- Reader : Option to not load images by [@Progi1984](https://github.com/Progi1984) fixing [#795](https://github.com/PHPOffice/PHPPresentation/pull/795) in [#850](https://github.com/PHPOffice/PHPPresentation/pull/850)
 
 ## Bug fixes
 

docs/usage/readers.md

@@ -10,6 +10,21 @@ $reader = IOFactory::createReader('ODPresentation');
 $reader->load(__DIR__ . '/sample.odp');
 ```
 
+### Options
+
+#### Load without images
+
+You can load a presentation without images.
+
+``` php
+<?php
+
+use PhpOffice\PhpPresentation\Reader\ODPresentation;
+
+$reader = new ODPresentation();
+$reader->load(__DIR__ . '/sample.odp', ODPresentation::SKIP_IMAGES);
+```
+
 ## PowerPoint97
 The name of the reader is `PowerPoint97`.
 
@@ -20,6 +35,21 @@ $reader = IOFactory::createReader('PowerPoint97');
 $reader->load(__DIR__ . '/sample.ppt');
 ```
 
+### Options
+
+#### Load without images
+
+You can load a presentation without images.
+
+``` php
+<?php
+
+use PhpOffice\PhpPresentation\Reader\PowerPoint97;
+
+$reader = new PowerPoint97();
+$reader->load(__DIR__ . '/sample.ppt', PowerPoint97::SKIP_IMAGES);
+```
+
 ## PowerPoint2007
 The name of the reader is `PowerPoint2007`.
 
@@ -30,6 +60,21 @@ $reader = IOFactory::createReader('PowerPoint2007');
 $reader->load(__DIR__ . '/sample.pptx');
 ```
 
+### Options
+
+#### Load without images
+
+You can load a presentation without images.
+
+``` php
+<?php
+
+use PhpOffice\PhpPresentation\Reader\PowerPoint2007;
+
+$reader = new PowerPoint2007();
+$reader->load(__DIR__ . '/sample.pptx', PowerPoint2007::SKIP_IMAGES);
+```
+
 ## Serialized
 The name of the reader is `Serialized`.
 

src/PhpPresentation/Reader/ODPresentation.php

@@ -82,6 +82,11 @@ class ODPresentation implements ReaderInterface
      */
     protected $levelParagraph = 0;
 
+    /**
+     * @var bool
+     */
+    protected $loadImages = true;
+
     /**
      * Can the current \PhpOffice\PhpPresentation\Reader\ReaderInterface read the file?
      */
@@ -116,13 +121,15 @@ public function fileSupportsUnserializePhpPresentation(string $pFilename = ''):
     /**
      * Loads PhpPresentation Serialized file.
      */
-    public function load(string $pFilename): PhpPresentation
+    public function load(string $pFilename, int $flags = 0): PhpPresentation
     {
         // Unserialize... First make sure the file supports it!
         if (!$this->fileSupportsUnserializePhpPresentation($pFilename)) {
             throw new InvalidFileFormatException($pFilename, self::class);
         }
 
+        $this->loadImages = !((bool) ($flags & self::SKIP_IMAGES));
+
         return $this->loadFile($pFilename);
     }
 
@@ -532,7 +539,7 @@ protected function loadSlide(DOMElement $nodeSlide): bool
         }
         foreach ($this->oXMLReader->getElements('draw:frame', $nodeSlide) as $oNodeFrame) {
             if ($oNodeFrame instanceof DOMElement) {
-                if ($this->oXMLReader->getElement('draw:image', $oNodeFrame)) {
+                if ($this->loadImages && $this->oXMLReader->getElement('draw:image', $oNodeFrame)) {
                     $this->loadShapeDrawing($oNodeFrame);
 
                     continue;

src/PhpPresentation/Reader/PowerPoint2007.php

@@ -95,6 +95,11 @@ class PowerPoint2007 implements ReaderInterface
      */
     protected $fileRels;
 
+    /**
+     * @var bool
+     */
+    protected $loadImages = true;
+
     /**
      * Can the current \PhpOffice\PhpPresentation\Reader\ReaderInterface read the file?
      */
@@ -129,13 +134,15 @@ public function fileSupportsUnserializePhpPresentation(string $pFilename = ''):
     /**
      * Loads PhpPresentation Serialized file.
      */
-    public function load(string $pFilename): PhpPresentation
+    public function load(string $pFilename, int $flags = 0): PhpPresentation
     {
         // Unserialize... First make sure the file supports it!
         if (!$this->fileSupportsUnserializePhpPresentation($pFilename)) {
             throw new InvalidFileFormatException($pFilename, self::class);
         }
 
+        $this->loadImages = !((bool) ($flags & self::SKIP_IMAGES));
+
         return $this->loadFile($pFilename);
     }
 
@@ -1498,7 +1505,7 @@ protected function loadSlideShapes($oSlide, DOMNodeList $oElements, XMLReader $x
 
                     break;
                 case 'p:pic':
-                    if ($oSlide instanceof AbstractSlide) {
+                    if ($this->loadImages && $oSlide instanceof AbstractSlide) {
                         $this->loadShapeDrawing($xmlReader, $oNode, $oSlide);
                     }
 

src/PhpPresentation/Reader/PowerPoint97.php

@@ -395,6 +395,11 @@ class PowerPoint97 implements ReaderInterface
      */
     private $filename;
 
+    /**
+     * @var bool
+     */
+    protected $loadImages = true;
+
     /**
      * Can the current \PhpOffice\PhpPresentation\Reader\ReaderInterface read the file?
      */
@@ -428,7 +433,7 @@ public function fileSupportsUnserializePhpPresentation(string $pFilename = ''):
     /**
      * Loads PhpPresentation Serialized file.
      */
-    public function load(string $pFilename): PhpPresentation
+    public function load(string $pFilename, int $flags = 0): PhpPresentation
     {
         // Unserialize... First make sure the file supports it!
         if (!$this->fileSupportsUnserializePhpPresentation($pFilename)) {
@@ -437,6 +442,8 @@ public function load(string $pFilename): PhpPresentation
 
         $this->filename = $pFilename;
 
+        $this->loadImages = !((bool) ($flags & self::SKIP_IMAGES));
+
         return $this->loadFile();
     }
 
@@ -1581,7 +1588,7 @@ private function readRecordOfficeArtSpContainer(string $stream, int $pos)
                 if (isset($shpPrimaryOptions['pib'])) {
                     // isDrawing
                     $drawingPib = $shpPrimaryOptions['pib'];
-                    if (isset($this->arrayPictures[$drawingPib - 1])) {
+                    if ($this->loadImages && isset($this->arrayPictures[$drawingPib - 1])) {
                         $gdImage = imagecreatefromstring($this->arrayPictures[$drawingPib - 1]);
                         $arrayReturn['shape'] = new Drawing\Gd();
                         $arrayReturn['shape']->setImageResource($gdImage);

src/PhpPresentation/Reader/ReaderInterface.php

@@ -27,6 +27,11 @@
  */
 interface ReaderInterface
 {
+    /**
+     * Skip loading of images.
+     */
+    public const SKIP_IMAGES = 1;
+
     /**
      * Can the current \PhpOffice\PhpPresentation\Reader\ReaderInterface read the file?
      */
@@ -35,5 +40,5 @@ public function canRead(string $pFilename): bool;
     /**
      * Loads PhpPresentation from file.
      */
-    public function load(string $pFilename): PhpPresentation;
+    public function load(string $pFilename, int $flags = 0): PhpPresentation;
 }

src/PhpPresentation/Reader/Serialized.php

@@ -58,7 +58,7 @@ public function fileSupportsUnserializePhpPresentation(string $pFilename): bool
     /**
      * Loads PhpPresentation Serialized file.
      */
-    public function load(string $pFilename): PhpPresentation
+    public function load(string $pFilename, int $flags = 0): PhpPresentation
     {
         // Check if file exists
         if (!file_exists($pFilename)) {