return
(PHP 4, PHP 5, PHP 7, PHP 8)
return
將程序控制返還給呼叫模組。
將在呼叫模組中執行的下一句表達式中繼續。
如果在一個函式中呼叫 return 語句,將立即結束此函式的執行並將它的參數作為函式的值返回。return 也會終止 eval() 語句或者指令碼檔案的執行。
如果在全域性範圍中呼叫,則目前指令碼檔案中止執行。如果目前指令碼檔案是被 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
;
相反返回型別需要而未帶參數也會同樣導致該錯誤。