return

(PHP 4, PHP 5, PHP 7, PHP 8)

return 將程序控制返還給調(diào)用模塊。 將在調(diào)用模塊中執(zhí)行的下一句表達(dá)式中繼續(xù)。

如果在一個(gè)函數(shù)中調(diào)用 return 語(yǔ)句，將立即結(jié)束此函數(shù)的執(zhí)行并將它的參數(shù)作為函數(shù)的值返回。return 也會(huì)終止 eval() 語(yǔ)句或者腳本文件的執(zhí)行。

如果在全局范圍中調(diào)用，則當(dāng)前腳本文件中止運(yùn)行。如果當(dāng)前腳本文件是被 include 的或者 require 的，則控制交回調(diào)用文件。此外，如果當(dāng)前腳本是被 include 的，則 return 的值會(huì)被當(dāng)作 include 調(diào)用的返回值。如果在主腳本文件中調(diào)用 return，則腳本中止運(yùn)行。如果當(dāng)前腳本文件是在 php.ini 中的配置選項(xiàng) auto_prepend_file 或者 auto_append_file 所指定的，則此腳本文件中止運(yùn)行。

更多信息見返回值。

注意: 注意既然 return 是語(yǔ)言結(jié)構(gòu)而不是函數(shù)，因此其參數(shù)沒(méi)有必要用括號(hào)將其括起來(lái)，也不推薦這樣用。

注意: 如果沒(méi)有提供參數(shù)，則一定不能用括號(hào)，此時(shí)返回 null。如果調(diào)用 return 時(shí)加上了括號(hào)卻又沒(méi)有參數(shù)會(huì)導(dǎo)致解析錯(cuò)誤。

自 PHP 7.1.0 起，如果返回類型需要是 void 而帶了返回的參數(shù)， 將導(dǎo)致 E_COMPILE_ERROR； 相反返回類型需要而未帶參數(shù)也會(huì)同樣導(dǎo)致該錯(cuò)誤。