إعداد PHPUnit وأول اختبار

ما هو PHPUnit؟

تثبيت PHPUnit

$ composer require --dev phpunit/phpunit "^11.0"

تهيئة phpunit.xml

<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
         bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="Unit">
            <directory>tests/</directory>
        </testsuite>
    </testsuites>
</phpunit>

كتابة فئة اختبار

<?php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function test_addition(): void
    {
        $calc = new Calculator();
        $this->assertEquals(5, $calc->add(2, 3));
    }
}

الفئة قيد الاختبار

<?php
class Calculator
{
    public function add(int $a, int $b): int
    {
        return $a + $b;
    }
}

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

$ vendor/bin/phpunit
...
OK (1 test, 1 assertion)

اصطلاحات تسمية الاختبارات

<?php
/** @test */
public function addition_returns_correct_sum(): void
{
    $this->assertEquals(5, (new Calculator())->add(2, 3));
}

بنية المجلدات

src/Calculator.php       → Calculator
tests/CalculatorTest.php → CalculatorTest

setUp() و tearDown()

<?php
protected function setUp(): void
{
    $this->calc = new Calculator();
}

public function test_add(): void
{
    $this->assertEquals(7, $this->calc->add(3, 4));
}

setUpBeforeClass() و tearDownAfterClass()

تغطية التعليمات البرمجية

$ vendor/bin/phpunit --coverage-html coverage/

الملخص

تحقّق سريع