1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Documentation SimpleTest pour les tests de régression en PHP</title>
<link rel="stylesheet" type="text/css" href="docs.css" title="Styles">
</head>
<body>
<div class="menu_back"><div class="menu">
<a href="index.html">SimpleTest</a>
|
<a href="overview.html">Overview</a>
|
<a href="unit_test_documentation.html">Unit tester</a>
|
<a href="group_test_documentation.html">Group tests</a>
|
<a href="mock_objects_documentation.html">Mock objects</a>
|
<a href="partial_mocks_documentation.html">Partial mocks</a>
|
<a href="reporter_documentation.html">Reporting</a>
|
<a href="expectation_documentation.html">Expectations</a>
|
<a href="web_tester_documentation.html">Web tester</a>
|
<a href="form_testing_documentation.html">Testing forms</a>
|
<a href="authentication_documentation.html">Authentication</a>
|
<a href="browser_documentation.html">Scriptable browser</a>
</div></div>
<h1>Documentation sur les tests unitaires en PHP</h1>
This page...
<ul>
<li>
<a href="#unitaire">Scénarios de test unitaire</a>
et opérations basiques.
</li>
<li>
<a href="#extension_unitaire">Étendre des scénarios de test</a>
pour les personnaliser à votre propre projet.
</li>
<li>
<a href="#lancement_unitaire">Lancer un scénario seul</a>
comme un script unique.
</li>
</ul>
<div class="content">
<p><a class="target" name="unitaire"><h2>Scénarios de tests unitaires</h2></a></p>
<p>
Le coeur du système est un framework de tests de régression
construit autour des scénarios de test.
Un exemple de scénario de test ressemble à...
<pre>
<strong>class FileTestCase extends UnitTestCase {
}</strong>
</pre>
Si aucun nom de test n'est fourni au moment
de la liaison avec le constructeur alors
le nom de la classe sera utilisé.
Il s'agit du nom qui sera affiché dans les résultats du test.
</p>
<p>
Les véritables tests sont ajoutés en tant que méthode
dans le scénario de test dont le nom par défaut
commence par la chaîne "test"
et quand le scénario de test est appelé toutes les méthodes
de ce type sont exécutées dans l'ordre utilisé
par l'introspection de PHP pour les trouver.
Peuvent être ajoutées autant de méthodes de test que nécessaires.
Par exemple...
<pre>
require_once('simpletest/autorun.php');
require_once('../classes/writer.php');
class FileTestCase extends UnitTestCase {
function FileTestCase() {
$this->UnitTestCase('File test');
}<strong>
function setUp() {
@unlink('../temp/test.txt');
}
function tearDown() {
@unlink('../temp/test.txt');
}
function testCreation() {
$writer = &new FileWriter('../temp/test.txt');
$writer->write('Hello');
$this->assertTrue(file_exists('../temp/test.txt'), 'File created');
}</strong>
}
</pre>
Le constructeur est optionnel et souvent omis. Sans nom,
le nom de la classe est utilisé comme nom pour le scénario de test.
</p>
<p>
Notre unique méthode de test pour le moment est
<span class="new_code">testCreation()</span> où nous vérifions
qu'un fichier a bien été créé par notre objet
<span class="new_code">Writer</span>. Nous pourrions avoir mis
le code <span class="new_code">unlink()</span> dans cette méthode,
mais en la plaçant dans <span class="new_code">setUp()</span>
et <span class="new_code">tearDown()</span> nous pouvons l'utiliser
pour nos autres méthodes de test que nous ajouterons.
</p>
<p>
La méthode <span class="new_code">setUp()</span> est lancé
juste avant chaque méthode de test.
<span class="new_code">tearDown()</span> est lancé après chaque méthode de test.
</p>
<p>
Vous pouvez placer une initialisation de
scénario de test dans le constructeur afin qu'elle soit lancée
pour toutes les méthodes dans le scénario de test
mais dans un tel cas vous vous exposeriez à des interférences.
Cette façon de faire est légèrement moins rapide,
mais elle est plus sûre.
Notez que si vous arrivez avec des notions de JUnit,
il ne s'agit pas du comportement auquel vous êtes habitués.
Bizarrement JUnit re-instancie le scénario de test
pour chaque méthode de test pour se prévenir
d'une telle interférence.
SimpleTest demande à l'utilisateur final d'utiliser
<span class="new_code">setUp()</span>, mais fournit aux codeurs de bibliothèque d'autres crochets.
</p>
<p>
Pour rapporter les résultats de test,
le passage par une classe d'affichage - notifiée par
les différentes méthodes de type <span class="new_code">assert...()</span> -
est utilisée. En voici la liste complète pour
la classe <span class="new_code">UnitTestCase</span>,
celle par défaut dans SimpleTest...
<table><tbody>
<tr>
<td><span class="new_code">assertTrue($x)</span></td>
<td>Echoue si $x est faux</td>
</tr>
<tr>
<td><span class="new_code">assertFalse($x)</span></td>
<td>Echoue si $x est vrai</td>
</tr>
<tr>
<td><span class="new_code">assertNull($x)</span></td>
<td>Echoue si $x est initialisé</td>
</tr>
<tr>
<td><span class="new_code">assertNotNull($x)</span></td>
<td>Echoue si $x n'est pas initialisé</td>
</tr>
<tr>
<td><span class="new_code">assertIsA($x, $t)</span></td>
<td>Echoue si $x n'est pas de la classe ou du type $t</td>
</tr>
<tr>
<td><span class="new_code">assertEqual($x, $y)</span></td>
<td>Echoue si $x == $y est faux</td>
</tr>
<tr>
<td><span class="new_code">assertNotEqual($x, $y)</span></td>
<td>Echoue si $x == $y est vrai</td>
</tr>
<tr>
<td><span class="new_code">assertIdentical($x, $y)</span></td>
<td>Echoue si $x === $y est faux</td>
</tr>
<tr>
<td><span class="new_code">assertNotIdentical($x, $y)</span></td>
<td>Echoue si $x === $y est vrai</td>
</tr>
<tr>
<td><span class="new_code">assertReference($x, $y)</span></td>
<td>Echoue sauf si $x et $y sont la même variable</td>
</tr>
<tr>
<td><span class="new_code">assertCopy($x, $y)</span></td>
<td>Echoue si $x et $y sont la même variable</td>
</tr>
<tr>
<td><span class="new_code">assertWantedPattern($p, $x)</span></td>
<td>Echoue sauf si l'expression rationnelle $p capture $x</td>
</tr>
<tr>
<td><span class="new_code">assertNoUnwantedPattern($p, $x)</span></td>
<td>Echoue si l'expression rationnelle $p capture $x</td>
</tr>
<tr>
<td><span class="new_code">assertNoErrors()</span></td>
<td>Echoue si une erreur PHP arrive</td>
</tr>
<tr>
<td><span class="new_code">assertError($x)</span></td>
<td>Echoue si aucune erreur ou message incorrect de PHP n'arrive</td>
</tr>
</tbody></table>
Toutes les méthodes d'assertion peuvent recevoir
une description optionnelle :
cette description sert pour étiqueter le résultat.
Sans elle, une message par défaut est envoyée à la place :
il est généralement suffisant.
Ce message par défaut peut encore être encadré
dans votre propre message si vous incluez "%s"
dans la chaîne.
Toutes les assertions renvoient vrai / true en cas de succès
et faux / false en cas d'échec.
</p>
<p>
D'autres exemples...
<pre>
<strong>$variable = null;
$this->assertNull($variable, 'Should be cleared');</strong>
</pre>
...passera et normalement n'affichera aucun message.
Si vous avez <a href="http://www.lastcraft.com/display_subclass_tutorial.php">
configuré le testeur pour afficher aussi les succès</a>
alors le message sera affiché comme tel.
<pre>
<strong>$this->assertIdentical(0, false, 'Zero is not false [%s]');</strong>
</pre>
Ceci échouera étant donné qu'il effectue une vérification
sur le type en plus d'une comparaison sur les deux valeurs.
La partie "%s" est remplacée par le message d'erreur
par défaut qui aurait été affiché si nous n'avions pas fourni le nôtre.
Cela nous permet d'emboîter les messages de test.
<pre>
<strong>$a = 1;
$b = $a;
$this->assertReference($a, $b);</strong>
</pre>
Échouera étant donné que la variable <span class="new_code">$b</span>
est une copie de <span class="new_code">$a</span>.
<pre>
<strong>$this->assertWantedPattern('/hello/i', 'Hello world');</strong>
</pre>
Là, ça passe puisque la recherche est insensible
à la casse et que donc <span class="new_code">hello</span>
est bien repérable dans <span class="new_code">Hello world</span>.
<pre>
<strong>trigger_error('Disaster');
trigger_error('Catastrophe');
$this->assertError();
$this->assertError('Catastrophe');
$this->assertNoErrors();</strong>
</pre>
Ici, il y a besoin d'une petite explication :
toutes passent !
</p>
<p>
Les erreurs PHP dans SimpleTest sont piégées et
placées dans une queue. Ici la première vérification
d'erreur attrape le message "Disaster"
sans vérifier le texte et passe. Résultat :
l'erreur est supprimée de la queue.
La vérification suivante teste non seulement l'existence
de l'erreur mais aussi le texte qui correspond :
un autre succès. Désormais la queue est vide
et le dernier test passe aussi.
Si une autre erreur non vérifiée est encore
dans la queue à la fin de notre méthode de test
alors une exception sera rapportée dans le test.
Notez que SimpleTest ne peut pas attraper les erreurs PHP à la compilation.
</p>
<p>
Les scénarios de test peuvent utiliser des méthodes
bien pratiques pour déboguer le code ou pour étendre la suite...
<table><tbody>
<tr>
<td><span class="new_code">setUp()</span></td>
<td>Est lancée avant chaque méthode de test</td>
</tr>
<tr>
<td><span class="new_code">tearDown()</span></td>
<td>Est lancée après chaque méthode de test</td>
</tr>
<tr>
<td><span class="new_code">pass()</span></td>
<td>Envoie un succès</td>
</tr>
<tr>
<td><span class="new_code">fail()</span></td>
<td>Envoie un échec</td>
</tr>
<tr>
<td><span class="new_code">error()</span></td>
<td>Envoi un évènement exception</td>
</tr>
<tr>
<td><span class="new_code">sendMessage()</span></td>
<td>Envoie un message d'état aux systèmes d'affichage qui le supporte</td>
</tr>
<tr>
<td><span class="new_code">signal($type, $payload)</span></td>
<td>Envoie un message défini par l'utilisateur au rapporteur du test</td>
</tr>
<tr>
<td><span class="new_code">dump($var)</span></td>
<td>Effectue un <span class="new_code">print_r()</span> formaté pour du déboguage rapide et grossier</td>
</tr>
<tr>
<td><span class="new_code">swallowErrors()</span></td>
<td>Vide les erreurs de la queue</td>
</tr>
</tbody></table>
</p>
<p><a class="target" name="extension_unitaire"><h2>Etendre les scénarios de test</h2></a></p>
<p>
Bien sûr des méthodes supplémentaires de test
peuvent être ajoutées pour créer d'autres types
de scénario de test afin d'étendre le framework...
<pre>
require_once('simpletest/autorun.php');
<strong>
class FileTester extends UnitTestCase {
function FileTester($name = false) {
$this->UnitTestCase($name);
}
function assertFileExists($filename, $message = '%s') {
$this->assertTrue(
file_exists($filename),
sprintf($message, 'File [$filename] existence check'));
}</strong>
}
</pre>
Ici la bibliothèque SimpleTest est localisée
dans un répertoire local appelé <em>simpletest</em>.
Pensez à le modifier pour votre propre environnement.
</p>
<p>
Alternativement vous pourriez utiliser dans votre code
un directive <span class="new_code">SimpleTestOptions::ignore('FileTester');</span>.
</p>
<p>
Ce nouveau scénario peut être hérité exactement
comme un scénario de test classique...
<pre>
class FileTestCase extends <strong>FileTester</strong> {
function setUp() {
@unlink('../temp/test.txt');
}
function tearDown() {
@unlink('../temp/test.txt');
}
function testCreation() {
$writer = &new FileWriter('../temp/test.txt');
$writer->write('Hello');<strong>
$this->assertFileExists('../temp/test.txt');</strong>
}
}
</pre>
</p>
<p>
Si vous souhaitez un scénario de test sans
toutes les assertions de <span class="new_code">UnitTestCase</span>
mais uniquement avec les vôtres propres,
vous aurez besoin d'étendre la classe
<span class="new_code">SimpleTestCase</span> à la place.
Elle se trouve dans <em>simple_test.php</em>
en lieu et place de <em>unit_tester.php</em>.
A consulter <a href="group_test_documentation.html">plus tard</a>
si vous souhaitez incorporer les scénarios
d'autres testeurs unitaires dans votre suite de test.
</p>
<p><a class="target" name="lancement_unitaire"><h2>Lancer un unique scénario de test</h2></a></p>
<p>
Ce n'est pas souvent qu'il faille lancer des scénarios
avec un unique test. Sauf lorsqu'il s'agit de s'arracher
les cheveux sur un module à problème sans pour
autant désorganiser la suite de test principale.
Avec <em>autorun</em> aucun échafaudage particulier
n'est nécessaire, il suffit de lancer votre test et
vous y êtes.
</p>
<p>
Vous pouvez même décider quel rapporteur
(par exemple, <span class="new_code">TextReporter</span> ou <span class="new_code">HtmlReporter</span>)
vous préférez pour un fichier spécifique quand il est lancé
tout seul...
<pre>
<?php
require_once('simpletest/autorun.php');<strong>
SimpleTest :: prefer(new TextReporter());</strong>
require_once('../classes/writer.php');
class FileTestCase extends UnitTestCase {
...
}
?>
</pre>
Ce script sera lancé tel que mais il n'y aura
aucun succès ou échec avant que des méthodes de test soient ajoutées.
</p>
</div>
References and related information...
<ul>
<li>
La page de SimpleTest sur
<a href="http://sourceforge.net/projects/simpletest/">SourceForge</a>.
</li>
<li>
La page de téléchargement de SimpleTest sur
<a href="http://www.lastcraft.com/simple_test.php">LastCraft</a>.
</li>
<li>
<a href="http://simpletest.org/api/">L'API complète de SimpleTest</a>
à partir de PHPDoc.
</li>
</ul>
<div class="menu_back"><div class="menu">
<a href="index.html">SimpleTest</a>
|
<a href="overview.html">Overview</a>
|
<a href="unit_test_documentation.html">Unit tester</a>
|
<a href="group_test_documentation.html">Group tests</a>
|
<a href="mock_objects_documentation.html">Mock objects</a>
|
<a href="partial_mocks_documentation.html">Partial mocks</a>
|
<a href="reporter_documentation.html">Reporting</a>
|
<a href="expectation_documentation.html">Expectations</a>
|
<a href="web_tester_documentation.html">Web tester</a>
|
<a href="form_testing_documentation.html">Testing forms</a>
|
<a href="authentication_documentation.html">Authentication</a>
|
<a href="browser_documentation.html">Scriptable browser</a>
</div></div>
<div class="copyright">
Copyright<br>Marcus Baker 2006
</div>
</body>
</html>
|
