Как вывести аргумент функции php

PHP: Параметры и аргументы функции

Аргументы и параметры

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

Что такое параметры мы рассмотрели, теперь узнаем о том, какими значениями они инициализируются. Значения, которые будут присвоены параметрам называются аргументами — это может быть например строковой или целочисленный литерал, переменная или какое-нибудь более сложное выражение состоящее из переменных и операторов, но которое может быть вычислено интерпретатором PHP для получения значения, которым будет инициализирован параметр. Проще говоря, аргумент — это переданное функции значение:

Передача аргументов

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

По умолчанию аргументы передаются в функцию по значению (это значит, если вы измените значение параметра внутри функции, то вне ее переданное значение останется прежним):

Если необходимо разрешить функции изменять переданные аргументы за ее пределами, вы должны передавать их по ссылке. Для того, чтобы аргумент был передан по ссылке, необходимо указать знак & (амперсанд) перед именем параметра в определении функции:

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

Значение, возвращаемое функцией

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

Оператор return может быть расположен в любом месте функции. Когда до него доходит управление, функция возвращает значение (если указано) и завершает свое выполнение. Если оператор return не указан или не указано возвращаемое значение, то функция вернет значение NULL . Для использования возвращаемого значения, результат выполнения функции можно присвоить к примеру переменной:

Источник

Аргументы функции

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

PHP поддерживает передачу аргументов по значению (по умолчанию), передачу аргументов по ссылке, и значения по умолчанию. Списки аргументов переменной длины также поддерживаются, смотрите также описания функций func_num_args() , func_get_arg() и func_get_args() для более детальной информации.

Пример #1 Передача массива в функцию

Передача аргументов по ссылке

По умолчанию аргументы в функцию передаются по значению (это означает, что если вы измените значение аргумента внутри функции, то вне ее значение все равно останется прежним). Если вы хотите разрешить функции модифицировать свои аргументы, вы должны передавать их по ссылке.

Если вы хотите, что бы аргумент всегда передавался по ссылке, вы можете указать амперсанд (&) перед именем аргумента в описании функции:

Пример #2 Передача аргументов по ссылке

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

Функция может определять значения по умолчанию в стиле C++ для скалярных аргументов, например:

Пример #3 Использование значений по умолчанию в определении функции

Результат выполнения данного примера:

PHP также позволяет использовать массивы ( array ) и специальный тип NULL в качестве значений по умолчанию, например:

Пример #4 Использование нескалярных типов в качестве значений по умолчанию

Значение по умолчанию должно быть константным выражением, а не (к примеру) переменной или вызовом функции/метода класса.

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

Пример #5 Некорректное использование значений по умолчанию

function makeyogurt ( $type = «ацидофил» , $flavour )
<
return «Готовим чашку из бактерий $type со вкусом $flavour .\n» ;
>

echo makeyogurt ( «малины» ); // Не будет работать так, как мы могли бы ожидать
?>

Результат выполнения данного примера:

Теперь сравним его со следующим примером:

Пример #6 Корректное использование значений по умолчанию

function makeyogurt ( $flavour , $type = «ацидофил» )
<
return «Готовим чашку из бактерий $type со вкусом $flavour .\n» ;
>

echo makeyogurt ( «малины» ); // отрабатывает правильно
?>

Результат выполнения данного примера:

Замечание: Начиная с PHP 5, значения по умолчанию могут быть переданны по ссылке.

Объявление типов

Объявление типов также известно, как подсказки для типов в PHP 5.

Объявления типов позволяют функциям строго задавать тип передаваемых параметров. Передача в функцию значений несоответствующего типа будет приводить к ошибке: в PHP 5 это будет обрабатываемая фатальная ошибка, а в PHP 7 будет выбрасываться исключение TypeError.

Чтобы объявить тип агрумента, необходимо перед его именем добавить имя требуемого типа. Также можно объявить тип NULL , чтобы указать, что значением по умолчанию аргумента является NULL .

Valid types

Тип	Описание	Минимальная версия PHP
Имя класса/интерфейса	Агрумент должен быть instanceof, что и имя класса или интерфейса.	PHP 5.0.0
array	Аргумент должен быть типа array .	PHP 5.1.0
callable	Аргумент должен быть корректным callable типом.	PHP 5.4.0
bool	Аргумент должен быть типа boolean .	PHP 7.0.0
float	Аргумент должен быть float типа.	PHP 7.0.0
int	Аргумент должен быть типа integer .	PHP 7.0.0
string	Аргумент должен иметь тип string .	PHP 7.0.0

Примеры

Пример #7 Основные объявления типов-классов

class C <>
class D extends C <>

// Это не является расширением класса C.
class E <>

function f ( C $c ) <
echo get_class ( $c ). «\n» ;
>

f (new C );
f (new D );
f (new E );
?>

Результат выполнения данного примера:

Пример #8 Основные объявления типов-интерфейсов

// Это не реализует интерфейс I.
class E <>

function f ( I $i ) <
echo get_class ( $i ). «\n» ;
>

Результат выполнения данного примера:

Пример #9 Объявление типа Null

function f ( C $c = null ) <
var_dump ( $c );
>

Результат выполнения данного примера:

Строгая типизация

По умолчанию, PHP будет пытаться привести значения несоответствующих типов к скалярному типу, если это возможно. Например, если в функцию передается integer , а тип аргумента объявлен string , в итоге функция получит преобразованное string значение.

