كود نظيف في PHP: المبادئ والأمثلة العملية

مقدمة: لماذا الكود النظيف في PHP ليس رفاهية بل ضرورة

كل مطور PHP واجه مرة واحدة على الأقل موقفًا يتحول فيه خطأ بسيط في بيئة الإنتاج إلى مطاردة تستغرق ساعات لـ"الشيطان في التفاصيل". في أغلب الأحيان، لا يكمن السبب في تعقيد المنطق، بل في الكود القذر: أسماء متغيرات لا معنى لها، دوال بطول 500 سطر، غياب الأنواع، وتعليقات كاذبة. الكود النظيف (Clean Code) ليس مجرد جماليات. إنها أداة تقلل تكلفة صيانة المشروع بمقدار 3-5 مرات وتسمح لأعضاء الفريق الجدد بالاندماج في المشروع في غضون ساعات وليس أسابيع.

في هذا المقال، سنستعرض المبادئ الأساسية للكود النظيف المطبقة على PHP، مدعومة بأمثلة حقيقية قبل وبعد إعادة الهيكلة. ستتعلم كيفية تطبيق معايير PSR، ومبادئ SOLID، وقواعد التسمية البسيطة لجعل كودك يتحدث عن نفسه.

1. تسمية المتغيرات والدوال والكلاسات: تحدث بلغة الأعمال

الاسم السيء هو العدو الأول لقابلية القراءة. إذا كان المتغير يُسمى $a أو $data، ففي كل مرة تقرأ فيها الكود، تهدر موارد ذهنية لفك التشفير. القاعدة بسيطة: يجب أن يجيب الاسم على سؤال "ما هذا؟" أو "ماذا يفعل؟"

مثال سيء

<?php// ما هو $d؟ لماذا $x = 2؟$d = new DateTime();$x = 2;$y = $d->modify('+' . $x . ' days');echo $y->format('Y-m-d');?>

مثال جيد (كود نظيف)

<?php$currentDate = new DateTime();$daysToAdd = 2;$futureDate = $currentDate->modify('+' . $daysToAdd . ' days');echo $futureDate->format('Y-m-d');?>

قواعد إضافية:

• الكلاسات والواجهات — أسماء: UserRepository، PaymentGatewayInterface.
• الدوال — أفعال: getUserById()، sendEmailNotification().
• المتغيرات المنطقية — بادئات is، has، can: $isActive، $hasPermission.
• تجنب الاختصارات: $cnt ← $count، $usr ← $user.

2. الدوال والطرق: مبدأ المسؤولية الواحدة (SRP) في العمل

دالة واحدة — إجراء واحد. إذا رأيت دالة أطول من 20-30 سطرًا، فمن المحتمل أنها قابلة للتقسيم. في PHP، هذا مهم بشكل خاص، لأن غياب الكتابة الصارمة (حتى PHP 7.4) يشجع على "مكبات" الكود.

مثال سيء: دالة السكين السويسري

<?phpfunction processOrder(array $orderData): array{    // التحقق    if (empty($orderData['email'])) {        throw new InvalidArgumentException('البريد الإلكتروني مطلوب');    }    // الحفظ في قاعدة البيانات    $pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');    $stmt = $pdo->prepare('INSERT INTO orders (email, total) VALUES (?, ?)');    $stmt->execute([$orderData['email'], $orderData['total']]);    // إرسال البريد الإلكتروني    mail($orderData['email'], 'تم تأكيد الطلب', 'شكرًا لك!');    // التسجيل    file_put_contents('log.txt', 'تم معالجة الطلب: ' . $orderData['email'] . PHP_EOL, FILE_APPEND);    return ['status' => 'success'];}?>

مثال جيد: فصل المسؤوليات

<?phpclass OrderProcessor{    private OrderValidator $validator;    private OrderRepository $repository;    private MailService $mailer;    private Logger $logger;

    public function __construct(        OrderValidator $validator,        OrderRepository $repository,        MailService $mailer,        Logger $logger    ) {        $this->validator = $validator;        $this->repository = $repository;        $this->mailer = $mailer;        $this->logger = $logger;    }

    public function process(array $orderData): arr