Ouvrir des présentations en PHP
Introduction
Aspose.Slides for PHP via Java peut charger des présentations PowerPoint et OpenDocument à partir de fichiers et de flux. Après le chargement d’une présentation, vous pouvez inspecter sa structure, modifier les diapositives, gérer les ressources et l’enregistrer dans le format d’origine ou dans un autre format pris en charge.
Le comportement de chargement peut être personnalisé via la classe LoadOptions. Par exemple, vous pouvez fournir un mot de passe d’ouverture, garder les gros objets binaires en dehors de la mémoire du tas Java, contrôler les ressources externes ou omettre les données binaires intégrées.
Open Presentations
Après le chargement d’un fichier ou d’un flux, vous pouvez déterminer son format de présentation d’origine pour choisir comment votre application le traite.
Pour ouvrir une présentation existante, transmettez son chemin de fichier au constructeur Presentation. Libérez la présentation après utilisation afin que les poignées de fichiers, les données temporaires et les autres ressources soient libérées rapidement.
L’exemple PHP suivant montre comment ouvrir une présentation et obtenir le nombre de diapositives :
use aspose\slides\Presentation;
$presentation = new Presentation("sample.pptx");
try {
echo("Slide count: " . java_values($presentation->getSlides()->size()) . "\n");
} finally {
$presentation->dispose();
}
Open Password-Protected Presentations
Un mot de passe d’ouverture chiffre le contenu de la présentation. Pour charger la présentation complète, transmettez le mot de passe correct à LoadOptions::setPassword et fournissez les options au constructeur Presentation. Le chargement échoue si le mot de passe est absent ou incorrect.
use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
$loadOptions = new LoadOptions();
$loadOptions->setPassword("open_password");
$presentation = new Presentation("encrypted-presentation.pptx", $loadOptions);
try {
echo("Slide count: " . java_values($presentation->getSlides()->size()) . "\n");
} finally {
$presentation->dispose();
}
Pour la détection, la validation et les flux de travail de chiffrement des mots de passe, consultez Password-Protect Presentations. Si une présentation chiffrée a été enregistrée intentionnellement avec des propriétés de document publiques, ces propriétés peuvent être lues sans mot de passe ; voir Manage Presentation Properties.
Open Large Presentations
LoadOptions::getBlobManagementOptions renvoie des options qui contrôlent la façon dont Aspose.Slides gère les objets binaires volumineux tels que les images, l’audio et la vidéo. Vous pouvez garder le fichier source verrouillé, autoriser les fichiers temporaires et limiter la quantité de données BLOB conservées en mémoire.
Le code PHP suivant montre comment charger une grande présentation (par exemple, 2 Go) :
use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
use aspose\slides\PresentationLockingBehavior;
use aspose\slides\SaveFormat;
$filePath = "large-presentation.pptx";
$loadOptions = new LoadOptions();
$loadOptions->getBlobManagementOptions()->setPresentationLockingBehavior(PresentationLockingBehavior::KeepLocked);
$loadOptions->getBlobManagementOptions()->setTemporaryFilesAllowed(true);
$loadOptions->getBlobManagementOptions()->setMaxBlobsBytesInMemory(10 * 1024 * 1024);
$presentation = new Presentation($filePath, $loadOptions);
try {
$presentation->getSlides()->get_Item(0)->setName("Large presentation");
$presentation->save("large-presentation-copy.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Note
Avec PresentationLockingBehavior::KeepLocked, le fichier source reste verrouillé jusqu’à ce que l’instance de présentation soit libérée. Ne déplacez, remplacez ni supprimez le fichier source tant que cette instance est vivante.
Aspose.Slides peut copier le contenu d’un flux d’entrée lors du chargement. Pour les grandes présentations, un chemin de fichier est généralement plus efficace qu’un flux. Consultez Manage BLOBs pour des options supplémentaires de stockage et de gestion de la mémoire.
Control External Resources
LoadOptions::setResourceLoadingCallback accepte une implémentation de l’interface Java IResourceLoadingCallback via le PHP/Java Bridge. Le rappel peut fournir des données de remplacement, rediriger une ressource, utiliser le chargeur par défaut ou ignorer la ressource. Ceci est utile lorsque les présentations contiennent des images externes qui doivent être résolues selon les règles de sécurité ou de stockage propres à l’application.
use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
use aspose\slides\ResourceLoadingAction;
class ImageLoadingHandler {
function resourceLoading($args) {
$originalUri = strtolower(java_values($args->getOriginalUri()));
$approvedImagePath = "approved-image.jpg";
$isJpeg = substr($originalUri, -4) === ".jpg";
if (!$isJpeg || !file_exists($approvedImagePath)) {
return ResourceLoadingAction::Skip;
}
$imageData = file_get_contents($approvedImagePath);
if ($imageData === false) {
echo("The approved replacement image could not be read.\n");
return ResourceLoadingAction::Skip;
}
$args->setData(java_values($imageData));
return ResourceLoadingAction::UserProvided;
}
}
$loadingHandler = java_closure(new ImageLoadingHandler(), null, java("com.aspose.slides.IResourceLoadingCallback"));
$loadOptions = new LoadOptions();
$loadOptions->setResourceLoadingCallback($loadingHandler);
$presentation = new Presentation("presentation-with-external-images.pptx", $loadOptions);
try {
echo("Slide count: " . java_values($presentation->getSlides()->size()) . "\n");
} finally {
$presentation->dispose();
}
Load Presentations without Embedded Binary Objects
Une présentation peut contenir des données binaires intégrées qu’une application n’a pas besoin de retenir ou ne souhaite pas conserver. Exemples :
- Projets VBA, disponibles via Presentation::getVbaProject;
- données OLE intégrées, disponibles via OleEmbeddedDataInfo::getEmbeddedFileData;
- données de contrôle ActiveX, disponibles via Control::getActiveXControlBinary.
Définissez LoadOptions::setDeleteEmbeddedBinaryObjects sur true pour supprimer ces données binaires lors du chargement. Enregistrez la présentation chargée pour conserver le résultat assaini.
Cette option réduit l’exposition à des charges utiles intégrées indésirables, mais ce n’est pas un système complet de détection de logiciels malveillants ou de désinfection de contenu.
use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$loadOptions = new LoadOptions();
$loadOptions->setDeleteEmbeddedBinaryObjects(true);
$presentation = new Presentation("presentation-with-embedded-data.pptx", $loadOptions);
try {
$presentation->save("presentation-without-embedded-data.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
FAQ
Comment savoir qu’un fichier est corrompu et ne peut pas être ouvert ?
Aspose.Slides lève une exception d’analyse ou de format lors du chargement. Gérez cet échec séparément d’une erreur de mot de passe incorrect afin que l’application puisse signaler la cause avec précision.
Que se passe-t-il si les polices requises sont manquantes ?
La présentation peut toujours être chargée, mais le rendu et l’exportation peuvent substituer les polices. Vous pouvez configurer la substitution de polices ou fournir des polices personnalisées pour rendre la sortie plus prévisible.
Le chargement d’une présentation charge-t-il également ses médias intégrés ?
L’audio et la vidéo intégrés deviennent disponibles via le modèle d’objet de la présentation. Les ressources externes sont résolues selon le comportement de chargement des ressources configuré et peuvent être indisponibles si leurs emplacements ne sont pas accessibles.