Subversion Repositories Applications.framework

Rev

Rev 464 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
464 jpm 1
<!DOCTYPE html>
2
<html>
3
<head>
4
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
	<meta name="generator" content="ApiGen 2.8.0">
6
 
465 jpm 7
	<title>Class CacheFichier</title>
464 jpm 8
 
9
	<script type="text/javascript" src="resources/combined.js?4205936287"></script>
465 jpm 10
	<script type="text/javascript" src="elementlist.js?4111837732"></script>
464 jpm 11
	<link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360">
12
 
13
</head>
14
 
15
<body>
16
<div id="left">
17
	<div id="menu">
18
		<a href="index.html" title="Overview"><span>Overview</span></a>
19
 
20
 
21
		<div id="groups">
22
			<h3>Packages</h3>
23
			<ul>
24
				<li><a href="package-Framework.html">Framework</a>
25
						</li>
26
				<li class="active"><a href="package-None.html">None</a>
27
						</li>
28
				<li><a href="package-PHP.html">PHP</a>
29
						</li>
30
				<li><a href="package-Utilitaire.html">Utilitaire</a>
31
						</li>
32
			</ul>
33
		</div>
34
 
35
		<hr>
36
 
37
 
38
		<div id="elements">
39
			<h3>Classes</h3>
40
			<ul>
41
				<li class="active"><a href="class-CacheFichier.html">CacheFichier</a></li>
42
				<li><a href="class-CacheSqlite.html">CacheSqlite</a></li>
43
			</ul>
44
 
45
 
46
 
47
 
48
 
49
		</div>
50
	</div>
51
</div>
52
 
53
<div id="splitter"></div>
54
 
55
<div id="right">
56
<div id="rightInner">
57
	<form id="search">
58
		<input type="hidden" name="cx" value="">
59
		<input type="hidden" name="ie" value="UTF-8">
60
		<input type="text" name="q" class="text">
61
		<input type="submit" value="Search">
62
	</form>
63
 
64
	<div id="navigation">
65
		<ul>
66
			<li>
67
				<a href="index.html" title="Overview"><span>Overview</span></a>
68
			</li>
69
			<li>
70
				<a href="package-None.html" title="Summary of None"><span>Package</span></a>
71
			</li>
72
			<li class="active">
73
<span>Class</span>			</li>
74
		</ul>
75
		<ul>
76
			<li>
77
				<a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
78
			</li>
79
			<li>
80
				<a href="deprecated.html" title="List of deprecated elements"><span>Deprecated</span></a>
81
			</li>
82
			<li>
83
				<a href="todo.html" title="Todo list"><span>Todo</span></a>
84
			</li>
85
		</ul>
86
		<ul>
87
		</ul>
88
	</div>
89
 
90
<div id="content" class="class">
91
	<h1>Class CacheFichier</h1>
92
 
93
 
94
 
95
 
96
 
97
 
98
 
99
 
100
 
101
 
102
 
103
	<div class="info">
104
 
105
 
106
 
107
 
108
 
465 jpm 109
		<b>Located at</b> <a href="source-class-CacheFichier.html#2-870" title="Go to source code">CacheFichier.php</a><br>
464 jpm 110
	</div>
111
 
112
 
113
 
114
	<table class="summary" id="methods">
115
	<caption>Methods summary</caption>
116
	<tr data-order="__construct" id="___construct">
117
 
118
		<td class="attributes"><code>
119
			 public
120
 
121
 
122
			</code>
123
		</td>
124
 
125
		<td class="name"><div>
126
		<a class="anchor" href="#___construct">#</a>
127
		<code><a href="source-class-CacheFichier.html#73-101" title="Go to source code">__construct</a>( <span>array <var>$options</var> = <span class="php-keyword1">array</span>()</span>, <span><code><a href="class-Cache.html">Cache</a></code> <var>$cache</var></span> )</code>
128
 
129
		<div class="description short">
130
 
131
<p>Constructor</p>
132
 
133
		</div>
134
 
135
		<div class="description detailed hidden">
136
 
137
<p>Constructor</p>
138
 
139
 
140
 
141
				<h4>Parameters</h4>
142
				<div class="list"><dl>
143
					<dt><var>$options</var></dt>
144
					<dd><code>array</code><br>$options associative array of options</dd>
145
					<dt><var>$cache</var></dt>
146
					<dd></dd>
147
				</dl></div>
148
 
149
 
150
				<h4>Throws</h4>
151
				<div class="list">
152
					<code>Zend_Cache_Exception</code><br>
153
				</div>
154
 
155
 
156
 
157
		</div>
158
		</div></td>
159
	</tr>
160
	<tr data-order="setEmplacement" id="_setEmplacement">
161
 
162
		<td class="attributes"><code>
163
			 public
164
 
165
 
166
			</code>
167
		</td>
168
 
169
		<td class="name"><div>
170
		<a class="anchor" href="#_setEmplacement">#</a>
171
		<code><a href="source-class-CacheFichier.html#123-132" title="Go to source code">setEmplacement</a>( <span>mixed <var>$emplacement</var></span> )</code>
172
 
173
		<div class="description short">
174
 
175
		</div>
176
 
177
		<div class="description detailed hidden">
178
 
179
 
180
 
181
 
182
 
183
 
184
 
185
 
186
		</div>
187
		</div></td>
188
	</tr>
189
	<tr data-order="charger" id="_charger">
190
 
191
		<td class="attributes"><code>
192
			 public
193
			string|false
194
 
195
			</code>
196
		</td>
197
 
198
		<td class="name"><div>
199
		<a class="anchor" href="#_charger">#</a>
200
		<code><a href="source-class-CacheFichier.html#134-159" title="Go to source code">charger</a>( <span>string <var>$id</var></span>, <span>boolean <var>$ne_pas_tester_validiter_du_cache</var> = <span class="php-keyword1">false</span></span> )</code>
201
 
202
		<div class="description short">
203
 
204
<p>Test if a cache is available for the given id and (if yes) return it (false
205
else)</p>
206
 
207
		</div>
208
 
209
		<div class="description detailed hidden">
210
 
211
<p>Test if a cache is available for the given id and (if yes) return it (false
212
else)</p>
213
 
214
 
215
 
216
				<h4>Parameters</h4>
217
				<div class="list"><dl>
218
					<dt><var>$id</var></dt>
219
					<dd><code>string</code><br>$id cache id</dd>
220
					<dt><var>$ne_pas_tester_validiter_du_cache</var></dt>
221
					<dd><code>boolean</code><br>$doNotTestCacheValidity if set to true, the cache validity won't be tested</dd>
222
				</dl></div>
223
 
224
				<h4>Returns</h4>
225
				<div class="list">
226
					<code>string|false</code><br>cached datas<br>
227
				</div>
228
 
229
 
230
 
231
 
232
		</div>
233
		</div></td>
234
	</tr>
235
	<tr data-order="tester" id="_tester">
236
 
237
		<td class="attributes"><code>
238
			 public
239
			mixed
240
 
241
			</code>
242
		</td>
243
 
244
		<td class="name"><div>
245
		<a class="anchor" href="#_tester">#</a>
246
		<code><a href="source-class-CacheFichier.html#161-170" title="Go to source code">tester</a>( <span>string <var>$id</var></span> )</code>
247
 
248
		<div class="description short">
249
 
