Как называть исключения?

Question

[Михаил]

Вот пример: есть контроллер с методом orderReport($dateStart, $dateEnd).
Хочется добавить проверку на то что дата начала не больше даты окончания, если это не так то выбросить исключение.

if ($dateTimeStart > $dateTimeEnd) {
    throw new InvalidArgumentException('Date start greater then date end.');
}

Не понятно как надо называть исключения:
в стиле описания ошибки
Date start is greater then date end.
или предупреждения об ошибке
Date start should be less then date end.

Кажется что в недрах кода лучше первый вариант, а второй - для пользователя.

Comments

[Lander]

Уверены что тут нужно исключение? Почему бы не делать проверку и если дата окончания меньше даты начала, то менять их местами? Это прям вот для пользователя будет!

[Михаил]

Lander, если бы программа разговаривала с пользователем, то ваше решение было бы как-никак кстати. В моем случае речь идет об параметрах страницы которые пользователь напрямую не пишет.
Я за предсказуемость поведения программы, поэтому и исключение.

Answer 1

[galliard]

Правильно писать предупреждение, то есть

Date start should be less then date end.

Так сразу понятно, в чем ошибка и как её исправить.

Во втором случае это может быть вообще не очевидно, например

Date start is greater then date end.

Ну ок. Одно число больше другого. А в чем ошибка? Разве не так должно быть? А как тогда? Они должны быть равны? Или остаток от деления одного на другое должен быть кратен 3м?

В общем вопросов остается много, а о правильном ответе остается лишь гадать.