Comment utiliser la fonction d'assertion en PHP

Cet article vous présentera comment 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.

En même temps, les exceptions ne peuvent pas être détecté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 aussi 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, la méthode d’utilisation obsolète n’est toujours pas recommandée. 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 le code. Il est généralement utilisé dans l'environnement de test
• 0, qui génère du code mais passe
• . - pendant l'exécution. 1. Aucun code n'est généré 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. , qui 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ètre INI | description de la valeur par défaut

• ASSERT_ACTIVE	assert.active	1	启用 assert() 断言
  ASSERT_WARNING	assert.warning	1	为每个失败的断言产生一个 PHP 警告（warning）
  ASSERT_BAIL	assert.bail	0	在断言失败时中止执行
  ASSERT_QUIET_EVAL	assert.quiet_eval	0	在断言表达式求值时禁用 error_reporting
  ASSERT_CALLBACK	assert.callback	(NULL)	断言失败时调用回调函数

这些参数的含义都非常好理解，大家可以自己测试一下。我们就来看一下最后一个 ASSERT_CALLBACK 的作用。其实它的说明也非常清楚，就是断言失败的情况下就进入到这个选项定义的回调函数中。

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====

当断言失败的时候，我们就进入了回调函数中，在回调函数直接简单的打印了传给回调函数的参数内容。可以看出，这个回调函数里面传递过来的是无法通过断言的文件信息。

总结

学习掌握一下断言函数的使用及配置，可以为我们将来学习 PHPUnit 单元测试打下基础，当然，本身这个能力的东西就不是很多，大家记住就好啦！

测试代码：

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

推荐学习：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!