return

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

Инструкция return возвращает управление программой модулю, из которого выполнили вызов. Выполнение программы продолжается в модуле — с выражения, которое идёт за местом вызова.

При вызове из функции инструкция return немедленно прекращает выполнение функции и возвращает свой аргумент как значение вызова функции. Инструкция return также завершит выполнение инструкции eval() или файла скрипта.

При вызове из глобальной области видимости инструкция return завершает выполнение текущего файла скрипта. Управление возвращается в файл, из которого для подключения файла скрипта вызвали инструкции include или require. Значение инструкции return вернётся как значение вызова инструкции include, когда файл скрипта подключили через include. Выполнение скрипта завершается, если инструкция return вызывается из главного файла скрипта. Если опции конфигурации auto_prepend_file или auto_append_file в файле php.ini называют текущий файл скрипта, выполнение этого файла скрипта завершается.

Дополнительную информацию даёт раздел «Возврат значений».

Замечание: Обратите внимание: поскольку инструкция return — языковая конструкция, а не функция, круглые скобки вокруг аргумента инструкции необязательны и не приветствуются.

Замечание: При вызове без аргумента инструкция return вернёт null. При вызове инструкции возврата без аргумента круглые скобки указывать нельзя. Вызов инструкции return со скобками, но без аргумента вызовет синтаксическую ошибку.

Начиная с PHP 7.1.0 инструкции возврата без аргумента в функциях, которые объявляют возвращаемый тип, вызывают ошибку уровня E_COMPILE_ERROR, если только возвращаемый тип не void, тогда инструкции возврата с аргументом вызывают такую ошибку.