250
<p>Teste si un enregistrement en cache est disponible ou pas (pour l'id passé
251
en paramètre).</p>
252
 
253
		</div>
254
 
255
		<div class="description detailed hidden">
256
 
257
<p>Teste si un enregistrement en cache est disponible ou pas (pour l'id passé
258
en paramètre).</p>
259
 
260
 
261
 
262
				<h4>Parameters</h4>
263
				<div class="list"><dl>
264
					<dt><var>$id</var></dt>
265
					<dd><code>string</code><br>$id identifiant de cache.</dd>
266
				</dl></div>
267
 
268
				<h4>Returns</h4>
269
				<div class="list">
270
					<code>mixed</code><br>false (le cache n'est pas disponible) ou timestamp (int) "de dernière
271
modification" de l'enregistrement en cache<br>
272
				</div>
273
 
274
 
275
 
276
 
277
		</div>
278
		</div></td>
279
	</tr>
280
	<tr data-order="sauver" id="_sauver">
281
 
282
		<td class="attributes"><code>
283
			 public
284
			boolean
285
 
286
			</code>
287
		</td>
288
 
289
		<td class="name"><div>
290
		<a class="anchor" href="#_sauver">#</a>
291
		<code><a href="source-class-CacheFichier.html#172-221" title="Go to source code">sauver</a>( <span>string <var>$donnees</var></span>, <span>string <var>$id</var></span>, <span>array <var>$tags</var> = <span class="php-keyword1">array</span>()</span>, <span>integer <var>$duree_vie_specifique</var> = <span class="php-keyword1">false</span></span> )</code>
292
 
293
		<div class="description short">
294
 
295
<p>Save some string datas into a cache record</p>
296
 
297
		</div>
298
 
299
		<div class="description detailed hidden">
300
 
301
<p>Save some string datas into a cache record</p>
302
 
303
<p>Note : $data is always "string" (serialization is done by the core not by the
304
backend)</p>
305
 
306
 
307
 
308
				<h4>Parameters</h4>
309
				<div class="list"><dl>
310
					<dt><var>$donnees</var></dt>
311
					<dd><code>string</code><br>$data Datas to cache</dd>
312
					<dt><var>$id</var></dt>
313
					<dd><code>string</code><br>$id Cache id</dd>
314
					<dt><var>$tags</var></dt>
315
					<dd><code>array</code><br>$tags Array of strings, the cache record will be tagged by each string entry</dd>
316
					<dt><var>$duree_vie_specifique</var></dt>
317
					<dd><code>integer</code><br>$specificLifetime If != false, set a specific lifetime for this cache record
318
(null =&gt; infinite lifetime)</dd>
319
				</dl></div>
320
 
321
				<h4>Returns</h4>
322
				<div class="list">
323
					<code>boolean</code><br>true if no problem<br>
324
				</div>
325
 
326
 
327
 
328
 
329
		</div>
330
		</div></td>
331
	</tr>
332
	<tr data-order="supprimer" id="_supprimer">
333
 
334
		<td class="attributes"><code>
335
			 public
336
			boolean
337
 
338
			</code>
339
		</td>
340
 
341
		<td class="name"><div>
342
		<a class="anchor" href="#_supprimer">#</a>
343
		<code><a href="source-class-CacheFichier.html#223-234" title="Go to source code">supprimer</a>( <span>string <var>$id</var></span> )</code>
344
 
345
		<div class="description short">
346
 
347
<p>Remove a cache record</p>
348
 
349
		</div>
350
 
351
		<div class="description detailed hidden">
352
 
353
<p>Remove a cache record</p>
354
 
355
 
356
 
357
				<h4>Parameters</h4>
358
				<div class="list"><dl>
359
					<dt><var>$id</var></dt>
360
					<dd><code>string</code><br>$id cache id</dd>
361
				</dl></div>
362
 
363
				<h4>Returns</h4>
364
				<div class="list">
365
					<code>boolean</code><br>true if no problem<br>
366
				</div>
367
 
368
 
369
 
370
 
371
		</div>
372
		</div></td>
373
	</tr>
374
	<tr data-order="nettoyer" id="_nettoyer">
375
 
376
		<td class="attributes"><code>
377
			 public
378
			boolean
379
 
380
			</code>
381
		</td>
382
 
383
		<td class="name"><div>
384
		<a class="anchor" href="#_nettoyer">#</a>
385
		<code><a href="source-class-CacheFichier.html#236-257" title="Go to source code">nettoyer</a>( <span>string <var>$mode</var> = <code><a href="class-Cache.html#NETTOYAGE_MODE_TOUS">Cache::<b>NETTOYAGE_MODE_TOUS</b></a></code></span>, <span>tags <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
386
 
387
		<div class="description short">
388
 
389
<p>Clean some cache records</p>
390
 
391
		</div>
392
 
393
		<div class="description detailed hidden">
394
 
395
<p>Clean some cache records</p>
396
 
397
<p>Available modes are : 'all' (default) =&gt; remove all cache entries ($tags
398
is not used) 'old' =&gt; remove too old cache entries ($tags is not used)
399
'matchingTag' =&gt; remove cache entries matching all given tags ($tags can be
400
an array of strings or a single string) 'notMatchingTag' =&gt; remove cache
401
entries not matching one of the given tags ($tags can be an array of strings or
402
a single string) 'matchingAnyTag' =&gt; remove cache entries matching any given
403
tags ($tags can be an array of strings or a single string)</p>
404
 
405
 
406
 
407
				<h4>Parameters</h4>
408
				<div class="list"><dl>
409
					<dt><var>$mode</var></dt>
410
					<dd><code>string</code><br>$mode clean mode</dd>
411
					<dt><var>$tags</var></dt>
412
					<dd><code>tags</code><br>array $tags array of tags</dd>
413
				</dl></div>
414
 
415
				<h4>Returns</h4>
416
				<div class="list">
417
					<code>boolean</code><br>true if no problem<br>
418
				</div>
419
 
420
 
421
 
422
 
423
		</div>
424
		</div></td>
425
	</tr>
426
	<tr data-order="getIds" id="_getIds">
427
 
428
		<td class="attributes"><code>
429
			 public
430
			array
431
 
432
			</code>
433
		</td>
434
 
435
		<td class="name"><div>
436
		<a class="anchor" href="#_getIds">#</a>
437
		<code><a href="source-class-CacheFichier.html#259-266" title="Go to source code">getIds</a>( )</code>
438
 
439
		<div class="description short">
440
 
441
<p>Return an array of stored cache ids</p>
442
 
443
		</div>
444
 
445
		<div class="description detailed hidden">
446
 
447
<p>Return an array of stored cache ids</p>
448
 
449
 
450
 
451
 
452
				<h4>Returns</h4>
453
				<div class="list">
454
					<code>array</code><br>array of stored cache ids (string)<br>
455
				</div>
456
 
457
 
458
 
459
 
460
		</div>
461
		</div></td>
462
	</tr>
463
	<tr data-order="getTags" id="_getTags">
464
 
465
		<td class="attributes"><code>
466
			 public
467
			array
468
 
469
			</code>
470
		</td>
471
 
472
		<td class="name"><div>
473
		<a class="anchor" href="#_getTags">#</a>
474
		<code><a href="source-class-CacheFichier.html#268-275" title="Go to source code">getTags</a>( )</code>
475
 
476
		<div class="description short">
477
 
478
<p>Return an array of stored tags</p>
479
 
480
		</div>
481
 
482
		<div class="description detailed hidden">
483
 
484
<p>Return an array of stored tags</p>
485
 
486
 
487
 
488
 
489
				<h4>Returns</h4>
490
				<div class="list">
491
					<code>array</code><br>array of stored tags (string)<br>
492
				</div>
493
 
494
 
495
 
496
 
497
		</div>
498
		</div></td>
499
	</tr>
500
	<tr data-order="getIdsAvecLesTags" id="_getIdsAvecLesTags">
501
 
502
		<td class="attributes"><code>
503
			 public
504
			array
505
 
506
			</code>
507
		</td>
508
 
509
		<td class="name"><div>
510
		<a class="anchor" href="#_getIdsAvecLesTags">#</a>
511
		<code><a href="source-class-CacheFichier.html#277-287" title="Go to source code">getIdsAvecLesTags</a>( <span>array <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
512
 
513
		<div class="description short">
514
 
515
<p>Return an array of stored cache ids which match given tags</p>
516
 
517
		</div>
518
 
519
		<div class="description detailed hidden">
520
 
521
<p>Return an array of stored cache ids which match given tags</p>
522
 
523
<p>In case of multiple tags, a logical AND is made between tags</p>
524
 
525
 
526
 
527
				<h4>Parameters</h4>
528
				<div class="list"><dl>
529
					<dt><var>$tags</var></dt>
530
					<dd><code>array</code><br>$tags array of tags</dd>
531
				</dl></div>
532
 
533
				<h4>Returns</h4>
534
				<div class="list">
535
					<code>array</code><br>array of matching cache ids (string)<br>
536
				</div>
537
 
538
 
539
 
540
 
541
		</div>
542
		</div></td>
543
	</tr>
544
	<tr data-order="getIdsSansLesTags" id="_getIdsSansLesTags">
545
 
546
		<td class="attributes"><code>
547
			 public
548
			array
549
 
550
			</code>
551
		</td>
552
 
553
		<td class="name"><div>
554
		<a class="anchor" href="#_getIdsSansLesTags">#</a>
555
		<code><a href="source-class-CacheFichier.html#289-299" title="Go to source code">getIdsSansLesTags</a>( <span>array <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
556
 
557
		<div class="description short">
558
 
559
<p>Return an array of stored cache ids which don't match given tags</p>
560
 
561
		</div>
562
 
563
		<div class="description detailed hidden">
564
 
565
<p>Return an array of stored cache ids which don't match given tags</p>
566
 
567
<p>In case of multiple tags, a logical OR is made between tags</p>
568
 
569
 
570
 
571
				<h4>Parameters</h4>
572
				<div class="list"><dl>
573
					<dt><var>$tags</var></dt>
574
					<dd><code>array</code><br>$tags array of tags</dd>
575
				</dl></div>
576
 
577
				<h4>Returns</h4>
578
				<div class="list">
579
					<code>array</code><br>array of not matching cache ids (string)<br>
580
				</div>
581
 
582
 
583
 
584
 
585
		</div>
586
		</div></td>
587
	</tr>
588
	<tr data-order="getIdsAvecUnTag" id="_getIdsAvecUnTag">
589
 
590
		<td class="attributes"><code>
591
			 public
592
			array
593
 
594
			</code>
595
		</td>
596
 
597
		<td class="name"><div>
598
		<a class="anchor" href="#_getIdsAvecUnTag">#</a>
599
		<code><a href="source-class-CacheFichier.html#301-311" title="Go to source code">getIdsAvecUnTag</a>( <span>array <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
600
 
601
		<div class="description short">
602
 
603
<p>Return an array of stored cache ids which match any given tags</p>
604
 
605
		</div>
606
 
607
		<div class="description detailed hidden">
608
 
609
<p>Return an array of stored cache ids which match any given tags</p>
610
 
611
<p>In case of multiple tags, a logical AND is made between tags</p>
612
 
613
 
614
 
615
				<h4>Parameters</h4>
616
				<div class="list"><dl>
617
					<dt><var>$tags</var></dt>
618
					<dd><code>array</code><br>$tags array of tags</dd>
619
				</dl></div>
620
 
621
				<h4>Returns</h4>
622
				<div class="list">
623
					<code>array</code><br>array of any matching cache ids (string)<br>
624
				</div>
625
 
626
 
627
 
628
 
629
		</div>
630
		</div></td>
631
	</tr>
632
	<tr data-order="getPourcentageRemplissage" id="_getPourcentageRemplissage">
633
 
634
		<td class="attributes"><code>
635
			 public
636
			integer
637
 
638
			</code>
639
		</td>
640
 
641
		<td class="name"><div>
642
		<a class="anchor" href="#_getPourcentageRemplissage">#</a>
643
		<code><a href="source-class-CacheFichier.html#313-330" title="Go to source code">getPourcentageRemplissage</a>( )</code>
644
 
645
		<div class="description short">
646
 
647
<p>Return the filling percentage of the backend storage</p>
648
 
649
		</div>
650
 
651
		<div class="description detailed hidden">
652
 
653
<p>Return the filling percentage of the backend storage</p>
654
 
655
 
656
 
657
 
658
				<h4>Returns</h4>
659
				<div class="list">
660
					<code>integer</code><br>integer between 0 and 100<br>
661
				</div>
662
 
663
				<h4>Throws</h4>
664
				<div class="list">
665
					<code>Zend_Cache_Exception</code><br>
666
				</div>
667
 
668
 
669
 
670
		</div>
671
		</div></td>
672
	</tr>
673
	<tr data-order="getMetadonnees" id="_getMetadonnees">
674
 
675
		<td class="attributes"><code>
676
			 public
677
			array
678
 
679
			</code>
680
		</td>
681
 
682
		<td class="name"><div>
683
		<a class="anchor" href="#_getMetadonnees">#</a>
684
		<code><a href="source-class-CacheFichier.html#332-357" title="Go to source code">getMetadonnees</a>( <span>string <var>$id</var></span> )</code>
685
 
686
		<div class="description short">
687
 
688
<p>Return an array of metadatas for the given cache id</p>
689
 
690
		</div>
691
 
692
		<div class="description detailed hidden">
693
 
694
<p>Return an array of metadatas for the given cache id</p>
695
 
696
<p>The array must include these keys :</p>
697
 
698
<ul>
699
	<li>expire : the expire timestamp</li>
700
 
701
	<li>tags : a string array of tags</li>
702
 
703
	<li>mtime : timestamp of last modification time</li>
704
</ul>
705
 
706
 
707
 
708
				<h4>Parameters</h4>
709
				<div class="list"><dl>
710
					<dt><var>$id</var></dt>
711
					<dd><code>string</code><br>$id cache id</dd>
712
				</dl></div>
713
 
714
				<h4>Returns</h4>
715
				<div class="list">
716
					<code>array</code><br>array of metadatas (false if the cache id is not found)<br>
717
				</div>
718
 
719
 
720
 
721
 
722
		</div>
723
		</div></td>
724
	</tr>
725
	<tr data-order="ajouterSupplementDureeDeVie" id="_ajouterSupplementDureeDeVie">
726
 
727
		<td class="attributes"><code>
728
			 public
729
			boolean
730
 
731
			</code>
732
		</td>
733
 
734
		<td class="name"><div>
735
		<a class="anchor" href="#_ajouterSupplementDureeDeVie">#</a>
736
		<code><a href="source-class-CacheFichier.html#359-382" title="Go to source code">ajouterSupplementDureeDeVie</a>( <span>string <var>$id</var></span>, <span>integer <var>$supplement_duree_de_vie</var></span> )</code>
737
 
738
		<div class="description short">
739
 
740
<p>Give (if possible) an extra lifetime to the given cache id</p>
741
 
742
		</div>
743
 
744
		<div class="description detailed hidden">
745
 
746
<p>Give (if possible) an extra lifetime to the given cache id</p>
747
 
748
 
749
 
750
				<h4>Parameters</h4>
751
				<div class="list"><dl>
752
					<dt><var>$id</var></dt>
753
					<dd><code>string</code><br>$id cache id</dd>
754
					<dt><var>$supplement_duree_de_vie</var></dt>
755
					<dd><code>integer</code><br>$extraLifetime</dd>
756
				</dl></div>
757
 
758
				<h4>Returns</h4>
759
				<div class="list">
760
					<code>boolean</code><br>true if ok<br>
761
				</div>
762
 
763
 
764
 
765
 
766
		</div>
767
		</div></td>
768
	</tr>
769
	<tr data-order="getMetadonneesFichier" id="_getMetadonneesFichier">
770
 
771
		<td class="attributes"><code>
772
			 protected
773
			array|false
774
 
775
			</code>
776
		</td>
777
 
778
		<td class="name"><div>
779
		<a class="anchor" href="#_getMetadonneesFichier">#</a>
780
		<code><a href="source-class-CacheFichier.html#384-400" title="Go to source code">getMetadonneesFichier</a>( <span>string <var>$id</var></span> )</code>
781
 
782
		<div class="description short">
783
 
784
<p>Get a metadatas record</p>
785
 
786
		</div>
787
 
788
		<div class="description detailed hidden">
789
 
790
<p>Get a metadatas record</p>
791
 
792
 
793
 
794
				<h4>Parameters</h4>
795
				<div class="list"><dl>
796
					<dt><var>$id</var></dt>
797
					<dd><code>string</code><br>$id Cache id</dd>
798
				</dl></div>
799
 
800
				<h4>Returns</h4>
801
				<div class="list">
802
					<code>array|false</code><br>Associative array of metadatas<br>
803
				</div>
804
 
805
 
806
 
807
 
808
		</div>
809
		</div></td>
810
	</tr>
811
	<tr data-order="setMetadonnees" id="_setMetadonnees">
812
 
813
		<td class="attributes"><code>
814
			 protected
815
			boolean
816
 
817
			</code>
818
		</td>
819
 
820
		<td class="name"><div>
821
		<a class="anchor" href="#_setMetadonnees">#</a>
822
		<code><a href="source-class-CacheFichier.html#402-424" title="Go to source code">setMetadonnees</a>( <span>string <var>$id</var></span>, <span>array <var>$metadonnees</var></span>, <span>boolean <var>$sauvegarde</var> = <span class="php-keyword1">true</span></span> )</code>
823
 
824
		<div class="description short">
825
 
826
<p>Set a metadatas record</p>
827
 
828
		</div>
829
 
830
		<div class="description detailed hidden">
831
 
832
<p>Set a metadatas record</p>
833
 
834
 
835
 
836
				<h4>Parameters</h4>
837
				<div class="list"><dl>
838
					<dt><var>$id</var></dt>
839
					<dd><code>string</code><br>$id Cache id</dd>
840
					<dt><var>$metadonnees</var></dt>
841
					<dd><code>array</code><br>$metadatas Associative array of metadatas</dd>
842
					<dt><var>$sauvegarde</var></dt>
843
					<dd><code>boolean</code><br>$save optional pass false to disable saving to file</dd>
844
				</dl></div>
845
 
846
				<h4>Returns</h4>
847
				<div class="list">
848
					<code>boolean</code><br>True if no problem<br>
849
				</div>
850
 
851
 
852
 
853
 
854
		</div>
855
		</div></td>
856
	</tr>
857
	<tr data-order="supprimerMetadonnees" id="_supprimerMetadonnees">
858
 
859
		<td class="attributes"><code>
860
			 protected
861
			boolean
862
 
863
			</code>
864
		</td>
865
 
866
		<td class="name"><div>
867
		<a class="anchor" href="#_supprimerMetadonnees">#</a>
868
		<code><a href="source-class-CacheFichier.html#426-438" title="Go to source code">supprimerMetadonnees</a>( <span>string <var>$id</var></span> )</code>
869
 
870
		<div class="description short">
871
 
872
<p>Drop a metadata record</p>
873
 
874
		</div>
875
 
876
		<div class="description detailed hidden">
877
 
878
<p>Drop a metadata record</p>
879
 
880
 
881
 
882
				<h4>Parameters</h4>
883
				<div class="list"><dl>
884
					<dt><var>$id</var></dt>
885
					<dd><code>string</code><br>$id Cache id</dd>
886
				</dl></div>
887
 
888
				<h4>Returns</h4>
889
				<div class="list">
890
					<code>boolean</code><br>True if no problem<br>
891
				</div>
892
 
893
 
894
 
895
 
896
		</div>
897
		</div></td>
898
	</tr>
899
	<tr data-order="nettoyerMetadonnees" id="_nettoyerMetadonnees">
900
 
901
		<td class="attributes"><code>
902
			 protected
903
 
904
 
905
			</code>
906
		</td>
907
 
908
		<td class="name"><div>
909
		<a class="anchor" href="#_nettoyerMetadonnees">#</a>
910
		<code><a href="source-class-CacheFichier.html#440-447" title="Go to source code">nettoyerMetadonnees</a>( )</code>
911
 
912
		<div class="description short">
913
 
914
<p>Clear the metadatas array</p>
915
 
916
		</div>
917
 
918
		<div class="description detailed hidden">
919
 
920
<p>Clear the metadatas array</p>
921
 
922
 
923
 
924
 
925
 
926
 
927
 
928
 
929
		</div>
930
		</div></td>
931
	</tr>
932
	<tr data-order="chargerMetadonnees" id="_chargerMetadonnees">
933
 
934
		<td class="attributes"><code>
935
			 protected
936
			array|false
937
 
938
			</code>
939
		</td>
940
 
941
		<td class="name"><div>
942
		<a class="anchor" href="#_chargerMetadonnees">#</a>
943
		<code><a href="source-class-CacheFichier.html#449-461" title="Go to source code">chargerMetadonnees</a>( <span>string <var>$id</var></span> )</code>
944
 
945
		<div class="description short">
946
 
947
<p>Load metadatas from disk</p>
948
 
949
		</div>
950
 
951
		<div class="description detailed hidden">
952
 
953
<p>Load metadatas from disk</p>
954
 
955
 
956
 
957
				<h4>Parameters</h4>
958
				<div class="list"><dl>
959
					<dt><var>$id</var></dt>
960
					<dd><code>string</code><br>$id Cache id</dd>
961
				</dl></div>
962
 
963
				<h4>Returns</h4>
964
				<div class="list">
965
					<code>array|false</code><br>Metadatas associative array<br>
966
				</div>
967
 
968
 
969
 
970
 
971
		</div>
972
		</div></td>
973
	</tr>
974
	<tr data-order="sauverMetadonnees" id="_sauverMetadonnees">
975
 
976
		<td class="attributes"><code>
977
			 protected
978
			boolean
979
 
980
			</code>
981
		</td>
982
 
983
		<td class="name"><div>
984
		<a class="anchor" href="#_sauverMetadonnees">#</a>
985
		<code><a href="source-class-CacheFichier.html#463-474" title="Go to source code">sauverMetadonnees</a>( <span>string <var>$id</var></span>, <span>array <var>$metadonnees</var></span> )</code>
986
 
987
		<div class="description short">
988
 
989
<p>Save metadatas to disk</p>
990
 
991
		</div>
992
 
993
		<div class="description detailed hidden">
994
 
995
<p>Save metadatas to disk</p>
996
 
997
 
998
 
999
				<h4>Parameters</h4>
1000
				<div class="list"><dl>
1001
					<dt><var>$id</var></dt>
1002
					<dd><code>string</code><br>$id Cache id</dd>
1003
					<dt><var>$metadonnees</var></dt>
1004
					<dd><code>array</code><br>$metadatas Associative array</dd>
1005
				</dl></div>
1006
 
1007
				<h4>Returns</h4>
1008
				<div class="list">
1009
					<code>boolean</code><br>True if no problem<br>
1010
				</div>
1011
 
1012
 
1013
 
1014
 
1015
		</div>
1016
		</div></td>
1017
	</tr>
1018
	<tr data-order="getNomFichierMeta" id="_getNomFichierMeta">
1019
 
1020
		<td class="attributes"><code>
1021
			 protected
1022
			string
1023
 
1024
			</code>
1025
		</td>
1026
 
1027
		<td class="name"><div>
1028
		<a class="anchor" href="#_getNomFichierMeta">#</a>
1029
		<code><a href="source-class-CacheFichier.html#476-486" title="Go to source code">getNomFichierMeta</a>( <span>string <var>$id</var></span> )</code>
1030
 
1031
		<div class="description short">
1032
 
1033
<p>Make and return a file name (with path) for metadatas</p>
1034
 
1035
		</div>
1036
 
1037
		<div class="description detailed hidden">
1038
 
1039
<p>Make and return a file name (with path) for metadatas</p>
1040
 
1041
 
1042
 
1043
				<h4>Parameters</h4>
1044
				<div class="list"><dl>
1045
					<dt><var>$id</var></dt>
1046
					<dd><code>string</code><br>$id Cache id</dd>
1047
				</dl></div>
1048
 
1049
				<h4>Returns</h4>
1050
				<div class="list">
1051
					<code>string</code><br>Metadatas file name (with path)<br>
1052
				</div>
1053
 
1054
 
1055
 
1056
 
1057
		</div>
1058
		</div></td>
1059
	</tr>
1060
	<tr data-order="etreFichierMeta" id="_etreFichierMeta">
1061
 
1062
		<td class="attributes"><code>
1063
			 protected
1064
			boolean
1065
 
1066
			</code>
1067
		</td>
1068
 
1069
		<td class="name"><div>
1070
		<a class="anchor" href="#_etreFichierMeta">#</a>
1071
		<code><a href="source-class-CacheFichier.html#488-497" title="Go to source code">etreFichierMeta</a>( <span>string <var>$fichier_nom</var></span> )</code>
1072
 
1073
		<div class="description short">
1074
 
1075
<p>Check if the given filename is a metadatas one</p>
1076
 
1077
		</div>
1078
 
1079
		<div class="description detailed hidden">
1080
 
1081
<p>Check if the given filename is a metadatas one</p>
1082
 
1083
 
1084
 
1085
				<h4>Parameters</h4>
1086
				<div class="list"><dl>
1087
					<dt><var>$fichier_nom</var></dt>
1088
					<dd><code>string</code><br>$fileName File name</dd>
1089
				</dl></div>
1090
 
1091
				<h4>Returns</h4>
1092
				<div class="list">
1093
					<code>boolean</code><br>True if it's a metadatas one<br>
1094
				</div>
1095
 
1096
 
1097
 
1098
 
1099
		</div>
1100
		</div></td>
1101
	</tr>
1102
	<tr data-order="supprimerFichier" id="_supprimerFichier">
1103
 
1104
		<td class="attributes"><code>
1105
			 protected
1106
			boolean
1107
 
1108
			</code>
1109
		</td>
1110
 
1111
		<td class="name"><div>
1112
		<a class="anchor" href="#_supprimerFichier">#</a>
1113
		<code><a href="source-class-CacheFichier.html#499-516" title="Go to source code">supprimerFichier</a>( <span>string <var>$fichier</var></span> )</code>
1114
 
1115
		<div class="description short">
1116
 
1117
<p>Remove a file</p>
1118
 
1119
		</div>
1120
 
1121
		<div class="description detailed hidden">
1122
 
1123
<p>Remove a file</p>
1124
 
1125
<p>If we can't remove the file (because of locks or any problem), we will touch
1126
the file to invalidate it</p>
1127
 
1128
 
1129
 
1130
				<h4>Parameters</h4>
1131
				<div class="list"><dl>
1132
					<dt><var>$fichier</var></dt>
1133
					<dd><code>string</code><br>$file Complete file path</dd>
1134
				</dl></div>
1135
 
1136
				<h4>Returns</h4>
1137
				<div class="list">
1138
					<code>boolean</code><br>True if ok<br>
1139
				</div>
1140
 
1141
 
1142
 
1143
 
1144
		</div>
1145
		</div></td>
1146
	</tr>
1147
	<tr data-order="nettoyerFichiers" id="_nettoyerFichiers">
1148
 
1149
		<td class="attributes"><code>
1150
			 protected
1151
			boolean
1152
 
1153
			</code>
1154
		</td>
1155
 
1156
		<td class="name"><div>
1157
		<a class="anchor" href="#_nettoyerFichiers">#</a>
1158
		<code><a href="source-class-CacheFichier.html#518-626" title="Go to source code">nettoyerFichiers</a>( <span>string <var>$dossier</var></span>, <span>string <var>$mode</var> = <code><a href="class-Cache.html#NETTOYAGE_MODE_TOUS">Cache::<b>NETTOYAGE_MODE_TOUS</b></a></code></span>, <span>array <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
1159
 
1160
		<div class="description short">
1161
 
1162
<p>Clean some cache records (protected method used for recursive stuff)</p>
1163
 
1164
		</div>
1165
 
1166
		<div class="description detailed hidden">
1167
 
1168
<p>Clean some cache records (protected method used for recursive stuff)</p>
1169
 
1170
<p>Available modes are : Zend_Cache::CLEANING_MODE_ALL (default) =&gt; remove
1171
all cache entries ($tags is not used) Zend_Cache::CLEANING_MODE_OLD =&gt; remove
1172
too old cache entries ($tags is not used) Zend_Cache::CLEANING_MODE_MATCHING_TAG
1173
=&gt; remove cache entries matching all given tags ($tags can be an array of
1174
strings or a single string) Zend_Cache::CLEANING_MODE_NOT_MATCHING_TAG =&gt;
1175
remove cache entries not {matching one of the given tags} ($tags can be an array
1176
of strings or a single string) Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG =&gt;
1177
remove cache entries matching any given tags ($tags can be an array of strings
1178
or a single string)</p>
1179
 
1180
 
1181
 
1182
				<h4>Parameters</h4>
1183
				<div class="list"><dl>
1184
					<dt><var>$dossier</var></dt>
1185
					<dd><code>string</code><br>$dir Directory to clean</dd>
1186
					<dt><var>$mode</var></dt>
1187
					<dd><code>string</code><br>$mode Clean mode</dd>
1188
					<dt><var>$tags</var></dt>
1189
					<dd><code>array</code><br>$tags Array of tags</dd>
1190
				</dl></div>
1191
 
1192
				<h4>Returns</h4>
1193
				<div class="list">
1194
					<code>boolean</code><br>True if no problem<br>
1195
				</div>
1196
 
1197
				<h4>Throws</h4>
1198
				<div class="list">
1199
					<code>Zend_Cache_Exception</code><br>
1200
				</div>
1201
 
1202
 
1203
 
1204
		</div>
1205
		</div></td>
1206
	</tr>
1207
	<tr data-order="analyserCache" id="_analyserCache">
1208
 
1209
		<td class="attributes"><code>
1210
			 protected
1211
 
1212
 
1213
			</code>
1214
		</td>
1215
 
1216
		<td class="name"><div>
1217
		<a class="anchor" href="#_analyserCache">#</a>
1218
		<code><a href="source-class-CacheFichier.html#628-709" title="Go to source code">analyserCache</a>( <span>mixed <var>$dossier</var></span>, <span>mixed <var>$mode</var></span>, <span>mixed <var>$tags</var> = <span class="php-keyword1">array</span>()</span> )</code>
1219
 
1220
		<div class="description short">
1221
 
1222
		</div>
1223
 
1224
		<div class="description detailed hidden">
1225
 
1226
 
1227
 
1228
 
1229
 
1230
 
1231
 
1232
 
1233
		</div>
1234
		</div></td>
1235
	</tr>
1236
	<tr data-order="genererCleSecu" id="_genererCleSecu">
1237
 
1238
		<td class="attributes"><code>
1239
			 protected
1240
			string
1241
 
1242
			</code>
1243
		</td>
1244
 
1245
		<td class="name"><div>
1246
		<a class="anchor" href="#_genererCleSecu">#</a>
1247
		<code><a href="source-class-CacheFichier.html#711-732" title="Go to source code">genererCleSecu</a>( <span>string <var>$donnees</var></span>, <span>string <var>$type_de_controle</var></span> )</code>
1248
 
1249
		<div class="description short">
1250
 
1251
<p>Make a control key with the string containing datas</p>
1252
 
1253
		</div>
1254
 
1255
		<div class="description detailed hidden">
1256
 
1257
<p>Make a control key with the string containing datas</p>
1258
 
1259
 
1260
 
1261
				<h4>Parameters</h4>
1262
				<div class="list"><dl>
1263
					<dt><var>$donnees</var></dt>
1264
					<dd><code>string</code><br>$data Data</dd>
1265
					<dt><var>$type_de_controle</var></dt>
1266
					<dd><code>string</code><br>$controlType Type of control 'md5', 'crc32' or 'strlen'</dd>
1267
				</dl></div>
1268
 
1269
				<h4>Returns</h4>
1270
				<div class="list">
1271
					<code>string</code><br>Control key<br>
1272
				</div>
1273
 
1274
				<h4>Throws</h4>
1275
				<div class="list">
1276
					<code>Zend_Cache_Exception</code><br>
1277
				</div>
1278
 
1279
 
1280
 
1281
		</div>
1282
		</div></td>
1283
	</tr>
1284
	<tr data-order="transformaterIdEnNomFichier" id="_transformaterIdEnNomFichier">
1285
 
1286
		<td class="attributes"><code>
1287
			 protected
1288
			string
1289
 
1290
			</code>
1291
		</td>
1292
 
1293
		<td class="name"><div>
1294
		<a class="anchor" href="#_transformaterIdEnNomFichier">#</a>
1295
		<code><a href="source-class-CacheFichier.html#734-744" title="Go to source code">transformaterIdEnNomFichier</a>( <span>string <var>$id</var></span> )</code>
1296
 
1297
		<div class="description short">
1298
 
1299
<p>Transform a cache id into a file name and return it</p>
1300
 
1301
		</div>
1302
 
1303
		<div class="description detailed hidden">
1304
 
1305
<p>Transform a cache id into a file name and return it</p>
1306
 
1307
 
1308
 
1309
				<h4>Parameters</h4>
1310
				<div class="list"><dl>
1311
					<dt><var>$id</var></dt>
1312
					<dd><code>string</code><br>$id Cache id</dd>
1313
				</dl></div>
1314
 
1315
				<h4>Returns</h4>
1316
				<div class="list">
1317
					<code>string</code><br>File name<br>
1318
				</div>
1319
 
1320
 
1321
 
1322
 
1323
		</div>
1324
		</div></td>
1325
	</tr>
1326
	<tr data-order="getFichierNom" id="_getFichierNom">
1327
 
1328
		<td class="attributes"><code>
1329
			 protected
1330
			string
1331
 
1332
			</code>
1333
		</td>
1334
 
1335
		<td class="name"><div>
1336
		<a class="anchor" href="#_getFichierNom">#</a>
1337
		<code><a href="source-class-CacheFichier.html#746-756" title="Go to source code">getFichierNom</a>( <span>string <var>$id</var></span> )</code>
1338
 
1339
		<div class="description short">
1340
 
1341
<p>Make and return a file name (with path)</p>
1342
 
1343
		</div>
1344
 
1345
		<div class="description detailed hidden">
1346
 
1347
<p>Make and return a file name (with path)</p>
1348
 
1349
 
1350
 
1351
				<h4>Parameters</h4>
1352
				<div class="list"><dl>
1353
					<dt><var>$id</var></dt>
1354
					<dd><code>string</code><br>$id Cache id</dd>
1355
				</dl></div>
1356
 
1357
				<h4>Returns</h4>
1358
				<div class="list">
1359
					<code>string</code><br>File name (with path)<br>
1360
				</div>
1361
 
1362
 
1363
 
1364
 
1365
		</div>
1366
		</div></td>
1367
	</tr>
1368
	<tr data-order="getChemin" id="_getChemin">
1369
 
1370
		<td class="attributes"><code>
1371
			 protected
1372
			string
1373
 
1374
			</code>
1375
		</td>
1376
 
1377
		<td class="name"><div>
1378
		<a class="anchor" href="#_getChemin">#</a>
1379
		<code><a href="source-class-CacheFichier.html#758-777" title="Go to source code">getChemin</a>( <span>string <var>$id</var></span>, <span>boolean <var>$decoupage</var> = <span class="php-keyword1">false</span></span> )</code>
1380
 
1381
		<div class="description short">
1382
 
1383
<p>Return the complete directory path of a filename (including
1384
hashedDirectoryStructure)</p>
1385
 
1386
		</div>
1387
 
1388
		<div class="description detailed hidden">
1389
 
1390
<p>Return the complete directory path of a filename (including
1391
hashedDirectoryStructure)</p>
1392
 
1393
 
1394
 
1395
				<h4>Parameters</h4>
1396
				<div class="list"><dl>
1397
					<dt><var>$id</var></dt>
1398
					<dd><code>string</code><br>$id Cache id</dd>
1399
					<dt><var>$decoupage</var></dt>
1400
					<dd><code>boolean</code><br>$decoupage if true, returns array of directory parts instead of single string</dd>
1401
				</dl></div>
1402
 
1403
				<h4>Returns</h4>
1404
				<div class="list">
1405
					<code>string</code><br>Complete directory path<br>
1406
				</div>
1407
 
1408
 
1409
 
1410
 
1411
		</div>
1412
		</div></td>
1413
	</tr>
1414
	<tr data-order="lancerMkdirEtChmodRecursif" id="_lancerMkdirEtChmodRecursif">
1415
 
1416
		<td class="attributes"><code>
1417
			 protected
1418
			boolean
1419
 
1420
			</code>
1421
		</td>
1422
 
1423
		<td class="name"><div>
1424
		<a class="anchor" href="#_lancerMkdirEtChmodRecursif">#</a>
1425
		<code><a href="source-class-CacheFichier.html#779-797" title="Go to source code">lancerMkdirEtChmodRecursif</a>( <span>string <var>$id</var></span> )</code>
1426
 
1427
		<div class="description short">
1428
 
1429
<p>Make the directory strucuture for the given id</p>
1430
 
1431
		</div>
1432
 
1433
		<div class="description detailed hidden">
1434
 
1435
<p>Make the directory strucuture for the given id</p>
1436
 
1437
 
1438
 
1439
				<h4>Parameters</h4>
1440
				<div class="list"><dl>
1441
					<dt><var>$id</var></dt>
1442
					<dd><code>string</code><br>$id cache id</dd>
1443
				</dl></div>
1444
 
1445
				<h4>Returns</h4>
1446
				<div class="list">
1447
					<code>boolean</code><br>true<br>
1448
				</div>
1449
 
1450
 
1451
 
1452
 
1453
		</div>
1454
		</div></td>
1455
	</tr>
1456
	<tr data-order="testerExistenceCache" id="_testerExistenceCache">
1457
 
1458
		<td class="attributes"><code>
1459
			 protected
1460
			boolean|mixed
1461
 
1462
			</code>
1463
		</td>
1464
 
1465
		<td class="name"><div>
1466
		<a class="anchor" href="#_testerExistenceCache">#</a>
1467
		<code><a href="source-class-CacheFichier.html#799-814" title="Go to source code">testerExistenceCache</a>( <span>string <var>$id</var></span>, <span>boolean <var>$ne_pas_tester_validiter_du_cache</var></span> )</code>
1468
 
1469
		<div class="description short">
1470
 
1471
<p>Test if the given cache id is available (and still valid as a cache
1472
record)</p>
1473
 
1474
		</div>
1475
 
1476
		<div class="description detailed hidden">
1477
 
1478
<p>Test if the given cache id is available (and still valid as a cache
1479
record)</p>
1480
 
1481
 
1482
 
1483
				<h4>Parameters</h4>
1484
				<div class="list"><dl>
1485
					<dt><var>$id</var></dt>
1486
					<dd><code>string</code><br>$id Cache id</dd>
1487
					<dt><var>$ne_pas_tester_validiter_du_cache</var></dt>
1488
					<dd><code>boolean</code><br>$doNotTestCacheValidity If set to true, the cache validity won't be tested</dd>
1489
				</dl></div>
1490
 
1491
				<h4>Returns</h4>
1492
				<div class="list">
1493
					<code>boolean|mixed</code><br>false (a cache is not available) or "last modified" timestamp (int) of the
1494
available cache record<br>
1495
				</div>
1496
 
1497
 
1498
 
1499
 
1500
		</div>
1501
		</div></td>
1502
	</tr>
1503
	<tr data-order="getContenuFichier" id="_getContenuFichier">
1504
 
1505
		<td class="attributes"><code>
1506
			 protected
1507
			string
1508
 
1509
			</code>
1510
		</td>
1511
 
1512
		<td class="name"><div>
1513
		<a class="anchor" href="#_getContenuFichier">#</a>
1514
		<code><a href="source-class-CacheFichier.html#816-834" title="Go to source code">getContenuFichier</a>( <span>string <var>$fichier</var></span> )</code>
1515
 
1516
		<div class="description short">
1517
 
1518
<p>Return the file content of the given file</p>
1519
 
1520
		</div>
1521
 
1522
		<div class="description detailed hidden">
1523
 
1524
<p>Return the file content of the given file</p>
1525
 
1526
 
1527
 
1528
				<h4>Parameters</h4>
1529
				<div class="list"><dl>
1530
					<dt><var>$fichier</var></dt>
1531
					<dd><code>string</code><br>$file File complete path</dd>
1532
				</dl></div>
1533
 
1534
				<h4>Returns</h4>
1535
				<div class="list">
1536
					<code>string</code><br>File content (or false if problem)<br>
1537
				</div>
1538
 
1539
 
1540
 
1541
 
1542
		</div>
1543
		</div></td>
1544
	</tr>
1545
	<tr data-order="setContenuFichier" id="_setContenuFichier">
1546
 
1547
		<td class="attributes"><code>
1548
			 protected
1549
			boolean
1550
 
1551
			</code>
1552
		</td>
1553
 
1554
		<td class="name"><div>
1555
		<a class="anchor" href="#_setContenuFichier">#</a>
1556
		<code><a href="source-class-CacheFichier.html#836-858" title="Go to source code">setContenuFichier</a>( <span>string <var>$fichier</var></span>, <span>string <var>$chaine</var></span> )</code>
1557
 
1558
		<div class="description short">
1559
 
1560
<p>Put the given string into the given file</p>
1561
 
1562
		</div>
1563
 
1564
		<div class="description detailed hidden">
1565
 
1566
<p>Put the given string into the given file</p>
1567
 
1568
 
1569
 
1570
				<h4>Parameters</h4>
1571
				<div class="list"><dl>
1572
					<dt><var>$fichier</var></dt>
1573
					<dd><code>string</code><br>$file File complete path</dd>
1574
					<dt><var>$chaine</var></dt>
1575
					<dd><code>string</code><br>$string String to put in file</dd>
1576
				</dl></div>
1577
 
1578
				<h4>Returns</h4>
1579
				<div class="list">
1580
					<code>boolean</code><br>true if no problem<br>
1581
				</div>
1582
 
1583
 
1584
 
1585
 
1586
		</div>
1587
		</div></td>
1588
	</tr>
1589
	<tr data-order="transformerNomFichierEnId" id="_transformerNomFichierEnId">
1590
 
1591
		<td class="attributes"><code>
1592
			 protected
1593
			string
1594
 
1595
			</code>
1596
		</td>
1597
 
1598
		<td class="name"><div>
1599
		<a class="anchor" href="#_transformerNomFichierEnId">#</a>
1600
		<code><a href="source-class-CacheFichier.html#860-869" title="Go to source code">transformerNomFichierEnId</a>( <span>string <var>$nom_de_fichier</var></span> )</code>
1601
 
1602
		<div class="description short">
1603
 
1604
<p>Transform a file name into cache id and return it</p>
1605
 
1606
		</div>
1607
 
1608
		<div class="description detailed hidden">
1609
 
1610
<p>Transform a file name into cache id and return it</p>
1611
 
1612
 
1613
 
1614
				<h4>Parameters</h4>
1615
				<div class="list"><dl>
1616
					<dt><var>$nom_de_fichier</var></dt>
1617
					<dd><code>string</code><br>$fileName File name</dd>
1618
				</dl></div>
1619
 
1620
				<h4>Returns</h4>
1621
				<div class="list">
1622
					<code>string</code><br>Cache id<br>
1623
				</div>
1624
 
1625
 
1626
 
1627
 
1628
		</div>
1629
		</div></td>
1630
	</tr>
1631
	</table>
1632
 
1633
 
1634
 
1635
 
1636
 
1637
 
1638
 
1639
 
1640
 
1641
 
1642
 
1643
 
1644
	<table class="summary" id="properties">
1645
	<caption>Properties summary</caption>
1646
	<tr data-order="options" id="$options">
1647
		<td class="attributes"><code>
1648
			protected
1649
			array
1650
		</code></td>
1651
 
1652
		<td class="name">
1653
				<a href="source-class-CacheFichier.html#3-62" title="Go to source code"><var>$options</var></a>
1654
		</td>
1655
		<td class="value"><code><span class="php-keyword1">array</span>(
1656
	<span class="php-quote">'stockage_chemin'</span> =&gt; <span class="php-keyword1">null</span>,
1657
	<span class="php-quote">'fichier_verrou'</span> =&gt; <span class="php-keyword1">true</span>,
1658
	<span class="php-quote">'controle_lecture'</span> =&gt; <span class="php-keyword1">true</span>,
1659
	<span class="php-quote">'controle_lecture_type'</span> =&gt; <span class="php-quote">'crc32'</span>,
1660
	<span class="php-quote">'dossier_niveau'</span> =&gt; <span class="php-num">0</span>,
1661
	<span class="php-quote">'dossier_umask'</span> =&gt; <span class="php-num">0700</span>,
1662
	<span class="php-quote">'fichier_prefixe'</span> =&gt; <span class="php-quote">'tbf'</span>,
1663
	<span class="php-quote">'fichier_umask'</span> =&gt; <span class="php-num">0600</span>,
1664
	<span class="php-quote">'metadonnees_max_taille'</span> =&gt; <span class="php-num">100</span>
1665
)</code></td>
1666
		<td class="description"><div>
1667
			<a href="#$options" class="anchor">#</a>
1668
 
1669
			<div class="description short">
1670
 
1671
<p>Options disponibles</p>
1672
 
1673
			</div>
1674
 
1675
			<div class="description detailed hidden">
1676
 
1677
<p>Options disponibles</p>
1678
 
1679
<h2>&gt; (string) stockage_chemin :</h2>
1680
 
1681
<p>Chemin vers le dossier devant contenir l'arborescence du cache.</p>
1682
 
1683
<h1>&gt; (boolean) fichier_verrou :</h1>
1684
 
1685
<ul>
1686
	<li>Active / Désactive le verrouillage des fichiers</li>
1687
 
1688
	<li>Peut éviter la corruption du cache dans de mauvaises circonstances, mais
1689
	cela ne fonctionne pas sur des serveur</li>
1690
</ul>
1691
 
1692
<p>multithread et sur les systèmes de fichiers NFS par exemple.</p>
1693
 
1694
<h1>&gt; (boolean) controle_lecture :</h1>
1695
 
1696
<ul>
1697
	<li>Activer / désactiver le contrôle de lecture</li>
1698
 
1699
	<li>S'il est activé, une clé de contrôle est ajoutée dans le fichier de
1700
	cache et cette clé est comparée avec celle calculée</li>
1701
</ul>
1702
 
1703
<p>après la lecture.</p>
1704
 
1705
<h1>&gt; (string) controle_lecture_type :</h1>
1706
 
1707
<p>Type de contrôle de lecture (seulement si le contrôle de lecture est
1708
activé). Les valeurs disponibles sont:</p>
1709
 
1710
<ul>
1711
	<li>«md5» pour un contrôle md5 (le meilleur mais le plus lent)</li>
1712
 
1713
	<li>«crc32» pour un contrôle de hachage crc32 (un peu moins sécurisé, mais
1714
	plus rapide, un meilleur choix)</li>
1715
 
1716
	<li>«adler32» pour un contrôle de hachage adler32 (excellent choix aussi,
1717
	plus rapide que crc32)</li>
1718
 
1719
	<li>«strlen» pour un test de longueur uniquement (le plus rapide)</li>
1720
</ul>
1721
 
1722
<h1>&gt; (int) dossier_niveau :</h1>
1723
 
1724
<ul>
1725
	<li>Permet de réglez le nombre de niveau de sous-dossier que contiendra
1726
	l'arborescence des dossiers du cache.</li>
1727
</ul>
1728
 
1729
<p>0 signifie "pas de sous-dossier pour le cache", 1 signifie "un niveau de
1730
sous-dossier", 2 signifie "deux niveaux" ... Cette option peut accélérer le
1731
cache seulement lorsque vous avez plusieurs centaines de fichiers de cache.
1732
Seuls des tests spécifiques peuvent vous aider à choisir la meilleure valeur
1733
possible pour vous. 1 ou 2 peut être est un bon début.</p>
1734
 
1735
<h1>&gt; (int) dossier_umask :</h1>
1736
 
1737
<ul>
1738
	<li>Umask pour les sous-dossiers de l'arborescence du cache.</li>
1739
</ul>
1740
 
1741
<h1>&gt; (string) fichier_prefixe :</h1>
1742
 
1743
<ul>
1744
	<li>préfixe pour les fichiers du cache</li>
1745
 
1746
	<li>ATTENTION : faite vraiment attention avec cette option, car une valeur trop
1747
	générique dans le dossier cache du système</li>
1748
</ul>
1749
 
1750
<p>(comme /tmp) peut provoquer des catastrophes lors du nettoyage du cache.</p>
1751
 
1752
<h1>&gt; (int) fichier_umask :</h1>
1753
 
1754
<ul>
1755
	<li>Umask pour les fichiers de cache</li>
1756
</ul>
1757
 
1758
<h1>&gt; (int) metadonnees_max_taille :</h1>
1759
 
1760
<ul>
1761
	<li>taille maximum pour le tableau de métadonnées du cache (ne changer pas
1762
	cette valeur sauf si vous savez ce que vous faite)</li>
1763
</ul>
1764
 
1765
 
1766
			</div>
1767
		</div></td>
1768
	</tr>
1769
	<tr data-order="metadonnees" id="$metadonnees">
1770
		<td class="attributes"><code>
1771
			protected
1772
			array
1773
		</code></td>
1774
 
1775
		<td class="name">
1776
				<a href="source-class-CacheFichier.html#64-69" title="Go to source code"><var>$metadonnees</var></a>
1777
		</td>
1778
		<td class="value"><code><span class="php-keyword1">array</span>()</code></td>
1779
		<td class="description"><div>
1780
			<a href="#$metadonnees" class="anchor">#</a>
1781
 
1782
			<div class="description short">
1783
 
1784
<p>Array of metadatas (each item is an associative array)</p>
1785
 
1786
			</div>
1787
 
1788
			<div class="description detailed hidden">
1789
 
1790
<p>Array of metadatas (each item is an associative array)</p>
1791
 
1792
 
1793
			</div>
1794
		</div></td>
1795
	</tr>
1796
	</table>
1797
 
1798
 
1799
 
1800
 
1801
 
1802
 
1803
</div>
1804
 
1805
	<div id="footer">
465 jpm 1806
		 API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
464 jpm 1807
	</div>
1808
</div>
1809
</div>
1810
</body>
1811
</html>