С помощью параметров мы можем передавать в функцию некоторые данные. Параметры определяются в скобках после названия функции как обычные переменные, оделенные друг от друга запятой.
Например, создадим и вызовем функцию с одним параметром:
Здесь функция hello определяет один параметр — $name . При наименовании параметров применяются те же правила, что и для переменных. Также название параметров начинается со знака доллара $. Единственное, что не нужно указывать значение для параметра.
Внутри самой функции мы можем использовать параметр так же как обычные переменные. Например, в данном случае его значение выводится на веб-страницу:
В дальнейшем при вызове функции нам надо передать для параметра некоторое значение. Значения при вызове функции передаются в скобках, сколько функция определяет параметров, столько необходимо передать значений.
Так, в данном случае функция определяет один параметр, соответственно при вызове функции передается только одно значение. Однако при каждом вызове это может быть разное значение:
hello("Tom"); hello("Bob"); hello("Sam");
Результат работы программы:
Если мы не передадим значение для параметра: hello(); , то мы столкнемся с ошибкой.
В качестве значения в функцию может передаваться и значение переменной:
$userName = "Tom"; hello($userName);
Подобным образом можно определять функции и с большим количеством параметров:
Здесь функция displayInfo определяет два параметра, соответственно при вызове функции нам надо передать в функцию два значения. Значения отделяются запятой и передаются параметрам по позиции . Так, первое значение передается первому параметру, второе значение передается второму параметру и так далее. В итоге мы получим следующий результат:
Необязательные параметры
Выше при определении функции мы были обязаны передать для всех параметров функции значения. Например, если функция определяет два параметра, соответственно нам надо передать в ее вызов два значения. Однако, PHP позволяет сделать параметры необязательными. Такие параметры имеют значение по умолчанию, которое применяется, если при вызове функции не передано никакого значения.
Здесь параметр $age определяется как необязательный. Для этого ему присваивается начальное значение — число 18. Причем если функция содержит обязательные и необязательные параметры, то необязательные параметры должны определяться в конце (как в данном случае параметр $age ).
При первом вызове в функцию передаются два значения: displayInfo(«Tom», 36) , поэтому параметр $age получит второе значение — число 36.
Во втором вызове в функцию передается одно значение: displayInfo(«Sam») , поэтому параметр $age будет использовать значение по умолчанию — число 18.
Имя: Tom Возраст: 36 __________________________________________ Имя: Sam Возраст: 18 __________________________________________
Именнованные параметры
Начиная с версии 8.0 в PHP была добавлена поддержка именнованных параметров . Так, до PHP 8.0 при вызове функции значения можно было передать параметрам только по позиции . Именнованные параметры позволяют передавать значения параметрам по имени:
При вызове функции сначала указывается название параметра (без символа $) и через двоеточие указывается значение параметра : age: 23, name: «Bob» . И в этом случае нам необязательно соблюдать позицию параметров.
Можно сочетать передачу значений параметрам по имени и по позиции. При этом любые именованные необязательные параметры должны располагаться после НЕименованных параметров:
Переменное количество параметров
В PHP функция может принимать переменное количество параметров. Для этого у функции определяется один параметр, перед которым указывается оператор . (три точки). Такой параметр рассматривается как массив:
При обращении к подобной функции мы можем передавать в нее различное количество значений. Результат:
Но, допустим, готовый массив значений, которые мы хотим передать в функцию. Чтобы его передать в функцию, опять же применяется оператор . , который указывается перед переменной массива:
Если функция должна принимать и другие параметры, то параметр, который представляет переменное количество значений, указывается в конце после остальных параметров.
Например, определим функцию, которая принимает имя студента и неопределенное количество его баллов успеваемости и выводит средний балл:
Баллы успеваемости передаются через параметр $scores , который указывается в конце списка параметров. В самой функции для вычисления среднего балла все баллы складываются и делятся на их количество. Количество элементов массива можно подсчитать с помощью встроенной в PHP функции count() , в которую передается массив.
Passing an Array as Arguments, not an Array, in PHP
I seem to remember that in PHP there is a way to pass an array as a list of arguments for a function, dereferencing the array into the standard func($arg1, $arg2) manner. But now I’m lost on how to do it. I recall the manner of passing by reference, how to «glob» incoming parameters . but not how to de-list the array into a list of arguments. It may be as simple as func(&$myArgs) , but I’m pretty sure that isn’t it. But, sadly, the php.net manual hasn’t divulged anything so far. Not that I’ve had to use this particular feature for the last year or so.
4 Answers 4
As has been mentioned, as of PHP 5.6+ you can (should!) use the . token (aka «splat operator», part of the variadic functions functionality) to easily call a function with an array of arguments:
function variadic($arg1, $arg2) < // Do stuff echo $arg1.' '.$arg2; >$array = ['Hello', 'World']; // 'Splat' the $array in the function call variadic(. $array); // => 'Hello World'
NB: Indexed array items are mapped to arguments by their position in the array, not their keys.
As of PHP8, and thanks to named arguments, it’s possible to use the named keys of an associative array with unpacking:
As per CarlosCarucce’s comment, this form of argument unpacking is the fastest method by far in all cases. In some comparisons, it’s over 5x faster than call_user_func_array .
Aside
Because I think this is really useful (though not directly related to the question): you can type-hint the splat operator parameter in your function definition to make sure all of the passed values match a specific type.
(Just remember that doing this it MUST be the last parameter you define and that it bundles all parameters passed to the function into the array.)
This is great for making sure an array contains items of a specific type:
// Define the function. function variadic($var, SomeClass . $items) < // $items will be an array of objects of type `SomeClass` >// Then you can call. variadic('Hello', new SomeClass, new SomeClass); // or even splat both ways $items = [ new SomeClass, new SomeClass, ]; variadic('Hello', . $items);
