return

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

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

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

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

更多信息見返回值。

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

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

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