# ✅ CORRECT
vendor/bin/phpunit tests/Module/
vendor/bin/phpunit --filter testMethodName
vendor/bin/phpunit --testsuite "Module Tests"
vendor/bin/phpunit -c phpunit.ci.xml        # Use specific config file
vendor/bin/phpunit --display-all-issues     # Show ALL issues (deprecations, warnings, etc.)

# ❌ WRONG - These do NOT exist in PHPUnit 12.x
vendor/bin/phpunit -v
vendor/bin/phpunit --verbose

<?php

declare(strict_types=1);

namespace Tests\ModuleName;

use PHPUnit\Framework\TestCase;
use ModuleName\ModuleService;

class ModuleServiceTest extends TestCase
{
    /** @var RepositoryInterface&\PHPUnit\Framework\MockObject\MockObject */
    private RepositoryInterface $mockRepository;
    
    private ModuleService $service;

    protected function setUp(): void
    {
        $this->mockRepository = $this->createMock(RepositoryInterface::class);
        $this->service = new ModuleService($this->mockRepository);
    }

    public function testDescriptiveBehaviorName(): void
    {
        // Arrange
        $this->mockRepository->method('findById')
            ->willReturn(['id' => 1, 'name' => 'Test']);
        
        // Act
        $result = $this->service->getById(1);
        
        // Assert
        $this->assertNotNull($result);
        $this->assertEquals('Test', $result['name']);
    }

    /**
     * @dataProvider invalidInputProvider
     */
    public function testRejectsInvalidInput(mixed $input, string $expectedError): void
    {
        $result = $this->service->validate($input);
        $this->assertFalse($result->isValid());
        $this->assertStringContainsString($expectedError, $result->getError());
    }

    public static function invalidInputProvider(): array
    {
        return [
            'empty string' => ['', 'cannot be empty'],
            'negative number' => [-1, 'must be positive'],
            'null value' => [null, 'required'],
        ];
    }
}

<?php

declare(strict_types=1);

namespace Tests\Integration\ModuleName;

use Tests\Integration\IntegrationTestCase;
use Tests\Integration\Mocks\TestDataFactory;
use ModuleName\ModuleHandler;

class ModuleIntegrationTest extends IntegrationTestCase
{
    private ModuleHandler $handler;

    protected function setUp(): void
    {
        parent::setUp();
        
        // Create real or mock dependencies
        $this->handler = new ModuleHandler($this->mockDb);
        
        // Prevent external notifications
        $_SERVER['SERVER_NAME'] = 'localhost';
    }

    protected function tearDown(): void
    {
        unset($this->handler);
        unset($_SERVER['SERVER_NAME']);
        parent::tearDown();
    }

    public function testCompleteWorkflow(): void
    {
        // Arrange - Use TestDataFactory for consistent fixtures
        $player = TestDataFactory::createPlayer(['pid' => 1]);
        $team = TestDataFactory::createTeam(['teamid' => 1]);
        
        $this->mockDb->setMockData([$player]);

        // Act
        $result = $this->handler->processWorkflow(1);

        // Assert - Both outcome and database operations
        $this->assertTrue($result->isSuccessful());
        $this->assertQueryExecuted('INSERT INTO ibl_module');
        $this->assertQueryNotExecuted('DELETE FROM ibl_plr');
    }
}

// Create player with defaults
$player = TestDataFactory::createPlayer();

// Override specific fields
$player = TestDataFactory::createPlayer(['pid' => 99, 'name' => 'John Doe']);

// Create team and season similarly
$team = TestDataFactory::createTeam(['teamid' => 2]);
$season = TestDataFactory::createSeason(['Beginning_Year' => 2026]);

// Set expected result for a query
$this->mockDb->setMockData([
    ['pid' => 1, 'name' => 'Player One'],
    ['pid' => 2, 'name' => 'Player Two']
]);

// Mock prepared statement with automatic injection
$stmt = $GLOBALS['mysqli_db']->prepare('SELECT * FROM ibl_plr WHERE pid = ?');
$stmt->bind_param('i', $playerId);
$stmt->execute();
$result = $stmt->get_result();

<testsuites>
    <testsuite name="ModuleName Tests">
        <directory>tests/ModuleName</directory>
    </testsuite>
</testsuites>

<!-- Example: DatabaseConnectionTest.php -->
<testsuite name="Root Tests">
    <file>tests/DatabaseConnectionTest.php</file>
</testsuite>