Для отдельных файлов можно включать режим строгой типизации. В этом режиме в функцию можно передавать значения только тех типов, которые объявлены для аргументов. В противном случае будет выбрасываться исключение TypeError. Есть лишь одно исключение — integer можно передать в функцию, которая ожидает значение типа float .

Для влючения режима строгой типизации используется выражение declare в объявлении strict_types:

Включение режима строгой типизации также повлияет на объявления типов возвращаемых значений.

Режим строгой типизации распространяется на вызовы функций совершенные из файла, в котором этот режим включен, а не на функции, которые в этом файле объявлены. Если файл без строгой типизации вызывает функцию, которая объявлена в файле с включенным режимом, значения аргументов будут приведены к нужным типам и ошибок не последует.

Строгая типизация применима только к скалярным типам и работает только в PHP 7.0.0 и выше. Равно как и сами объявления скалярных типов добавлены в этой версии.

Пример #10 Строгая типизация

declare( strict_types = 1 );

function sum ( int $a , int $b ) <
return $a + $b ;
>

var_dump ( sum ( 1 , 2 ));
var_dump ( sum ( 1.5 , 2.5 ));
?>

Результат выполнения данного примера:

Пример #11 Слабая типизация

function sum ( int $a , int $b ) <
return $a + $b ;
>

var_dump ( sum ( 1 , 2 ));

// These will be coerced to integers: note the output below!
var_dump ( sum ( 1.5 , 2.5 ));
?>

Результат выполнения данного примера:

Пример #12 Обработка исключения TypeError

declare( strict_types = 1 );

function sum ( int $a , int $b ) <
return $a + $b ;
>

try <
var_dump ( sum ( 1 , 2 ));
var_dump ( sum ( 1.5 , 2.5 ));
> catch ( TypeError $e ) <
echo ‘Error: ‘ . $e -> getMessage ();
>
?>

Результат выполнения данного примера:

Списки аргументов переменной длины

PHP поддерживает списки аргументов переменной длины для функций, определяемых пользователем. Для версий PHP 5.6 и выше это делается добавлением многоточия (. ). Для версий 5.5 и старше используются функции func_num_args() , func_get_arg() и func_get_args() .

. в PHP 5.6+

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

Пример #13 Использование . для доступа к аргументам

function sum (. $numbers ) <
$acc = 0 ;
foreach ( $numbers as $n ) <
$acc += $n ;
>
return $acc ;
>

echo sum ( 1 , 2 , 3 , 4 );
?>

Результат выполнения данного примера:

Многоточие (. ) можно использовать при вызове функции, чтобы распаковать массив ( array ) или Traversable переменную в список аргументов:

Пример #14 Использование . для передачи аргументов

function add ( $a , $b ) <
return $a + $b ;
>

echo add (. [ 1 , 2 ]). «\n» ;

Результат выполнения данного примера:

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

Также можно добавить подсказку типа перед . . В этом случае PHP будет следить, чтобы все аргументы обработанные многоточием (. ) были того же типа, что указан в подсказке.

Пример #15 Аргументы с подсказкой типов

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’ ;

// This will fail, since null isn’t a DateInterval object.
echo total_intervals ( ‘d’ , null );
?>

Результат выполнения данного примера:

В конце концов, можно передавать аргументы по ссылке. Для этого перед . нужно поставить амперсанд (&).

Предыдущие версии PHP

Для указания того, что функция принимает переменное число аргументов, никакой специальный синтаксис не используется. Для доступа к аргументам необходимо использовать функции func_num_args() , func_get_arg() и func_get_args() .

В первом примере выше было показано, как задать список аргументов переменной длины для версий PHP 5.5 и более ранних:

Пример #16 Доступ к аргументам в PHP 5.5 и ранних версий

function sum () <
$acc = 0 ;
foreach ( func_get_args () as $n ) <
$acc += $n ;
>
return $acc ;
>

Источник

Функции в PHP

Если говорить простым языком, то функция — это блок кода, который может быть именован и вызван повторно. Иногда функцию ещё называют подпрограммой. Мы привыкли, что обычной переменной можно присвоить число, строку или массив, а затем получить его обратно, обратившись к значению по имени переменной. Функции устроены похожим образом. Это тоже своего рода переменная, только вместо строки или числа в ней хранится блок кода, который вызывается при использовании этой «переменной».

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

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

Разделяют два типа функций — встроенные и пользовательские.

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

Одна из таких, уже очень хорошо знакомых нам функций — это функция, которая выводит переданный ей текст на экран — print()

Пользовательские функции программист создает самостоятельно. Эти функции, как правило, используются только внутри одного проекта или, даже, сценария.

Анатомия функций

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

Пояснить все составные части функции проще всего на примере.
Допустим, на своём сайте мы хотим показывать, является ли выбранный пользователем год високосным. Для этого напишем функцию, в которую передаётся год. В результате работы функции мы хотим получить значение «истина», если год високосный, и «ложь» — если нет.
Определение такой функции:

Пример использования функции:

Потренироваться использовать функции в PHP можно в этом тренажёре.

Аргументы функции и область видимости

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

Аргументы функции — это переменные, которые функция может получить из внешнего кода. В примере с is_leap_year такая переменная была только одна — $year .

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

В отличие от аргументов, которых может быть несколько, вернуть во внешний код функция может только одно значение — с помощью инструкции «return» (возврат). Возвращаемое значение называют результатом работы функции.

Источник