مبادئ الكود النظيف: اكتب كودًا يمكن للبشر قراءته

الكود يُقرأ 10 مرات أكثر مما يُكتب. الكود النظيف يقلل الأخطاء ويسرّع التأهيل.

أسماء ذات معنى

// سيء
$d = 7;

// جيد
$maxLoginAttempts = 7;
$activeUsers = User::where('status', 'active')->get();

دوال صغيرة

function processOrder(OrderRequest $request): Order
{
    $validated = $this->validateOrder($request);
    $order = $this->createOrder($validated);
    $this->chargePayment($order);
    $this->notifyCustomer($order);
    return $order;
}

استخدم التعدادات

enum UserRole: int {
    case Admin = 1;
    case Editor = 2;
    case Viewer = 3;
}

العودة المبكرة

function getDiscount(?User $user): float
{
    if (!$user) return 0;
    if (!$user->isPremium()) return 0.05;
    if ($user->ordersCount() <= 10) return 0.1;
    return 0.2;
}

مرجع SOLID

S — المسؤولية الواحدة
O — مفتوح/مغلق
L — استبدال ليسكوف
I — فصل الواجهات
D — عكس التبعية