4 * SPIP, Systeme de publication pour l'internet
6 * Copyright (c) 2001-2020
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL.
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.
13 namespace Spip\Archives
;
16 * Point d'entrée de la gestion des archives compressées de SPIP
20 /** @var integer Dernier code d'erreur */
23 /** @var string Dernier message d'erreur */
24 private $messageErreur;
26 /** @var array Mode de compression connus */
27 private $compressionsConnues = array('zip');
29 /** @var string Mode de compression si l'extension du fichier n'est pas explicite */
30 private $modeCompression;
32 /** @var string Chemin vers le fichier d'archives */
33 private $fichierArchive;
35 /** @var boolean true si l'archive est en lecture seule */
36 private $lectureSeule = true;
38 /** @var array Liste des erreurs possibles */
39 private $erreurs = array(
41 1 => 'erreur_inconnue',
42 2 => 'extension_inconnue',
43 3 => 'fichier_absent',
44 4 => 'fichier_lecture_seule',
45 5 => 'destination_inaccessible',
49 * Renvoyer le dernier code d'erreur.
51 * @return integer Dernier code d'erreur
53 public function erreur() {
54 $code = in_array($this->codeErreur
, array_keys($this->erreurs
)) ?
$this->codeErreur
: 1;
56 $this->codeErreur
= $code;
57 $this->messageErreur
= 'archives:'.$this->erreurs
[$code];
63 * Renvoyer le dernier message d'erreur.
65 * @return string Dernier message d'erreur
67 public function message() {
68 return $this->messageErreur
;
72 * Indiquer le détail du contenu de l'archive.
74 * @return array détail du contenu de l'archive
76 public function informer() {
78 'proprietes' => array(),
84 * Extraire tout ou partie des fichiers de l'archive vers une destination.
86 * @param string $destination Chemin du répertoire d'extraction
87 * @param array $fichiers Liste des fichiers à extraire
89 * @return boolean Succès de l'opération
91 public function deballer($destination = '', array $fichiers = array()) {
92 if ($this->codeErreur
!== 0) {
96 if (!(is_dir($destination) and is_writable($destination))) {
97 $this->codeErreur
= 5;
101 $this->codeErreur
= 0;
106 * Créer ou modifier des fichiers dans le fichier d'archive.
108 * @param array $fichiers Liste des fichiers à ajouter ou modifier
110 * @return boolean Succès de l'opération
112 public function emballer(array $fichiers = array()) {
113 if ($this->lectureSeule
) {
114 $this->codeErreur
= 4;
118 $this->codeErreur
= 0;
123 * Retirer une liste de fichiers dans le fichier d'archive.
125 * @param array $fichiers Liste des fichiers à retirer
127 * @return boolean Succès de l'opération
129 public function retirer(array $fichiers = array()) {
130 if ($this->lectureSeule
) {
131 $this->codeErreur
= 4;
135 $this->codeErreur
= 0;
140 * Constructeur de base.
142 * @param string $fichierArchive Chemin vers le fichier d'archives
143 * @param string $modeCompression Mode de compression si l'extension du fichier n'est pas explicite
145 public function __construct($fichierArchive, $modeCompression = '') {
146 $this->codeErreur
= 0;
148 if ('' === $modeCompression) {
149 $modeCompression = preg_replace(',.+\.([^.]+)$,', '$1', $fichierArchive);
152 $modeCompression = strtolower($modeCompression);
153 if (!in_array($modeCompression, $this->compressionsConnues
)) {
154 $this->codeErreur
= 2;
155 } elseif (!file_exists($fichierArchive)) {
156 $this->codeErreur
= 3;
158 $repertoireArchive = dirname($fichierArchive);
159 $this->lectureSeule
= !(is_dir($repertoireArchive) and is_writable($repertoireArchive));
161 $this->lectureSeule
= !is_writable($fichierArchive);
164 $this->modeCompression
= $modeCompression;
165 $this->fichierArchive
= $fichierArchive;
169 * Indique si l'archive est accessible en ecriture ou pas.
171 * @return boolean true si l'archive est en lecture seule
173 public function getLectureSeule() {
174 return $this->lectureSeule
;