PHPTime

Функции в PHP: аргументы, типы, замыкания и стрелочные функции

Функция в PHP принимает аргументы, выполняет операцию и может вернуть результат. Разберём, где PHP проверяет типы, как замыкания получают доступ к внешним переменным и когда подходят global, static и fn.

Объявление функции в PHP: синтаксис function

После function укажите имя, затем параметры в скобках. Тип результата пишется после двоеточия, а тело функции заключают в фигурные скобки. При вызове PHP связывает аргументы с параметрами и выполняет тело.

PHP
<?php
declare(strict_types=1);

function subtotal(int $price, int $quantity): int
{
    return $price * $quantity;
}

echo subtotal(150, 3); // 450

$price и $quantity — параметры объявления, а 150 и 3 — аргументы вызова. Объявленную на верхнем уровне именованную функцию можно вызвать выше по файлу. Если объявление находится внутри if или другой функции, оно становится доступным только после выполнения соответствующего блока. Повторное объявление функции с тем же именем в одном пространстве имён приводит к ошибке.

Аргументы функций PHP: значения по умолчанию, имена и ссылки

Позиционные и именованные аргументы

Позиционные аргументы передаются по порядку. Именованные аргументы позволяют указать только нужные параметры, оставив остальным значения по умолчанию. Параметры с умолчаниями размещайте после обязательных. Явно переданный null считается аргументом и проходит обычную проверку типа.

PHP
<?php
declare(strict_types=1);

function formatName(string $name, string $prefix = '', string $suffix = ''): string
{
    return $prefix . $name . $suffix;
}

echo formatName('Анна', suffix: '!'); // Анна!

В смешанном вызове позиционные аргументы идут первыми. Вызов formatName(name: 'Анна', '!') вызовет ошибку. Ошибкой также будут неизвестное имя параметра в этой функции и повторная передача одного параметра. Если библиотека допускает именованные вызовы, переименование параметра может сломать код её клиентов.

Переменное число аргументов

Последний параметр с ... собирает оставшиеся аргументы в массив. Тип перед ним применяется к каждому элементу. В вызове тот же оператор раскрывает массив в аргументы. Числовые ключи дают позиционные аргументы, строковые — именованные. При вызове вариативной функции неизвестные имена могут попасть в массив вариативного параметра как строковые ключи.

PHP
<?php
declare(strict_types=1);

function sum(int ...$values): int
{
    return array_sum($values);
}

$prices = [120, 80, 50];
echo sum(...$prices); // 250

Передача по ссылке

По умолчанию присваивание параметру внутри функции оставляет переменную вызывающего кода с прежним значением. У объектов обе переменные указывают на один объект, поэтому изменение его свойства видно снаружи. Чтобы функция могла изменить саму переменную вызывающего кода, поставьте & перед параметром в объявлении.

PHP
<?php
declare(strict_types=1);

function normalizeEmail(string &$email): void
{
    $email = strtolower(trim($email));
}

$email = ' USER@EXAMPLE.TEST ';
normalizeEmail($email);
echo $email; // user@example.test

Для параметра по ссылке передавайте переменную, например $email. Вызов normalizeEmail(' USER@EXAMPLE.TEST ') приведёт к ошибке. Если вызывающему коду удобнее явно видеть присваивание, функция может вернуть нормализованную строку, а вызов будет выглядеть как $email = normalizeEmail($email).

Типы параметров и declare(strict_types=1)

В сигнатуре можно указывать скалярные типы, array, callable, классы и интерфейсы. ?string и string|null допускают строку или null. Объединение int|string допускает любой из перечисленных типов, а пересечение Countable&Iterator требует реализации обоих интерфейсов. Тип array проверяет сам массив. Ограничение на тип его элементов можно описать в PHPDoc для статического анализатора или проверить в коде.

declare(strict_types=1) ставят первым оператором файла. Для скалярных параметров пользовательской функции режим определяет файл, из которого сделан вызов. Для скалярного результата режим определяется файлом, в котором объявлена функция. При строгом вызове передача строки '42' параметру int вызывает TypeError. Целое число можно передать параметру float даже в строгом режиме.

PHP
<?php
declare(strict_types=1);

function minutesToSeconds(int $minutes): int
{
    return $minutes * 60;
}

