Денди-код | Laravel Russian Community

Денди-код

Руководство о том, как писать код с аккуратностью, уважением к читателю и стилем — даже если вы новичок.

// Плохо ❌
public function hasAccess(User $user): bool {
    if (!$user->isBanned()) {
        if ($user->isAdmin()) {
            return true;
        } else {
            if ($user->isGranted(GRANT::EDIT)) {
                return true;
            } else {
                return false;
            }
            return false;
        }
    } else {
        return false;
    }
}

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

Для опытных разработчиков, уставших от беспорядка и стремящихся к порядку и эффективности.

Для руководителей и тимлидов, желающих донести до команды важность стиля и общих правил.

Ты ведь и сам знаешь, как тяжело читать запутанный, неряшливый код

Наверняка в школе у вас были тетрадки в клетку и в линейку — для каждого предмета свои. На уроках математики вы аккуратно писали «2 + 2 = 4», размещая каждый знак в отдельной клетке. Оставляли пару строк между задачами, чтобы всё выглядело опрятно и не сливалось.

Когда вы стали старше, преподаватель просил оформлять работы по правилам — чтобы было понятно и удобно проверять. С кодом — то же самое. Если он написан неаккуратно и хаотично, с ним сложно разобраться.

А если код понятный, то работать с ним куда приятнее. Вот чему учит «Денди-код».

// Хорошо ✅
public function hasAccess(User $user): bool
{
    if ($user->isBanned()) {
        // Пользователь заблокирован
        return false;
    }

    if ($user->isAdmin()) {
        // Пользователь является администратором
        return true;
    }

    // Пользователь имеет разрешение на редактирование
    return $user->isGranted(GRANT::EDIT);
}

Реальные советы

Можно сразу применить, чтобы сделать свои приложения лучше и прокачать навыки разработчика.