return
(PHP 4, PHP 5, PHP 7, PHP 8)
return
возвращает управление программой модулю, из которого
была вызвана функция.
Выполнение программы продолжается с инструкции, следующей за местом вызова.
Если вызывается из функции, выражение return
немедленно прекращает выполнение текущей функции и
возвращает свой аргумент как значение данной функции.
return
также завершит выполнение выражения
eval() или всего файла скрипта.
Если вызывается из глобальной области видимости, выполнение текущего файла
скрипта прекращается. Если текущий файл скрипта был подключён
с помощью функций include или require,
тогда управление возвращается к файлу, который вызывал текущий. Более того, если
текущий файл скрипта был подключён с помощью include, тогда
значение переданное return
будет возвращено в качестве
значения вызова include. Если
return
вызывается из главного файла скрипта,
тогда выполнение скрипта прекращается. Если текущий файл скрипта был
вызван конфигурационными опциями auto_prepend_file или auto_append_file
из файла настроек php.ini,
тогда выполнение этого скрипта прекращается.
Для более детальной информации смотрите раздел Возвращаемые значения.
Замечание:
Заметьте, что return
является языковой
конструкцией, а не функцией и круглые скобки, окружающие
аргументы, не являются необходимостью. Мало того, они тут не приветствуются.
Замечание:
Если параметры не указаны, тогда круглые скобки должны быть опущены
и будет возвращён null
.
Вызов return
со скобками, но
без аргументов вызовет синтаксическую ошибку.
Начиная с PHP 7.1.0, операторы возврата без аргумента в функциях,
объявляющих тип возврата, вызывают E_COMPILE_ERROR
,
если только тип возврата не void, в этом случае такую же ошибку вызывают операторы возврата с аргументом.