Informatie over presentaties ophalen en bijwerken in PHP

Waar deze pagina over gaat

Verken dia’s, structuur en metadata in PowerPoint‑ en OpenDocument‑presentaties met Aspose.Slides voor PHP voor snellere inzichten en slimmere inhoudsaudits.

Overzicht

Aspose.Slides kan het formaat van een presentatie identificeren en de documentmetadata lezen zonder een volledig presentatiemodel te creëren. Dit is handig wanneer u bestanden moet classificeren, een inventaris moet opstellen of eigenschappen moet inspecteren voordat u beslist of u de presentatie‑inhoud wilt laden en verwerken.

Dit artikel demonstreert een lichtgewicht inspectie via PresentationFactory en PresentationInfo, evenals gerichte updates via DocumentProperties.

Controleer een presentatieformaat

Als u al een geladen presentatie heeft, zie Determine the Original Presentation Format voor detectie na het laden en de beperkingen van legacy PPT‑, PPS‑ en POT‑streams.

Gebruik PresentationFactory::getPresentationInfo om een bestand te inspecteren zonder een Presentation‑instantie te maken. De PresentationInfo::getLoadFormat‑methode geeft het gedetecteerde formaat terug, zoals PPTX, PPT of 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;
}

Bouw een lichtgewicht presentatie‑inventaris

Wanneer u veel presentatiebestanden verwerkt, hebt u mogelijk een compacte inventaris nodig voor validatie, indexering of een document‑beheersysteem. Gebruik in dit scenario PresentationFactory::getPresentationInfo om een PresentationInfo‑object te verkrijgen, en roep vervolgens PresentationInfo::readDocumentProperties aan. Deze aanpak maakt geen Presentation‑instantie aan en vereist niet dat u het volledige presentatiemodel doorloopt.

De uitgebreide eigenschappen die door DocumentProperties worden blootgesteld, leveren de volgende inventariswaarden:

Methode	Inventariswaarde
getSlides	Totaal aantal dia’s.
getHiddenSlides	Aantal verborgen dia’s.
getNotes	Aantal dia’s met notities.
getParagraphs	Totaal aantal alinea’s, indien beschikbaar.
getWords	Totaal aantal woorden.
getMultimediaClips	Totaal aantal audio‑ en videoclips.

Het volgende voorbeeld leest deze waarden zonder een Presentation‑object te maken en drukt een compacte inventaris af. Het combineert bovendien DocumentProperties::getHeadingPairs met DocumentProperties::getTitlesOfParts om inhoudsgroepen weer te geven, zoals lettertypen, thema’s en diatitel.

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++;
            }
        }
    }
}

Elk [HeadingPair] levert een groepsnaam en het aantal items in die groep. [DocumentProperties::getTitlesOfParts] retourneert een platte, geordende array, zodat u het aantal opeenvolgende titels dat door elk heading‑pair wordt opgegeven kunt gebruiken.

Opgeslagen metadata en formatbeperkingen

De inventarisseigenschappen die worden geretourneerd door PresentationInfo::readDocumentProperties weerspiegelen de metadata die beschikbaar zijn in het brondocument. Aspose.Slides laadt en doorloopt het presentatiemodel niet om deze waarden voor deze oproep opnieuw te berekenen. Ontbrekende eigenschappen worden weergegeven met standaardwaarden, en opgeslagen waarden kunnen verouderd zijn als de applicatie die het bestand laatst opsloeg de documenteigenschappen niet bijwerkte.

PPTX: Het formaat biedt uitgebreide documenteigenschappen voor dia‑, notitie‑, verborgen‑dia‑, alinea‑, woord‑ en multimedia‑telling, evenals heading‑pairs en part‑titles. Beschikbaarheid hangt af van welke eigenschappen door de documentproducent zijn weggeschreven.
PPT: Het binaire formaat kan overeenkomstige document‑samenvattings‑eigenschappen opslaan. Als een eigenschap afwezig is of niet is ververst door de documentproducent, retourneert Aspose.Slides de opgeslagen of standaardwaarde in plaats van deze uit de dia’s te berekenen.
ODP: OpenDocument‑metadata biedt algemene documentstatistieken, zoals pagina‑, alinea‑ en woord‑telling, maar deze waarden komen niet overeen met elke PowerPoint‑specifieke uitgebreide eigenschap. Metadata voor verborgen dia’s, notities, multimedia, heading‑pair en part‑title kan niet beschikbaar zijn, en de inventarisseigenschappen kunnen standaardwaarden retourneren. Beschouw een nulwaarde of een lege array niet als definitief bewijs dat de corresponderende inhoud afwezig is.

