PHPUnit Documentation

```wiki

PHPUnit Documentation: دليل شامل للمبتدئين

مقدمة

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

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

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

لماذا نستخدم PHPUnit؟

• جودة الكود العالية: يساعد PHPUnit في كتابة كود أكثر موثوقية وخالي من الأخطاء.
• تقليل الأخطاء: اكتشاف الأخطاء مبكراً يقلل من تكلفة إصلاحها على المدى الطويل.
• قابلية الصيانة: الكود الذي يتم اختباره جيداً أسهل في الصيانة والتعديل.
• التوثيق: الاختبارات تعمل كنوع من التوثيق للكود، حيث توضح كيفية عمل كل وحدة.
• الثقة في التطوير: يمنح المطورين الثقة في إجراء التغييرات على الكود دون الخوف من إدخال أخطاء جديدة.
• الاندماج المستمر: PHPUnit يتكامل بشكل جيد مع أدوات الاندماج المستمر (Continuous Integration) مثل Jenkins و Travis CI.

تثبيت PHPUnit

أسهل طريقة لتثبيت PHPUnit هي باستخدام Composer، مدير الحزم لـ PHP. افتح سطر الأوامر (command line) وانتقل إلى مجلد مشروعك، ثم قم بتشغيل الأمر التالي:

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

سيقوم Composer بتنزيل PHPUnit وتثبيته في مجلد `vendor` الخاص بمشروعك.

إعداد بيئة العمل

بعد تثبيت PHPUnit، تحتاج إلى التأكد من أن بيئة العمل الخاصة بك مهيأة بشكل صحيح. هذا يعني التأكد من أن PHPUnit موجود في مسار النظام (system path) الخاص بك.

يمكنك إضافة PHPUnit إلى مسار النظام عن طريق إضافة السطر التالي إلى ملف `composer.json` الخاص بمشروعك:

```json "bin": [

   "vendor/bin/phpunit"

] ```

ثم قم بتشغيل الأمر التالي لتحديث المسار:

```bash composer dump-autoload ```

الآن يمكنك تشغيل PHPUnit من أي مكان في سطر الأوامر عن طريق كتابة `phpunit`.

كتابة أول اختبار

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

```php <?php

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

   return $a + $b;

}

```

لكتابة اختبار لهذه الدالة، قم بإنشاء ملف جديد باسم `AddTest.php` في مجلد `tests` الخاص بمشروعك. يجب أن يكون هذا المجلد موجوداً. إذا لم يكن موجوداً، قم بإنشائه. يجب أن يحتوي الملف على الكود التالي:

```php <?php

use PHPUnit\Framework\TestCase;

class AddTest extends TestCase {

   public function testAdd(): void
   {
       $this->assertEquals(5, add(2, 3));
   }

} ```

شرح الكود:

• `use PHPUnit\Framework\TestCase;`: يستورد الصنف `TestCase` من PHPUnit، وهو الصنف الأساسي الذي يجب أن ترث منه جميع اختباراتك.
• `class AddTest extends TestCase`: يعرف صنف الاختبار `AddTest` الذي يرث من `TestCase`.
• `public function testAdd(): void`: يعرف طريقة الاختبار `testAdd`. يجب أن تبدأ جميع طرق الاختبار بالبادئة `test`.
• `$this->assertEquals(5, add(2, 3));`: يستخدم طريقة `assertEquals` من `TestCase` للتحقق من أن قيمة `add(2, 3)` تساوي 5. هذا هو التأكيد (assertion) الذي يتحقق من صحة الكود.

تشغيل الاختبارات

لتشغيل الاختبارات، انتقل إلى سطر الأوامر وانتقل إلى مجلد مشروعك، ثم قم بتشغيل الأمر التالي:

```bash phpunit ```

سيقوم PHPUnit بتشغيل جميع الاختبارات في مجلد `tests` الخاص بك. سترى نتيجة الاختبارات في سطر الأوامر. إذا كان الاختبار ناجحاً، فسترى رسالة تشير إلى ذلك. إذا كان الاختبار فاشلاً، فسترى رسالة خطأ توضح سبب الفشل.

أنواع التأكيدات (Assertions)

PHPUnit يوفر مجموعة واسعة من التأكيدات التي يمكنك استخدامها للتحقق من صحة الكود الخاص بك. بعض التأكيدات الشائعة تشمل:

• `assertEquals($expected, $actual)`: يتحقق من أن قيمتين متساويتان.
• `assertSame($expected, $actual)`: يتحقق من أن قيمتين متساويتان ونفس النوع.
• `assertTrue($condition)`: يتحقق من أن الشرط صحيح.
• `assertFalse($condition)`: يتحقق من أن الشرط خاطئ.
• `assertNull($variable)`: يتحقق من أن المتغير فارغ.
• `assertNotNull($variable)`: يتحقق من أن المتغير غير فارغ.
• `assertEmpty($array)`: يتحقق من أن المصفوفة فارغة.
• `assertNotEmpty($array)`: يتحقق من أن المصفوفة غير فارغة.
• `assertContains($needle, $haystack)`: يتحقق من أن القيمة موجودة في المصفوفة.
• `assertCount($count, $array)`: يتحقق من أن عدد عناصر المصفوفة يساوي القيمة المحددة.

Mocking و Stubbing

في بعض الأحيان، قد تحتاج إلى اختبار وحدة تعتمد على وحدات أخرى. في هذه الحالات، يمكنك استخدام Mocking و Stubbing لعزل الوحدة التي تختبرها.

• Mocking: إنشاء نسخة وهمية من وحدة تعتمد عليها الوحدة التي تختبرها. يسمح لك Mocking بالتحكم في سلوك الوحدة الوهمية والتحقق من أن الوحدة التي تختبرها تتفاعل معها بالطريقة المتوقعة.
• Stubbing: توفير استجابات محددة لوحدة تعتمد عليها الوحدة التي تختبرها. يسمح لك Stubbing بعزل الوحدة التي تختبرها وتجنب الاعتماد على سلوك الوحدة الخارجية.

PHPUnit يوفر دعمًا قويًا لـ Mocking و Stubbing من خلال مكتبة Mockery.

Data Providers

Data Providers تسمح لك بتشغيل نفس الاختبار مع مجموعة مختلفة من البيانات. هذا يمكن أن يوفر لك الكثير من الوقت والجهد.

```php public function testAddWithDataProvider(int $a, int $b, int $expected): void {

   $this->assertEquals($expected, add($a, $b));

}

