Symfony & HTTP

Symfony & HTTP Introduction to HTTPFoundation & HTTPKernel Components [email protected]
@methylbro Meetup Drupal, Montpellier Wednesday, March 18, 2015

The Workflow of a Request

Definition • HTTPFoundation A programmable Interface for Requests & Responses.
• HTTPKernel An implementation of the HTTP workflow.

HTTP Foundation

Accessible properties of Request • request equivalent of $_POST; •
query equivalent of $_GET ($request->query->get('name')); • cookies equivalent of $_COOKIE; • attributes no equivalent - used by your app to store other data (see below); • files equivalent of $_FILES; • server equivalent of $_SERVER; • headers mostly equivalent to a sub-set of $_SERVER ($request->headers->get('User-Agent')).

HTTPFoundation/Request <?php // /example.php?id=3 use Symfony\Component\HttpFoundation\Request; $request = Request::createFromGlobals(); $id
= $request->query->get('id');

HTTPFoundation/Session <?php use Symfony\Component\HttpFoundation\Request; $request = Request::createFromGlobals(); $session = $request->getSession();
$message = $request->request->get(‘message'); $session->set(‘last_message‘, [ ‘message’ => $message, ‘datetime’ => new DateTime(‘now’), ]);

HTTPFoundation/Response <?php $content = <<<HTML <html><body>It works !</body></html> HTML; $response
= new Response( $content, Response::HTTP_OK, ['content-type' => 'text/html'] );

Redirections <?php use Symfony\Component\HttpFoundation\RedirectResponse; $response = new RedirectResponse( 'http://methylbro.fr/', Response::HTTP_MOVED_PERMANENTLY
);

Managing Cookies <?php use Symfony\Component\HttpFoundation\Cookie; $cookie = new Cookie('cookie', 'miam!);
$response->headers->setCookie($cookie);

Sending the Response <?php // … $response->prepare($request); $response->send();

Controller Example Using HTTPFoundation <?php class ArticleController { private $manager;
public function __construct($article_manager) { $this->manager = $article_manager; } public function readName(Request $request) { $id = $request->query->get('id'); if ($article = $this->manager->getOneById($id)) { $response = new Response($article->getName(), Response::HTTP_OK, ['content-type' => 'text/plain']); } else { $response = new Response('Not found', Response::HTTP_NOT_FOUND, ['content-type' => 'text/plain']); } return $response; } }

HTTP Kernel

HTTPKernel::handle <?php namespace Symfony\Component\HttpKernel; use Symfony\Component\HttpFoundation\Request; interface HttpKernelInterface { //
... /** * @return Response A Response instance */ public function handle( Request $request, $type = self::MASTER_REQUEST, $catch = true ); }

exception Request request resolve controller controller resolve arguments view response
Response terminate exception Sub-Request Call Controller “sub-response” content response?

• EventDispatcher : Implementation of Observer pattern used to handle
events. • ControllerResolver : Here’s Drupal begins.

Example <?php // create the Request object $request = Request::createFromGlobals();
$dispatcher = new EventDispatcher(); // ... add some event listeners // create your controller resolver $resolver = new ControllerResolver(); // instantiate the kernel $kernel = new HttpKernel($dispatcher, $resolver); // actually execute the kernel, which turns the request into a response // by dispatching events, calling a controller, and returning the response $response = $kernel->handle($request); // send the headers and echo the content $response->send(); // triggers the kernel.terminate event $kernel->terminate($request, $response);

Interests • HTTP Foundation ◦ grasp simply the HTTP headers
◦ mocking Request & Response in your tests • HTTP Kernel ◦ loading from multiple environments ◦ resolving dynamically controller arguments

#RTFM HTTP Foundation : http://symfony.com/doc/current/components/http_foundation/introduction.html HTTP Kernel : http://symfony.com/doc/current/components/http_kernel/introduction.html

Questions ?

Symfony & HTTP

Symfony & HTTP

Thomas Gasc

More Decks by Thomas Gasc

Other Decks in Programming

Featured

Transcript

Symfony & HTTP Introduction to HTTPFoundation & HTTPKernel Components [email protected]

The Workflow of a Request

Definition • HTTPFoundation A programmable Interface for Requests & Responses.

HTTP Foundation

Accessible properties of Request • request equivalent of $_POST; •

HTTPFoundation/Request <?php // /example.php?id=3 use Symfony\Component\HttpFoundation\Request; $request = Request::createFromGlobals(); $id

HTTPFoundation/Session <?php use Symfony\Component\HttpFoundation\Request; $request = Request::createFromGlobals(); $session = $request->getSession();

HTTPFoundation/Response <?php $content = <<<HTML <html><body>It works !</body></html> HTML; $response

Redirections <?php use Symfony\Component\HttpFoundation\RedirectResponse; $response = new RedirectResponse( 'http://methylbro.fr/', Response::HTTP_MOVED_PERMANENTLY

Managing Cookies <?php use Symfony\Component\HttpFoundation\Cookie; $cookie = new Cookie('cookie', 'miam!);

Sending the Response <?php // … $response->prepare($request); $response->send();

Controller Example Using HTTPFoundation <?php class ArticleController { private $manager;

HTTP Kernel

HTTPKernel::handle <?php namespace Symfony\Component\HttpKernel; use Symfony\Component\HttpFoundation\Request; interface HttpKernelInterface { //

exception Request request resolve controller controller resolve arguments view response

• EventDispatcher : Implementation of Observer pattern used to handle

Example <?php // create the Request object $request = Request::createFromGlobals();

Interests • HTTP Foundation ◦ grasp simply the HTTP headers

#RTFM HTTP Foundation : http://symfony.com/doc/current/components/http_foundation/introduction.html HTTP Kernel : http://symfony.com/doc/current/components/http_kernel/introduction.html

Questions ?