Download the PHP package marko/testing without Composer

marko/testing

Testing utilities for Marko---reusable fakes with built-in assertions that eliminate test boilerplate.

Overview

marko/testing provides a set of in-memory fakes that replace real infrastructure dependencies during tests. Instead of mocking interfaces by hand or spinning up real services, you drop in a fake, run your code, and call assertion methods directly on the fake. This removes hundreds of lines of boilerplate and keeps tests focused on behavior.

Installation

Available Fakes

FakeEventDispatcher, FakeMailer, FakeQueue, FakeSession, FakeCookieJar, FakeLogger, FakeConfigRepository, FakeAuthenticatable, FakeUserProvider, FakeGuard

Usage

FakeEventDispatcher

FakeMailer

FakeQueue

FakeSession

FakeCookieJar

FakeLogger

FakeConfigRepository

FakeAuthenticatable

FakeUserProvider

FakeGuard

API Reference

FakeEventDispatcher

• dispatch($event): void — Record a dispatched event
• dispatched(string $class): array — Return all dispatched events of a class
• assertDispatched(string $class): void — Assert an event was dispatched
• assertNotDispatched(string $class): void — Assert an event was not dispatched
• assertDispatchedCount(string $class, int $count): void — Assert exact dispatch count

FakeMailer

• send($message): void — Record a sent message
• assertSent(string $class): void — Assert a message was sent
• assertNothingSent(): void — Assert no messages were sent
• assertSentCount(string $class, int $count): void — Assert exact sent count

FakeQueue

• push($job): void — Record a pushed job
• assertPushed(string $class): void — Assert a job was pushed
• assertNotPushed(string $class): void — Assert a job was not pushed
• assertPushedCount(string $class, int $count): void — Assert exact pushed count
• assertNothingPushed(): void — Assert no jobs were pushed

FakeLogger

• info(string $message): void, error(), warning(), etc. — Record log entries
• assertLogged(string $message): void — Assert a message was logged
• assertNothingLogged(): void — Assert nothing was logged

FakeGuard

• new FakeGuard(string $name, bool $attemptResult) — Create guard; $attemptResult controls what attempt() returns
• setUser(?AuthenticatableInterface $user): void — Set the current authenticated user
• attempt(array $credentials): bool — Record credentials attempt and return configured result
• login(AuthenticatableInterface $user): void — Log in a user directly
• logout(): void — Clear current user and record logout
• assertAuthenticated(): void — Assert a user is currently authenticated
• assertGuest(): void — Assert no user is authenticated
• assertAttempted(?callable $callback = null): void — Assert attempt() was called, optionally matching credentials via callback
• assertNotAttempted(): void — Assert attempt() was never called
• assertLoggedOut(): void — Assert logout() was called

Pest Expectations

marko/testing ships Pest custom expectations that are auto-loaded via autoload.files.

Documentation

Full usage, API reference, and examples: marko/testing