原來(lái)一直以為斷言相關(guān)的函數(shù)是 PHPUnit 這些單元測(cè)試組件提供的呼畸，在閱讀手冊(cè)后才發(fā)現(xiàn)里初，這個(gè) assert() 斷言函數(shù)是 PHP 本身就自帶的一個(gè)函數(shù)锅睛。也就是說(shuō)疚膊，我們?cè)诖a中進(jìn)行簡(jiǎn)單的測(cè)試的時(shí)候是不需要完全引入整個(gè)單元測(cè)試組件的义辕。
assert() 斷言函數(shù)
assert(1==1);
assert(1==2);
// assert.exception = 0 時(shí)，Warning: assert(): assert(1 == 2)
// assert.exception = 1 時(shí)寓盗，F(xiàn)atal error: Uncaught AssertionError: 驗(yàn)證不通過(guò)
很明顯灌砖，第二段代碼無(wú)法通過(guò)斷言驗(yàn)證。這時(shí)傀蚌，PHP 就會(huì)返回一個(gè)警告或者異常錯(cuò)誤基显。為什么有可能是兩種錯(cuò)誤形式呢？當(dāng)我們?cè)O(shè)置 php.ini 中的 assert.exception 為 off 或者 0 時(shí)善炫，也就是關(guān)閉這個(gè)參數(shù)的能力時(shí)撩幽，程序就會(huì)以 PHP5 的形式依然返回一個(gè)警告，就像上面代碼中的注釋一樣箩艺。同時(shí)窜醉，通過(guò) try...catch 也無(wú)法進(jìn)行異常的捕獲了。這個(gè)參數(shù)其實(shí)就是控制是否以正宗的異常對(duì)象進(jìn)行拋出艺谆。如果保持這個(gè)參數(shù)為默認(rèn)情況也就是設(shè)置為 on 或者 1 的話(huà)酱虎，就會(huì)直接拋出異常，程序中止擂涛。
從上述代碼可以看出读串，斷言的第一個(gè)參數(shù)是一個(gè)表達(dá)式，而且是需要一個(gè)返回 bool 類(lèi)型對(duì)象的表達(dá)式撒妈。如果我們傳遞的是一個(gè)字符串或者一個(gè)數(shù)字呢恢暖？
// 設(shè)置 assert.exception = 0 進(jìn)行多條測(cè)試
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
很明顯第一個(gè)參數(shù)的表達(dá)式會(huì)進(jìn)行類(lèi)型強(qiáng)制轉(zhuǎn)換，但是字符串類(lèi)型會(huì)多出一個(gè)過(guò)時(shí)提醒狰右，表明給 assert() 函數(shù)傳遞字符串類(lèi)型的表達(dá)式類(lèi)型已經(jīng)過(guò)時(shí)了杰捂。當(dāng)前的測(cè)試版本是 7.3 ，在將來(lái)可能就會(huì)直接報(bào)中止運(yùn)行的錯(cuò)誤或異常了棋蚌。主要問(wèn)題在于嫁佳，如果傳遞的字符串本身也是一個(gè)表達(dá)式的話(huà)挨队，會(huì)以這個(gè)表達(dá)式的內(nèi)容為基礎(chǔ)進(jìn)行判斷，這樣很容易產(chǎn)生歧義蒿往，就像最后一段代碼一樣盛垦。當(dāng)然，已經(jīng)過(guò)時(shí)的使用方式還是不推薦的瓤漏，這里僅是做一個(gè)了解即可腾夯。
接下來(lái)我們看一下 assert() 函數(shù)的其他參數(shù)，它的第二個(gè)參數(shù)是兩種類(lèi)型蔬充，要么給一個(gè)字符串用來(lái)定義錯(cuò)誤的信息蝶俱，要么給一個(gè) 異常類(lèi) 用于拋出異常。
assert(1==1, "驗(yàn)證不通過(guò)");
assert(1==2, "驗(yàn)證不通過(guò)");
// Warning: assert(): 驗(yàn)證不通過(guò) failed
如果直接給的一個(gè)字符串饥漫，那么在警告的提示信息中榨呆，顯示的就是我們定義的這個(gè)錯(cuò)誤信息的內(nèi)容。這個(gè)非常好理解庸队。
// 注意 assert.exception 設(shè)置不同的區(qū)別
assert(1==1, new Exception("驗(yàn)證不通過(guò)"));
assert(1==2, new Exception("驗(yàn)證不通過(guò)"));
// assert.exception = 1 時(shí)愕提，F(xiàn)atal error: Uncaught Exception: 驗(yàn)證不通過(guò)
// assert.exception = 0 時(shí)，Warning: assert(): Exception: 驗(yàn)證不通過(guò)
當(dāng)然皿哨，我們也可以給一個(gè) 異常類(lèi) 讓斷言?huà)伋鲆粋€(gè)異常。在默認(rèn)情況下纽谒，這個(gè)異常的拋出將中止程序的運(yùn)行证膨。也就是一個(gè)正常的異常拋出流程，我們可以使用 try...catch 進(jìn)行異常的捕獲鼓黔。
try{
assert(1==2, new Exception("驗(yàn)證不通過(guò)"));
}catch(Exception $e){
echo "驗(yàn)證失斞肜铡！:", $e->getMessage(), PHP_EOL;
}
// 驗(yàn)證失敯幕崔步！:驗(yàn)證不通過(guò)
另外還有一個(gè)參數(shù)會(huì)對(duì)斷言的整體運(yùn)行產(chǎn)生影響，那就是 php.ini 中的 zend.assertions 參數(shù)缎谷。它包含三個(gè)值：
- 1井濒，生成并執(zhí)行代碼，一般在測(cè)試環(huán)境使用
- 0列林，生成代碼但是在運(yùn)行時(shí)會(huì)路過(guò)
- -1瑞你，不生成代碼，一般在正式環(huán)境使用
這個(gè)參數(shù)大家可以自行配置測(cè)試希痴，默認(rèn)的 php.ini 中它的默認(rèn)值是 1 者甲，也就是正常的執(zhí)行 assert() 函數(shù)。
assert_options() 及相對(duì)應(yīng)的 php.ini 中的參數(shù)配置
PHP 中的斷言功能還為我們提供了一個(gè) assert_options() 函數(shù)砌创，用于方便地設(shè)置和獲取一些和斷言能力有關(guān)的參數(shù)配置虏缸。它能夠設(shè)置的斷言標(biāo)志包括：
| 標(biāo)志 | INI設(shè)置 | 默認(rèn)值 | 描述 |
|---|---|---|---|
| ASSERT_ACTIVE | assert.active | 1 | 啟用 assert() 斷言 |
| ASSERT_WARNING | assert.warning | 1 | 為每個(gè)失敗的斷言產(chǎn)生一個(gè) PHP 警告（warning） |
| ASSERT_BAIL | assert.bail | 0 | 在斷言失敗時(shí)中止執(zhí)行 |
| ASSERT_QUIET_EVAL | assert.quiet_eval | 0 | 在斷言表達(dá)式求值時(shí)禁用 error_reporting |
| ASSERT_CALLBACK | assert.callback | (NULL) | 斷言失敗時(shí)調(diào)用回調(diào)函數(shù) |
這些參數(shù)的含義都非常好理解鲫懒，大家可以自己測(cè)試一下。我們就來(lái)看一下最后一個(gè) ASSERT_CALLBACK 的作用刽辙。其實(shí)它的說(shuō)明也非常清楚窥岩，就是斷言失敗的情況下就進(jìn)入到這個(gè)選項(xiàng)定義的回調(diào)函數(shù)中。
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/一起學(xué)習(xí)PHP中斷言函數(shù)的使用.php"
// ====faild====
當(dāng)斷言失敗的時(shí)候扫倡，我們就進(jìn)入了回調(diào)函數(shù)中谦秧，在回調(diào)函數(shù)直接簡(jiǎn)單的打印了傳給回調(diào)函數(shù)的參數(shù)內(nèi)容∧炖＃可以看出疚鲤，這個(gè)回調(diào)函數(shù)里面?zhèn)鬟f過(guò)來(lái)的是無(wú)法通過(guò)斷言的文件信息。
總結(jié)
學(xué)習(xí)掌握一下斷言函數(shù)的使用及配置缘挑，可以為我們將來(lái)學(xué)習(xí) PHPUnit 單元測(cè)試打下基礎(chǔ)集歇，當(dāng)然，本身這個(gè)能力的東西就不是很多语淘，大家記住就好啦诲宇！
測(cè)試代碼：
參考文檔：
https://www.php.net/manual/zh/function.assert-options.php
https://www.php.net/manual/zh/function.assert.php
===========
各自媒體平臺(tái)均可搜索【硬核項(xiàng)目經(jīng)理】
