Testing Your Application¶

Erlenmeyer includes a built-in testing utility called ErlenClient,
designed to simulate real HTTP requests without a web server.

It lets you fully test routes, middlewares, authentication, errors,
and even CORS — directly inside PHP, fast and isolated.

🧩 Why ErlenClient?¶

ErlenClient acts like a mini HTTP client that runs inside the same process
as your app. This means:

No need to start php -S or a local server.
Requests pass through the same middleware, routes, and handlers.
You can test APIs, sessions, and even global middleware logic easily.

⚙️ Basic Setup¶

Let’s start with a simple test structure:

project/
├── app/
│   └── App.php
├── tests/
│   ├── bootstrap.php
│   └── ExampleTest.php
└── public/
└── index.php

Example: `tests/bootstrap.php`¶

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

use AdaiasMagdiel\Erlenmeyer\App;

$app = new App();

$app->get('/hello', fn($req, $res, $params) =>
    $res->withJson(['message' => 'Hello, Tests!'])
);

return $app;

🧪 Writing Your First Test¶

<?php
use AdaiasMagdiel\Erlenmeyer\Testing\ErlenClient;

$app = require __DIR__ . '/bootstrap.php';
$client = new ErlenClient($app);

$response = $client->get('/hello');

echo $response->getStatusCode(); // 200
echo $response->getBody();       // {"message":"Hello, Tests!"}

✅ This test runs entirely in memory — no HTTP calls, no external dependencies.

🧱 Testing JSON Endpoints¶

To simulate a POST request with a JSON body:

$response = $client->post('/users', [
    'json' => ['name' => 'Alice']
]);

echo $response->getStatusCode(); // 201
echo $response->getBody();       // {"message":"User created","user":{"name":"Alice"}}

Assertions (for PHPUnit or Pest)¶

$this->assertEquals(201, $response->getStatusCode());
$this->assertStringContainsString('Alice', $response->getBody());

🧩 Sending Headers and Tokens¶

You can add headers globally or per request.

Global Headers¶

$client->withHeaders(['Authorization' => 'Bearer test123']);

Per Request¶

$response = $client->get('/profile', [
    'headers' => ['Authorization' => 'Bearer test123']
]);

All headers are automatically transformed into the proper PHP $_SERVER keys (HTTP_AUTHORIZATION, CONTENT_TYPE, etc.) before dispatch.

🧠 Testing Middleware and Auth¶

Global and route-specific middleware logic is fully executed in tests.

Example¶

$app->addMiddleware(function ($req, $res, $next, $params) {
    $token = $req->getHeader('Authorization');
    if ($token !== 'Bearer valid123') {
        $res->withJson(['error' => 'Unauthorized'])->setStatusCode(401)->send();
        return;
    }
    $params->user = ['id' => 1, 'name' => 'Alice'];
    $next($req, $res, $params);
});

$app->get('/me', fn($req, $res, $params) =>
    $res->withJson($params->user)
);

Test:

$response = $client->get('/me', [
    'headers' => ['Authorization' => 'Bearer valid123']
]);

$this->assertEquals(200, $response->getStatusCode());
$this->assertStringContainsString('Alice', $response->getBody());

🧩 Testing CORS and Preflight Requests¶

CORS is easy to test — just send an OPTIONS request.

$response = $client->options('/users');

$this->assertEquals(204, $response->getStatusCode());
$this->assertEquals('*', $response->getHeaders()['Access-Control-Allow-Origin']);

If your global middleware sets CORS headers, they will appear in the response automatically.

⚙️ Testing Query Strings and Form Data¶

Query Strings¶

$response = $client->get('/search', [
    'query' => ['q' => 'test']
]);

$this->assertStringContainsString('test', $response->getBody());

Form Data¶

$response = $client->post('/submit', [
    'form_params' => ['email' => 'user@example.com']
]);

$this->assertEquals(200, $response->getStatusCode());

🧱 Testing File Uploads¶

ErlenClient supports simulated file uploads as well:

$response = $client->post('/upload', [
    'files' => [
        'avatar' => [
            'name' => 'photo.jpg',
            'type' => 'image/jpeg',
            'tmp_name' => __DIR__ . '/fixtures/photo.jpg',
            'error' => 0,
            'size' => 2048
        ]
    ]
]);

🧩 Testing Error Handling¶

You can verify custom exception and 404 handlers easily.

404 Example¶

$response = $client->get('/does-not-exist');
$this->assertEquals(404, $response->getStatusCode());

Exception Example¶

If a route throws an error:

$app->get('/boom', fn() => throw new Exception('Boom!'));