Skip to content
Very basic blueprint server for API prototyping.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

HTTP blueprint server

Build Status Code Quality Test Coverage Dependencies Version Licence

Table of contents


composer require weew/http-blueprint


This little package allows you to easily spin up a server, maybe during your unit tests. It consists of two parts, the server and the proxy. The server is responsible for starting and stopping of, big surprise, the http server. The proxy is basically responsible for grabbing all of the registered routes, figuring out which one should be called and returning an http response.

This package was mainly built for testing of the http layer and the http client where I could not simply mock the endpoints, but had instead to actually test the whole http communication and the resulting requests and responses. But at the end I think this is a really useful package and might be used elsewhere as well.

Creating a blueprint

Create a file that will be used as your blueprint. Register your routes in there. Let the proxy to the rest.

// file: blueprint.php

// create a proxy
$proxy = new BlueprintProxy();

// register all of your routes
    ->get('/', 'hello world')
    ->get('about', new HttpResponse(HttpStatusCode::OK, 'foo'))
    ->post('post', function() {
        return 'hello world';
    ->put('users/{id}', function(IHttpRequest $request, array $parameters) {
        return new HttpResponse(HttpStatusCode::OK, $parameters['id']);

// send a response

Starting and stopping the server

It is very easy. Just pass in the hostname, your desired port, and the path to the blueprint file you've created.

$server = new BlueprintServer('localhost', 9000, '/path/to/blueprint.php');

When you're done, simply stop the server.


Related projects

  • HTTP Layer: offers response and request objects, handles cookies, headers and much more.
  • HTTP Server: allows you to start an http server in a directory of your choice.
  • HTTP Client: allows you to send HttpRequest and to receive HttpResponse objects.
  • Router: allows you to create complex routes and map them to a response.
You can’t perform that action at this time.