$raw = '15'; // Например, значение из формы.
$minutes = filter_var($raw, FILTER_VALIDATE_INT);
if ($minutes !== false) {
    echo minutesToSeconds($minutes); // 900
}

Строгое сравнение с false сохраняет допустимое значение 0. Тип int сам по себе допускает отрицательные числа. Если предметная область требует неотрицательного значения, проверьте диапазон отдельно. Для колбэков, которые вызывает сама встроенная функция PHP, например array_map(), объявление строгого режима в вашем файле не гарантирует строгую проверку скалярных аргументов этого внутреннего вызова.

return в PHP: результат и ранний выход

return $value; завершает выполнение функции и передаёт значение вызывающему коду. Если функция без объявленного типа результата дошла до конца, вызов вернёт null. При объявленном типе ?string допустимы return 'текст'; и return null;. Если функция с таким типом дойдёт до конца без return, PHP выбросит TypeError.

PHP
<?php
declare(strict_types=1);

function findLabel(array $labels, int $id): ?string
{
    if (!isset($labels[$id])) {
        return null; // Запись отсутствует или её значение равно null.
    }

    return $labels[$id]; // Ожидается строка.
}

echo findLabel([10 => 'Черновик'], 20) ?? 'Без метки'; // Без метки
  • void подходит для функций, которые выполняют действие без полезного результата. Используйте return; для раннего выхода или дойдите до конца тела. return null; в такой функции вызовет ошибку.
  • never означает, что управление не вернётся к вызывающему коду. Например, функция всегда выбрасывает исключение. Дойти до конца её тела без исключения или завершения программы нельзя.
  • echo выводит данные, а return отдаёт результат для дальнейшей работы. Если результат нужно проверить, записать или преобразовать, возвращайте его и выбирайте место вывода в вызывающем коде.

Область видимости в PHP: global и static

global связывает переменную с глобальной областью

Параметры и переменные внутри функции локальны. global $taxRate; связывает локальное имя с одноимённой переменной в глобальной области. Присваивание через это имя меняет глобальную переменную. К ней также можно обратиться через $GLOBALS['taxRate']. Суперглобальные массивы, например $_GET, доступны внутри функций без global.

PHP
<?php
declare(strict_types=1);

$taxRate = 0.2;

function taxFor(int $amount): float
{
    global $taxRate;
    return $amount * $taxRate;
}

echo taxFor(100); // 20

Результат этого примера зависит от текущего значения $taxRate и порядка инициализации. Если ставка является входом расчёта, объявите function taxFor(int $amount, float $taxRate): float и передавайте её явно. Так один и тот же расчёт можно вызвать с разными ставками в рамках одного запроса.

Локальная переменная static хранит значение между вызовами

PHP
<?php
declare(strict_types=1);

function nextNumber(): int
{
    static $number = 0;
    return ++$number;
}

echo nextNumber(), ' ', nextNumber(); // 1 2

$number доступна только внутри функции. В обычном веб-приложении следующий HTTP-запрос начнёт отсчёт заново. В долгоживущем воркере значение может сохраняться между заданиями, поэтому статическая переменная с данными одного задания способна повлиять на другое. В объявлении метода класса static имеет другой смысл: метод можно вызвать через класс без экземпляра.

Замыкания в PHP: function и захват через use

Анонимная функция создаёт объект Closure. Его можно сохранить в переменную, вернуть из функции или передать как колбэк. В конструкции function (...) use (...) первые скобки содержат параметры вызова, вторые — имена переменных из области, где создаётся замыкание.

PHP
<?php
declare(strict_types=1);

$rate = 2;
$scale = static function (int $value) use ($rate): int {
    return $value * $rate;
};

$rate = 3;
echo $scale(10); // 20: захвачено значение 2.

use ($rate) захватывает значение на момент создания замыкания. Если захваченная переменная содержит объект, внешнее присваивание ей другого объекта оставит замыканию исходный объект. Изменение свойств исходного объекта будет видно через обе переменные. use (&$rate) связывает замыкание с самой внешней переменной, поэтому последующие присваивания будут видны и снаружи, и внутри.

PHP
<?php
declare(strict_types=1);

$total = 0;
$add = static function (int $amount) use (&$total): void {
    $total += $amount;
};

$add(40);
$add(10);
echo $total; // 50

