Abrufen und Aktualisieren von Präsentationsinformationen in PHP

Worum es auf dieser Seite geht

Untersuchen Sie Folien, Struktur und Metadaten in PowerPoint- und OpenDocument-Präsentationen mit Aspose.Slides für PHP für schnellere Einblicke und intelligentere Inhaltsprüfungen.

Übersicht

Aspose.Slides kann das Format einer Präsentation erkennen und deren Dokument‑Metadaten auslesen, ohne ein vollständiges Präsentations‑Objektmodell zu erstellen. Dies ist nützlich, wenn Sie Dateien klassifizieren, ein Inventar erstellen oder Eigenschaften prüfen möchten, bevor Sie entscheiden, ob Sie den Präsentationsinhalt laden und verarbeiten.

Dieser Artikel zeigt die leichte Inspektion über PresentationFactory und PresentationInfo sowie zielgerichtete Aktualisierungen über DocumentProperties.

Prüfen des Präsentationsformats

Falls Sie bereits eine geladene Präsentation besitzen, lesen Sie Determine the Original Presentation Format für die Erkennung nach dem Laden und die Einschränkungen von Legacy‑PPT, PPS und POT‑Streams.

Verwenden Sie PresentationFactory::getPresentationInfo, um eine Datei zu prüfen, ohne eine Presentation‑Instanz zu erzeugen. Die Methode PresentationInfo::getLoadFormat gibt das erkannte Format zurück, z. B. PPTX, PPT oder ODP.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$fileNames = ["pres.pptx", "pres.ppt", "pres.odp"];

foreach ($fileNames as $fileName) {
    $presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($fileName);
    $loadFormat = java_values($presentationInfo->getLoadFormat());
    $formatName = "Other (" . $loadFormat . ")";

    if ($loadFormat === LoadFormat::Pptx) {
        $formatName = "PPTX";
    } elseif ($loadFormat === LoadFormat::Ppt) {
        $formatName = "PPT";
    } elseif ($loadFormat === LoadFormat::Odp) {
        $formatName = "ODP";
    }

    echo $fileName . ": " . $formatName . PHP_EOL;
}

Erstellung eines leichten Präsentationsinventars

Wenn Sie viele Präsentationsdateien verarbeiten, benötigen Sie möglicherweise ein kompaktes Inventar für Validierung, Indexierung oder ein Dokument‑Management‑System. In diesem Szenario verwenden Sie PresentationFactory::getPresentationInfo, um ein PresentationInfo‑Objekt zu erhalten, und rufen dann PresentationInfo::readDocumentProperties auf, um die Dokument‑Metadaten zu lesen. Dieser Ansatz erstellt keine Presentation‑Instanz und erfordert kein Durchlaufen des gesamten Präsentations‑Objektmodells.

Die erweiterten Eigenschaften, die von DocumentProperties bereitgestellt werden, liefern die folgenden Inventarwerte:

Methode	Inventarwert
getSlides	Gesamte Anzahl der Folien.
getHiddenSlides	Anzahl der versteckten Folien.
getNotes	Anzahl der Folien mit Notizen.
getParagraphs	Gesamte Anzahl der Absätze, sofern verfügbar.
getWords	Gesamte Anzahl der Wörter.
getMultimediaClips	Gesamte Anzahl von Audio‑ und Videoclips.

Das folgende Beispiel liest diese Werte, ohne ein Presentation‑Objekt zu erzeugen, und gibt ein kompaktes Inventar aus. Es kombiniert außerdem DocumentProperties::getHeadingPairs mit DocumentProperties::getTitlesOfParts, um Inhaltsgruppen wie Schriftarten, Designs und Folientitel anzuzeigen.

use aspose\slides\LoadFormat;
use aspose\slides\PresentationFactory;

$filePath = "sample.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($filePath);
$documentProperties = $presentationInfo->readDocumentProperties();

$loadFormat = java_values($presentationInfo->getLoadFormat());
$formatName = "Other (" . $loadFormat . ")";

if ($loadFormat === LoadFormat::Pptx) {
    $formatName = "PPTX";
} elseif ($loadFormat === LoadFormat::Ppt) {
    $formatName = "PPT";
} elseif ($loadFormat === LoadFormat::Odp) {
    $formatName = "ODP";
}

