إزاي تكتب كود PHP نظيف (Clean Code) وتخلص من كابوس الـ Spaghetti Code
أكيد مريت بالموقف ده قبل كدة، فتحت بروجكت قديم كنت شغال عليه من 6 شهور، وفجأة لقيت نفسك تايه وسط ملفات PHP طويلة جداً، ودوامات من الـ If-else المتداخلة، وبقيت خايف تمسح أي سطر كود لاحسن السيستم كله يقع! ده بالضبط اللي بنسميه الـ Spaghetti Code أو "كود المكرونة"، والنهاردة هنتكلم إزاي تحول الكود بتاعك من كومة لخبطة لكود احترافي (Clean Code) سهل تقراه وتعدل عليه.
Table of contents [Show]
- 1 يعني إيه Clean Code وليه هو مهم في الـ PHP؟
- 2 1. سمي الأشياء بمسمياتها (Meaningful Naming)
- 3 2. التزم بمبدأ المسؤولية الواحدة (Single Responsibility Principle)
- 4 3. ابعد عن الـ Nested If-Else واستخدم الـ Guard Clauses
- 5 4. استخدم الـ Type Hinting و الـ Return Types
- 6 5. التزم بـ PSR (PHP Standard Recommendations)
- 7 نصيحة من أخ لمبرمج
يعني إيه Clean Code وليه هو مهم في الـ PHP؟
الكود النظيف مش معناه إنه شغال بس، لأ، ده معناه إنه كود "مفهوم" لأي حد غيرك. في لغة PHP، بسبب مرونتها العالية، المبرمجين بيقعوا بسهولة في فخ التوسع العشوائي. الكود النظيف بيخلي الـ Maintenance أو صيانة الكود أسهل بكتير، وبيقلل الـ Technical Debt أو "الديون التقنية" اللي بتأخر تطوير البروجكت بتاعك مع الوقت.
1. سمي الأشياء بمسمياتها (Meaningful Naming)
أول قاعدة في كتابة كود PHP محترم هي أسماء المتغيرات والدوال. بلاش الأسماء المختصرة زي $x أو $temp. خلي اسم المتغير يعبر عن وظيفته.
// كود مش نظيف
$d = date('Y-m-d');
function get($u) { ... }
// كود نظيف
$currentDate = date('Y-m-d');
function getUserById($userId) { ... }
2. التزم بمبدأ المسؤولية الواحدة (Single Responsibility Principle)
ده واحد من أهم مبادئ الـ SOLID. القاعدة بتقول إن أي Function أو Class لازم يكون ليها "وظيفة واحدة فقط". لو لقيت دالة بتعمل Calculation وبتطبع Report وبتسيف في الـ Database، فإنت محتاج فوراً تقسمها لدوال أصغر.
3. ابعد عن الـ Nested If-Else واستخدم الـ Guard Clauses
التداخل الكتير في الشروط بيخلي الكود صعب جداً في التتبع (Tracing). الحل هو استخدام الـ Guard Clauses، يعني لو الشرط مش متحقق، اخرج من الدالة فوراً (Return Early).
// كود سيء
if ($user) {
if ($user->isActive) {
if ($user->hasPermission) {
// تنفيذ العملية
}
}
}
// كود نظيف
if (!$user || !$user->isActive) return;
if (!$user->hasPermission) return;
// تنفيذ العملية مباشرة هنا
4. استخدم الـ Type Hinting و الـ Return Types
من أول PHP 7 واحنا عندنا ميزة الـ Type Hinting. دي بتخلي الكود بتاعك أقوى (Strongly Typed) وبتقلل الـ Bugs اللي بتيجي بسبب أنواع البيانات الغلط.
function calculateTotal(array $items): float {
return array_sum($items);
}
5. التزم بـ PSR (PHP Standard Recommendations)
دي معايير عالمية اتفق عليها مجتمع الـ PHP عشان كلنا نكتب كود بنفس الشكل. لازم تتعرف على PSR-1 و PSR-12. هتلاقي حياتك أسهل بكتير لما تستخدم أداة زي PHP_CodeSniffer عشان تتأكد إن كودك ماشي على المعايير دي.
نصيحة من أخ لمبرمج
الكود النظيف مش بييجي بين يوم وليلة، ده "عضلة" محتاجة تدريب. حاول يومياً تقرأ كود لمشاريع Open Source مشهورة زي Laravel أو Symfony، شوف هما بيكتبوا الـ Classes والـ Functions إزاي. وأهم حاجة، "اكتب الكود وكأن المبرمج اللي هيصينه بعدك شخص عصبي ومعاه سلاح!".
