nette-testing

nette's avatarfrom nette

Invoke before writing or modifying any .phpt test files. Provides Nette Tester conventions, Assert methods, and tester commands.

⭐27stars🔀3forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

This Claude skill streamlines the process of writing and managing PHP unit tests using the Nette Tester framework. It provides developers with immediate access to Nette Tester conventions, assertion methods, and command-line tools, ensuring efficient test-driven development and high code reliability through standardized .phpt test files.

Use Cases

  • Generating standardized .phpt test files with correct Nette Tester bootstrap and environment setups.
  • Implementing robust exception testing using Assert::exception and testException methods to ensure code reliability.
  • Quickly referencing and applying Nette Tester Assert methods for unit testing PHP classes and functions.
  • Executing and debugging specific test suites or directories using optimized Nette Tester CLI commands.
  • Integrating static analysis and code quality checks into the testing workflow using PHPStan.
namenette-testing
descriptionInvoke before writing or modifying any .phpt test files. Provides Nette Tester conventions, Assert methods, and tester commands.

Testing with Nette Tester

We use Nette Tester for unit testing. Test files should have .phpt extension.

composer require nette/tester --dev

Bootstrap File

The bootstrap file should set up the Tester environment and enable helper functions:

<?php

declare(strict_types=1);

require __DIR__ . '/../vendor/autoload.php';

Tester\Environment::setup();
Tester\Environment::setupFunctions();  // enables test(), testException(), testNoError()

Basic Test Structure

<?php

declare(strict_types=1);

use Tester\Assert;
use Nette\Assets\SomeClass;

require __DIR__ . '/../bootstrap.php';


test('SomeClass correctly does something', function () {
	$object = new SomeClass();
	$result = $object->doSomething();

	Assert::same('expected value', $result);
});


test('SomeClass handles edge case properly', function () {
	$object = new SomeClass();
	$result = $object->handleEdgeCase();

	Assert::true($result);
});

Key points:

  • Use the test() function for each test case
  • The first parameter of test() should be a clear description of what is being tested
  • Do not add comments before test() calls - the description parameter serves this purpose
  • Group related tests in the same file

Testing Exceptions

To test if code correctly throws exceptions:

Assert::exception(
	fn() => $mapper->getAsset('missing.txt'),
	AssetNotFoundException::class,
	"Asset file 'missing.txt' not found at path: %a%",
);

The Assert::exception() method:

  1. First parameter: A closure that should throw the exception
  2. Second parameter: Expected exception class
  3. Third parameter (optional): Expected exception message, can contain placeholders (%a% means any text)

If the entire test() block is to end with an exception, you can use testException():

testException('throws exception for invalid input', function () {
	$mapper = new FilesystemMapper(__DIR__ . '/fixtures');<br>
	$mapper->getAsset('missing.txt');
}, AssetNotFoundException::class, "Asset file 'missing.txt' not found at path: %a%");

Essential Commands

# Run all tests
composer tester

# Run specific test file
vendor/bin/tester tests/common/Engine.phpt -s

# Run tests in specific directory
vendor/bin/tester tests/filters/ -s

Static Analysis & Code Quality using PHPStan

# Run PHPStan static analysis
composer phpstan