echo "File: " . basename($filePath) . PHP_EOL;
echo "Format: " . $formatName . PHP_EOL;
echo "Title: " . java_values($documentProperties->getTitle()) . PHP_EOL;
echo "Author: " . java_values($documentProperties->getAuthor()) . PHP_EOL;
echo "Statistics:" . PHP_EOL;
echo "  Slides: " . java_values($documentProperties->getSlides()) . PHP_EOL;
echo "  Hidden slides: " . java_values($documentProperties->getHiddenSlides()) . PHP_EOL;
echo "  Slides with notes: " . java_values($documentProperties->getNotes()) . PHP_EOL;
echo "  Paragraphs: " . java_values($documentProperties->getParagraphs()) . PHP_EOL;
echo "  Words: " . java_values($documentProperties->getWords()) . PHP_EOL;
echo "  Multimedia clips: " . java_values($documentProperties->getMultimediaClips()) . PHP_EOL;

$headingPairs = $documentProperties->getHeadingPairs();
$titlesOfParts = $documentProperties->getTitlesOfParts();

if (java_is_null($headingPairs) || java_is_null($titlesOfParts)) {
    echo "Content groups: not available" . PHP_EOL;
} else {
    $headingPairs = java_values($headingPairs);
    $titlesOfParts = java_values($titlesOfParts);
    $partIndex = 0;

    if (count($headingPairs) === 0 || count($titlesOfParts) === 0) {
        echo "Content groups: not available" . PHP_EOL;
    } else {
        echo "Content groups:" . PHP_EOL;

        foreach ($headingPairs as $headingPair) {
            $partCount = java_values($headingPair->getCount());
            echo "  " . java_values($headingPair->getName()) . " (" . $partCount . ")" . PHP_EOL;

            for ($partOffset = 0; $partOffset < $partCount && $partIndex < count($titlesOfParts); $partOffset++) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }

        if ($partIndex < count($titlesOfParts)) {
            echo "  Other parts:" . PHP_EOL;

            while ($partIndex < count($titlesOfParts)) {
                echo "    - " . $titlesOfParts[$partIndex] . PHP_EOL;
                $partIndex++;
            }
        }
    }
}

Jedes HeadingPair liefert einen Gruppennamen und die Anzahl der Elemente in dieser Gruppe. DocumentProperties::getTitlesOfParts gibt ein flaches, geordnetes Array zurück, sodass Sie die Anzahl aufeinanderfolgender Titel, die durch jedes Heading‑Pair angegeben werden, verarbeiten können.

Gespeicherte Metadaten und Formatbeschränkungen

Die durch PresentationInfo::readDocumentProperties zurückgegebenen Inventareigenschaften spiegeln die im Quell‑Dokument verfügbaren Metadaten wider. Aspose.Slides lädt und durchläuft das Präsentations‑Objektmodell nicht, um diese Werte für diesen Aufruf neu zu berechnen. Fehlende Eigenschaften werden durch Standardwerte dargestellt, und gespeicherte Werte können veraltet sein, wenn die Anwendung, die die Datei zuletzt gespeichert hat, ihre Dokument‑Eigenschaften nicht aktualisiert hat.

• PPTX: Das Format stellt erweiterte Dokument‑Eigenschaften für Folien, Notizen, versteckte Folien, Absätze, Wörter und Multimedia‑Zählungen sowie Heading‑Pairs und Part‑Titel bereit. Die Verfügbarkeit hängt davon ab, welche Eigenschaften vom Dokument‑Ersteller geschrieben wurden.
• PPT: Das Binärformat kann entsprechende Dokument‑Zusammenfassungs‑Eigenschaften speichern. Ist eine Eigenschaft nicht vorhanden oder wurde nicht vom Dokument‑Ersteller aktualisiert, gibt Aspose.Slides ihren gespeicherten oder Standardwert zurück, anstatt ihn aus den Folien zu berechnen.
• ODP: OpenDocument‑Metadaten liefern allgemeine Dokument‑Statistiken wie Seiten‑, Absatz‑ und Wort‑Zählungen, aber diese Werte lassen sich nicht auf jede PowerPoint‑spezifische erweiterte Eigenschaft abbilden. Metadaten für versteckte Folien, Notizen‑Folien, Multimedia, Heading‑Pairs und Part‑Titel können fehlen, und die Inventareigenschaften können Standardwerte zurückgeben. Behandeln Sie einen Nullwert oder ein leeres Array nicht als endgültigen Beweis dafür, dass der entsprechende Inhalt fehlt.

