(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::decompress — Décompresse l'archive Phar entière
Description
public
PharData::decompress(?string
$extension
=
null
): ?PharData
Pour les archives Zip, cette méthode échoue et lève une exception.
L'extension zlib doit être activée
pour décompresser une archive compressée avec gzip et l'extension
bzip2 doit être disponible pour
décompresser une archive compressée avec bzip2.
De plus, cette méthode renomme automatiquement l'extension de
fichier de l'archive, .tar
par défaut.
Sinon, une extension de fichier peut être spécifiée avec le paramètre
extension
.
Liste de paramètres
-
extension
-
Pour décompresser, l'extension par défaut est
.tar
. Utilisez ce paramètre
pour spécifier une autre extension de fichier. Gardez
à l'esprit que seul les archives exécutables peuvent
contenir .phar
dans leur nom de fichier.
Valeurs de retour
Un objet PharData est retourné en cas de succès,
ou null
en cas d'échec.
Erreurs / Exceptions
Soulève une exception BadMethodCallException si
l'extension zlib n'est pas disponible ou si
l'extension bzip2 n'est pas activée.
Historique
Exemples
Exemple #1 Exemple avec PharData::decompress()
<?php
$p = new PharData('/path/to/my.tar.gz');
$p->decompress(); // crée /path/to/my.tar
?>
Voir aussi
- pharfileinfo::getCompressedSize() - Retourne la taille actuelle (avec compression) du fichier au sein de l'archive Phar
- pharfileinfo::isCompressed() - Retourne si l'entrée est compressée
- PharFileInfo::compress() - Compresse l'entrée Phar courante avec une des compressions zlib ou bzip2
- PharFileInfo::decompress() - Décompresse l'entrée Phar courante au sein du phar
- PharData::compress() - Compresse l'archive tar/zip complète en utilisant la compression Gzip ou Bzip2
- 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)
- PharData::compress() - Compresse l'archive tar/zip complète en utilisant la compression Gzip ou Bzip2
- phar::getSupportedCompression() - Retourne un tableau des algorithmes de compression supportés
- PharData::compressFiles() - Compresse tous les fichiers de l'archive tar/zip courante
- PharData::decompressFiles() - Décompresse tous les fichiers de l'archive zip courante