PharData::convertToData
Convertit une archive phar en une archive tar ou zip non-exécutable
&reftitle.description;
public PharDatanullPharData::convertToData
intnullformat&null;
intnullcompression&null;
stringnullextension&null;
Cette méthode est utilisée pour convertir une archive non exécutable tar ou zip en un
autre format non-exécutable.
Si aucun changement n'est demandé, cette méthode, cette méthode soulève une exception
BadMethodCallException.
Cette méthode doit être utilisée pour convertir une archive tar au format zip et vice-versa.
Bien qu'il soit possible de changer la compression d'une archive tar avec cette méthode, il est
préférable d'utiliser la méthode PharData::compress pour rester cohérent au
niveau de la logique.
En cas de succès, cette méthode crée une nouvelle archive sur le disque et retourne un objet
PharData. L'ancienne archive n'est pas effacée du disque, ceci devant
être fait manuellement une fois le traitement terminé.
&reftitle.parameters;
format
Le format doit être Phar::TAR ou
Phar::ZIP. S'il vaut &null;, le format de fichier actuel sera conservé.
compression
La compression doit être Phar::NONE pour éviter la compression de l'archive
complète, Phar::GZ pour la compression basée sur zlib, et
Phar::BZ2 pour la compression basée sur bzip.
extension
Ce paramètre est utilisé pour écrase l'extension de fichier par défaut de l'archive convertie. Notez
que .phar ne peut pas être utilisé n'importe où dans le nom de fichier d'une
archive tar ou zip non-exécutable.
En cas de conversion vers une archive phar basée sur tar, les extensions par défaut sont
.tar, .tar.gz
et .tar.bz2 selon la compression spécifiée.
Pour les archives basées sur zip, l'extension par défaut est .zip.
&reftitle.returnvalues;
Cette méthode retourne un objet PharData en cas de succès,
ou &null; en cas d'échec.
&reftitle.errors;
Cette méthode soulève une exception BadMethodCallException
quand elle est incapable de compresser, quand une méthode de compression inconnue a été
spécifiée, quand l'archive demandée est mise en tampon avec
Phar::startBuffering et qu'elle n'a pas été conclue avec
Phar::stopBuffering, et soulève une exception
PharException si un quelconque problème est rencontré lors de
la création du phar.
&reftitle.changelog;
&Version;
&Description;
8.0.0
format, compression, et
extension sont désormais nullable.
&reftitle.examples;
Un exemple avec PharData::convertToData
Utilisons PharData::convertToData():
convertToData(Phar::ZIP);
// crée monphar.tbz
$tgz = $zip->convertToData(Phar::TAR, Phar::BZ2, '.tbz');
// crée monphar.phar.tgz
$phar = $tarphar->convertToData(Phar::PHAR); // soulève une exceptions
} catch (Exception $e) {
// les erreurs sont traitées ici
}
?>
]]>
&reftitle.seealso;
Phar::convertToExecutable
Phar::convertToData
PharData::convertToExecutable