shroophp/psr

A library for building PSR-compliant applications with ShrooPHP.

v1.3.1 2018-11-13 22:58 UTC

Requires

• guzzlehttp/psr7: ^1.4
• psr/http-server-handler: ^1.0
• shroophp/framework: ^3.0 || ^2.1

Requires (Dev)

• mikey179/vfsstream: ^1.6
• phpunit/phpunit: ^6.3 || ^5.7 || ^4.8

LGPL-3.0-only

• Jonty Newman

• psr
• shroophp

README

A library for building PSR-compliant applications with ShrooPHP.

Installation

composer require 'shroophp/psr ^1.0'

Example Usage

<?php

use GuzzleHttp\Psr7\ServerRequest;
use ShrooPHP\Core\Request;
use ShrooPHP\Framework\Application;
use ShrooPHP\Framework\Request\Responses\Response;
use ShrooPHP\PSR\RequestHandler;

require 'vendor/autoload.php';

$default = new \GuzzleHttp\Psr7\Response(Response::HTTP_NOT_FOUND);
$handler = new RequestHandler($default);

$handler->apply(function (Application $app) {

	$app->path('/greeting', $app->_(function (Request $request) {

		return Response::string('Hello, world!', 'text/plain');
	}));
});

$no = $handler->handle(new ServerRequest('GET', '/'));         // 404 Not Found
$ok = $handler->handle(new ServerRequest('GET', '/greeting')); // 200 OK

Important Notes

When applying an application modifier to the request handler, it is important to specify each response indirectly as the return value of a callback (as opposed to having the response as an explicit application modifier or handler).

This is because direct modifiers and handlers are not given the opportunity to make use of the presenter associated with the application. In terms of the request handler, this means that the response cannot be buffered and hence converted into a PSR-compliant instance.