array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'phardata.decompress.php', 1 => 'PharData::decompress', 2 => 'Décompresse l\'archive Phar entière', ), 'up' => array ( 0 => 'class.phardata.php', 1 => 'PharData', ), 'prev' => array ( 0 => 'phardata.copy.php', 1 => 'PharData::copy', ), 'next' => array ( 0 => 'phardata.decompressfiles.php', 1 => 'PharData::decompressFiles', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/phar/PharData/decompress.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PharData::decompress

(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

Décompresse l'archive entière, si c'est une archive tar.

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. Utiliser 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

Version Description
8.0.0 extension est désormais nullable.

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