Building web APIs in PHP with Zend Expressive

Building web APIs in PHPBuilding web APIs in PHP
with Zend Expressivewith Zend Expressive
Enrico Zimuel
Senior software engineer, Rogue Wave Software

About meAbout me
PHP developer since 1999
Senior Software Engineer at
Inc.
Core team of ,
and
and international speaker
Research Programmer at
Co-founder of (Italy)
Rogue Wave Software
Apigility
Expressive Zend Framework
TEDx
Amsterdam University
PUG Torino
© 2018 Rogue Wave Software, Inc. All Rights Reserved.

Building a Web APIBuilding a Web API
Managing the HTTP request and response
Choosing a representation format
Choosing an error format
Filtering & validating input data
Authenticating HTTP requests
Authorizing HTTP requests
Documentation

HTTP request in PHPHTTP request in PHP
Managed using global variables 
$_SERVER
$_POST
$_GET
$_FILES
$_COOKIE

HTTP response in PHPHTTP response in PHP
http_response_code()
header(), header_remove(), headers_list(),
headers_sent()
setcookie(), setrawcookie()
direct output for body content (bu ered)

PSR-7PSR-7
PHP Standards Recommendations (PSR)
Part of PHP Framework Interop Group (PHP FIG)
PSR-7 is a collection of interfaces for representing
HTTP messages as described in and
, and URIs for use with HTTP messages as
described in
RFC 7230 RFC
7231
RFC 3986

ExampleExample
// Request
$header = $request->getHeader('Accept');
$query = $request->getQueryParams();
$body = $request->getBodyParams();
// Response
$response = $response->withStatus(418, "I'm a teapot");
$response = $response->withBodyParams(json_encode($body));

MiddlewareMiddleware
A function that gets a request and generates a response
function ($request)
{
// do something with $request
return $response;
}

Delegating middlewareDelegating middleware
Create a pipeline of execution
function ($request, $delegate)
{
// delegating another middleware
$response = $delegate($request);
return $response;
}

Example: cacheExample: cache
function ($request, $delegate) use ($cache)
{
if ($cache->has($request)) {
return $cache->get($request);
}
$response = $delegate($request);
$cache->set($request, $response);
return $response;
}

The PHP framework for middleware applications
PSR-7 support (using )
PSR-15 support
Piping work ow (using )
Features: routing, dependency injection, templating,
error handling
Last release 3.1.0, 22th June 2018
zend-diactoros
zend-stratigility

A basic web APIA basic web API
use ZendDiactorosResponseJsonResponse;
use ZendExpressiveApplication;
$container = require 'config/container.php';
$app = $container->get(Application::class);
$app->pipe('/api/ping', function($request) {
return new JsonResponse(['ack' => time()]);
});
// or $app->pipe('/api/ping', AppHandlerPingHandler::class);
$app->run();

Request Handler (PSR-15)Request Handler (PSR-15)
use PsrHttpMessageResponseInterface; // PSR-7
use PsrHttpMessageServerRequestInterface; // PSR-7
use PsrHttpServerRequestHandlerInterface; // PSR-15
use ZendDiactorosResponseJsonResponse;
class PingHandler implements RequestHandlerInterface
{
public function handle(
ServerRequestInterface $request
) : ResponseInterface
{
return new JsonResponse(['ack' => time()]);
}
}
A request handler generates a response from an HTTP request

Middleware (PSR-15)Middleware (PSR-15)
use PsrHttpServerMiddlewareInterface; // PSR-15
class CacheMiddleware implements MiddlewareInterface
{
// ...
public function process(
ServerRequestInterface $request,
RequestHandlerInterface $handler
): ResponseInterface {
if ($this->cache->has($request)) {
return $this->cache->get($request);
}
$response = $handler($request);
$this->cache->set($request, $response);
return $response;
}
}
A middleware participates in processing an HTTP message, it may deletegate

Expressive tool for APIExpressive tool for API
HAL-JSON:
Problem details:
Filtering & validation:
Authentication (HTTP Basic, OAuth2):
Authorization (ACL, RBAC):
zend-expressive-hal
zend-problem-details
zend-input lter
zend-expressive-
authentication
zend-expressive-
authorization
REST API example: ezimuel/zend-expressive-api

Thanks!Thanks!
More information: getexpressive.org
Free Expressive ebook

Join our seriesJoin our series
2018 PHP expert talks2018 PHP expert talks
August 23: –
Zeev Suraski
A match made in heaven, learn the capabilities in Zend Server that help optimize apps and boost
performance.
Maxing out performance with Zend Server on PHP 7
September 20: –
Massimiliano Cavicchioli
As the top platform for modernizing IBM i applications, learn how to build PHP apps on i using Zend
Expressive, Zend Server, IBM i Toolkit, and DB2.
Building PHP applications fast for IBM i
On demand: – Zeev SuraskiTo PHP 7 and beyond

Building web APIs in PHP with Zend Expressive

Recommended

Recommended

More Related Content

What's hot

What's hot (10)

Similar to Building web APIs in PHP with Zend Expressive

Similar to Building web APIs in PHP with Zend Expressive (20)

More from Zend by Rogue Wave Software

More from Zend by Rogue Wave Software (20)

Recently uploaded

Recently uploaded (20)

Building web APIs in PHP with Zend Expressive