phputil/httpwrapper

A simple PSR-7 wrapper for common responses.

HTTP Wrapper

This library provides a wrapper for the PSR-7's ResponseInterface., _(*1)

You have to use it with a library/framework that offers a PSR-7 implementation, such as Slim 3, Guzzle, Aura or Zend., _(*2)

We use semantic versioning. See our releases., _(*3)

Classes:, _(*4)

• phputil\HttpResponseWrapper

Dependencies (installed automatically by composer):, _(*5)

• phputil/http
• phputil/json

Installation

composer require phputil/httpwrapper

Example 1

Using with Slim 3:, _(*6)

get( '/names', function ( $request, $response, $args ) use ( $hrw ) {

    $names = array( 'Suzan', 'Mary', 'Mike', 'Bob' );

    // Will return HTTP 200 with the array as JSON encoded with UTF-8
    return $hrw->with( $response )
        ->withStatusOk()
        ->asJsonUtf8( $names ) // Any var type accepted
        ->end()
        ;
} );

$app->get( '/bad', function ( $request, $response, $args ) use ( $hrw ) {
    // Will return HTTP 400
    return $hrw->with( $response )->withStatusBadRequest->end();
} );

$app->get( '/i-am-just-curious', function ( $request, $response, $args ) use ( $hrw ) {
    // Will return HTTP 403 (Forbidden)
    return $hrw->with( $response )->withStatusForbidden->end();
} );

?>

Example 2

Also with Slim 3:, _(*7)

get( '/names', function ( $request, $response, $args ) use ( $hrw ) {

    $names = array( 'Suzan', 'Mary', 'Mike', 'Bob' );

    // Helper method to return HTTP 200 with a JSON content encoded with UTF-8.
    return $hrw->with( $response )->ok( $names );
} );

$app->get( '/bad', function ( $request, $response, $args ) use ( $hrw ) {
    // Helper method to return HTTP 400 with a JSON content encoded with UTF-8.
    return $hrw->with( $response )->bad( array( 'Something bad happened' ) );
} );

$app->get( '/none', function ( $request, $response, $args ) use ( $hrw ) {
    // Helper method to return HTTP 204.
    return $hrw->with( $response )->noContent();
} );

?>