Middleware web APIs in PHP 7.x

MIDDLEWARE WEB APIS IN PHP 7.X
Jan Burkl
Solution Consulting Manager
, Dresden, 22nd September 2017
Rogue Wave Software
php developer day 2017

PHP
PHP: Hypertext Preprocessor
The most popular server-side language: PHP is
used by 82.6% of all the websites (source:
)
Used by Facebook, Wikipedia, Yahoo, Etsy,
Flickr, Digg, etc
22 years of usage, since 1995
Full OOP support since PHP 5
w3techs.com

PHP 7
Released: 3 December 2015
Previous major was , 13 July 2004
Skipped PHP 6: Unicode failure
Last release is (3 Aug 2017)
PHP 5
7.1.8

PHP 7 PERFORMANCE
PHP 7 is also faster than !Python 3

BENCHMARK
PHP 5.6 PHP 7
Memory Usage 428 MB 33 MB
Execution time 0.49 sec 0.06 sec
$a = [];
for ($i = 0; $i < 1000000; $i++) {
$a[$i] = ["hello"];
}
echo memory_get_usage(true);

MOVING TO PHP 7
Badoo saved one million dollars switching to PHP
7 ( )
Tumblr reduced the latency and CPU load by half
moving to PHP 7 ( )
Dailymotion handles twice more traffic with
same infrastructure switching to PHP 7 ( )
source
source
source

PHP 7 IS NOT ONLY FAST!
Return and Scalar Type Declarations
Improved Exception hierarchy
Many fatal errors converted to Exceptions
Secure random number generator
Authenticated encryption AEAD (PHP 7.1+)
Nullable types (PHP 7.1+)
and !more

EXAMPLE
Request:
Response:
GET /api/version
HTTP/1.1 200 OK
Connection: close
Content-Length: 17
Content-Type: application/json
{
"version": "1.0"
}

MIDDLEWARE
A function that gets a request and generates a
response
use PsrHttpMessageServerRequestInterface as Request;
use InteropHttpServerMiddlewareDelegateInterface;
function (Request $request, DelegateInterface $next)
{
// doing something with $request...
// for instance calling the delegate middleware $next
$response = $next->process($request);
// manipulate the $response
return $response;
}

DELEGATEINTERFACE
DelegateInterface is part of HTTP Middleware proposal
namespace InteropHttpServerMiddleware;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
interface DelegateInterface
{
/**
* @return ResponseInterface;
*/
public function process(ServerRequestInterface $request);
}
PSR-15

EXPRESSIVE 2.0
The PHP framework for Middleware applications
PSR-7 HTTP Message support (using
)
Support of lambda middleware (PSR-15) and
double pass ($request, $response, $next)
Piping workflow (using )
Features: routing, dependency injection,
templating, error handling
Last release 2.0.3, 28th March 2017
zend-
diactoros
zend-stratigility

INSTALLATION
You can install Expressive 2.0 using :
Choose the default options during the installation
composer
composer create-project
zendframework/zend-expressive-skeleton api

DEFAULT
The skeleton has 2 URL as example: / and
/api/ping
The routes are registered in /config/routes.php
The middleware actions are stored in
/src/App/Action

ROUTES
/config/routes.php
$app->get('/', AppActionHomePageAction::class, 'home');
$app->get('/api/ping', AppActionPingAction::class, 'api.ping');

API MIDDLEWARE
/src/App/Action/PingAction.php
namespace AppAction;
use InteropHttpServerMiddlewareMiddlewareInterface;
use ZendDiactorosResponseJsonResponse;
class PingAction implements MiddlewareInterface
{
public function process(
ServerRequestInterface $request,
DelegateInterface $delegate
) {
return new JsonResponse(['ack' => time()]);
}
}

PIPELINE WORKFLOW
/config/pipeline.php
$app->pipe(ErrorHandler::class);
$app->pipe(ServerUrlMiddleware::class);
$app->pipeRoutingMiddleware();
$app->pipe(ImplicitHeadMiddleware::class);
$app->pipe(ImplicitOptionsMiddleware::class);
$app->pipe(UrlHelperMiddleware::class);
$app->pipeDispatchMiddleware();
$app->pipe(NotFoundHandler::class);

SERVICE CONTAINER
/config/container.php
use ZendServiceManagerConfig;
use ZendServiceManagerServiceManager;
$config = require __DIR__ . '/config.php';
$container = new ServiceManager();
$config = new Config($config['dependencies']);
$config->configureServiceManager($container);
$container->setService('config', $config);
return $container;

THE EXPRESSIVE APP
/public/index.php
chdir(dirname(__DIR__));
require 'vendor/autoload.php';
call_user_func(function () {
$container = require 'config/container.php';
$app = $container->get(ZendExpressiveApplication::class
require 'config/pipeline.php';
require 'config/routes.php';
$app->run();
});

ROUTE A REST API
$app->route('/api/users[/{user-id}]', [
AuthenticationAuthenticationMiddleware::class,
AuthorizationAuthorizationMiddleware::class,
ApiActionUserAction::class
], ['GET', 'POST', 'PATCH', 'DELETE'], 'api.users');
// or route each HTTP method
$app->get('/api/users[/{user-id}]', ..., 'api.users.get');
$app->post('/api/users', ..., 'api.users.post');
$app->patch('/api/users/{user-id}', ..., 'api.users.patch');
$app->delete('/api/users/{user-id}', ..., 'api.users.delete');

REST DISPATCH TRAIT
trait RestDispatchTrait
{
public function process(
ServerRequestInterface $request,
DelegateInterface $delegate
) {
$method = strtolower($request->getMethod());
if (method_exists($this, $method)) {
return $this->$method($request);
}
return $response->withStatus(501); // Method not implem
}

REST MIDDLEWARE
ApiActionUserAction.php
class UserAction implements MiddlewareInterface
{
use RestDispatchTrait;
public function get(ServerRequestInterface $request)
{
$id = $request->getAttribute('user-id', false);
$data = (false === $id) ? /* all users */ : /* user id */;
return new JsonResponse($data);
}
public function post(ServerRequestInterface $request){ ... }
public function patch(ServerRequestInterface $request){ ... }
public function delete(ServerRequestInterface $request){ ...
}

DANKE SCHÖN
Slides: http://5square.github.io/talks/
More info:
Contact me: jan.burkl [at] roguewave.com
Follow me:
Credits:
This work is licensed under a
.
I used to make this presentation.
https://framework.zend.com/blog
@janatzend
@ezimuel
Creative Commons Attribution-ShareAlike 3.0 Unported License
reveal.js

Middleware web APIs in PHP 7.x

More Related Content

What's hot (9)

Similar to Middleware web APIs in PHP 7.x (20)

More from Zend by Rogue Wave Software (20)

Recently uploaded (20)

Middleware web APIs in PHP 7.x