اختبارات الوحدة

```wiki

اختبارات الوحدة في MediaWiki

اختبارات الوحدة هي ممارسة أساسية في تطوير البرمجيات تهدف إلى التحقق من أن أجزاء فردية من الكود (الوحدات) تعمل كما هو متوقع. في سياق MediaWiki، يمكن أن تكون هذه الوحدات عبارة عن دوال، أو طرق في الفئات، أو حتى أجزاء صغيرة من التعليمات البرمجية المسؤولة عن مهمة محددة. تضمن اختبارات الوحدة أن أي تغييرات مستقبلية في الكود لن تؤدي إلى تعطيل الوظائف الحالية، مما يزيد من استقرار النظام وقابليته للصيانة.

لماذا اختبارات الوحدة مهمة؟

اكتشاف الأخطاء مبكراً: تساعد اختبارات الوحدة في تحديد الأخطاء في مرحلة مبكرة من عملية التطوير، عندما يكون من الأسهل والأرخص إصلاحها.
تحسين جودة الكود: تشجع كتابة اختبارات الوحدة المطورين على كتابة كود أكثر قابلية للقراءة، وأكثر تنظيمًا، وأكثر قابلية للصيانة.
تسهيل إعادة الهيكلة: عند إجراء تغييرات على الكود، توفر اختبارات الوحدة شبكة أمان للتأكد من أن التغييرات لا تؤدي إلى إدخال أخطاء جديدة.
توثيق الكود: يمكن أن تعمل اختبارات الوحدة كنوع من التوثيق، حيث توضح كيفية استخدام الوحدات المختلفة وكيف من المفترض أن تعمل.
تقليل المخاطر: تقلل اختبارات الوحدة من مخاطر إطلاق برامج معيبة، مما قد يؤثر سلبًا على المستخدمين.

أساسيات اختبارات الوحدة

الوحدة: أصغر جزء قابل للاختبار من الكود. في MediaWiki، يمكن أن تكون الوحدة دالة PHP، أو طريقة في فئة PHP.
حالة الاختبار: مجموعة من المدخلات المتوقعة والمخرجات المتوقعة لوحدة معينة.
بيئة الاختبار: البيئة التي يتم فيها تشغيل الاختبارات. يجب أن تكون هذه البيئة معزولة عن بيئة الإنتاج لتجنب التأثير على البيانات الحقيقية.
إطار عمل الاختبار: مجموعة من الأدوات والمكتبات التي تسهل كتابة وتشغيل الاختبارات. في سياق PHP و MediaWiki، يعتبر PHPUnit هو إطار العمل الأكثر شيوعًا.

استخدام PHPUnit في MediaWiki

PHPUnit هو إطار عمل اختبار وحدة شائع لـ PHP. يوفر مجموعة واسعة من الميزات التي تجعل كتابة وتشغيل الاختبارات أمرًا سهلاً.

خطوات استخدام PHPUnit في MediaWiki:

1. التثبيت: تأكد من تثبيت PHPUnit على نظامك. يمكن تثبيته باستخدام Composer:

   ```bash
   composer require --dev phpunit/phpunit
   ```

2. إنشاء ملف اختبار: قم بإنشاء ملف اختبار لكل وحدة تريد اختبارها. يجب أن يكون اسم ملف الاختبار مشابهًا لاسم الوحدة التي يتم اختبارها، مع إضافة لاحقة "Test". على سبيل المثال، إذا كنت تختبر وحدة باسم "MyClass.php"، فيجب أن يكون اسم ملف الاختبار "MyClassTest.php". 3. كتابة حالات الاختبار: داخل ملف الاختبار، قم بإنشاء فئة اختبار ترث من `PHPUnit\Framework\TestCase`. لكل حالة اختبار، قم بإنشاء طريقة اختبار تبدأ بكلمة "test". 4. استخدام التأكيدات: استخدم طرق التأكيد التي يوفرها PHPUnit للتحقق من أن المخرجات الفعلية تتطابق مع المخرجات المتوقعة. بعض طرق التأكيد الشائعة تشمل:

   *   `assertEquals()`: للتحقق من أن قيمتين متساويتان.
   *   `assertTrue()`: للتحقق من أن تعبير ما صحيح.
   *   `assertFalse()`: للتحقق من أن تعبير ما خاطئ.
   *   `assertNull()`: للتحقق من أن قيمة ما فارغة.
   *   `assertNotNull()`: للتحقق من أن قيمة ما ليست فارغة.

5. تشغيل الاختبارات: قم بتشغيل الاختبارات باستخدام سطر الأوامر:

   ```bash
   ./vendor/bin/phpunit
   ```

مثال على اختبار وحدة في MediaWiki

لنفترض أن لدينا دالة PHP بسيطة في MediaWiki تقوم بحساب مجموع رقمين:

```php <?php /**

* Adds two numbers together.
*
* @param int $a The first number.
* @param int $b The second number.
*
* @return int The sum of the two numbers.
*/

function addNumbers(int $a, int $b): int {

 return $a + $b;

} ```

يمكننا إنشاء ملف اختبار لهذه الدالة على النحو التالي:

```php <?php

use PHPUnit\Framework\TestCase;

require_once __DIR__ . '/../includes/functions.php'; // Replace with the actual path

class AddNumbersTest extends TestCase {

 public function testAddPositiveNumbers() {
   $this->assertEquals(5, addNumbers(2, 3));
 }

 public function testAddNegativeNumbers() {
   $this->assertEquals(-5, addNumbers(-2, -3));
 }

 public function testAddPositiveAndNegativeNumbers() {
   $this->assertEquals(1, addNumbers(3, -2));
 }

 public function testAddZero() {
   $this->assertEquals(2, addNumbers(2, 0));
 }

} ```

في هذا المثال، قمنا بإنشاء فئة اختبار باسم "AddNumbersTest" ترث من `PHPUnit\Framework\TestCase`. قمنا بعد ذلك بإنشاء أربع طرق اختبار، كل منها يتحقق من أن الدالة "addNumbers" تعمل بشكل صحيح في سيناريو مختلف.

أفضل الممارسات لاختبارات الوحدة

اكتب اختبارات لكل وحدة: يجب أن يكون لكل وحدة كود اختبارات وحدة مقابلة.
اجعل الاختبارات قصيرة وبسيطة: يجب أن تركز كل طريقة اختبار على اختبار جانب واحد فقط من الوحدة.
استخدم أسماء وصفية للاختبارات: يجب أن يكون اسم طريقة الاختبار واضحًا وموجزًا ويصف ما يتم اختباره.
استخدم البيانات الوهمية: عند اختبار الوحدات التي تعتمد على وحدات أخرى، استخدم البيانات الوهمية (mocks) لعزل الوحدة التي يتم اختبارها.
قم بتشغيل الاختبارات بانتظام: يجب تشغيل الاختبارات بانتظام، على سبيل المثال، قبل كل عملية إرسال (commit) أو نشر (deploy).
حافظ على الاختبارات محدثة: يجب تحديث الاختبارات عند إجراء تغييرات على الكود.