Замыкание, созданное в контексте экземпляра, обычно получает доступ к $this. Объявление static function отключает эту привязку. Выбирайте его для колбэков, которым экземпляр не нужен. Явные захваты через use при этом работают как обычно.

Стрелочные функции fn и отличия PHP 8.3–8.5

Стрелочная функция вычисляет одно выражение и возвращает его результат. Внешние переменные, использованные в выражении, захватываются автоматически по значению. Типы параметров и результата объявляются так же, как у обычного замыкания. Когда колбэку нужны несколько операторов, ранние выходы или изменение внешней скалярной переменной по ссылке, используйте function с блоком.

PHP
<?php
declare(strict_types=1);

$fee = 20;
$prices = [100, 250, 500];
$withFee = array_map(
    static fn (int $price): int => $price + $fee,
    $prices,
);

print_r($withFee); // [120, 270, 520]

Чтобы передать уже существующую функцию в качестве вызываемого объекта, можно использовать синтаксис trim(...). Например, array_map(trim(...), [' a ', ' b ']) вернёт массив ['a', 'b']. При создании trim(...) сама функция ещё не выполняется.

ВерсияЧто учитывать
PHP 8.3Локальные static-переменные можно инициализировать выражением с вызовом функции, например static $startedAt = time();. Инициализация происходит при первом выполнении объявления.
PHP 8.4Неявно допускающие null параметры устарели. Вместо string $name = null пишите ?string $name = null или string|null $name = null. В обеих формах значение по умолчанию позволяет опустить аргумент.
PHP 8.5Добавлен оператор конвейера |>. Выражение $input |> trim(...) |> strtolower(...) последовательно передаёт строку в две функции. Для совместимости с PHP 8.3 и 8.4 используйте strtolower(trim($input)).

Чек-лист для объявления и вызова функций

  1. Укажите типы параметров и результата. Проверьте, включён ли strict_types в файлах, из которых вызывается функция.
  2. Проверьте входные данные до вызова. Для числовых параметров отдельно учитывайте формат, диапазон и допустимость нуля.
  3. Поставьте обязательные параметры первыми. При изменении сигнатуры проверьте именованные вызовы и распаковку массивов со строковыми ключами.
  4. Проследите все пути выполнения. Для ?T верните значение или явный null, для void используйте выход без значения, для never гарантируйте прекращение выполнения.
  5. Передавайте зависимости параметрами. Если используете global, локальный static или захват по ссылке, проверьте, кто может менять состояние и сколько оно живёт.
  6. Используйте fn для одного выражения, function ... use для колбэка с телом из нескольких операторов и имя_функции(...) для передачи готовой функции.

Частые вопросы

Что вернёт функция PHP без return?

Функция без объявленного типа результата вернёт null, если выполнение дошло до конца тела. Если объявлен тип вроде int или ?string, достижение конца тела вызовет TypeError. Для ?string укажите return null явно.

Чем function use отличается от стрелочной функции fn?

В function внешние переменные перечисляют в use и выбирают захват по значению или по ссылке. fn автоматически захватывает использованные внешние переменные по значению и возвращает результат одного выражения.

В чём разница между global и static внутри функции PHP?

global связывает имя внутри функции с переменной в глобальной области. Локальная static-переменная принадлежит функции и сохраняет значение между её вызовами в рамках текущего выполнения программы.

Справка по теме

Ещё в разделе «Справочник PHP»

Хеширование паролей в PHP: password_hash, password_verify, md5 и hash

Как хешировать и проверять пароли в PHP 8.3–8.5, обновлять старые хеши при входе и выбирать между password_hash(), md5(), hash() и hash_hmac() для разных задач.

9 мин

Циклы в PHP: for, while, do-while и foreach

Как работают циклы for, while, do-while и foreach в PHP 8.3–8.5. Примеры обхода массивов, вложенных циклов и применения break и continue.

10 мин

Что нового в PHP 8.x: от 8.0 до 8.5

Разбираем, что изменилось в PHP 8.0–8.5: типы, enum, readonly, хуки свойств и оператор pipe. Примеры кода, ошибки совместимости и чек-лист обновления.

9 мин

Composer: установка, composer.json и управление зависимостями

Как установить Composer для PHP 8.3–8.5, настроить composer.json и автозагрузку PSR-4, обновлять зависимости и устранять конфликты версий.

8 мин