Использование null значений в методах PHP21.10.2023 11:45

В этом случае аргументы функции передаются по имени параметра, а не по его позиции. Аргумент не зависит от порядка и указанного значения по умолчанию. Именованный аргумент передаётся с помощью добавления двоеточия перед значением имени параметра. Для имени параметра можно использовать зарезервированные слова. Однако имя не может быть создано динамически и должно быть идентификатором.

Возврат null из метода

Обычно из функции возвращают false, если что-то пошло не так. Аналогичное делают и стандартные функции PHP. Для этих же целей возвращают NULL, пустую строку, пустой массив или вообще ничего. В общем, у каждого свой поход и причины возвращать то или иное значение. Многие даже как-то не сильно об этом задумываются. Однако в некоторых случаях, возврат NULL как и возврат других значений, которые изначально не подразумевались для возврата, могут приводить к ошибкам и непонятным замешательствам. Здесь конечно же серьёзную роль играет сам PHP, поскольку типы данных в нём слабо типизированы и мы можем вертеть данными как угодно.

К примеру, возьмем такой метод:

mysqli—>query($query);

  if ($result) {
    return false;
  }

  $data = [];

  while ($row = $result->fetch_assoc())
  {
    $data[] = $row;
  }


  return $data;
}

В нём мы собираемся получить список клиентов из базы данных. Если клиенты успешно получены, мы возвращаем массив, а если что-то пошло не так, то метод возвращает false. Затем мы используем данный метод, чтобы далее проводить операции с клиентами:

getClients();

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

getClients();

if (!$result) {
// что-то произошло не так
}
// работаем с массивом клиентов

В этом примере идёт неявная проверка данных, поэтому даже если функция getClients () возвращает пустой массив, то условие сработает. Поэтому лучше проверять на конкретный тип данных:

getClients();

if ($result === false) {
// что-то произошло не так
}

if (count($result) === 0) {
 // пустой результат
}

// а если не false и array не пустой, то работаем с массивом клиентов

Если мы используем вместо false другое значение, пустую строку или NULL, то ситуация может возникнуть практически такая же. Как в таком случае лучше изменить код и что использовать?

Вместо возврата false, пустой строки или NULL можно использовать исключения. Это позволит сразу же определить, что именно и на каком моменте произошло.

mysqli—>query($query);

  if ($result) {
    throw new ErrorException('Произошла такая-то ошибка');
  }

  $data = [];

  while ($row = $result->fetch_assoc())
  {
    $data[] = $row;
  }


  return $data;
}

Затем при использовании метода обработать это исключение:

getClients();
  // все норм, двигаемся дальше
} catch (ErrorException $e) {
  // схватили ошибку!
}

Здесь уже не нужно дополнительно проверять на всякие false или NULL и можно быть точно уверенным, почему метод не отдал правильные данные. Важно лишь правильно перехватывать и обрабатывать такие исключения.

exists()) {
    return null;
  }
  return $file—>getLength();
}

В этом простом примере метод возвращает размер файла. Если файла не существует, то возвращается NULL, 0 или пустая строка — неважно. Вот здесь и начинается проблема, что файла не существует, он был перемещён или удалён, но вместо того чтобы узнать об этом, подобная проверка маскирует проблему. В этом случае можно использовать исключение:

exists()) {
     throw new Exception(
      "Нельзя получить размер файла. Файл не найден!"
    );
  }
  return $file—>getLength();
}

Начиная с PHP7 для функций можно установить тип возвращаемого значения. Например:

int(777)

int(777)

declare(strict_types=1);