Une brève discussion sur l'utilisation des fonctions d'assertion en PHP

Cet article vous apprendra à utiliser les fonctions d'assertion en PHP. Il a une certaine valeur de référence. Les amis dans le besoin peuvent s'y référer. J'espère qu'il sera utile à tout le monde.

Au départ, je pensais que les fonctions liées aux assertions étaient fournies par PHPUnit et d'autres composants de tests unitaires. Après avoir lu le manuel, j'ai découvert que la fonction d'assertion assert() est fournie avec PHP. lui-même une fonction de. En d’autres termes, lorsque nous effectuons des tests simples dans le code, nous n’avons pas besoin d’introduire complètement l’intégralité du composant de test unitaire.

fonction d'assertion assert()

assert(1==1);

assert(1==2);
// assert.exception = 0 时，Warning: assert(): assert(1 == 2)
// assert.exception = 1 时，Fatal error: Uncaught AssertionError: 验证不通过

De toute évidence, le deuxième morceau de code ne peut pas passer la vérification d'assertion. À ce moment-là, PHP renverra une erreur d’avertissement ou d’exception. Pourquoi y a-t-il deux formes d’erreur possibles ? Lorsque nous définissons assert.exception dans php.ini sur off ou 0, c'est-à-dire lorsque nous désactivons la capacité de ce paramètre, le programme renverra toujours un avertissement sous la forme de PHP5, tout comme le commentaire dans le code ci-dessus. Dans le même temps, les exceptions ne peuvent pas être interceptées via try...catch. Ce paramètre contrôle en fait s'il faut lancer un objet d'exception authentique. Si vous conservez ce paramètre par défaut, c'est-à-dire réglé sur on ou 1, une exception sera levée directement et le programme se terminera.

Comme le montre le code ci-dessus, le premier paramètre de l'assertion est une expression, et elle nécessite une expression qui renvoie un objet de type booléen. Et si on passait une chaîne ou un nombre ?

// 设置 assert.exception = 0 进行多条测试

assert(" ");
// Deprecated: assert(): Calling assert() with a string argument is deprecated
// Warning: assert(): Assertion " " failed

assert("1");
// Deprecated: assert(): Calling assert() with a string argument is deprecated

assert(0);
// Warning: assert(): assert(0) failed

assert(1);

assert("1==2");
// Deprecated: assert(): Calling assert() with a string argument is deprecated
// Warning: assert(): Assertion "1==2" failed

Évidemment, l'expression du premier paramètre sera transtypée, mais le type chaîne aura un rappel obsolète, indiquant que le type d'expression du type chaîne passé à la fonction assert() est obsolète. La version de test actuelle est la 7.3. À l'avenir, les erreurs ou exceptions mettant fin à l'opération pourront être directement signalées. Le principal problème est que si la chaîne passée elle-même est également une expression, le jugement sera basé sur le contenu de cette expression, ce qui peut facilement conduire à une ambiguïté, tout comme le dernier morceau de code. Bien entendu, les méthodes d’utilisation obsolètes ne sont toujours pas recommandées. Voici juste une compréhension.

Jetons ensuite un œil aux autres paramètres de la fonction assert(). Son deuxième paramètre est de deux types, soit une chaîne utilisée pour définir les informations d'erreur, soit une classe d'exception utilisée pour lancer une exception.

assert(1==1, "验证不通过");

assert(1==2, "验证不通过");
// Warning: assert(): 验证不通过 failed

Si une chaîne est donnée directement, alors le contenu du message d'erreur que nous avons défini sera affiché dans le message d'avertissement. C'est très facile à comprendre.

// 注意 assert.exception 设置不同的区别

assert(1==1,  new Exception("验证不通过"));

assert(1==2,  new Exception("验证不通过"));
// assert.exception = 1 时，Fatal error: Uncaught Exception: 验证不通过
// assert.exception = 0 时，Warning: assert(): Exception: 验证不通过

Bien sûr, nous pouvons également donner une classe d'exception pour permettre à l'assertion de lever une exception. Par défaut, la levée de cette exception annulera l'exécution du programme. Il s'agit d'un processus normal de lancement d'exceptions. Nous pouvons utiliser try...catch pour intercepter les exceptions.

try{
    assert(1==2,  new Exception("验证不通过"));
}catch(Exception $e){
    echo "验证失败！:", $e->getMessage(), PHP_EOL;
}
// 验证失败！:验证不通过

Il existe un autre paramètre qui affectera le fonctionnement global des assertions, et c'est le paramètre zend.assertions dans php.ini. Il contient trois valeurs :

• 1, qui génère et exécute du code Généralement utilisé dans l'environnement de test,
• 0, qui génère du code mais passe
• - pendant. runtime. 1. Aucun code n'est généré. Il est généralement utilisé dans l'environnement formel

Ce paramètre peut être configuré et testé par vous-même. La valeur par défaut dans le php.ini est 1. est l'exécution normale de la fonction assert().

assert_options() et la configuration des paramètres correspondante dans php.ini

La fonction d'assertion en PHP nous fournit également une fonction assert_options() pour définir et obtenir facilement configurations de paramètres liées aux capacités d’assertion. Les indicateurs d'assertion qu'il peut définir incluent :

Indicateur | Paramètres INI | Valeur par défaut Description

• | :-: :-:

ASSERT_ACTIVE | assert.active | 1 | Activer l'assertion assert() ASSERT_WARNING | assert.warning | 1 | Générer un avertissement PHP pour chaque assertion échouée ASSERT_BAIL | assert.bail | 0 | Abandonner l'exécution en cas d'échec de l'assertion ASSERT_QUIET_EVAL | assert.quiet_eval | 0 | Désactiver le rapport d'erreur lorsque les expressions d'assertion sont évaluées ASSERT_CALLBACK | assert.callback | (NULL) | Appeler la fonction de rappel lorsque l'assertion échoue

La signification de ces paramètres est très simple à comprendre, vous pouvez la tester vous-même. Jetons un coup d'œil à la fonction du dernier ASSERT_CALLBACK. En fait, sa description est également très claire, c'est-à-dire que si l'assertion échoue, elle entrera dans la fonction de rappel définie par cette option.

assert_options(ASSERT_ACTIVE, 1);
assert_options(ASSERT_WARNING, 1);
assert_options(ASSERT_BAIL, 1);

assert_options(ASSERT_CALLBACK, function($params){
    echo "====faild====", PHP_EOL;
    var_dump($params);
    echo "====faild====", PHP_EOL;
});

assert(1!=1);
// ====faild====
// string(105) ".../source/一起学习PHP中断言函数的使用.php"
// ====faild====

Lorsque l'assertion échoue, nous entrons dans la fonction de rappel, et la fonction de rappel imprime simplement le contenu des paramètres passés à la fonction de rappel. On peut voir que les informations de fichier transmises dans cette fonction de rappel ne peuvent pas transmettre l'assertion.

Résumé

Apprendre et maîtriser l'utilisation et la configuration des fonctions d'assertion peut jeter les bases pour nous d'apprendre les tests unitaires PHPUnit à l'avenir. Bien sûr, il n'y en a pas. beaucoup de choses avec cette capacité, rappelez-vous-en tout le monde !

测试代码：
https://github.com/zhangyue0503/dev-blog/blob/master/php/202005/source/%E4%B8%80%E8%B5%B7%E5%AD%A6%E4%B9%A0PHP%E4%B8%AD%E6%96%AD%E8%A8%80%E5%87%BD%E6%95%B0%E7%9A%84%E4%BD%BF%E7%94%A8.php

Étude recommandée : "Tutoriel vidéo PHP"

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!