return

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

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

如果在一個函數(shù)中調用 return 語句,將立即結束此函數(shù)的執(zhí)行并將它的參數(shù)作為函數(shù)的值返回。return 也會終止 eval() 語句或者腳本文件的執(zhí)行。

如果在全局范圍中調用,則當前腳本文件中止運行。如果當前腳本文件是被 include 的或者 require 的,則控制交回調用文件。此外,如果當前腳本是被 include 的,則 return 的值會被當作 include 調用的返回值。如果在主腳本文件中調用 return,則腳本中止運行。如果當前腳本文件是在 php.ini 中的配置選項 auto_prepend_file 或者 auto_append_file 所指定的,則此腳本文件中止運行。

更多信息見返回值

注意: 注意既然 return 是語言結構而不是函數(shù),因此其參數(shù)沒有必要用括號將其括起來,也不推薦這樣用。

注意: 如果沒有提供參數(shù),則一定不能用括號,此時返回 null。如果調用 return 時加上了括號卻又沒有參數(shù)會導致解析錯誤。

自 PHP 7.1.0 起,如果返回類型需要是 void 而帶了返回的參數(shù), 將導致 E_COMPILE_ERROR; 相反返回類型需要而未帶參數(shù)也會同樣導致該錯誤。