fol/http

Http library

Monday, June 8, 2015
by oscarotero
Repository
1 Watchers
3 Stars
169 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
16 Versions
0 % Grown

The README.md

Fol\Http

Biblioteca Http para PHP 5.5. Aínda que esta dentro do proxecto FOL, pódese usar de xeito independente, _(*1)

, _(*2)

Exemplos

Uso básico

use Fol\Http\Request;
use Fol\Http\Response;
use Fol\Http\MiddlewareStack;
use Fol\Http\Middlewares;

//Inicia unha instancia de MiddlewareStack
$stack = new MiddlewareStack();

//Engade alguns middlewares
$stack->push(new Middlewares\Languages());
$stack->push(new Middlewares\Ips());

$stack->push(function ($request, $response, $stack) {
    $response->getBody()->write('Hello world');
    $stack->next();
});

$stack->push(function ($request, $response, $stack) {
    $response->getBody()->setStatus(200);
    $stack->next();
});

//Executaos
$response = $stack->run(new Request('http://domain.com'));

//Envía a resposta ao navegador
$response->send();

Uso con sesións e rutas

As sesións e rutas son como outros "middlewares" que podes engadir ao MiddlewareStack, _(*3)

use Fol\Http\Request;
use Fol\Http\Response;
use Fol\Http\MiddlewareStack;

use Fol\Http\Sessions\Native;
use Fol\Http\Routes\Router;

//Inicia o router
$router = new Router();

$router->map([
    'index' => [
        'path' => '/',
        'target' => function ($request, $response) {
            $response->getBody()->write('Esta é a portada');
        }
    ],
    'about' => [
        'path' => '/about',
        'target' => function ($request, $response) {
            $session = $request->attributes->get('SESSION');

            $response->getBody()->write('Ola, ti eres '.$session->get('username'));
        }
    ]
]);

//Inicia o MiddlewareStack
$stack = new MiddlewareStack();

//Engade a middleware da sesión
$stack->push(new Native());

//E tamén a do router
$stack->push($router);

//Executa
$response = $stack->run(new Request('http://domain.com'));

//Envía a resposta
$response->send();

Classes

Request

Xestiona os datos dunha petición http, _(*4)

use Fol\Http\Request;

//Crear dende as variables globais ($_SERVER, $_FILES, etc)
$request = Request::createFromGlobals();

//Ou podes crear a túa petición personalizada
$request = new Request('http://blog.com/?page=2', 'GET', ['Accept' => 'text/html']);

//Obxecto para acceder aos datos da url (host, path, query, fragment, etc)
$request->url;

//Accede á "query" (alias de $request->url->query):
$request->query;

//Xestiona cabeceiras
$request->headers

//Xestiona cookies
$request->cookies

//Xestiona os datos parseados do body
$request->data

//Xestiona os arquivos subidos
$request->files

//Devolve o body (streamable)
$body = $response->getBody();

Response

use Fol\Http\Response;

//Crea unha resposta
$response = new Response('Hello world', 200, ['Content-Type' => 'text/html']);

//Xestiona as cabeceiras
$request->headers

//Xestiona as cookies
$request->cookies

//Devolve o body (streamable)
$body = $response->getBody();

MiddlewareStack

Xestiona todos os middlewares en todo o ciclo petición/resposta de http. Para entender mellor o concepto dos middlewares, recomendo ler este artigo, _(*5)

Middlewares

Esta biblioteca trae consigo unha serie de middlewares por defecto coas funcionalidades máis comúns:, _(*6)

BaseUrl: Útil para definir por defecto unha url base, que se usaría tanto para cookies como para o router. Para acceder á url: $request->attributes->get('BASE_URL')
BasicAuthentication: Para crear unha autentificación http básica
DigestAuthentication: Para crear unha autentificación http de tipo "digest"
Formats: Para detectar e normalizar automaticamente o formato da petición (json, txt, html, png, etc). Para acceder ao formato: $request->attributes->get('FORMAT')
Ips: Detecta a ip do cliente. Para acceder a ela: $request->attributes->get('IP')
Languages: Detecta o idioma preferido polo cliente. Para acceder a el: $request->attributes->get('LANGUAGE')

Sessions

Proporciona unha interface sinxela para traballar con sesións. Para acceder á sesion: $request->attributes->get('SESSION'). Hai dous tipos de sesións:, _(*7)

Native (usa a implementación nativa de PHP)
Session (para traballar con sesións de proba)

Router

Proporciona un sinxelo sistema de enrutamento para MVC. Para acceder á ruta: $request->attributes->get('ROUTE'), _(*8)

The Versions

08/06 2015

dev-psr-7

dev-psr-7 https://github.com/fol-project/http

Http library

library http

Http library

fol/http

The README.md

Fol\Http

Exemplos

Uso básico

Uso con sesións e rutas

Classes

Request

Response

MiddlewareStack

Middlewares

Sessions

Router

The Versions

dev-psr-7

The Requires

by Oscar Otero

dev-master

The Requires

by Oscar Otero

v6.0.2

The Requires

by Oscar Otero

v6.0.1

The Requires

by Oscar Otero

v6.0

The Requires

by Oscar Otero

6.0.x-dev

The Requires

by Oscar Otero

v5.0.1

The Requires

by Oscar Otero

v5.0

The Requires

by Oscar Otero

v4.0.1

The Requires

by Oscar Otero

v4.0

The Requires

by Oscar Otero

v3.0

The Requires

by Oscar Otero

v2.0.3

The Requires

by Oscar Otero

v2.0.2

The Requires

by Oscar Otero

v2.0.1

The Requires

by Oscar Otero

v2.0.0

The Requires

by Oscar Otero

v1.0.0

The Requires

by Oscar Otero