Writing PHPUnit Unit Tests

Write independent test methods with clear expected outputs, boundary inputs and useful assertion failures.

What It Does

Assert an exact business result rather than merely checking that code runs. Compare array contents and ordering. Use expectException before calling the operation expected to fail. Compare array contents and ordering.

Requirements and Compatibility

Use a supported PHP runtime and install any third-party tool or extension explicitly shown in the examples. Commands should be run from the project root unless stated otherwise.

Syntax, Inputs and Results

The examples separate configuration, the smallest working operation and a realistic follow-up task. Adapt file paths and dependency versions to your own project.

Example 1: Basic Use

Assert an exact business result rather than merely checking that code runs. Compare array contents and ordering.

<?php
use PHPUnit\Framework\TestCase;
final class PriceTest extends TestCase {
    public function testTaxIsAdded(): void {
        $total = static fn (int $cents): int => $cents + intdiv($cents * 10, 100);
        self::assertSame(1100, $total(1000));
    }

    public function test1ArticleBoundary(): void { self::assertSame([2, 4], array_map(static fn(int $x): int => $x * 2, [1, 2])); }
}

Example 2: Another Case

Use expectException before calling the operation expected to fail. Compare array contents and ordering.

<?php
use PHPUnit\Framework\TestCase;
final class QuantityTest extends TestCase {
    public function testNegativeQuantityIsRejected(): void {
        $validate = static function (int $n): void {
            if ($n < 0) throw new InvalidArgumentException('Negative quantity');
        };
        $this->expectException(InvalidArgumentException::class);
        $validate(-2);
    }

    public function test2ArticleBoundary(): void { self::assertSame([2, 4], array_map(static fn(int $x): int => $x * 2, [1, 2])); }
}

Practical Example

Named datasets help identify failures for each input. Compare array contents and ordering.

<?php
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;
final class ShippingTest extends TestCase {
    public static function weights(): iterable {
        yield 'light' => [2, 4];
        yield 'heavy' => [8, 16];
    }
    #[DataProvider('weights')]
    public function testCost(int $weight, int $expected): void {
        self::assertSame($expected, $weight * 2);
    }

    public function test3ArticleBoundary(): void { self::assertSame([2, 4], array_map(static fn(int $x): int => $x * 2, [1, 2])); }
}

For production, apply the compatibility and edge-case limits described below.

Important Behavior and Edge Cases

Separate isolated unit tests from integration tests requiring a real database or network.

Comparison with Related Functions and Tools

Subject	Key difference
Unit tests vs integration tests	Unit tests isolate one behavior; integration tests use actual interfaces, databases or framework components.

Common Beginner Mistakes

Mistake	Correct approach
Writing tests without meaningful assertions	Assert an exact result or expected exception, including at least one boundary case.
Skipping the prerequisite of this specific workflow	Install or configure the named tool and confirm the example can actually run.
Ignoring edge conditions	Separate isolated unit tests from integration tests requiring a real database or network.

Key Takeaways

Write independent test methods with clear expected outputs, boundary inputs and useful assertion failures.
Separate isolated unit tests from integration tests requiring a real database or network.
Keep application configuration, source code and validation tests under version control.

Use these examples as a starting point, then validate the result with the actual PHP build, dependencies and inputs used by your application.