Обязательные аргументы функций языка PHP

Расширенные примеры с обязательными параметрами

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

Пример 1: Обязательные параметры с разными типами и проверка на ошибки

<?php
function createProfile(string $username, string $email, int $age) {
    return "Профиль: $username, $email, возраст $age";
}
// Корректный вызов
echo createProfile('ivan_p', 'ivan@example.com', 25);
// Ошибочный вызов - пропущен $age
// echo createProfile('ivan_p', 'ivan@example.com'); // ArgumentCountError
?>

Профиль: ivan_p, ivan@example.com, возраст 25

В этом примере все три параметра обязательны. Если забыть передать возраст, PHP немедленно сообщит об ошибке, предотвращая некорректную работу функции.

Пример 2: Строгая типизация и сообщение об ошибке типа

<?php
declare(strict_types=1);
function setDiscount(float $discount) {
    echo "Скидка: $discount%";
}
setDiscount(15.5); // OK
// setDiscount('15.5'); // TypeError
?>

Скидка: 15.5%

При включённом строгом режиме передача строки вместо float вызывает TypeError, что делает тип параметра частью его обязательности.

Пример 3: Именованные аргументы и пропуск необязательных параметров

<?php
function configure(string $host, int $port = 8080, string $protocol = 'http') {
    echo "Подключение к $protocol://$host:$port";
}
// Обязательный $host, остальные необязательные
configure(host: 'localhost', protocol: 'https'); // порт по умолчанию 8080
// configure(port: 3306); // ArgumentCountError - нет обязательного $host
?>

Подключение к https://localhost:8080

Именованные аргументы позволяют передавать только обязательные и нужные необязательные параметры, но обязательный $host в любом случае должен быть указан.

Пример 4: Вариадические параметры после обязательных

<?php
function formatList(string $prefix, string ...$items): string {
    $result = $prefix;
    foreach ($items as $item) {
        $result .= " [$item]";
    }
    return $result;
}
echo formatList('Список:', 'A', 'B', 'C');
echo "\n";
echo formatList('Только префикс:'); // без элементов
?>

Список: [A] [B] [C]
Только префикс:

Первый параметр $prefix обязателен, остальные собираются в массив. Если передать ноль дополнительных аргументов - это допустимо, так как вариадический параметр не является обязательным.

Пример 5: Проверка количества аргументов через func_num_args (не рекомендуется)

<?php
function oldSchool($a, $b) {
    if (func_num_args() !== 2) {
        throw new InvalidArgumentException('Требуется ровно 2 аргумента');
    }
    return $a + $b;
}
try {
    echo oldSchool(3, 4); // 7
    echo oldSchool(3);    // исключение
} catch (Throwable $e) {
    echo 'Ошибка: ' . $e->getMessage();
}
?>

7
Ошибка: Требуется ровно 2 аргумента

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

Пример 6: Обязательные параметры в методах классов с интерфейсами

<?php
interface LoggerInterface {
    public function log(string $level, string $message): void;
}
class FileLogger implements LoggerInterface {
    public function log(string $level, string $message): void {
        echo "[$level] $message";
    }
}
$logger = new FileLogger();
$logger->log('INFO', 'Система запущена');
// $logger->log('INFO'); // ArgumentCountError
?>

[INFO] Система запущена

Интерфейс гарантирует, что любой логгер будет иметь обязательные параметры $level и $message. Это повышает надёжность архитектуры.