PHP: Функции
2026-02-26 22:47 Diff
https://ru.hexlet.io/courses/php-functions/lessons/named-parameters/theory_unit

Существует несколько методов передачи данных в функции, и одним из базовых является использование позиционных параметров.

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

Например, возьмем следующую функцию:

Когда мы вызываем эту функцию с фактическими параметрами, например, add(10, 20), параметр $x получает значение 10, а параметр $y — значение 20.

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

Например, рассмотрим следующую функцию:

У функции calculate() три параметра: основное значение ($base), значение, что вычитается и значение, на которое происходит умножение. При вызове этой функции, например calculate(10, 3, 2), может быть неочевидно сразу, где какой параметр, ведь их несколько и они одного, числового, типа

В таком случае мы можем вызвать функцию с именованными параметрами, чтобы явно указать, какое значение должно быть подставлено в соответствующий параметр функции.

Чтобы передать именованные параметры в функцию, нужно указать их имена, которые были заданы при объявлении функции. Для этого используется синтаксис имя_параметра: значение. В самом определении функции при этом ничего не меняется

В этом случае PHP будет знать, что значение 10 должно быть подставлено в параметр $base, значение 3 — в параметр $sub, а значение 2 — в параметр $mul

Порядок передачи именованных параметров уже не важен. Например, мы можем вызвать нашу функцию так:

И PHP все равно подставит правильные значения в соответствующие параметры.

Нет строгих правил, по которым используются именованные параметры. Однако широко практикуется такой подход: если функция принимает больше трех параметров, желательно хотя бы часть из них указать по имени. Важно именовать значения параметров, если несколько значений имеют одинаковый тип. В другом случае будет трудно понять, что делает функция с подобным вызовом:

Сравните с этим:

Такой код читать значительно проще

Значения параметров по умолчанию

В некоторых случаях параметры функции могут иметь значения по умолчанию. Например, функция json_decode(), которая преобразует строку в формате JSON в PHP значение, имеет несколько параметров со значениями по умолчанию:

Предположим, при ее вызове нам обязательно нужно установить для параметра $flags значение JSON_THROW_ON_ERROR, чтобы при ошибках преобразования выбрасывалось исключение. Но все остальные необязательные параметры нам устанавливать не нужно. С использованием позиционных аргументов вызов функции выглядел бы так:

Одним из преимуществ именованных аргументов является возможность пропускать при вызове функции параметры, которые имеют значения по умолчанию. Это позволяет вызывать функции, указывая только те параметры, которые нам действительно нужны, и игнорируя остальные. Сравните, как будет выглядеть вызов этой функции с использованием именованных параметров:

Именованные аргументы сделали вызов функции более читаемым и лаконичным

Сочетание позиционных и именованных параметров

Мы можем сочетать позиционные и именованные параметры при вызове функции. Главное правило здесь — именованные аргументы должны идти после позиционных. Это позволяет нам передавать обязательные параметры в правильном порядке, а затем указывать значения для необязательных параметров с помощью их имен.

Например, в функции json_decode() первый параметр, строка JSON, обязательный, а все остальные — нет. Мы можем вызвать функцию так:

Мы передали обязательный параметр первым, как позиционный, а затем указали только необходимые нам необязательные параметры по имени

Выводы

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

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