Аргумент функции массив php
Функция может принимать информацию в виде списка аргументов, который является списком разделенных запятыми выражений. Аргументы вычисляются слева направо.
PHP поддерживает передачу аргументов по значению (по умолчанию), передачу аргументов по ссылке, и значения по умолчанию. Списки аргументов переменной длины также поддерживаются, смотрите также описания функций func_num_args() , func_get_arg() и func_get_args() для более детальной информации.
Пример #1 Передача массива в функцию
function takes_array ( $input )
echo » $input [ 0 ] + $input [ 1 ] = » , $input [ 0 ]+ $input [ 1 ];
>
?>
Начиная с PHP 8.0.0, список аргументов функции может содержать завершающую запятую, которая будет проигнорирована. Это полезно в случае, когда список аргументов очень длинный, либо если имена переменных длинны, что подталкивает к их вертикальному расположению.
Пример #2 Function Argument List with trailing Comma
function takes_many_args (
$first_arg ,
$second_arg ,
$a_very_long_argument_name ,
$arg_with_default = 5 ,
$again = ‘a default string’ , // Эта завершающая запятая допустима только начиная с 8.0.0.
)
// .
>
?>
Начиная с PHP 8.0.0, передача обязательных аргументов после необязательных аргументов устарела. Обычно это можно решить, отказавшись от значения по умолчанию. Единственным исключением из этого правила являются аргументы формы Type $param = null , где null по умолчанию делает тип неявно допускающим значение null. Это использование остается разрешенным, хотя вместо этого рекомендуется использовать явный тип, допускающий значение null.
Пример #3 Передача необязательных аргументов после обязательных аргументов
function foo ( $a = [], $b ) <> // Раньше
function foo ( $a , $b ) <> // Теперь
function bar ( A $a = null , $b ) <> // Все еще разрешено
function bar (? A $a , $b ) <> // Рекомендуется
?>
Передача аргументов по ссылке
По умолчанию аргументы в функцию передаются по значению (это означает, что если вы измените значение аргумента внутри функции, то вне ее значение все равно останется прежним). Если вы хотите разрешить функции модифицировать свои аргументы, вы должны передавать их по ссылке.
Если вы хотите, чтобы аргумент всегда передавался по ссылке, вы можете указать амперсанд (&) перед именем аргумента в описании функции:
Пример #4 Передача аргументов по ссылке
function add_some_extra (& $string )
$string .= ‘и кое-что еще.’ ;
>
$str = ‘Это строка, ‘ ;
add_some_extra ( $str );
echo $str ; // выведет ‘Это строка, и кое-что еще.’
?>
Ошибка передачи значения в качестве аргумента, которое должно передаваться по ссылке.
Значения аргументов по умолчанию
Функция может определять значения по умолчанию в стиле C++ для скалярных аргументов, например:
Пример #5 Использование значений по умолчанию в определении функции
function makecoffee ( $type = «капучино» )
return «Готовим чашку $type .\n» ;
>
echo makecoffee ();
echo makecoffee ( null );
echo makecoffee ( «эспрессо» );
?>
Результат выполнения данного примера:
Готовим чашку капучино. Готовим чашку . Готовим чашку эспрессо.
PHP также позволяет использовать массивы ( array ) и специальный тип null в качестве значений по умолчанию, например:
Пример #6 Использование нескалярных типов в качестве значений по умолчанию
function makecoffee ( $types = array( «капучино» ), $coffeeMaker = NULL )
$device = is_null ( $coffeeMaker ) ? «вручную» : $coffeeMaker ;
return «Готовлю чашку » . join ( «, » , $types ). » $device .\n» ;
>
echo makecoffee ();
echo makecoffee (array( «капучино» , «лавацца» ), «в чайнике» );
?>
Значение по умолчанию должно быть константным выражением, а не (к примеру) переменной или вызовом функции/метода класса.
Обратите внимание, что все аргументы, для которых установлены значения по умолчанию, должны находиться правее аргументов, для которых значения по умолчанию не заданы, в противном случае ваш код может работать не так, как вы этого ожидаете. Рассмотрим следующий пример:
Пример #7 Некорректное использование значений по умолчанию
function makeyogurt ( $type = «ацидофил» , $flavour )
return «Готовим чашку из бактерий $type со вкусом $flavour .\n» ;
>
echo makeyogurt ( «малины» ); // Не будет работать так, как мы могли бы ожидать
?>
Результат выполнения данного примера:
Warning: Missing argument 2 in call to makeyogurt() in /usr/local/etc/httpd/htdocs/phptest/functest.html on line 41 Готовим чашку из бактерий малины со вкусом .
Теперь сравним его со следующим примером:
Пример #8 Корректное использование значений по умолчанию
function makeyogurt ( $flavour , $type = «ацидофил» )
return «Готовим чашку из бактерий $type со вкусом $flavour .\n» ;
>
echo makeyogurt ( «малины» ); // отрабатывает правильно
?>
Результат выполнения данного примера:
Готовим чашку из бактерий ацидофил со вкусом малины.
Замечание: Значения по умолчанию могут быть переданы по ссылке.
Списки аргументов переменной длины
PHP поддерживает списки аргументов переменной длины для функций, определяемых пользователем с помощью добавления многоточия ( . ).
Замечание: Также можно добиться аргументов переменной длины, используя функции func_num_args() , func_get_arg() и func_get_args() . Этот метод не рекомендуется, поскольку он использовался до введения. токена . .
Список аргументов может содержать многоточие . , чтобы показать, что функция принимает переменное количество аргументов. Аргументы в этом случае будут переданы в виде массива. Например:
Пример #9 Использование . для доступа к аргументам
function sum (. $numbers ) $acc = 0 ;
foreach ( $numbers as $n ) $acc += $n ;
>
return $acc ;
>
Результат выполнения данного примера:
Многоточие ( . ) можно использовать при вызове функции, чтобы распаковать массив ( array ) или Traversable переменную в список аргументов:
Пример #10 Использование . для передачи аргументов
Результат выполнения данного примера:
Можно задать несколько аргументов в привычном виде, а затем добавить . . В этом случае . поместит в массив только те аргументы, которые не нашли соответствия указанным в объявлении функции.
Также можно добавить объявление типов перед . . В этом случае PHP будет следить, чтобы все аргументы обработанные многоточием ( . ) были того же типа, что указан в подсказке.
Пример #11 Аргументы с подсказкой типов
function total_intervals ( $unit , DateInterval . $intervals ) $time = 0 ;
foreach ( $intervals as $interval ) $time += $interval -> $unit ;
>
return $time ;
>
$a = new DateInterval ( ‘P1D’ );
$b = new DateInterval ( ‘P2D’ );
echo total_intervals ( ‘d’ , $a , $b ). ‘ days’ ;
// Это не сработает, т.к. null не является объектом DateInterval.
echo total_intervals ( ‘d’ , null );
?>
Результат выполнения данного примера:
3 days Catchable fatal error: Argument 2 passed to total_intervals() must be an instance of DateInterval, null given, called in - on line 14 and defined in - on line 2
В конце концов, можно передавать аргументы по ссылке. Для этого перед . нужно поставить амперсанд ( & ).
Предыдущие версии PHP
Для указания того, что функция принимает переменное число аргументов, никакой специальный синтаксис не используется. Для доступа к аргументам необходимо использовать функции func_num_args() , func_get_arg() и func_get_args() .
В первом примере выше было показано, как задать список аргументов переменной длины для предыдущих версий PHP:
Пример #12 Доступ к аргументам в предыдущих версиях PHP
function sum () $acc = 0 ;
foreach ( func_get_args () as $n ) $acc += $n ;
>
return $acc ;
>
Результат выполнения данного примера:
Аргумент функции массив php
To experiment on performance of pass-by-reference and pass-by-value, I used this script. Conclusions are below.
#!/usr/bin/php
function sum ( $array , $max ) < //For Reference, use: "&$array"
$sum = 0 ;
for ( $i = 0 ; $i < 2 ; $i ++)#$array[$i]++; //Uncomment this line to modify the array within the function.
$sum += $array [ $i ];
>
return ( $sum );
>
$max = 1E7 //10 M data points.
$data = range ( 0 , $max , 1 );
$start = microtime ( true );
for ( $x = 0 ; $x < 100 ; $x ++)$sum = sum ( $data , $max );
>
$end = microtime ( true );
echo «Time: » .( $end — $start ). » s\n» ;
/* Run times:
# PASS BY MODIFIED? Time
— ——- ——— —-
1 value no 56 us
2 reference no 58 us
3 valuue yes 129 s
4 reference yes 66 us
1. PHP is already smart about zero-copy / copy-on-write. A function call does NOT copy the data unless it needs to; the data is
only copied on write. That’s why #1 and #2 take similar times, whereas #3 takes 2 million times longer than #4.
[You never need to use &$array to ask the compiler to do a zero-copy optimisation; it can work that out for itself.]
2. You do use &$array to tell the compiler «it is OK for the function to over-write my argument in place, I don’t need the original
any more.» This can make a huge difference to performance when we have large amounts of memory to copy.
(This is the only way it is done in C, arrays are always passed as pointers)
3. The other use of & is as a way to specify where data should be *returned*. (e.g. as used by exec() ).
(This is a C-like way of passing pointers for outputs, whereas PHP functions normally return complex types, or multiple answers
in an array)
5. Sometimes, pass by reference could be at the choice of the caller, NOT the function definitition. PHP doesn’t allow it, but it
would be meaningful for the caller to decide to pass data in as a reference. i.e. «I’m done with the variable, it’s OK to stomp
on it in memory».
*/
?>