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

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

PHP підтримує передачу аргументів за значенням (за умовчанням), передачу аргументів за посиланням, изначення за замовчуванням. . Списки аргументів змінної довжини і іменовані аргументитакже поддерживаются.

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

Loading...
▶

Починаючи з PHP 8.0.0, список аргументів функції може містити завершальну кому, яка буде проігнорована. Це корисно у випадку, коли список аргументів дуже довгий, або якщо імена змінних довжини, що підштовхує до їхнього вертикального розташування.

Приклад #2 Список аргументів функції завершальної коми

Loading...
▶

Передача аргументів за посиланням

За умовчанням аргументи в функцію передаються за значенням (це означає, що якщо ви зміните значення аргументу всередині функції, то поза її значенням все одно залишиться колишнім). Якщо ви хочете дозволити функції модифікувати свої аргументи, ви повинні надсилати їх за посиланням.

Якщо ви бажаєте, щоб аргумент завжди передавався за посиланням, ви можете вказати амперсанд (&) перед ім'ям аргументу в описі функції:

Приклад #3 Передача аргументів за посиланням

Loading...
▶

Передача значення як аргумент, який має передаватися за посиланням, є помилкою.

Значення аргументів за умовчанням

Функція може визначати значення за промовчанням для аргументів, використовуючи синтаксис, подібний до присвоєння змінної. Значення за промовчанням використовується лише в тому випадку, якщо параметр не вказано; зокрема, зверніть увагу, що передача null неприсваивает значение по умолчанию.

Приклад #4 Використання значень за умовчанням для визначення функції

Loading...
▶

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

Готовим чашку капучино.
Готовим чашку .
Готовим чашку эспрессо.

Значення параметрів за замовчуванням можуть бути скалярні значення, масиви (array), спеціальний тип null, і, починаючи з версії PHP 8.1.0, об'єкти, які використовують синтаксис new ClassName()

Приклад #5 Використання нескалярних типів як значень за замовчуванням

Loading...
▶

Приклад #6 Використання об'єктів як значень за замовчуванням (починаючи з PHP 8.1.0)

Loading...
▶

Значення за умовчанням має бути константним виразом, а чи не (наприклад) змінної чи викликом функції/методу класу.

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

Приклад #7 Некоректне використання значень за замовчуванням

Loading...
▶

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

Fatal error: Uncaught ArgumentCountError: Too few arguments
to function makeyogurt(), 1 passed in example.php on line 42

Тепер порівняємо його з наступним прикладом:

Приклад #8 Коректне використання значень за замовчуванням

Loading...
▶

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

Делаем миску с малиновым йогуртом.

Починаючи з PHP 8.0.0, іменовані аргументи можна використовувати для пропуску кількох необов'язкових параметрів.

Приклад #9 Правильне використання аргументів за замовчуванням функцій

Loading...
▶

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

Делаем миску с малиновым натуральным йогуртом.

Починаючи з PHP 8.0.0, оголошення обов'язкових аргументів після необов'язкових аргументів є застарілим. Зазвичай це можна вирішити, відмовившись від значення за замовчуванням, оскільки воно ніколи не буде використовуватися. Винятком із цього правила є аргументи виду Type $param = null, где**null** за замовчуванням робить тип, що неявно обнулюється. Таке використання залишається допустимим, хоча рекомендується використовувати явний тип nullable

Приклад #10 Оголошення необов'язкових аргументів після обов'язкових аргументів

Loading...
▶

Зауваження: Починаючи з PHP 7.1.0, опущення параметра, не заданого за умовчанням, викидає виняток ArgumentCountError; у попередніх версіях це викликало попередження.

Зауваження: Значення за промовчанням можна надіслати за посиланням.

Списки аргументів змінної довжини

PHP підтримує списки аргументів змінної довжини для функцій, що визначаються користувачем за допомогою додавання крапки (...

Список аргументів може містити багатокрапку (...), щоб показати, що функція приймає змінну кількість аргументів. Аргументи в цьому випадку будуть передані у вигляді масиву:

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

Loading...
▶

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

10

Багатокрапка (...) можна використовувати під час виклику функції, щоб розпакувати масив (array) або Traversableпеременную в список аргументов:

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

Loading...
▶

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

3
3

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

Також можна додати оголошення типуперед.... У цьому випадку всі аргументи, оброблені трьома крапками (...), повинні відповідати цьому типу параметра.

Приклад #13 Аргументи з підказкою типу

Loading...
▶

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

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 8.0.0 як продовження позиційних параметрів з'явилися іменовані аргументи. З їхньою допомогою аргументи функції можна передавати на ім'я параметра, а чи не з його позиції. Таким чином аргумент стає самодокументованим, незалежним від порядку та зазначеного значення за умовчанням.

Іменовані аргументи передаються шляхом додавання через двокрапки імені параметра перед його значенням. Як імена параметрів можна використовувати зарезервовані ключові слова. Ім'я параметра має бути ідентифікатором, тобто. він не може бути створений динамічно.

Приклад #14 Синтаксис іменованого аргументу

Loading...
▶

Приклад #15 Позиційні аргументи проти іменованими аргументами

Loading...
▶

Порядок, у якому передаються іменовані аргументи, немає значення.

Приклад #16 Той самий приклад, як і вище, але з іншим порядком параметрів

Loading...
▶

Іменовані аргументи можна поєднувати з позиційними. У цьому випадку іменовані аргументи мають слідувати після позиційних аргументів. Також можна передати лише частину необов'язкових аргументів функції, незалежно від їх порядку.

Приклад #17 Об'єднання іменованих аргументів із позиційними аргументами

Loading...
▶

Передача одного і того ж параметра кілька разів призводить до викидання винятку Error.

Приклад #18 Помилка, що виникає при передачі одного і того ж параметра кілька разів

Loading...
▶

Починаючи з PHP 8.1.0 можна використовувати іменовані аргументи після розпакування аргументів. Іменований аргумент не повинен перевизначати вже розпакований аргумент.

Приклад #19 Приклад використання іменованих аргументів після розпакування

Loading...
▶