Gebruik de lichtgewicht metadata‑benadering voor inventarissen en voorlopige controles. Laad de presentatie en inspecteer het live‑objectmodel wanneer het resultaat de wijzigingen in het geheugen moet weerspiegelen of wanneer u de daadwerkelijke presentatie‑inhoud moet verifiëren.

Update presentatie‑eigenschappen

De eigenschappen die worden geretourneerd door PresentationInfo::readDocumentProperties kunnen ook worden gewijzigd zonder een Presentation‑instantie te maken. Pas de wijzigingen toe met PresentationInfo::updateDocumentProperties en schrijf vervolgens de gekoppelde presentatie weg met PresentationInfo::writeBindedPresentation.

De volgende afbeelding toont de oorspronkelijke documenteigenschappen.

Oorspronkelijke documenteigenschappen van de PowerPoint‑presentatie

Het volgende voorbeeld wijzigt de titel en de laatst‑opgeslagen tijd en schrijft het resultaat naar een nieuw bestand:

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();
}

De volgende afbeelding toont de gewijzigde documenteigenschappen.

Gewijzigde documenteigenschappen van de PowerPoint‑presentatie

Handige links

Voor gerelateerde beveiligingscontroles en beschermingsinstellingen, zie de volgende artikelen:

FAQ

Hoe kan ik controleren of lettertypen zijn ingesloten en welke dat zijn?

Laad de presentatie en gebruik Presentation::getFontsManager. Roep FontsManager::getEmbeddedFonts aan om de ingesloten lettertypen te verkrijgen en FontsManager::getFonts om de lettertypen te verkrijgen die door de presentatie worden gebruikt. Vergelijk de twee resultaten om lettertypen te vinden die nodig zijn voor weergave maar niet zijn ingesloten.

Hoe kan ik snel zien of het bestand verborgen dia’s bevat en hoeveel?

Wanneer de opgeslagen documentmetadata voldoende is, lees DocumentProperties::getHiddenSlides via PresentationFactory::getPresentationInfo en PresentationInfo::readDocumentProperties. Dit is geschikt voor een lichtgewicht inventaris. Als de presentatie in het geheugen is aangepast, kan de opgeslagen metadata ontbreken of verouderd zijn, of moet u de live‑waarden verifiëren door door Presentation::getSlides te itereren en de Slide::getHidden‑methode van elke dia te inspecteren.

Kan ik detecteren of een aangepaste dia‑grootte en -oriëntatie worden gebruikt, en of ze afwijken van de standaardwaarden?

Ja. Laad de presentatie en roep Presentation::getSlideSize aan. Gebruik SlideSize::getType, SlideSize::getSize en SlideSize::getOrientation om de huidige instellingen te vergelijken met de verwachte preset en afmetingen.

Ja.
Ja. Zoek elk Chart en roep ChartData::getDataSourceType aan. Voor een extern werkboek roep ChartData::getExternalWorkbookPath aan. Het gegevenstype en pad identificeren een externe referentie, maar om te controleren of het doel beschikbaar is, is een afzonderlijke resource‑check vereist.

Hoe kan ik ‘zware’ dia’s beoordelen die het renderen of PDF‑exporten kunnen vertragen?

Er bestaat geen enkele complexiteits‑eigenschap. Doorloop Presentation::getSlides en de BaseSlide::getShapes‑collectie van elke dia. Gebruik het aantal vormen en de aanwezigheid van grote afbeeldingen, effecten, animaties of multimedia als screeningssignalen, en meet een representatieve render of export voordat u een dia als een bevestigd prestatie‑knelpunt beschouwt.

Presentaties openen in PHP Bepaal het originele presentatieformaat in PHP