[SPIP] ~version 3.0.7-->3.0.10
[ptitvelo/web/www.git] / www / ecrire / inc / flock.php
1 <?php
2
3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
5 * *
6 * Copyright (c) 2001-2012 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
8 * *
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. *
11 \***************************************************************************/
12
13
14 if (!defined('_ECRIRE_INC_VERSION')) return;
15 // ajouter define('_CREER_DIR_PLAT', true); dans mes_options pour restaurer
16 // le fonctionnement des faux repertoires en .plat
17 define('_CREER_DIR_PLAT', false);
18 if (!defined('_TEST_FILE_EXISTS')) define('_TEST_FILE_EXISTS', preg_match(',(online|free)[.]fr$,', isset($_ENV["HTTP_HOST"]) ? $_ENV["HTTP_HOST"] : ""));
19
20 #define('_SPIP_LOCK_MODE',0); // ne pas utiliser de lock (deconseille)
21 #define('_SPIP_LOCK_MODE',1); // utiliser le flock php
22 #define('_SPIP_LOCK_MODE',2); // utiliser le nfslock de spip
23
24 if (_SPIP_LOCK_MODE==2)
25 include_spip('inc/nfslock');
26
27 $GLOBALS['liste_verrous'] = array();
28 // http://doc.spip.org/@spip_fopen_lock
29 function spip_fopen_lock($fichier,$mode,$verrou){
30 if (_SPIP_LOCK_MODE==1){
31 if ($fl = @fopen($fichier,$mode))
32 // verrou
33 @flock($fl, $verrou);
34 return $fl;
35 }
36 elseif(_SPIP_LOCK_MODE==2) {
37 if (($verrou = spip_nfslock($fichier)) && ($fl = @fopen($fichier,$mode))){
38 $GLOBALS['liste_verrous'][$fl] = array($fichier,$verrou);
39 return $fl;
40 }
41 else return false;
42 }
43 return @fopen($fichier,$mode);
44 }
45 // http://doc.spip.org/@spip_fclose_unlock
46 function spip_fclose_unlock($handle){
47 if (_SPIP_LOCK_MODE==1){
48 @flock($handle, LOCK_UN);
49 }
50 elseif(_SPIP_LOCK_MODE==2) {
51 spip_nfsunlock(reset($GLOBALS['liste_verrous'][$handle]),end($GLOBALS['liste_verrous'][$handle]));
52 unset($GLOBALS['liste_verrous'][$handle]);
53 }
54 return @fclose($handle);
55 }
56
57
58 // http://doc.spip.org/@spip_file_get_contents
59 function spip_file_get_contents ($fichier) {
60 if (substr($fichier, -3) != '.gz') {
61 if (function_exists('file_get_contents')
62 AND (
63 // quand on est sous window on ne sait pas si file_get_contents marche
64 // on essaye : si ca retourne du contenu alors c'est bon
65 // sinon on fait un file() pour avoir le coeur net
66 ($contenu = @file_get_contents ($fichier))
67 OR _OS_SERVEUR != 'windows')
68 )
69 return $contenu;
70 else
71 $contenu = @file($fichier);
72 } else
73 $contenu = @gzfile($fichier);
74 return is_array($contenu)?join('', $contenu):(string)$contenu;
75 }
76
77 // options = array(
78 // 'phpcheck' => 'oui' # verifier qu'on a bien du php
79 // dezippe automatiquement les fichiers .gz
80 // http://doc.spip.org/@lire_fichier
81 function lire_fichier ($fichier, &$contenu, $options=false) {
82 $contenu = '';
83 // inutile car si le fichier n'existe pas, le lock va renvoyer false juste apres
84 // economisons donc les acces disque, sauf chez free qui rale pour un rien
85 if (_TEST_FILE_EXISTS AND !@file_exists($fichier))
86 return false;
87
88 #spip_timer('lire_fichier');
89
90 // pas de @ sur spip_fopen_lock qui est silencieux de toute facon
91 if ($fl = spip_fopen_lock($fichier, 'r', LOCK_SH)) {
92 // lire le fichier avant tout
93 $contenu = spip_file_get_contents($fichier);
94
95 // le fichier a-t-il ete supprime par le locker ?
96 // on ne verifie que si la tentative de lecture a echoue
97 // pour discriminer un contenu vide d'un fichier absent
98 // et eviter un acces disque
99 if (!$contenu AND !@file_exists($fichier)) {
100 spip_fclose_unlock($fl);
101 return false;
102 }
103
104 // liberer le verrou
105 spip_fclose_unlock($fl);
106
107 // Verifications
108 $ok = true;
109 if ($options['phpcheck'] == 'oui')
110 $ok &= (preg_match(",[?]>\n?$,", $contenu));
111
112 #spip_log("$fread $fichier ".spip_timer('lire_fichier'));
113 if (!$ok)
114 spip_log("echec lecture $fichier");
115
116 return $ok;
117 }
118 return false;
119 }
120
121 //
122 // Ecrire un fichier de maniere un peu sure
123 //
124 // zippe les fichiers .gz
125 // http://doc.spip.org/@ecrire_fichier
126 function ecrire_fichier ($fichier, $contenu, $ignorer_echec = false, $truncate=true) {
127
128 #spip_timer('ecrire_fichier');
129
130 // verrouiller le fichier destination
131 if ($fp = spip_fopen_lock($fichier, 'a',LOCK_EX)) {
132 // ecrire les donnees, compressees le cas echeant
133 // (on ouvre un nouveau pointeur sur le fichier, ce qui a l'avantage
134 // de le recreer si le locker qui nous precede l'avait supprime...)
135 if (substr($fichier, -3) == '.gz')
136 $contenu = gzencode($contenu);
137 // si c'est une ecriture avec troncation , on fait plutot une ecriture complete a cote suivie unlink+rename
138 // pour etre sur d'avoir une operation atomique
139 // y compris en NFS : http://www.ietf.org/rfc/rfc1094.txt
140 // sauf sous wintruc ou ca ne marche pas
141 $ok = false;
142 if ($truncate AND _OS_SERVEUR != 'windows'){
143 if (!function_exists('creer_uniqid'))
144 include_spip('inc/acces');
145 $id = creer_uniqid();
146 // on ouvre un pointeur sur un fichier temporaire en ecriture +raz
147 if ($fp2 = spip_fopen_lock("$fichier.$id", 'w',LOCK_EX)) {
148 $s = @fputs($fp2, $contenu, $a = strlen($contenu));
149 $ok = ($s == $a);
150 spip_fclose_unlock($fp2);
151 spip_fclose_unlock($fp);
152 // unlink direct et pas spip_unlink car on avait deja le verrou
153 // a priori pas besoin car rename ecrase la cible
154 // @unlink($fichier);
155 // le rename aussitot, atomique quand on est pas sous windows
156 // au pire on arrive en second en cas de concourance, et le rename echoue
157 // --> on a la version de l'autre process qui doit etre identique
158 @rename("$fichier.$id",$fichier);
159 // precaution en cas d'echec du rename
160 if (!_TEST_FILE_EXISTS OR @file_exists("$fichier.$id"))
161 @unlink("$fichier.$id");
162 if ($ok)
163 $ok = file_exists($fichier);
164 }
165 else
166 // echec mais penser a fermer ..
167 spip_fclose_unlock($fp);
168 }
169 // sinon ou si methode precedente a echoueee
170 // on se rabat sur la methode ancienne
171 if (!$ok){
172 // ici on est en ajout ou sous windows, cas desespere
173 if ($truncate)
174 @ftruncate($fp,0);
175 $s = @fputs($fp, $contenu, $a = strlen($contenu));
176
177 $ok = ($s == $a);
178 spip_fclose_unlock($fp);
179 }
180
181 // liberer le verrou et fermer le fichier
182 @chmod($fichier, _SPIP_CHMOD & 0666);
183 if ($ok) return $ok;
184 }
185
186 if (!$ignorer_echec){
187 include_spip('inc/autoriser');
188 if (autoriser('chargerftp'))
189 raler_fichier($fichier);
190 spip_unlink($fichier);
191 }
192 spip_log("Ecriture fichier $fichier impossible",_LOG_INFO_IMPORTANTE);
193 return false;
194 }
195
196 /**
197 * Ecrire un contenu dans un fichier encapsule en php pour en empecher l'acces en l'absence
198 * de htaccess
199 * @param string $fichier
200 * @param <type> $contenu
201 * @param <type> $ecrire_quand_meme
202 * @param <type> $truncate
203 */
204 function ecrire_fichier_securise ($fichier, $contenu, $ecrire_quand_meme = false, $truncate=true) {
205 if (substr($fichier,-4) !== '.php')
206 spip_log('Erreur de programmation: '.$fichier.' doit finir par .php');
207 $contenu = "<"."?php die ('Acces interdit'); ?".">\n" . $contenu;
208 return ecrire_fichier($fichier, $contenu, $ecrire_quand_meme, $truncate);
209 }
210
211 /**
212 * Lire un fichier encapsule en php
213 * @param <type> $fichier
214 * @param <type> $contenu
215 * @param <type> $options
216 */
217 function lire_fichier_securise ($fichier, &$contenu, $options=false) {
218 if ($res = lire_fichier($fichier,$contenu,$options)){
219 $contenu = substr($contenu,strlen("<"."?php die ('Acces interdit'); ?".">\n"));
220 }
221 return $res;
222 }
223
224 // http://doc.spip.org/@raler_fichier
225 function raler_fichier($fichier)
226 {
227 include_spip('inc/minipres');
228 $dir = dirname($fichier);
229 http_status(401);
230 echo minipres(_T('texte_inc_meta_2'), "<h4 style='color: red'>"
231 . _T('texte_inc_meta_1', array('fichier' => $fichier))
232 . " <a href='"
233 . generer_url_ecrire('install', "etape=chmod&test_dir=$dir")
234 . "'>"
235 . _T('texte_inc_meta_2')
236 . "</a> "
237 . _T('texte_inc_meta_3',
238 array('repertoire' => joli_repertoire($dir)))
239 . "</h4>\n");
240 exit;
241 }
242
243 //
244 // Retourne Vrai si son premier argument a ete cree il y a moins de N secondes
245 //
246
247 // http://doc.spip.org/@jeune_fichier
248 function jeune_fichier($fichier, $n)
249 {
250 if (!file_exists($fichier)) return false;
251 if (!$c = @filemtime($fichier)) return false;
252 return (time()-$n <= $c);
253 }
254
255 //
256 // Supprimer le fichier de maniere sympa (flock)
257 //
258 // http://doc.spip.org/@supprimer_fichier
259 function supprimer_fichier($fichier, $lock=true) {
260 if (!@file_exists($fichier))
261 return true;
262
263 if ($lock) {
264 // verrouiller le fichier destination
265 if (!$fp = spip_fopen_lock($fichier, 'a', LOCK_EX))
266 return false;
267
268 // liberer le verrou
269 spip_fclose_unlock($fp);
270 }
271
272 // supprimer
273 return @unlink($fichier);
274 }
275
276 // Supprimer brutalement, si le fichier existe
277 // http://doc.spip.org/@spip_unlink
278 function spip_unlink($f) {
279 if (!is_dir($f))
280 supprimer_fichier($f,false);
281 else {
282 @unlink("$f/.ok");
283 @rmdir($f);
284 }
285 }
286
287 /**
288 * clearstatcache adapte a la version PHP
289 * @param bool $clear_realpath_cache
290 * @param null $filename
291 */
292 function spip_clearstatcache($clear_realpath_cache = false, $filename=null){
293 return (version_compare(PHP_VERSION, '5.3.0') >= 0)?
294 clearstatcache($clear_realpath_cache,$filename):clearstatcache();
295 }
296
297 /*
298 * Suppression complete d'un repertoire.
299 *
300 * http://www.php.net/manual/en/function.rmdir.php#92050
301 *
302 * @param string $dir Chemin du repertoire
303 * @return bool Suppression reussie.
304 */
305 function supprimer_repertoire($dir) {
306 if (!file_exists($dir)) return true;
307 if (!is_dir($dir) || is_link($dir)) return @unlink($dir);
308
309 foreach (scandir($dir) as $item) {
310 if ($item == '.' || $item == '..') continue;
311 if (!supprimer_repertoire($dir . "/" . $item)) {
312 @chmod($dir . "/" . $item, 0777);
313 if (!supprimer_repertoire($dir . "/" . $item)) return false;
314 };
315 }
316
317 return @rmdir($dir);
318 }
319
320
321 //
322 // Retourne $base/${subdir}/ si le sous-repertoire peut etre cree,
323 // $base/${subdir}_ sinon ; $nobase signale qu'on ne veut pas de $base/
324 // On peut aussi ne donner qu'un seul argument,
325 // subdir valant alors ce qui suit le dernier / dans $base
326 //
327 // http://doc.spip.org/@sous_repertoire
328 function sous_repertoire($base, $subdir='', $nobase = false, $tantpis=false) {
329 static $dirs = array();
330
331 $base = str_replace("//", "/", $base);
332
333 # suppr le dernier caractere si c'est un / ou un _
334 $base = rtrim($base, '/_');
335
336 if (!strlen($subdir)) {
337 $n = strrpos($base, "/");
338 if ($n === false) return $nobase ? '' : ($base .'/');
339 $subdir = substr($base, $n+1);
340 $base = substr($base, 0, $n+1);
341 } else {
342 $base .= '/';
343 $subdir = str_replace("/", "", $subdir);
344 }
345
346 $baseaff = $nobase ? '' : $base;
347 if (isset($dirs[$base.$subdir]))
348 return $baseaff.$dirs[$base.$subdir];
349
350
351 if (_CREER_DIR_PLAT AND @file_exists("$base${subdir}.plat"))
352 return $baseaff.($dirs[$base.$subdir] = "${subdir}_");
353
354 $path = $base.$subdir; # $path = 'IMG/distant/pdf' ou 'IMG/distant_pdf'
355
356 if (file_exists("$path/.ok"))
357 return $baseaff.($dirs[$base.$subdir] = "$subdir/");
358
359 @mkdir($path, _SPIP_CHMOD);
360 @chmod($path, _SPIP_CHMOD);
361
362 $ok = false;
363 if ($test = @fopen("$path/dir_test.php", "w")) {
364 @fputs($test, '<'.'?php $ok = true; ?'.'>');
365 @fclose($test);
366 @include("$path/dir_test.php");
367 spip_unlink("$path/dir_test.php");
368 }
369 if ($ok) {
370 @touch ("$path/.ok");
371 spip_log("creation $base$subdir/");
372 return $baseaff.($dirs[$base.$subdir] = "$subdir/");
373 }
374
375 // en cas d'echec c'est peut etre tout simplement que le disque est plein :
376 // l'inode du fichier dir_test existe, mais impossible d'y mettre du contenu
377 // => sauf besoin express (define dans mes_options), ne pas creer le .plat
378 if (_CREER_DIR_PLAT
379 AND $f = @fopen("$base${subdir}.plat", "w"))
380 fclose($f);
381 else {
382 spip_log("echec creation $base${subdir}");
383 if ($tantpis) return '';
384 if (!_DIR_RESTREINT)
385 $base = preg_replace(',^' . _DIR_RACINE .',', '',$base);
386 $base .= $subdir;
387 raler_fichier($base . ($test?'/.ok':'/dir_test.php'));
388 }
389 spip_log("faux sous-repertoire $base${subdir}");
390 return $baseaff.($dirs[$base.$subdir] = "${subdir}_");
391 }
392
393 //
394 // Cette fonction parcourt recursivement le repertoire $dir, et renvoie les
395 // fichiers dont le chemin verifie le pattern (preg) donne en argument.
396 // En cas d'echec retourne un array() vide
397 //
398 // Usage: array preg_files('ecrire/data/', '[.]lock$');
399 //
400 // Attention, afin de conserver la compatibilite avec les repertoires '.plat'
401 // si $dir = 'rep/sous_rep_' au lieu de 'rep/sous_rep/' on scanne 'rep/' et on
402 // applique un pattern '^rep/sous_rep_'
403 // si $recurs vaut false, la fonction ne descend pas dans les sus repertoires
404 //
405 // http://doc.spip.org/@preg_files
406 function preg_files($dir, $pattern=-1 /* AUTO */, $maxfiles = 10000, $recurs=array()) {
407 $nbfiles = 0;
408 if ($pattern == -1)
409 $pattern = "^$dir";
410 $fichiers = array();
411 // revenir au repertoire racine si on a recu dossier/truc
412 // pour regarder dossier/truc/ ne pas oublier le / final
413 $dir = preg_replace(',/[^/]*$,', '', $dir);
414 if ($dir == '') $dir = '.';
415
416 if (@is_dir($dir) AND is_readable($dir) AND $d = @opendir($dir)) {
417 while (($f = readdir($d)) !== false && ($nbfiles<$maxfiles)) {
418 if ($f[0] != '.' # ignorer . .. .svn etc
419 AND $f != 'CVS'
420 AND $f != 'remove.txt'
421 AND is_readable($f = "$dir/$f")) {
422 if (is_file($f)) {
423 if (preg_match(";$pattern;iS", $f))
424 {
425 $fichiers[] = $f;
426 $nbfiles++;
427 }
428 }
429 else if (is_dir($f) AND is_array($recurs)){
430 $rp = @realpath($f);
431 if (!is_string($rp) OR !strlen($rp)) $rp=$f; # realpath n'est peut etre pas autorise
432 if (!isset($recurs[$rp])) {
433 $recurs[$rp] = true;
434 $beginning = $fichiers;
435 $end = preg_files("$f/", $pattern,
436 $maxfiles-$nbfiles, $recurs);
437 $fichiers = array_merge((array)$beginning, (array)$end);
438 $nbfiles = count($fichiers);
439 }
440 }
441 }
442 }
443 closedir($d);
444 }
445 sort($fichiers);
446 return $fichiers;
447 }
448
449 ?>