| blob | 97693ff1c51edf8c97f7e4a7a6fd55efd44b3b56 |
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!-- EN-Revision: 21815 -->
3 <!-- Reviewed: no -->
4 <sect1 id="zend.file.transfer.validators">
5 <title>Prüfungen für Zend_File_Transfer</title>
7 <para>
8 <classname>Zend_File_Transfer</classname> wird mit verschiedenen Datei-relevanten Prüfungen
9 ausgeliefert welche verwendet werden können um die Sicherheit zu erhöhen und mögliche
10 Attacken zu verhindern. Es ist zu beachten das diese Prüfungen nur so effektiv sind wie Sie
11 effektiv angewendet verwendet. Alle Prüfungen die mit
12 <classname>Zend_File_Transfer</classname> angeboten werden können in der
13 <classname>Zend_Validator</classname> Komponente gefunden werden und heißen
14 <classname>Zend_Validate_File_*</classname>. Die folgenden Prüfungen sind vorhanden:
15 </para>
17 <itemizedlist>
18 <listitem>
19 <para>
20 <classname>Count</classname>: Diese Prüfung checkt die Anzahl der Dateien. Es kann
21 ein Minimum und ein Maximum spezifiziert werden. Ein Fehler wird geworfen wenn einer
22 der zwei Werte überschritten wird.
23 </para>
24 </listitem>
26 <listitem>
27 <para>
28 <classname>Crc32</classname>: Diese Prüfung checkt den Crc32 Hashwert vom Inhalt
29 einer Datei. Sie basiert auf der <classname>Hash</classname> Prüfung und bietet eine
30 bequeme und einfache Prüfung die nur Crc32 unterstützt.
31 </para>
32 </listitem>
34 <listitem>
35 <para>
36 <classname>ExcludeExtension</classname>: Diese Prüfung checkt die Dateierweiterung.
37 Sie wirft einen Fehler wenn die angegebene Datei eine definierte Erweiterung hat.
38 Mit dieser Prüfung können definierte Erweiterungen von der Prüfung ausgenommen
39 werden.
40 </para>
41 </listitem>
43 <listitem>
44 <para>
45 <classname>ExcludeMimeType</classname>: Diese Prüfung prüft den
46 <acronym>MIME</acronym> Typ von Dateien. Sie kann auch Arten von
47 <acronym>MIME</acronym> Typen prüfen und wirft einen Fehler wenn der
48 <acronym>MIME</acronym> Typ einer spezifizierten Datei passt.
49 </para>
50 </listitem>
52 <listitem>
53 <para>
54 <classname>Exists</classname>: Diese Prüfung checkt ob Dateien existieren. Sie wirft
55 einen Fehler wenn eine spezifizierte Datei nicht existiert.
56 </para>
57 </listitem>
59 <listitem>
60 <para>
61 <classname>Extension</classname>: Diese Prüfung checkt die Dateierweiterung. Sie
62 wirft einen Fehler wenn eine spezifizierte Datei eine undefinierte Erweiterung hat.
63 </para>
64 </listitem>
66 <listitem>
67 <para>
68 <classname>FilesSize</classname>: Diese Prüfung checkt die Größe von geprüften
69 Dateien. Sie merkt sich intern die Größe aller geprüften Dateien und wirft einen
70 Fehler wenn die Summe aller spezifizierten Dateien die definierte Größe
71 überschreitet. Sie bietet auch Mindest- und Maximalwerte an.
72 </para>
73 </listitem>
75 <listitem>
76 <para>
77 <classname>ImageSize</classname>: Diese Prüfung checkt die Größe von Bildern. Sie
78 prüft die Breite und Höhe und erzwingt sowohl eine Mindest- als auch eine
79 Maximalgröße.
80 </para>
81 </listitem>
83 <listitem>
84 <para>
85 <classname>IsCompressed</classname>: Diese Prüfung checkt ob die Datei komprimiert
86 ist. Sie basiert auf der <classname>MimeType</classname> Prüfung und validiert
87 Komprimierungsarchiven wie Zip oder Arc. Sie kann auch auf andere Archive begrenzt
88 werden.
89 </para>
90 </listitem>
92 <listitem>
93 <para>
94 <classname>IsImage</classname>: Diese Prüfung checkt ob die Datei ein Bild ist. Sie
95 basiert auf der <classname>MimeType</classname> Prüfung und validiert Bilddateien
96 wie Jpg oder Gif. Sie kann auch auf andere Bildtypen begrenzt werden.
97 </para>
98 </listitem>
100 <listitem>
101 <para>
102 <classname>Hash</classname>: Diese Prüfung check den Hashwert des Inhalts einer
103 Datei. Sie unterstützt mehrere Algorithmen.
104 </para>
105 </listitem>
107 <listitem>
108 <para>
109 <classname>Md5</classname>: Diese Prüfung checkt den Md5 Hashwert vom Inhalt einer
110 Datei. Sie basiert auf der <code>Hash</code> Prüfung und bietet eine bequeme und
111 einfache Prüfung die nur Md5 unterstützt.
112 </para>
113 </listitem>
115 <listitem>
116 <para>
117 <classname>MimeType</classname>: Diese Prüfung prüft den <acronym>MIME</acronym> Typ
118 von Dateien. Sie kann auch Arten von <acronym>MIME</acronym> Typen prüfen und wirft
119 einen Fehler wenn der <acronym>MIME</acronym> Typ einer spezifizierten Datei nicht
120 passt.
121 </para>
122 </listitem>
124 <listitem>
125 <para>
126 <classname>NotExists</classname>: Diese Prüfung checkt ob Dateien existieren. Sie
127 wirft einen Fehler wenn eine angegebene Datei existiert.
128 </para>
129 </listitem>
131 <listitem>
132 <para>
133 <classname>Sha1</classname>: Diese Prüfung checkt den Sha1 Hashwert vom Inhalt einer
134 Datei. Sie basiert auf der <classname>Hash</classname> Prüfung und bietet eine
135 bequeme und einfache Prüfung die nur Sha1 unterstützt.
136 </para>
137 </listitem>
139 <listitem>
140 <para>
141 <classname>Size</classname>: Diese Prüfung ist fähig Dateien auf Ihre Dateigröße zu
142 prüfen. Sie bietet eine Mindest- und eine Maximalgröße an und wirft einen Fehler
143 wenn eine der beiden Grenzen überschritten wird.
144 </para>
145 </listitem>
147 <listitem>
148 <para>
149 <classname>Upload</classname>: Diese Prüfung ist eine interne. Sie prüft ob ein
150 Upload zu einem Fehler geführt hat. Dieser darf nicht gesetzt werden, da er
151 automatisch durch <classname>Zend_File_Transfer</classname> selbst gesetzt wird.
152 Deshalb darf diese Prüfung nicht direkt verwendet werden. Man sollte nur wissen das
153 Sie existiert.
154 </para>
155 </listitem>
157 <listitem>
158 <para>
159 <classname>WordCount</classname>: Diese Prüfung ist fähig die Anzahl von Wörtern in
160 Dateien zu prüfen. Sie bietet eine Mindest- und Maximalanzahl und wirft einen Fehler
161 wenn eine der Grenzen überschritten wird.
162 </para>
163 </listitem>
164 </itemizedlist>
166 <sect2 id="zend.file.transfer.validators.usage">
167 <title>Prüfungen mit Zend_File_Transfer verwenden</title>
169 <para>
170 Prüfungen einzubinden ist sehr einfach. Es gibt verschiedene Methoden für das
171 Hinzufügen und Manipulieren von Prüfungen:
172 </para>
174 <itemizedlist>
175 <listitem>
176 <para>
177 <methodname>isValid($files = null)</methodname>: Prüft die spezifizierten
178 Dateien indem alle Prüfungen verwendet werden. <varname>$files</varname> kann
179 entweder ein richtiger Dateiname, der Name des Elements, oder der Name der
180 temporären Datei sein.
181 </para>
182 </listitem>
184 <listitem>
185 <para>
186 <methodname>addValidator($validator, $breakChainOnFailure, $options = null,
187 $files = null)</methodname>: Fügt die spezifizierte Prüfung zu den
188 Prüfungsstapel hinzu (optional nur zu den Datei(en) die spezifiziert wurden).
189 <varname>$validator</varname> kann entweder eine aktuelle Prüfinstanz sein oder
190 ein Kurzname der den Prüfungstyp spezifiziert (z.B. 'Count').
191 </para>
192 </listitem>
194 <listitem>
195 <para>
196 <methodname>addValidators(array $validators, $files = null)</methodname>: Fügt
197 die spezifizierten Prüfungen zum Prüfungsstapel hinzu. Jeder Eintrag kann
198 entweder ein Prüfungstyp/-options Paar sein oder ein Array mit dem Schlüssel
199 'validator' das die Prüfung spezifiziert. Alle anderen Optionen werden als
200 Optionen für die Instanzierung der Prüfung angenommen.
201 </para>
202 </listitem>
204 <listitem>
205 <para>
206 <methodname>setValidators(array $validators, $files = null)</methodname>:
207 Überschreibt alle bestehenden Prüfungen mit den spezifizierten Prüfungen. Die
208 Prüfungen sollten der Syntax folgen die für
209 <methodname>addValidators()</methodname> definiert ist.
210 </para>
211 </listitem>
213 <listitem>
214 <para>
215 <methodname>hasValidator($name)</methodname>: Zeigt ob eine Prüfung registriert
216 wurde.
217 </para>
218 </listitem>
220 <listitem>
221 <para>
222 <methodname>getValidator($name)</methodname>: Gibt eine vorher registrierte
223 Prüfung zurück.
224 </para>
225 </listitem>
227 <listitem>
228 <para>
229 <methodname>getValidators($files = null)</methodname>: Gibt registrierte
230 Prüfungen zurück. Wenn <varname>$files</varname> spezifiziert wurde, werden die
231 Prüfungen für die betreffende Datei oder das Set an Dateien zurückgegeben.
232 </para>
233 </listitem>
235 <listitem>
236 <para>
237 <methodname>removeValidator($name)</methodname>: Entfernt eine vorher
238 registrierte Prüfung.
239 </para>
240 </listitem>
242 <listitem>
243 <para>
244 <methodname>clearValidators()</methodname>: Löscht alle registrierten
245 Prüfungen.
246 </para>
247 </listitem>
248 </itemizedlist>
250 <example id="zend.file.transfer.validators.usage.example">
251 <title>Prüfungen zu einem File Transfer Objekt hinzufügen</title>
253 <programlisting language="php"><![CDATA[
254 $upload = new Zend_File_Transfer();
256 // Setzt eine Dateigröße von 20000 Bytes
257 $upload->addValidator('Size', false, 20000);
259 // Setzt eine Dateigröße von mindestens 20 Bytes und maximal 20000 Bytes
260 $upload->addValidator('Size', false, array('min' => 20, 'max' => 20000));
262 // Setzt eine Dateigröße von mindestens 20 Bytes und Maximal
263 // 20000 Bytes und eine Dateianzahl in einem Schritt
264 $upload->setValidators(array(
265 'Size' => array('min' => 20, 'max' => 20000),
266 'Count' => array('min' => 1, 'max' => 3),
267 ));
268 ]]></programlisting>
269 </example>
271 <example id="zend.file.transfer.validators.usage.exampletwo">
272 <title>Prüfungen auf eine einzelne Datei limitieren</title>
274 <para>
275 <methodname>addValidator()</methodname>, <methodname>addValidators()</methodname>,
276 und <methodname>setValidators()</methodname> akzeptieren ein endendes Argument
277 <varname>$files</varname>. Dieses Argument kann verwendet werden um eine Datei oder
278 ein Array von Dateien zu spezifizieren auf dem die angegebene Prüfung gesetzt werden
279 soll.
280 </para>
282 <programlisting language="php"><![CDATA[
283 $upload = new Zend_File_Transfer();
285 // Setzt die Dateigröße auf 20000 Bytes und limitiert Sie nur auf 'file2'
286 $upload->addValidator('Size', false, 20000, 'file2');
287 ]]></programlisting>
288 </example>
290 <para>
291 Normal sollte die <methodname>addValidators()</methodname> Methode verwendet werden,
292 welche mehrmals aufgerufen werden kann.
293 </para>
295 <example id="zend.file.transfer.validators.usage.examplemultiple">
296 <title>Mehrere Prüfungen hinzufügen</title>
298 <para>
299 Oft ist es einfacher <methodname>addValidator()</methodname> mehrere Male
300 aufzurufen mit einem Aufruf für jede Prüfung. Das erhöht auch die Lesbarkeit und
301 macht den Code wartbarer. Alle Methoden implementieren das Fluent-Interface,
302 deshalb können Aufrufe einfach wie anbei gezeigt gekoppelt werden:
303 </para>
305 <programlisting language="php"><![CDATA[
306 $upload = new Zend_File_Transfer();
308 // Setzt die Dateigröße auf 20000 Bytes
309 $upload->addValidator('Size', false, 20000)
310 ->addValidator('Count', false, 2)
311 ->addValidator('Filessize', false, 25000);
312 ]]></programlisting>
313 </example>
315 <note>
316 <para>
317 Es ist zu beachten, dass das mehrfache Setzen der gleichen Prüfung erlaubt
318 ist, dass das aber zu Problemen führen kann wenn verschiedene Optionen für die
319 gleiche Prüfung verwendet werden.
320 </para>
321 </note>
323 <para>
324 Letztendlich können Dateien einfach geprüft werden indem
325 <methodname>isValid()</methodname> verwendet wird.
326 </para>
328 <example id="zend.file.transfer.validators.usage.exampleisvalid">
329 <title>Prüfen der Dateien</title>
331 <para>
332 <methodname>isValid()</methodname> akzeptiert den Dateinamen der hochgeladenen oder
333 heruntergeladenen Datei, den temporären Dateinamen oder den Namen des
334 Formularelements. Wenn kein Parameter oder null angegeben wird, werden alle
335 gefundenen Dateien geprüft.
336 </para>
338 <programlisting language="php"><![CDATA[
339 $upload = new Zend_File_Transfer();
341 // Setzt die Dateigröße auf 20000 Bytes
342 $upload->addValidator('Size', false, 20000)
343 ->addValidator('Count', false, 2)
344 ->addValidator('Filessize', false, 25000);
346 if ($upload->isValid()) {
347 print "Prüfung fehlgeschlagen";
348 }
349 ]]></programlisting>
350 </example>
352 <note>
353 <para>
354 Es ist zu beachten das <methodname>isValid()</methodname> automatisch aufgerufen
355 wird, wenn die Dateien empfangen werden und es zuvor noch nicht aufgerufen wurde.
356 </para>
357 </note>
359 <para>
360 Wenn Prüfungen fehlgeschlagen sind, ist es eine gute Idee Informationen über die
361 gefundenen Probleme zu erhalten. Um diese Information zu erhalten können die Methoden
362 <methodname>getMessages()</methodname>, welche alle Prüfmeldungen als Array zurückgibt,
363 <methodname>getErrors()</methodname> welche alle Fehlercodes zurückgibt, und
364 <methodname>hasErrors()</methodname> welche <constant>TRUE</constant> zurückgibt sobald
365 ein Prüffehler gefunden wurde, verwendet werden.
366 </para>
367 </sect2>
369 <sect2 id="zend.file.transfer.validators.count">
370 <title>Count Prüfung</title>
372 <para>
373 Die <classname>Count</classname> Prüfung checkt die Anzahl der Dateien die angegeben
374 wurde. Sie unterstützt die folgenden Schlüssel für Optionen:
375 </para>
377 <itemizedlist>
378 <listitem>
379 <para>
380 <property>min</property>: Setzt die minimale Anzahl der Dateien die übertragen
381 wird.
382 </para>
384 <note>
385 <para>
386 Wenn diese Option verwendet wird, muß die minimale Anzahl an Dateien
387 übergeben werden wenn die Prüfung das erste Mal aufgerufen wird; sonst wird
388 ein Fehler zurückgegeben.
389 </para>
390 </note>
392 <para>
393 Mit dieser Option kann die Mindestanzahl an Dateien definiert werden die man
394 Empfangen sollte.
395 </para>
396 </listitem>
398 <listitem>
399 <para>
400 <property>max</property>: Setzt die maximale Anzahl an Dateien die übertragen
401 wird.
402 </para>
404 <para>
405 Mit dieser Option kann die Anzahl der Dateien limitiert werden die man
406 akzeptiert, aber genauso eine mögliche Attacke erkennen wenn mehr Dateien
407 übertragen werden als im Formular definiert wurden.
408 </para>
409 </listitem>
410 </itemizedlist>
412 <para>
413 Wenn diese Prüfung mit einem String oder Integer initiiert wird, wird Sie als
414 <property>max</property> verwendet. Es können aber auch die Methoden
415 <methodname>setMin()</methodname> und <methodname>setMax()</methodname> verwendet
416 werden um beide Optionen im Nachhinein zu setzen und <methodname>getMin()</methodname>
417 und <methodname>getMax()</methodname> um die aktuell gesetzten Werte zu erhalten.
418 </para>
420 <example id="zend.file.transfer.validators.count.example">
421 <title>Die Count Prüfung verwenden</title>
423 <programlisting language="php"><![CDATA[
424 $upload = new Zend_File_Transfer();
426 // Die Anzahl der Dateien auf maximal 2 limitieren
427 $upload->addValidator('Count', false, 2);
429 // Die Anzahl der Dateien auf maximal 5 und mindestens 1 Datei limitieren
430 $upload->addValidator('Count', false, array('min' =>1, 'max' => 5));
431 ]]></programlisting>
432 </example>
434 <note>
435 <para>
436 Beachte das diese Prüfung die Anzahl der geprüften Dateien intern speichert. Die
437 Datei welche das Maximum überschrietet wird als Fehler zurückgegeben.
438 </para>
439 </note>
440 </sect2>
442 <sect2 id="zend.file.transfer.validators.crc32">
443 <title>Crc32 Prüfung</title>
445 <para>
446 Die <classname>Crc32</classname> Prüfung checkt den Inhalt einer übertragenen Datei
447 durch hashen. Diese Prüfung verwendet die Hash Erweiterung von <acronym>PHP</acronym>
448 mit dem Crc32 Algorithmus. Sie unterstützt die folgenden Optionen:
449 </para>
451 <itemizedlist>
452 <listitem>
453 <para>
454 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
455 Array. Dieser Wert wird als Hash verwendet gegen den geprüft wird.
456 </para>
458 <para>
459 Man kann mehrere Hashes setzen indem unterschiedliche Schlüssel angegeben
460 werden. Jeder von Ihnen wird geprüft und die Prüfung schlägt nur fehl wenn alle
461 Werte fehlschlagen.
462 </para>
463 </listitem>
464 </itemizedlist>
466 <example id="zend.file.transfer.validators.crc32.example">
467 <title>Verwenden der Crc32 Prüfung</title>
469 <programlisting language="php"><![CDATA[
470 $upload = new Zend_File_Transfer();
472 // Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
473 $upload->addValidator('Hash', false, '3b3652f');
475 // Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
476 $upload->addValidator('Crc32', false, array('3b3652f', 'e612b69'));
477 ]]></programlisting>
478 </example>
479 </sect2>
481 <sect2 id="zend.file.transfer.validators.excludeextension">
482 <title>ExcludeExtension Prüfung</title>
484 <para>
485 Die <classname>ExcludeExtension</classname> Prüfung checkt die Dateierweiterung der
486 angegebenen Dateien. Sie unterstützt die folgenden Optionen:
487 </para>
489 <itemizedlist>
490 <listitem>
491 <para>
492 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
493 Array. Dieser Wert wird verwendet um zu prüfen ob die angegebene Datei diese
494 Dateierweiterung nicht verwendet.
495 </para>
496 </listitem>
498 <listitem>
499 <para>
500 <property>case</property>: Setzt ein Boolean der anzeigt ob die Prüfung auf die
501 Klein/Großschreibung achten soll. Standardmäßig ist die Klein/Großschreibung
502 egal. Beachte das dieser Schlüssel für alle vorhandenen Erweiterungen angewendet
503 werden kann.
504 </para>
505 </listitem>
506 </itemizedlist>
508 <para>
509 Dieser Prüfer akzeptiert mehrere Erweiterungen entweder als komma-getrennten String,
510 oder als ein Array. Man kann auch die <methodname>setExtension()</methodname>,
511 <methodname>addExtension()</methodname> und <methodname>getExtension()</methodname>
512 Methoden verwenden um Erweiterungen zu setzen und zu erhalten.
513 </para>
515 <para>
516 In einigen Fällen ist es nützlich auch auf Klein/Großschreibung zu testen. Deshalb
517 erlaubt der Constructor einen zweiten Parameter <varname>$case</varname> der, wenn er
518 auf <constant>TRUE</constant> gesetzt wird, die Erweiterungen abhängig von der Klein-
519 oder Großschreibung prüft.
520 </para>
522 <example id="zend.file.transfer.validators.excludeextension.example">
523 <title>Die ExcludeExtension Prüfung verwenden</title>
525 <programlisting language="php"><![CDATA[
526 $upload = new Zend_File_Transfer();
528 // Dateien mit der Erweiterung php oder exe nicht erlauben
529 $upload->addValidator('ExcludeExtension', false, 'php,exe');
531 // Dateien mit der Erweiterung php oder exe nicht erlauben
532 // aber die Array Schreibweise verwenden
533 $upload->addValidator('ExcludeExtension', false, array('php', 'exe'));
535 // Prüft abhängig von der Groß-/Kleinschreibung
536 $upload->addValidator('ExcludeExtension',
537 false,
538 array('php', 'exe', 'case' => true));
539 ]]></programlisting>
540 </example>
542 <note>
543 <para>
544 Es ist zu beachten das diese Prüfung nur die Dateierweiterung prüft. Sie prüft nicht
545 den <acronym>MIME</acronym> Typ der Datei.
546 </para>
547 </note>
548 </sect2>
550 <sect2 id="zend.file.transfer.validators.excludemimetype">
551 <title>ExcludeMimeType Prüfung</title>
553 <para>
554 Die <classname>ExcludeMimeType</classname> Prüfung checkt den <acronym>MIME</acronym>
555 Typ von übertragenen Dateien. Sie unterstützt die folgenden Optionen:
556 </para>
558 <itemizedlist>
559 <listitem>
560 <para>
561 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
562 Array. Setzt den <acronym>MIME</acronym> Typ gegen den geprüft werden soll.
563 </para>
565 <para>
566 Mit dieser Option kann der <acronym>MIME</acronym> Typ von Dateien definiert
567 werden die nicht akzeptiert werden.
568 </para>
569 </listitem>
571 <listitem>
572 <para>
573 <property>headerCheck</property>: Wenn diese Option auf
574 <constant>TRUE</constant> gesetzt wird, dann werden die <acronym>HTTP</acronym>
575 Informationen für den Dateityp geprüft wenn die <emphasis>fileInfo</emphasis>
576 oder <emphasis>mimeMagic</emphasis> Erweiterungen nicht gefunden werden können.
577 Der Standardwert dieser Option ist <constant>FALSE</constant>.
578 </para>
579 </listitem>
580 </itemizedlist>
582 <para>
583 Diese Prüfung akzeptiert viele <acronym>MIME</acronym> Typ entweder als Komma-getrennter
584 String, oder als Array. Man kan auch die Methoden
585 <methodname>setMimeType()</methodname>, <methodname>addMimeType()</methodname>, und
586 <methodname>getMimeType()</methodname> verwenden um <acronym>MIME</acronym> Typen zu
587 setzen und zu erhalten.
588 </para>
590 <example id="zend.file.transfer.validators.excludemimetype.example">
591 <title>Verwendung der ExcludeMimeType Prüfung</title>
593 <programlisting language="php"><![CDATA[
594 $upload = new Zend_File_Transfer();
596 // Verweigert den MIME Typ gif für alle gegebenen Dateien
597 $upload->addValidator('ExcludeMimeType', 'image/gif');
599 // Verweigert den MIME Typ gif und jpeg für alle gegebenen Dateien
600 $upload->setValidator('ExcludeMimeType', array('image/gif',
601 'image/jpeg');
603 // Verweigert die MIME Typ Gruppe image für alle Dateien
604 $upload->setValidator('ExcludeMimeType', 'image');
605 ]]></programlisting>
606 </example>
608 <para>
609 Das obige Beispiel zeigt das es auch möglich ist Gruppen von <acronym>MIME</acronym>
610 Typen zu verweigern. Um, zum Beispiel, alle Bilder zu verweigern, muß nur 'image' als
611 <acronym>MIME</acronym> Typ verwendet werden. Das kann für alle Gruppen von
612 <acronym>MIME</acronym> Typen wie 'image', 'audio', 'video', 'test', und so weiter
613 verwendet werden.
614 </para>
616 <note>
617 <para>
618 Es ist zu beachten das bei Verwendung von <acronym>MIME</acronym> Typ-Gruppen alle
619 Mitglieder dieser Gruppe verweigert werden, selbst wenn das nicht gewünscht ist.
620 Wenn man 'image' verweigert, werden alle Typen von Bildern verweigert wie
621 'image/jpeg' oder 'image/vasa'. Wenn man nicht sicher ist ob man alle Typen
622 verweigern will sollte man nur definierte <acronym>MIME</acronym> Typen zu
623 verweigern statt der kompletten Gruppe.
624 </para>
625 </note>
626 </sect2>
628 <sect2 id="zend.file.transfer.validators.exists">
629 <title>Exists Prüfung</title>
631 <para>
632 Die <classname>Exists</classname> Prüfung checkt ob Dateien die spezifiziert werden
633 existieren. Sie unterstützt die folgenden Optionen:
634 </para>
636 <itemizedlist>
637 <listitem>
638 <para>
639 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
640 Array um zu prüfen ob die spezifizierte Datei im gegebenen Verzeichnis
641 existiert.
642 </para>
643 </listitem>
644 </itemizedlist>
646 <para>
647 Diese Prüfung akzeptiert mehrere Verzeichnisse, entweder als Komma-getrennter String,
648 oder als Array. Es können aber auch die Methoden
649 <methodname>setDirectory()</methodname>, <methodname>addDirectory()</methodname>, und
650 <methodname>getDirectory()</methodname> verwendet werden um die Verzeichnisse zu setzen
651 und zu erhalten.
652 </para>
654 <example id="zend.file.transfer.validators.exists.example">
655 <title>Die Exists Prüfung verwenden</title>
657 <programlisting language="php"><![CDATA[
658 $upload = new Zend_File_Transfer();
660 // Das temporäre Verzeichnis für die Prüfung hinzufügen
661 $upload->addValidator('Exists', false, '\temp');
663 // Zwei Verzeichnisse hinzufügen indem die Array Schreibweise verwendet wird
664 $upload->addValidator('Exists',
665 false,
666 array('\home\images', '\home\uploads'));
667 ]]></programlisting>
668 </example>
670 <note>
671 <para>
672 Beachte das diese Prüfung checkt ob die spezifizierte Datei in allen angegebenen
673 Verzeichnissen existiert. Die Prüfung schlägt fehl, wenn die Datei in irgendeinem
674 der angegebenen Verzeichnisse nicht existiert.
675 </para>
676 </note>
677 </sect2>
679 <sect2 id="zend.file.transfer.validators.extension">
680 <title>Extension Prüfung</title>
682 <para>
683 Die <classname>Extension</classname> Prüfung checkt die Dateierweiterung der angegebenen
684 Dateien. Sie unterstützt die folgenden Optionen:
685 </para>
687 <itemizedlist>
688 <listitem>
689 <para>
690 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
691 Array um zu prüfen ob die angegebene Datei diese Dateierweiterung verwendet.
692 </para>
693 </listitem>
695 <listitem>
696 <para>
697 <property>case</property>: Definiert of die Prüfung auf die Klein/Großschreibung
698 achten soll. Standardmäßig ist die Klein/Großschreibung egal. Es ist zu beachten
699 das dieser Schlüssel für alle verwendeten Erweiterungen angegeben wird.
700 </para>
701 </listitem>
702 </itemizedlist>
704 <para>
705 Dieser Prüfer akzeptiert mehrere Erweiterungen entweder als komma-getrennten String,
706 oder als ein Array. Man kann auch die <methodname>setExtension()</methodname>,
707 <methodname>addExtension()</methodname> und <methodname>getExtension()</methodname>
708 Methoden verwenden um Erweiterungs Werte zu setzen und zu erhalten.
709 </para>
711 <para>
712 In einigen Fällen ist es nützlich auch auf Klein/Großschreibung zu testen. Hierfür nimmt
713 der Constructor einen zweiten Parameter <varname>$case</varname> der, wenn er auf
714 <constant>TRUE</constant> gesetzt wird, die Erweiterungen abhängig von der Klein-
715 oder Großschreibung prüft.
716 </para>
718 <example id="zend.file.transfer.validators.extension.example">
719 <title>Verwendung der Extension Prüfung</title>
721 <programlisting language="php"><![CDATA[
722 $upload = new Zend_File_Transfer();
724 // Limitiert die Erweiterungen auf jpg und png Dateien
725 $upload->addValidator('Extension', false, 'jpg,png');
727 // Limitiert die Erweiterungen auf jpg und png Dateien,
728 // verwendet aber die Array Schreibweise
729 $upload->addValidator('Extension', false, array('jpg', 'png'));
731 // Abhängig von der Klein/Großschreibung prüfen
732 $upload->addValidator('Extension', false, array('mo', 'png', 'case' => true));
733 if (!$upload->isValid('C:\temp\myfile.MO')) {
734 print 'Nicht gültig da MO und mo Kleinschreibungsmäßig nicht passen';
735 }
736 ]]></programlisting>
737 </example>
739 <note>
740 <para>
741 Es ist zu beachten das diese Prüfung nur die Dateierweiterung prüft. Sie prüft nicht
742 den <acronym>MIME</acronym> Typ der Datei.
743 </para>
744 </note>
745 </sect2>
747 <sect2 id="zend.file.transfer.validators.filessize">
748 <title>FilesSize Prüfung</title>
750 <para>
751 Die <classname>FilesSize</classname> Prüfung checkt die komplette Größe aller
752 übertragenen Dateien. Sie unterstützt die folgenden Optionen:
753 </para>
755 <itemizedlist>
756 <listitem>
757 <para>
758 <property>min</property>: Setzt die minimale gemeinsame Dateigröße. Diese Option
759 definiert die mindeste gemeinsame Größe die übertragen werden soll.
760 </para>
761 </listitem>
763 <listitem>
764 <para>
765 <property>max</property>: Setzt die maximale gemeinsame Dateigröße.
766 </para>
768 <para>
769 Diese Option begrenzt die gemeinsame Dateigröße aller Dateien die übertragen
770 werden, aber nicht die Dateigröße von einzelnen Dateien.
771 </para>
772 </listitem>
774 <listitem>
775 <para>
776 <property>bytestring</property>: Definiert ob im Fehlerfall eine
777 benutzerfreundliche Nummer, oder die reine Dateigröße zurückgegeben wird.
778 </para>
780 <para>
781 Diese Option definiert ob der Benutzer '10864' oder '10MB' sieht. Der
782 Standardwert ist <constant>TRUE</constant> weshalb '10MB' zurückgegeben wird
783 wenn nicht anders angegeben.
784 </para>
785 </listitem>
786 </itemizedlist>
788 <para>
789 Diese Prüfung kann auch mit einem String initiiert werden, der dann verwendet wird um
790 die <property>max</property> Option zu setzen. Man kann auch die Methoden
791 <methodname>setMin()</methodname> und <methodname>setMax()</methodname> verwenden um
792 beide Optionen nach den Contrucor zu setzen, zusammen mit
793 <methodname>getMin()</methodname> und <methodname>getMax()</methodname> um die Werte zu
794 erhalten die vorher gesetzt wurden.
795 </para>
797 <para>
798 Die Größe selbst wird auch in der SI Schreibweise akzeptiert wie Sie die meisten
799 Betriebsystemen verwenden. Statt <emphasis>20000 bytes</emphasis> kann auch
800 <emphasis>20kB</emphasis> angeben werden. Alle Einheiten werden mit dem Basiswert 1024
801 konvertiert. Die folgenden Einheiten werden akzeptiert: <emphasis>kB</emphasis>,
802 <emphasis>MB</emphasis>, <emphasis>GB</emphasis>, <emphasis>TB</emphasis>,
803 <emphasis>PB</emphasis> und <emphasis>EB</emphasis>. Beachte das 1kB gleich 1024 Bytes
804 ist, 1MB gleich 1024kB, und so weiter.
805 </para>
807 <example id="zend.file.transfer.validators.filessize.example">
808 <title>Verwenden der FilesSize Prüfung</title>
810 <programlisting language="php"><![CDATA[
811 $upload = new Zend_File_Transfer();
813 // Limitiert die Größe aller Dateien die hochgeladen werden auf 40000 Bytes
814 $upload->addValidator('FilesSize', false, 40000);
816 // Limitiert die Größe aller Dateien die hochgeladen
817 // werden auf maximal 4MB und minimal 10kB
818 $upload->addValidator('FilesSize',
819 false,
820 array('min' => '10kB', 'max' => '4MB'));
822 // Wie zuvor, gibt aber die reine Dateigröße
823 // statt einem benutzerfreundlichen String zurück
824 $upload->addValidator('FilesSize',
825 false,
826 array('min' => '10kB',
827 'max' => '4MB',
828 'bytestring' => false));
829 ]]></programlisting>
830 </example>
832 <note>
833 <para>
834 Beachte das diese Prüfung intern die Dateigrößen der geprüften Dateien intern
835 speichert. Die Datei welche die Größe überschreitet wird als Fehler zurückgegeben.
836 </para>
837 </note>
838 </sect2>
840 <sect2 id="zend.file.transfer.validators.imagesize">
841 <title>ImageSize Prüfung</title>
843 <para>
844 Die <classname>ImageSize</classname> Prüfung checkt die Größe von Bildern. Sie
845 unterstützt die folgenden Optionen:
846 </para>
848 <itemizedlist>
849 <listitem>
850 <para><property>minheight</property>: Setzt die mindeste Höhe des Bildes.</para>
851 </listitem>
853 <listitem>
854 <para><property>maxheight</property>: Settzt die maximale Höhe des Bildes.</para>
855 </listitem>
857 <listitem>
858 <para><property>minwidth</property>: Setzt die mindeste Breite des Bildes.</para>
859 </listitem>
861 <listitem>
862 <para><property>maxwidth</property>: Setzt die maximale Breite des Bildes.</para>
863 </listitem>
864 </itemizedlist>
866 <para>
867 Die Methoden <methodname>setImageMin()</methodname> und
868 <methodname>setImageMax()</methodname> setzen auch beide Minimal- und Maximalwerte im
869 Nachhinein, wärend die <methodname>getMin()</methodname> und
870 <methodname>getMax()</methodname> Methoden die aktuell gesetzten Werte zurückgeben.
871 </para>
873 <para>
874 Der Bequemlichkeit halber gibt es auch eine <methodname>setImageWidth()</methodname>
875 und <methodname>setImageHeight()</methodname> Methode welche die Mindest- und
876 Maximalhöhe und -Breite der Bilddatei setzen. Sie haben auch passende
877 <methodname>getImageWidth()</methodname> und <methodname>getImageHeight()</methodname>
878 Methoden um die aktuell gesetzten Werte zu erhalten.
879 </para>
881 <para>
882 Um die Prüfung einer betreffenden Dimension zu gestatten, muß die relevante Option
883 einfach nicht gesetzt werden.
884 </para>
886 <example id="zend.file.transfer.validators.imagesize.example">
887 <title>Verwendung der ImageSize Prüfung</title>
889 <programlisting language="php"><![CDATA[
890 $upload = new Zend_File_Transfer();
892 // Begrenzt die Größe eines Bildes auf eine Höhe von 100-200
893 // und eine Breite von 40-80 Pixel
894 $upload->addValidator('ImageSize', false,
895 array('minwidth' => 40,
896 'maxwidth' => 80,
897 'minheight' => 100,
898 'maxheight' => 200
899 );
901 // Setzt die Breite der Prüfung zurück
902 $upload->setImageWidth(array('minwidth' => 20, 'maxwidth' => 200));
903 ]]></programlisting>
904 </example>
905 </sect2>
907 <sect2 id="zend.file.transfer.validators.iscompressed">
908 <title>IsCompressed Prüfung</title>
910 <para>
911 Die <classname>IsCompressed</classname> Prüfung checkt ob eine übertragene Datei
912 komprimiert ist wie zum Beispiel Zip oder Arc. Diese Prüfung basiert auf der
913 <classname>MimeType</classname> Prüfung und unterstützt die gleichen Methoden und
914 Optionen. Diese Prüfung kann mit den dort beschriebenen Methoden auf gewünschte
915 Komprimierungstypen limitiert werden.
916 </para>
918 <example id="zend.file.transfer.validators.iscompressed.example">
919 <title>Verwenden der IsCompressed Prüfung</title>
921 <programlisting language="php"><![CDATA[
922 $upload = new Zend_File_Transfer();
924 // Checkt ob die hochgeladene Datei komprimiert ist
925 $upload->addValidator('IsCompressed', false);
927 // Limitiert diese Prüfung auf Zip Dateien
928 $upload->addValidator('IsCompressed', false, array('application/zip'));
930 // Limitiert diese Prüfung auf Zip Dateien,
931 // und verwendet eine einfachere Schreibweise
932 $upload->addValidator('IsCompressed', false, 'zip');
933 ]]></programlisting>
934 </example>
936 <note>
937 <para>
938 Es ist zu beachten das nicht geprüft wird ob ein gesetzter <acronym>MIME</acronym>
939 Typ ein Komprimierungstyp ist oder nicht. Man könnte zum Beispiel definieren das Gif
940 Dateien von dieser Prüfung akzeptiert werden. Die Verwendung der 'MimeType' Prüfung
941 für Dateien welche nicht archiviert sind, führt zu besser lesbarem Code.
942 </para>
943 </note>
944 </sect2>
946 <sect2 id="zend.file.transfer.validators.isimage">
947 <title>IsImage Prüfung</title>
949 <para>
950 Die <classname>IsImage</classname> Prüfung checkt ob eine übertragene Datei eine
951 Bilddatei ist, wie zum Beispiel Gif oder Jpeg. Diese Prüfung basiert auf der
952 <classname>MimeType</classname> Prüfung und unterstützt die gleichen Methoden und
953 Optionen. Diese Prüfung kann mit den dort beschriebenen Methoden auf gewünschte
954 Bildarten limitiert werden.
955 </para>
957 <example id="zend.file.transfer.validators.isimage.example">
958 <title>Verwenden der IsImage Prüfung</title>
960 <programlisting language="php"><![CDATA[
961 $upload = new Zend_File_Transfer();
963 // Checkt ob die hochgeladene Datei ein Bild ist
964 $upload->addValidator('IsImage', false);
966 // Limitiert diese Prüfung auf Gif Dateien
967 $upload->addValidator('IsImage', false, array('application/gif'));
969 // Limitiert diese Prüfung auf Jpeg Dateien,
970 // verwendet eine einfachere Schreibweise
971 $upload->addValidator('IsImage', false, 'jpeg');
972 ]]></programlisting>
973 </example>
975 <note>
976 <para>
977 Es ist zu beachten das nicht geprüft wird ob ein gesetzter <acronym>MIME</acronym>
978 Typ kein Bild ist. Es ist zum Beispiel möglich, Zip Dateien von dieser Prüfung
979 akzeptieren zu lassen. Die Verwendung der 'MimeType' Prüfung für Dateien welche
980 keine Bilder sind, führt zu besser lesbarem Code.
981 </para>
982 </note>
983 </sect2>
985 <sect2 id="zend.file.transfer.validators.hash">
986 <title>Hash Prüfung</title>
988 <para>
989 Die <classname>Hash</classname> Prüfung checkt den Inhalt einer übertragenen Datei indem
990 Sie gehasht wird. Diese Prüfung verwendet die Hash Erweiterung von
991 <acronym>PHP</acronym>. Sie unterstützt die folgenden Optionen:
992 </para>
994 <itemizedlist>
995 <listitem>
996 <para>
997 <property>*</property>: Nimmt einen beliebigen Schlüssel oder ein nummerisches
998 Array. Setzt den Hash gegen den geprüft werden soll.
999 </para>
1001 <para>
1002 Man kann mehrere Hashes setzen indem Sie als Array angegeben werden. Jede Datei
1003 wird geprüft, und die Prüfung wird nur fehlschlagen wenn alle Dateien die
1004 Prüfung nicht bestehen.
1005 </para>
1006 </listitem>
1008 <listitem>
1009 <para>
1010 <property>algorithm</property>: Setzt den Algorithmus der für das Hashen des
1011 Inhalts verwendet wird.
1012 </para>
1014 <para>
1015 Man kann mehrere Algorithmen setzen indem die
1016 <methodname>addHash()</methodname> Methode mehrere Male aufgerufen wird.
1017 </para>
1018 </listitem>
1019 </itemizedlist>
1021 <example id="zend.file.transfer.validators.hash.example">
1022 <title>Verwenden der Hash Prüfung</title>
1024 <programlisting language="php"><![CDATA[
1025 $upload = new Zend_File_Transfer();
1027 // Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash enthält
1028 $upload->addValidator('Hash', false, '3b3652f');
1030 // Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
1031 $upload->addValidator('Hash', false, array('3b3652f', 'e612b69'));
1033 // Setzt einen anderen Algorithmus gegen den geprüft wird
1034 $upload->addValidator('Hash',
1035 false,
1036 array('315b3cd8273d44912a7',
1037 'algorithm' => 'md5'));
1038 ]]></programlisting>
1039 </example>
1041 <note>
1042 <para>
1043 Diese Prüfung unterstützt über 34 verschiedene Hash Algorithmen. Die bekanntesten
1044 sind 'crc32', 'md5' und 'sha1'. Eine gesammelte Liste aller unterstützten Hash
1045 Algorithmen kann in PHP's <ulink
1046 url="http://php.net/hash_algos">hash_algos Methode</ulink> auf der
1047 <ulink url="http://php.net">php.net Seite</ulink> gefunden werden.
1048 </para>
1049 </note>
1050 </sect2>
1052 <sect2 id="zend.file.transfer.validators.md5">
1053 <title>Md5 Prüfung</title>
1055 <para>
1056 Die <classname>Md5</classname> Prüfung checkt den Inhalt einer übertragenen Datei durch
1057 hashen. Diese Prüfung verwendet die Hash Erweiterung von <acronym>PHP</acronym> mit dem
1058 Md5 Algorithmus. Sie unterstützt die folgenden Optionen:
1059 </para>
1061 <itemizedlist>
1062 <listitem>
1063 <para>
1064 <property>*</property>: nimmt einen beliebigen Schlüssel oder ein nummerisches
1065 Array.
1066 </para>
1068 <para>
1069 Man kann mehrere Hashes setzen indem Sie als Array übergeben werden. Jede Datei
1070 wird geprüft und die Prüfung schlägt nur dann fehl wenn die Prüfung alle Dateien
1071 fehlschlägt.
1072 </para>
1073 </listitem>
1074 </itemizedlist>
1076 <example id="zend.file.transfer.validators.md5.example">
1077 <title>Verwenden der Md5 Prüfung</title>
1079 <programlisting language="php"><![CDATA[
1080 $upload = new Zend_File_Transfer();
1082 // Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
1083 $upload->addValidator('Md5', false, '3b3652f336522365223');
1085 // Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
1086 $upload->addValidator('Md5',
1087 false,
1088 array('3b3652f336522365223',
1089 'eb3365f3365ddc65365'));
1090 ]]></programlisting>
1091 </example>
1092 </sect2>
1094 <sect2 id="zend.file.transfer.validators.mimetype">
1095 <title>MimeType Prüfung</title>
1097 <para>
1098 Die <classname>MimeType</classname> Prüfung checkt den <acronym>MIME</acronym> Typ von
1099 übertragenen Dateien. Sie unterstützt die folgenden Optionen:
1100 </para>
1102 <itemizedlist>
1103 <listitem>
1104 <para>
1105 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
1106 Array. Setzt die Art des <acronym>MIME</acronym> Typs der geprüft werden soll.
1107 </para>
1109 <para>
1110 Definiert den <acronym>MIME</acronym> Typ von Dateien die akzeptiert werden
1111 soll.
1112 </para>
1113 </listitem>
1115 <listitem>
1116 <para>
1117 <property>headerCheck</property>: Wenn diese Option auf
1118 <constant>TRUE</constant> gesetzt wird, dann werden die <acronym>HTTP</acronym>
1119 Informationen für den Dateityp geprüft wenn die <emphasis>fileInfo</emphasis>
1120 oder <emphasis>mimeMagic</emphasis> Erweiterungen nicht gefunden werden können.
1121 Der Standardwert dieser Option ist <constant>FALSE</constant>.
1122 </para>
1123 </listitem>
1125 <listitem>
1126 <para>
1127 <property>magicfile</property>: Das Magicfile das verwendet werden soll.
1128 </para>
1130 <para>
1131 Mit dieser Option kann definiert werden welches Magicfile zu verwenden ist. Wenn
1132 es nicht gesetzt wird, oder leer ist, wird stattdessen die MAGIC Konstante
1133 verwendet. Diese Option ist seit dem Zend Framework 1.7.1 vorhanden.
1134 </para>
1135 </listitem>
1136 </itemizedlist>
1138 <para>
1139 Diese Prüfung akzeptiert viele <acronym>MIME</acronym> Typen entweder als
1140 Komma-getrennter String, oder als Array. Man kan auch die Methoden
1141 <methodname>setMimeType()</methodname>, <methodname>addMimeType()</methodname>, und
1142 <methodname>getMimeType()</methodname> verwenden um <acronym>MIME</acronym> Typen zu
1143 setzen und zu erhalten.
1144 </para>
1146 <para>
1147 Man kann mit der 'magicfile' Option auch die Magicdatei setzen die von Fileinfo
1148 verwendet werden soll. Zusätzlich gibt es die komfortablen
1149 <methodname>setMagicFile()</methodname> und <methodname>getMagicFile()</methodname>
1150 Methoden die das spätere Setzen und Empfangen des Magicfile Parameters erlauben. Diese
1151 Methoden sind seit dem Zend Framework 1.7.1 vorhanden.
1152 </para>
1154 <example id="zend.file.transfer.validators.mimetype.example">
1155 <title>Verwendung der MimeType Prüfung</title>
1157 <programlisting language="php"><![CDATA[
1158 $upload = new Zend_File_Transfer();
1160 // Begrenzt den MIME Typ aller gegebenen Dateien auf Gif Bilder
1161 $upload->addValidator('MimeType', 'image/gif');
1163 // Begrenzt den MIME Typ alle gegebenen Dateien auf Gif und Jpeg Dateien
1164 $upload->addValidator('MimeType', array('image/gif', 'image/jpeg');
1166 // Begrenzt den MIME Typ aller Dateien auf die Gruppe image
1167 $upload->addValidator('MimeType', 'image');
1169 // Ein anderes magicfile verwenden
1170 $upload->addValidator('MimeType',
1171 false,
1172 array('image',
1173 'magicfile' => '/path/to/magicfile.mgx'));
1174 ]]></programlisting>
1175 </example>
1177 <para>
1178 Das obige Beispiel zeigt das es auch möglich ist den akzeptierten
1179 <acronym>MIME</acronym> Typ auf eine Gruppe von <acronym>MIME</acronym> Typen zu
1180 begrenzen. Um alle Bilder zu erlauben kann einfach 'image' als <acronym>MIME</acronym>
1181 Typ verwendet werden. Das kann für alle Gruppen von <acronym>MIME</acronym> Typen wie
1182 'image', 'audio', 'video', 'test', und so weiter gemacht werden.
1183 </para>
1185 <note>
1186 <para>
1187 Es ist zu beachten das die Verwendung von <acronym>MIME</acronym> Typ-Gruppen alle
1188 Mitglieder dieser Gruppe akzeptiert, selbst wenn die Anwendung diese nicht
1189 unterstützt. Wenn man 'image' erlaubt, erhält man auch 'image/xpixmap' oder
1190 'image/vasa' was problematisch sein könnte. Wenn man nicht sicher ist ob die eigene
1191 Anwendung alle Typen unterstützt ist es besser nur definierte
1192 <acronym>MIME</acronym> Typen zu erlauben statt der kompletten Gruppe.
1193 </para>
1194 </note>
1196 <note>
1197 <para>
1198 Diese Komponente verwendet die <classname>FileInfo</classname> Erweiterung wenn Sie
1199 vorhanden ist. Wenn nicht wird Sie die <methodname>mime_content_type()</methodname>
1200 Funktion verwenden. Und wenn dieser Funktionsaufruf fehlschlägt wird der
1201 <acronym>MIME</acronym> Typ verwendet der von <acronym>HTTP</acronym> angegeben
1202 wurde.
1203 </para>
1205 <para>
1206 Man sollte sich vor möglichen Sicherheitsproblemen vorsehen wenn weder
1207 <classname>FileInfo</classname> noch <methodname>mime_content_type()</methodname>
1208 vorhanden sind. Der von <acronym>HTTP</acronym> angegebene <acronym>MIME</acronym>
1209 Typ ist nicht sicher und kann einfach manipuliert werden.
1210 </para>
1211 </note>
1212 </sect2>
1214 <sect2 id="zend.file.transfer.validators.notexists">
1215 <title>NotExists Prüfung</title>
1217 <para>
1218 Die <classname>NotExists</classname> Prüfung checkt ob Dateien die angegeben werden
1219 existieren. Sie unterstützt die folgenden Optionen:
1220 </para>
1222 <itemizedlist>
1223 <listitem>
1224 <para>
1225 <property>*</property>: Setzt einen beliebigen Schlüssel oder ein nummerisches
1226 Array. Checkt ob die Datei im gegebenen Verzeichnis existiert.
1227 </para>
1228 </listitem>
1229 </itemizedlist>
1231 <para>
1232 Diese Prüfung akzeptiert mehrere Verzeichnisse, entweder als Komma-getrennter String,
1233 oder als Array. Es können aber auch die Methoden
1234 <methodname>setDirectory()</methodname>, <methodname>addDirectory()</methodname>, und
1235 <methodname>getDirectory()</methodname> verwendet werden um die Verzeichnisse zu setzen
1236 und zu erhalten.
1237 </para>
1239 <example id="zend.file.transfer.validators.notexists.example">
1240 <title>Verwendung der NotExists Prüfung</title>
1242 <programlisting language="php"><![CDATA[
1243 $upload = new Zend_File_Transfer();
1245 // Das temporäre Verzeichnis für die Prüfung hinzufügen
1246 $upload->addValidator('NotExists', '\temp');
1248 // Zwei Verzeichnisse durch Verwendung der Array Schreibweise hinzufügen
1249 $upload->addValidator('NotExists',
1250 array('\home\images',
1251 '\home\uploads')
1252 );
1253 ]]></programlisting>
1254 </example>
1256 <note>
1257 <para>
1258 Beachte das diese Prüfung checkt ob die Datei in allen angegebenen Verzeichnissen
1259 nicht existiert. Die Prüfung schlägt fehl, wenn die Datei in irgendeinem der
1260 angegebenen Verzeichnisse existiert.
1261 </para>
1262 </note>
1263 </sect2>
1265 <sect2 id="zend.file.transfer.validators.sha1">
1266 <title>Sha1 Prüfung</title>
1268 <para>
1269 Die <classname>Sha1</classname> Prüfung checkt den Inhalt einer übertragenen Datei durch
1270 hashen. Diese Prüfung verwendet die Hash Erweiterung von <acronym>PHP</acronym> mit dem
1271 Sha1 Algorithmus. Sie unterstützt die folgenden Optionen:
1272 </para>
1274 <itemizedlist>
1275 <listitem>
1276 <para>
1277 <property>*</property>: Nimmt einen beliebigen Schlüssel oder ein nummerisches
1278 Array.
1279 </para>
1281 <para>
1282 Man kann mehrere Hashes setzen indem Sie als Array übergeben werden. Jeder Datei
1283 wird geprüft und die Prüfung schlägt nur dann fehl wenn alle Dateien
1284 fehlschlagen.
1285 </para>
1286 </listitem>
1287 </itemizedlist>
1289 <example id="zend.file.transfer.validators.sha1.example">
1290 <title>Verwenden der Sha1 Prüfung</title>
1292 <programlisting language="php"><![CDATA[
1293 $upload = new Zend_File_Transfer();
1295 // Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
1296 $upload->addValidator('Sha1', false, '3b3652f336522365223');
1298 // Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
1299 $upload->addValidator('Sha1',
1300 false, array('3b3652f336522365223',
1301 'eb3365f3365ddc65365'));
1302 ]]></programlisting>
1303 </example>
1304 </sect2>
1306 <sect2 id="zend.file.transfer.validators.size">
1307 <title>Size Prüfung</title>
1309 <para>
1310 Die <classname>Size</classname> Prüfung checkt die Größe von einzelnen Dateien. Sie
1311 unterstützt die folgenden Optionen:
1312 </para>
1314 <itemizedlist>
1315 <listitem>
1316 <para><property>min</property>: Setzt die minimale Dateigröße.</para>
1317 </listitem>
1319 <listitem>
1320 <para><property>max</property>: Setzt die maximale Dateigröße.</para>
1321 </listitem>
1323 <listitem>
1324 <para>
1325 <property>bytestring</property>: Definiert ob ein Fehler mit einer
1326 benutzerfreundlichen Nummer zurückgegeben wird, oder mit der reinen Dateigröße.
1327 </para>
1329 <para>
1330 Mit dieser Option kann definiert werden ob der Benutzer '10864' oder '10MB'
1331 erhält. Der Standardwert ist <constant>TRUE</constant> was '10MB' zurückgibt.
1332 </para>
1333 </listitem>
1334 </itemizedlist>
1336 <para>
1337 Man kann diese Prüfung auch nur mit einem String initialisieren, der dann verwendet
1338 wird um die <property>max</property> Option zu setzen. Man kann auch die Methoden
1339 <methodname>setMin()</methodname> und <methodname>setMax()</methodname> verwenden um
1340 beide Optionen nach der Instanziierung setzen, zusammen mit
1341 <methodname>getMin()</methodname> und <methodname>getMax()</methodname> um die Werte zu
1342 setzen die vorher gesetzt wurden.
1343 </para>
1345 <para>
1346 Die Größe selbst wird auch in der SI Schreibweise akzeptiert wie Sie von den meisten
1347 Betriebsystemen verwendet wird. Statt <emphasis>20000 bytes</emphasis> kann man auch
1348 <emphasis>20kB</emphasis> angeben. Alle Einheiten werden konvertiert wobei 1024 als
1349 Basiswert verwendet wird. Die folgenden Einheiten werden akzeptiert:
1350 <emphasis>kB</emphasis>, <emphasis>MB</emphasis>, <emphasis>GB</emphasis>,
1351 <emphasis>TB</emphasis>, <emphasis>PB</emphasis> und <emphasis>EB</emphasis>. Beachte
1352 das 1kB identisch mit 1024 Bytes ist, 1MB identisch mit 1024kB ist, und so weiter.
1353 </para>
1355 <example id="zend.file.transfer.validators.size.example">
1356 <title>Verwendung der Size Prüfung</title>
1358 <programlisting language="php"><![CDATA[
1359 $upload = new Zend_File_Transfer();
1361 // Limitiert die Größe einer Datei auf 40000 Bytes
1362 $upload->addValidator('Size', false, 40000);
1364 // Limitiert die Größe der angegebenen Datei auf maximal 4MB und minimal 10kB
1365 // Gibt auch im Fall eines Fehlers die reine Zahl statt einer
1366 // Benutzerfreundlichen zurück
1367 $upload->addValidator('Size',
1368 false,
1369 array('min' => '10kB',
1370 'max' => '4MB',
1371 'bytestring' => false));
1372 ]]></programlisting>
1373 </example>
1374 </sect2>
1376 <sect2 id="zend.file.transfer.validators.wordcount">
1377 <title>WordCount Prüfung</title>
1379 <para>
1380 Die <classname>WordCount</classname> Prüfung checkt die Anzahl von Wörtern in
1381 angegebenen Dateien. Sie Unterstützt die folgenden Optionen:
1382 </para>
1384 <itemizedlist>
1385 <listitem>
1386 <para>
1387 <property>min</property>: Setzt die mindeste Anzahl an Wörtern die gefunden
1388 werden soll.
1389 </para>
1390 </listitem>
1392 <listitem>
1393 <para>
1394 <property>max</property>: Setzt die maximale Anzahl an Wörtern die gefunden
1395 werden soll.
1396 </para>
1397 </listitem>
1398 </itemizedlist>
1400 <para>
1401 Wenn man diese Prüfung mit einem String oder Integer initiiert, wird der Wert als
1402 <property>max</property> verwendet. Oder man verwendet die
1403 <methodname>setMin()</methodname> und <methodname>setMax()</methodname> Methoden um
1404 beide Optionen im Nachhinein zu Setzen und <methodname>getMin()</methodname> sowie
1405 <methodname>getMax()</methodname> um die aktuell gesetzten Werte zu erhalten.
1406 </para>
1408 <example id="zend.file.transfer.validators.wordcount.example">
1409 <title>Verwendung der WordCount Prüfung</title>
1411 <programlisting language="php"><![CDATA[
1412 $upload = new Zend_File_Transfer();
1414 // Begrenzt die Anzahl der Wörter in Dateien auf maximal 2000
1415 $upload->addValidator('WordCount', false, 2000);
1417 // Begrenzt die Anzahl der Wörter in Dateien auf maximal 5000
1418 // und mindestens 1000 Wörter
1419 $upload->addValidator('WordCount', false, array('min' => 1000, 'max' => 5000));
1420 ]]></programlisting>
1421 </example>
1422 </sect2>
1423 </sect1>