Codeception documentation

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

Codeception هو إطار عمل لاختبار قبول (Acceptance Testing) مُصمم خصيصًا لتطبيقات الويب، ولكن يمكن استخدامه أيضًا لاختبار واجهات برمجة التطبيقات (APIs) و قواعد البيانات. يرتكز Codeception على مبادئ اختبار السلوك المدفوع (Behavior Driven Development - BDD) والتركيز على وصف سلوك التطبيق من وجهة نظر المستخدم النهائي. هذه المقالة هي دليل للمبتدئين لشرح كيفية استخدام توثيق Codeception بشكل فعال.

ما هو Codeception ولماذا نستخدمه؟

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

• سهولة الاستخدام: الكتابة بلغة طبيعية.
• المرونة: يدعم أنواعًا مختلفة من الاختبارات.
• التكامل: يتكامل مع إطارات عمل PHP الشائعة.
• التقارير: يقدم تقارير اختبار مفصلة.

تثبيت Codeception

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

Admin (talk)bash composer require codeception/codeception Admin (talk)

بعد التثبيت، يمكنك تهيئة مشروع Codeception جديد باستخدام الأمر:

Admin (talk)bash codeception init Admin (talk)

سيقوم هذا الأمر بإنشاء ملف تكوين (codeception.yml) وهيكل مجلدات للاختبارات.

هياكل مجلدات الاختبار

يعتمد Codeception على هيكل مجلدات منظم لتمييز أنواع الاختبارات المختلفة. إليك الهيكل الأساسي:

• tests/acceptance: اختبارات القبول (Acceptance Tests) - تحاكي تفاعلات المستخدم مع التطبيق.
• tests/functional: اختبارات وظيفية (Functional Tests) - تختبر وظائف محددة في التطبيق.
• tests/unit: اختبارات الوحدة (Unit Tests) - تختبر وحدات صغيرة من التعليمات البرمجية بشكل منفصل.
• tests/integration: اختبارات التكامل (Integration Tests) - تختبر التفاعل بين مكونات مختلفة من التطبيق.

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

لنفترض أنك تريد اختبار عملية تسجيل الدخول في تطبيق ويب. يمكنك كتابة اختبار قبول باستخدام Scenario و Given, When, Then. إليك مثال:

Admin (talk)php <?php

namespace tests\acceptance;

use Codeception\Test\AcceptanceTester;

class LoginCest {

   public function _before()
   {
       // تنفيذ إجراءات قبل كل اختبار
   }

   public function checkLoginSuccess(AcceptanceTester $I)
   {
       $I->wantTo('Verify successful login');
       $I->amOnPage('/login');
       $I->fillField('username', 'testuser');
       $I->fillField('password', 'testpassword');
       $I->click('Login');
       $I->see('Welcome, testuser!');
   }

   public function _after()
   {
       // تنفيذ إجراءات بعد كل اختبار
   }

} Admin (talk)

• $I: هو مثيل من AcceptanceTester، والذي يوفر طرقًا للتفاعل مع التطبيق.
• wantTo: يصف الهدف من الاختبار.
• amOnPage: ينتقل إلى صفحة ويب محددة.
• fillField: يملأ حقل إدخال.
• click: ينقر على عنصر.
• see: يتحقق من وجود نص معين على الصفحة.

فهم ملف التكوين (codeception.yml)

يحتوي ملف codeception.yml على إعدادات المشروع، بما في ذلك:

• modules: يحدد الوحدات (Modules) المستخدمة في الاختبارات.
• actor: يحدد سلوك الممثل (Actor) المستخدم في الاختبارات.
• paths: يحدد مسارات مجلدات الاختبار.
• db: يحدد إعدادات قاعدة البيانات.

يمكنك تعديل هذا الملف لتخصيص بيئة الاختبار الخاصة بك.

الوحدات (Modules) في Codeception

توفر الوحدات وظائف إضافية للاختبارات. بعض الوحدات الشائعة تشمل:

• WebModule: للتفاعل مع تطبيقات الويب.
• ApiModule: لاختبار واجهات برمجة التطبيقات.
• DbModule: للتفاعل مع قواعد البيانات.
• AssertModule: لإجراء تأكيدات إضافية.

يمكنك إضافة وحدات إلى ملف التكوين لتوسيع قدرات Codeception.

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

لتشغيل الاختبارات، استخدم الأمر التالي:

Admin (talk)bash codeception run Admin (talk)

سيقوم Codeception بتشغيل جميع الاختبارات الموجودة في مجلدات الاختبار المحددة وتقديم تقرير بنتائج الاختبار.

استراتيجيات اختبار إضافية و تحليل البيانات

بالإضافة إلى اختبارات القبول، يمكن استخدام Codeception مع استراتيجيات أخرى مثل:

• اختبار A/B: لتقييم أداء إصدارات مختلفة من التطبيق.
• اختبار الحمل: لتقييم أداء التطبيق تحت الضغط.
• اختبار الأمان: لتحديد الثغرات الأمنية في التطبيق.
• تحليل مسار المستخدم: لفهم كيفية تفاعل المستخدمين مع التطبيق.

وتكامل Codeception مع أدوات تحليل حجم التداول و التحليل الفني يمكن أن يوفر رؤى قيمة حول أداء التطبيق.

روابط ذات صلة

• اختبار القبول (Acceptance Testing)
• اختبار السلوك المدفوع (Behavior Driven Development - BDD)
• PHPUnit
• Symfony Test Framework
• Composer
• AcceptanceTester
• WebModule
• ApiModule
• DbModule
• AssertModule
• اختبار الوحدة (Unit Testing)
• اختبار التكامل (Integration Testing)
• تحليل مسار المستخدم
• اختبار A/B
• اختبار الحمل
• تحليل حجم التداول - Volume Profile
• مؤشر القوة النسبية (RSI)
• خطوط بولينجر (Bollinger Bands)
• التحليل الفني - Technical Analysis
• الشموع اليابانية (Candlestick Patterns)
• مؤشر المتوسط المتحرك (Moving Average)
• تصحيح الأخطاء (Debugging)
• إدارة الإصدارات (Version Control)
• أفضل ممارسات كتابة الاختبارات (Best Practices for Writing Tests)
• التكامل المستمر (Continuous Integration).

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

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

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

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