عرض مصدر Laravel/testing

<noinclude>{{DISPLAYTITLE:مقدمة إلى التعامل مع الاختبارات}}</noinclude>
== مقدمة ==
بُني [[Laravel]] آخذًا الاختبارات بالحسبان؛ إذ يدعم [[Laravel]] الاختبارات باستخدام PHPUnit، ويهيّئ ملف <code>phpunit.xml</code> جاهز للعمل بما يناسب تطبيقك. كما دُعم إطار العمل بتوابع مساعدة لتمهيد الطريق أمام اختبار تطبيقاتك بشكل سلس وسهل.

يحتوي المجلد <code>tests</code> الخاص بتطبيقك افتراضيًّا على مجلّدين فرعيين: <code>Feature</code> و <code>Unit</code>. تمكنك اختبارات الوحدة Unit tests من التركيز على جزء صغير ومعزول من الشيفرة الخاصة بك، إذ أنّ معظم اختبارات الوحدة تركّز فقط على تابع واحد؛ بينما تستخدم اختبارات الميزات Feature tests لاختبار جزء كبير من الشيفرة، بما فيها كيفية تواصل مجموعة من الكائنات، أو حتى إمكانية إرسال طلب HTTP إلى نقطة نهاية JSON معيّنة.

يمكنك الاطلاع على ملف <code>ExampleTest.php</code> المضمّن في كلا المجلّدين <code>Feature</code> و <code>Unit</code>. بعد تثبيت مشروعك باستخدام إطار عمل Laravel، شغّل الأمر <code>phpunit</code> للبدء باختباراتك.

== البيئة ==
عند تشغيل الاختبارات باستخدام <code>phpunit</code>، سيُهيئ [[Laravel]] بيئة العمل الحالية إلى <code>testing</code>، بسبب متحولات البيئة المعرّفة في ملف <code>phpunit.xml</code>. سيقوم [[Laravel]] أيضًا بتهيئة الجلسة session وذاكرة التخزين المؤقتة إلى مصفوفة برنامج التشغيل( ‎(array driver أثناء الاختبار، مما يعني أنّه لن يحتفظ ببيانات الجلسة وذاكرة التخزين المؤقتة أثناء الاختبار.

أنت حر بتعريف متغيرات بيئة الاختبار الأخرى إذا دعت الحاجة لذلك. يمكنك تعريف متغيرات بيئة الاختبار في ملف <code>phpunit.xml</code>، لكن تأكد من تنظيف التخزين المؤقت للإعدادات باستخدام أمر <code>artisan config:clear</code> وذلك قبل تشغيل الاختبارات.

علاوةً على ذلك، يمكنك إنشاء ملف ‎<code>.env.testing</code> في جذر المشروع الخاص بك. سيعيد هذا الملف تعيين الإعدادات المعرّفة في ملف ‎<code>.env</code> عند تشغيل اختبارات PHPUnit أو عند تشغيل أوامر artisan باستخدام الخيار ‎<code>--env=testing</code>.

== إنشاء وتشغيل الاختبارات ==
لإنشاء حالة اختبار جديدة، استخدم أمر <code>artisan make:test</code>:<syntaxhighlight lang="php">
// لإنشاء حالة اختبار في مجلد الميزات.
php artisan make:test UserTest

// لإنشاء حالة اختبار في مجلد وحدات الاختبار.
php artisan make:test UserTest --unit
</syntaxhighlight>عندما يولَّد ملف الاختبار، يمكنك تعريف توابع الاختبار كما تقوم بالعادة باستخدام PHPUnit. ولتشغيل اختباراتك، شغل الأمر <code>phpunit</code> من واجهة الأوامر:<syntaxhighlight lang="php">
<?php

namespace Tests\Unit;

use Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;

class ExampleTest extends TestCase
{
   /**
    * مثال بسيط عن حالة اختبار
    *
    * @return void
    */
   public function testBasicTest()
   {
       $this->assertTrue(true);
   }
}
</syntaxhighlight>

'''ملاحظة:''' إذا قمت بتعريف التابع <code>setUp</code> الخاص بك، تأكد من مناداة التابع الأب <code>parent::setUp()</code>‎.

== مصادر ==
* [https://laravel.com/docs/5.6/testing صفحة Testing: Getting Started في توثيق Laravel الرسمي.]
[[تصنيف:Laravel]]
[[تصنيف:Laravel Testing]]