Verwenden Sie den leichten Metadaten‑Ansatz für Inventare und Vorprüfungen. Laden Sie die Präsentation und prüfen Sie ihr Live‑Objektmodell, wenn das Ergebnis In‑Memory‑Änderungen widerspiegeln muss oder Sie den tatsächlichen Präsentationsinhalt verifizieren möchten.

Aktualisieren von Präsentationseigenschaften

Die durch PresentationInfo::readDocumentProperties zurückgegebenen Eigenschaften können ebenfalls geändert werden, ohne eine Presentation‑Instanz zu erzeugen. Wenden Sie die Änderungen mit PresentationInfo::updateDocumentProperties an und schreiben Sie die gebundene Präsentation mit PresentationInfo::writeBindedPresentation.

Das folgende Bild zeigt die ursprünglichen Dokument‑Eigenschaften.

Das folgende Beispiel ändert den Titel und die zuletzt gespeicherte Zeit und schreibt das Ergebnis in eine neue Datei:

use aspose\slides\PresentationFactory;

$sourceFile = "sample.pptx";
$outputFile = "sample_with_updated_properties.pptx";
$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($sourceFile);
$documentProperties = $presentationInfo->readDocumentProperties();

$documentProperties->setTitle("Quarterly sales report");
$documentProperties->setLastSavedTime(new Java("java.util.Date"));

$presentationInfo->updateDocumentProperties($documentProperties);
$outputStream = new Java("java.io.FileOutputStream", $outputFile);
try {
    $presentationInfo->writeBindedPresentation($outputStream);
} finally {
    $outputStream->close();
}

Das folgende Bild zeigt die aktualisierten Dokument‑Eigenschaften.

Nützliche Links

Für verwandte Sicherheitsprüfungen und Schutz‑Einstellungen siehe die folgenden Artikel:

• Password-Protect Presentations
• Write-Protect Presentations

FAQ

Wie kann ich prüfen, ob Schriftarten eingebettet sind und welche das sind?

Laden Sie die Präsentation und verwenden Sie Presentation::getFontsManager. Rufen Sie FontsManager::getEmbeddedFonts auf, um die eingebetteten Schriftarten zu erhalten, und FontsManager::getFonts, um die von der Präsentation genutzten Schriftarten zu erhalten. Vergleichen Sie die beiden Ergebnisse, um Schriftarten zu finden, die für die Darstellung erforderlich, aber nicht eingebettet sind.

Wie kann ich schnell feststellen, ob die Datei versteckte Folien enthält und wie viele?

Wenn die gespeicherten Dokument‑Metadaten ausreichen, lesen Sie DocumentProperties::getHiddenSlides über PresentationFactory::getPresentationInfo und PresentationInfo::readDocumentProperties. Dies eignet sich für ein leichtes Inventar. Wenn die Präsentation im Speicher geändert wurde, können die gespeicherten Metadaten fehlen oder veraltet sein, oder Sie müssen Live‑Werte prüfen, indem Sie über Presentation::getSlides iterieren und für jede Folie die Methode Slide::getHidden aufrufen.

Kann ich erkennen, ob benutzerdefinierte Foliengröße und -ausrichtung verwendet werden und ob sie von den Vorgaben abweichen?

Ja. Laden Sie die Präsentation und rufen Sie Presentation::getSlideSize auf. Verwenden Sie SlideSize::getType, SlideSize::getSize und SlideSize::getOrientation, um die aktuellen Einstellungen mit den erwarteten Voreinstellungen und Abmessungen zu vergleichen.

Gibt es eine schnelle Möglichkeit zu sehen, ob Diagramme externe Datenquellen referenzieren?

Ja. Lokalisieren Sie jedes Chart und rufen Sie ChartData::getDataSourceType auf. Für ein externes Arbeitsbuch rufen Sie ChartData::getExternalWorkbookPath auf. Der Datentyp und Pfad identifizieren eine externe Referenz, aber die Prüfung, ob das Ziel verfügbar ist, erfordert eine separate Ressourcen‑Überprüfung.

Wie kann ich ‘schwere’ Folien beurteilen, die das Rendern oder PDF‑Export verlangsamen könnten?

Es gibt keine einzelne Komplexitäts‑Eigenschaft. Durchlaufen Sie Presentation::getSlides und für jede Folie die Sammlung BaseSlide::getShapes. Verwenden Sie die Form‑Anzahl sowie das Vorhandensein großer Bilder, Effekte, Animationen oder Multimedia als Screening‑Signale und messen Sie ein repräsentatives Rendering oder Export, bevor Sie eine Folie als bestätigten Performance‑Engpass einstufen.