return

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

return повертає управління програмою модулю, що викликає. Виконання продовжується з виразу, що слідує за викликом викликаного модуля.

Якщо викликати оператор return зсередини функції, він негайно завершує виконання поточної функції і повертає її аргумент як значення виклику функції. return також завершує виконання оператора eval() або скриптового файлу.

Якщо виклик виконується з глобальної області видимості, то виконання поточного файлу скрипта завершується. Якщо поточний файл скрипта було включено або він був потрібен, то керування передається назад до файлу, що його викликав. Крім того, якщо поточний файл скрипта було включено, то значення, передане в return, буде повернуто як значення виклику include. Якщо return викликано з основного файлу скрипта, то виконання скрипта завершується. Якщо поточний файл скрипта було названо за допомогою параметрів auto_prepend_file або auto_append_file у файлі php.ini, то виконання цього файлу скрипта буде завершено.

Для отримання додаткової інформації див. розділ Значення, що повертаються.

Зауваження: Зауважте, що оскільки return - це мовна конструкція, а не функція, дужки навколо її аргументу не є обов'язковими, і їх використання не рекомендується.

Примітка: Якщо параметр не задано, дужки слід опустити і буде повернуто null. Виклик return з дужками, але без аргументів призведе до помилки розбору.

Починаючи з PHP 7.1.0, оператори повернення без аргументу у функціях, які оголошують тип повернення, викликають помилку E_COMPILE_ERROR, за винятком випадків, коли тип повернення є void, в яких оператори повернення з аргументом викликають цю помилку.