public static function dataProviderAdd(): array {

   return [
       [2, 3, 5],
       [10, 20, 30],
       [-5, 5, 0],
   ];

} ```

Configuration (phpunit.xml)

يمكنك تكوين PHPUnit باستخدام ملف `phpunit.xml`. هذا الملف يسمح لك بتحديد مجموعة متنوعة من الخيارات، مثل مجلد الاختبارات، ومسارات المكتبات، والتقارير.

مثال على ملف `phpunit.xml`:

```xml <?xml version="1.0" encoding="UTF-8"?> <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:noNamespaceSchemaLocation="https://phpunit.de/xml/configuration.xsd"
        bootstrap="vendor/autoload.php">
   <testsuites>
       <testsuite name="My Project Tests">
           <directory>tests</directory>
       </testsuite>
   </testsuites>

</phpunit> ```

نصائح متقدمة

• Test Driven Development (TDD): كتابة الاختبارات قبل كتابة الكود.
• Code Coverage: قياس نسبة الكود الذي يتم اختباره.
• Continuous Integration: دمج الاختبارات في عملية الاندماج المستمر.
• استخدام الـ linters و static analysis tools: أدوات مثل PHPStan و Psalm يمكن أن تساعدك في العثور على الأخطاء المحتملة في الكود الخاص بك قبل تشغيل الاختبارات.
• التركيز على اختبار الحالات الحدودية (Edge Cases): اختبار الحالات التي قد تسبب مشاكل في الكود الخاص بك.
• استخدام أسماء وصفية للاختبارات: أسماء الاختبارات يجب أن تكون واضحة ومفهومة.

الخلاصة

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

روابط ذات صلة (إضافية)

• تحليل البيانات: فهم كيفية تحليل البيانات يمكن أن يساعدك في كتابة اختبارات أفضل.
• التحليل الفني: يمكن استخدام مبادئ التحليل الفني في اختبار الكود.
• تحليل حجم التداول: فهم حجم التداول يمكن أن يساعدك في تحديد أولويات الاختبارات.
• المؤشرات: استخدام المؤشرات في الاختبارات يمكن أن يساعدك في تتبع التقدم.
• الاتجاهات: تحليل الاتجاهات يمكن أن يساعدك في تحديد المشاكل المحتملة.
• استراتيجية مارتينجال: استراتيجية تداول خطيرة تتطلب اختبارًا دقيقًا.
• استراتيجية فيبوناتشي: استراتيجية تداول تعتمد على تسلسل فيبوناتشي.
• استراتيجية بولينجر باندز: استراتيجية تداول تستخدم نطاقات بولينجر.
• استراتيجية الاختراق: استراتيجية تداول تعتمد على اختراق مستويات الدعم والمقاومة.
• استراتيجية المتوسط المتحرك: استراتيجية تداول تعتمد على المتوسطات المتحركة.
• الخيارات الثنائية: فهم أساسيات الخيارات الثنائية.
• إدارة المخاطر في الخيارات الثنائية: أهمية إدارة المخاطر في التداول.
• التحليل الأساسي في الخيارات الثنائية: تحليل العوامل الاقتصادية والسياسية.
• التحليل الفني في الخيارات الثنائية: استخدام الرسوم البيانية والمؤشرات.
• الرافعة المالية في الخيارات الثنائية: فهم كيفية عمل الرافعة المالية.
• الوساطة في الخيارات الثنائية: اختيار وسيط موثوق.
• التداول الآلي في الخيارات الثنائية: استخدام الروبوتات للتداول.
• إشارات التداول في الخيارات الثنائية: استخدام إشارات التداول.
• الضرائب على الخيارات الثنائية: فهم القوانين الضريبية.
• التحقق من صحة البيانات: أهمية التحقق من صحة البيانات المدخلة.
• التعامل مع الأخطاء: كتابة كود يتعامل مع الأخطاء بشكل صحيح.
• التوثيق: أهمية توثيق الكود.
• التحسين: تحسين أداء الكود.
• الأمن: تأمين الكود ضد الهجمات.
• التصميم: تصميم كود قابل للصيانة والتطوير.
• Jenkins: أداة الاندماج المستمر.
• Travis CI: أداة الاندماج المستمر.
• PHPStan: أداة تحليل ثابت لـ PHP.
• Psalm: أداة تحليل ثابت لـ PHP.

```

ابدأ التداول الآن

سجّل في IQ Option (الحد الأدنى للإيداع 10 دولار) افتح حساباً في Pocket Option (الحد الأدنى للإيداع 5 دولار)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin لتصلك: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات اتجاهات السوق ✓ مواد تعليمية للمبتدئين