PowerPoint bemutatók megnyitása PHP-ben

Bevezetés

A PowerPoint bemutatók önmagukban történő létrehozása mellett az Aspose.Slides lehetővé teszi meglévő bemutatók megnyitását is. A bemutató betöltése után információkat kérhet le róla, szerkesztheti a dia tartalmát, új diát adhat hozzá, eltávolíthat meglévő diákat, és még sok mást.

Bemutatók megnyitása

Egy meglévő bemutató megnyitásához hozza létre a Presentation osztály példányát, és adja át a fájl elérési útját a konstruktorának.

Az alábbi PHP példa bemutatja, hogyan nyithat meg egy bemutatót, és hogyan kérdezheti le a diák számát:

// Példányosítsa a Presentation osztályt, és adja át a fájl elérési útját a konstruktorának.
$presentation = new Presentation("Sample.pptx");
try {
    // Írassa ki a bemutató diáinak összes számát.
    echo($presentation->getSlides()->size());
} finally {
    $presentation->dispose();
}

Jelszóval védett bemutatók megnyitása

Amikor jelszóval védett bemutatót kell megnyitni, adja át a jelszót a LoadOptions osztály setPassword metódusával a titkosítás feloldásához és betöltéséhez. Az alábbi PHP kód ezt a műveletet mutatja be:

$loadOptions = new LoadOptions();
$loadOptions->setPassword("YOUR_PASSWORD");

$presentation = new Presentation("Sample.pptx", $loadOptions);
try {
    // Végrehajtja a műveleteket a visszafejtett bemutatón.
} finally {
    $presentation->dispose();
}

Nagy bemutatók megnyitása

Az Aspose.Slides lehetőségeket biztosít – különösen a LoadOptions osztály getBlobManagementOptions metódusát – a nagy bemutatók betöltéséhez.

Az alábbi PHP kód egy nagy bemutató betöltését mutatja (például 2 GB):

$filePath = "LargePresentation.pptx";

$loadOptions = new LoadOptions();
// Choose the KeepLocked behavior—the presentation file will remain locked for the lifetime of
// the Presentation instance, but it does not need to be loaded into memory or copied to a temporary file.
$loadOptions->getBlobManagementOptions()->setPresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
$loadOptions->getBlobManagementOptions()->setTemporaryFilesAllowed(true);
$loadOptions->getBlobManagementOptions()->setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

$presentation = new Presentation($filePath, $loadOptions);
try {
    // The large presentation has been loaded and can be used, while memory consumption remains low.

    // Make changes to the presentation.
    $presentation->getSlides()->get_Item(0)->setName("Very large presentation");

    // Save the presentation to another file. Memory consumption remains low during this operation.
    $presentation->save("LargePresentation-copy.pptx", SaveFormat::Pptx);
	
	// Don't do this! An I/O exception will be thrown because the file is locked until the presentation object is disposed.
	//unlink($filePath);
} finally {
    $presentation->dispose();
}
// It is OK to do it here. The source file is no longer locked by the presentation object.
unlink($filePath);

Külső erőforrások vezérlése

Az Aspose.Slides biztosítja az IResourceLoadingCallback interfészt, amely lehetővé teszi a külső erőforrások kezelését. Az alábbi PHP kód bemutatja, hogyan használhatja az IResourceLoadingCallback interfészt:

class ImageLoadingHandler {
    function resourceLoading($args) {
        if (java_values($args->getOriginalUri()->endsWith(".jpg"))) {
            // Töltsön be egy helyettesítő képet.
			$bytes = file_get_contents("aspose-logo.jpg");
			$javaByteArray = java_values($bytes);
            $args->setData($javaByteArray);
            return ResourceLoadingAction::UserProvided;
        } else if (java_values($args->getOriginalUri()->endsWith(".png"))) {
            // Állítson be egy helyettesítő URL-t.
            $args->setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction::Default;
        }
        // Hagyja ki az összes többi képet.
        return ResourceLoadingAction::Skip;
    }
}

$loadingHandler = java_closure(new ImageLoadingHandler(), null, java("com.aspose.slides.IResourceLoadingCallback"));

$loadOptions = new LoadOptions();
$loadOptions->setResourceLoadingCallback($loadingHandler);

$presentation = new Presentation("Sample.pptx", $loadOptions);

Beágyazott bináris objektumok nélkül történő betöltés

Egy PowerPoint bemutató a következő típusú beágyazott bináris objektumokat tartalmazhatja:

A LoadOptions.setDeleteEmbeddedBinaryObjects metódus használatával betölthet egy bemutatót minden beágyazott bináris objektum nélkül.

Ez a módszer hasznos a potenciálisan rosszindulatú bináris tartalom eltávolításához. Az alábbi PHP kód bemutatja, hogyan tölthet be egy bemutatót beágyazott bináris tartalom nélkül:

$loadOptions = new LoadOptions();
$loadOptions->setDeleteEmbeddedBinaryObjects(true);

$presentation = new Presentation("malware.ppt", $loadOptions);
try {
    // Végezze el a műveleteket a bemutatón.
} finally {
    $presentation->dispose();
}

GYIK

Hogyan tudom megmondani, hogy egy fájl sérült és nem nyitható meg?
A betöltés során parsing/formátum ellenőrzési kivételt kap. Az ilyen hibák gyakran egy érvénytelen ZIP struktúrára vagy törött PowerPoint rekordokra utalnak.

Mi történik, ha a megnyitáskor hiányoznak a szükséges betűkészletek?
A fájl megnyílik, de a későbbi renderelés/export helyettesítheti a betűtípusokat. A betűtípushelyettesítések beállítása vagy a szükséges betűkészletek hozzáadása a futási környezethez segíthet.

Mi a helyzet a beágyazott médiával (videó/hang) a megnyitáskor?
A média a bemutató erőforrásaként lesz elérhető. Ha a médiát külső útvonalakon hivatkozzák, győződjön meg arról, hogy ezek az útvonalak hozzáférhetők a környezetben; ellenkező esetben a renderelés/export kihagyhatja a médiát.