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, тогда
инструкции возврата с аргументом вызывают такую ошибку.