Phar::uncompressAllFiles
(PECL phar < 2.0.0)
Phar::uncompressAllFiles — Décompresse tous les fichiers de l'archive Phar courante
Description
Note:
Cette méthode a été supprimée de l'extension phar depuis la version 2.0.0. Vous pouvez utiliser Phar::compress(), Phar::decompress(), Phar::compressFiles() et Phar::decompressFiles() à la place.
Note:
Cette méthode nécessite que la variable de configuration INI phar.readonly soit définie à 0 pour fonctionner avec les objets Phar. Sinon, une exception PharException sera lançée.
Cette méthode décompresse tous les fichiers de l'archive Phar. Si un des fichiers est déjà compressé en utilisant la compression gzip, l'extension zlib doit être activée pour décompresser le fichier, et si un des fichiers est déjà compressé en utilisant la compression bzip2, l'extension bzip2 doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu d'un As with all functionality that modifies the contents of phar, la variable INI phar.readonly doit être à off pour que ça fonctionne.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Erreurs / Exceptions
Lève une exception BadMethodCallException si la variable INI phar.readonly est à on, si l'extension bzip2 n'est pas activée alors qu'au moins un fichier est compressé avec la compression bzip2 ou si au moins un des fichiers est compressé avec la compression gzip et que l'extension zlib n'est pas activée.
Exemples
Exemple #1 Un exemple avec Phar::uncompressAllFiles()
<?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p->compressAllFilesGZ(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->uncompressAllFiles(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } } catch (Exception $e) { echo 'Les opération d'écriture sur mon.phar ont échoué : ', $e; } ?>
L'exemple ci-dessus va afficher :
string(10) "monfichiere.txt" bool(true) bool(false) bool(true) string(11) "monfichier2.txt" bool(true) bool(false) bool(true) string(10) "monfichier.txt" bool(false) bool(false) bool(false) string(11) "monfichier2.txt" bool(false) bool(false) bool(false)
Voir aussi
- PharFileInfo::getCompressedSize() - Retourne la taille actuelle (avec compression) du fichier au sein de l'archive Phar
- PharFileInfo::isCompressedBZIP2() - Détermine si l'archive Phar est compressée avec bzip2
- PharFileInfo::isCompressed() - Retourne si l'entrée est compressée
- PharFileInfo::isCompressedGZ() - Détermine si l'archive Phar est compressée avec gzip
- PharFileInfo::setCompressedBZIP2() - Compresse l'entrée Phar courante au sein du phar avec Bzip2
- PharFileInfo::setUncompressed() - Décompresse l'entrée Phar courante au sein du phar s'il y a lieu
- PharFileInfo::setCompressedGZ() - Compresse l'entrée Phar courante au sein du phar avec gzip
- Phar::canCompress() - Détermine si l'extension phar supporte une la compression en utilisant soit zip soit bzip2
- Phar::isCompressed() - Retourne Phar::GZ ou PHAR::BZ2 si l'archive entière est compressée (.tar.gz/tar.bz, etc)
- Phar::compressAllFilesBZIP2() - Compresse tous les fichiers de l'archive Phar courante en utilisant la compression Bzip2
- Phar::compressAllFilesGZ() - Compresse tous les fichiers de l'archive Phar courante en utilisant la compression Gzip
- Phar::getSupportedCompression() - Retourne un tableau des algorithmes de compression supportés