php-conventions
php-conventions copied to clipboard
3.5. Именование методов
Названия методов ДОЛЖНЫ описывать предназначение их использования внешним кодом, а не детали реализации.
// Не правильно
public function findUserById(int $id): ?User
// Правильно
public function find(int $id): ?User
Первый вариант описывает реализацию, в отличии от второго. И название метода дублирует аргумент и возвращаемое значение. Масло масленное.
Мне самому этот пункт не очень нравится, я его подкорректирую