BZDECOMPRESS |
Décompresse |
PHP 4.0.4+ |
Syntaxe
function bzdecompress($source [, $small = 0 ] );
|
Paramètres
Nom |
Description |
$data |
Ce paramètre permet d'indiquer la représentation des données compressées au format Bzip2 que vous souhaitez décompresser. Il doit être fourni sous forme de chaîne de caractères. |
$small |
Ce paramètre permet d'indiquer si sa valeur est true, un algorithme de décompression alternatif sera utilisé utilisant moins de mémoire (la mémoire maximale requise tombe à environ 2 300 Ko) mais fonctionne à environ la moitié de la vitesse. |
Description
Cette fonction permet d'effectuer la décompression d'un encodage de données bzip2.
Remarques
- Usage principal : La fonction bzdecompress est utilisée pour décompresser des données compressées au format Bzip2. Elle est utile lorsqu'on manipule
des fichiers ou des flux de données qui ont été compressés pour réduire leur taille et qu'on souhaite les ramener à leur format original.
- Format spécifique : Cette fonction ne supporte que le format Bzip2, ce qui signifie qu'elle ne peut pas traiter d'autres formats de compression comme
Gzip ou ZIP. Si vous travaillez avec un autre format, vous devrez utiliser une bibliothèque ou une fonction différente.
- Dépendance de l'extension Bzip2 : Pour que bzdecompress fonctionne, l'extension Bzip2 doit être activée dans votre installation de PHP.
Si cette extension est absente, une erreur fatale sera générée. Assurez-vous de vérifier sa présence avant de l'utiliser.
- Retour en cas d'échec : En cas de problème, comme une donnée corrompue ou un format incompatible, la fonction renvoie false. Il est donc recommandé
d'effectuer une vérification des erreurs après l'appel de la fonction pour gérer ces cas.
- Performance et limites : La décompression peut consommer beaucoup de mémoire et de CPU, surtout pour de grandes quantités de données. Assurez-vous d'avoir les
ressources nécessaires sur le serveur pour éviter des ralentissements ou des erreurs de mémoire.
- Utilisation typique : bzdecompress est souvent utilisée en combinaison avec bzcompress. Les données sont compressées
à l'aide de bzcompress avant d'être stockées ou transférées, puis décompressées avec bzdecompress pour être utilisées.
- Données partiellement corrompues : Si les données compressées sont partiellement corrompues, la décompression échouera complètement. Contrairement à certains formats
comme ZIP, Bzip2 ne permet pas de récupérer les parties valides des données.
- Non adaptée aux flux continus : bzdecompress attend que toutes les données compressées soient passées sous forme de chaîne de caractères. Elle n'est donc pas
idéale pour décompresser des flux continus en temps réel. Si cela est nécessaire, envisagez des solutions utilisant des bibliothèques externes comme stream_filter_append.
Dernière mise à jour : Jeudi, le 28 Mai 2020