Developing web APIs using middleware in PHP 7
2 likes1,921 views
The document discusses the development of web APIs using middleware in PHP 7, detailing its enhanced performance and features compared to previous versions. It also provides a tutorial on setting up a PHP middleware application using Zend Expressive framework, including examples of routing, service containers, and the implementation of a RESTful API. Key highlights include PHP 7's speed improvements, memory efficiency, and the structure of middleware components.
![BENCHMARK
$a = [];
for ($i = 0; $i < 1000000; $i++) {
$a[$i] = ["hello"];
}
echo memory_get_usage(true);
PHP 5.6 PHP 7
Memory Usage 428 MB 33 MB
Execution time 0.49 sec 0.06 sec](https://image.slidesharecdn.com/apiconf2017-170630140212/85/Developing-web-APIs-using-middleware-in-PHP-7-7-320.jpg)
![APIMIDDLEWARE
namespace AppAction;
use InteropHttpServerMiddlewareDelegateInterface;
use InteropHttpServerMiddlewareMiddlewareInterface;
use ZendDiactorosResponseJsonResponse;
use PsrHttpMessageServerRequestInterface;
class PingAction implements MiddlewareInterface
{
public function process(
ServerRequestInterface $request,
DelegateInterface $delegate
) {
return new JsonResponse(['ack' => time()]);
}
}
/src/App/Action/PingAction.php](https://image.slidesharecdn.com/apiconf2017-170630140212/85/Developing-web-APIs-using-middleware-in-PHP-7-20-320.jpg)
![SERVICECONTAINER
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;
/con g/container.php](https://image.slidesharecdn.com/apiconf2017-170630140212/85/Developing-web-APIs-using-middleware-in-PHP-7-22-320.jpg)
![ROUTEARESTAPI
$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');](https://image.slidesharecdn.com/apiconf2017-170630140212/85/Developing-web-APIs-using-middleware-in-PHP-7-24-320.jpg)
![THANKS!
More info: https://framework.zend.com/blog
Contact me: enrico.zimuel [at] roguewave.com
Follow me: @ezimuel
This work is licensed under a
.
I used to make this presentation.
Creative Commons Attribution-ShareAlike 3.0 Unported License
reveal.js](https://image.slidesharecdn.com/apiconf2017-170630140212/85/Developing-web-APIs-using-middleware-in-PHP-7-27-320.jpg)
Developing web APIs using middleware in PHP 7
- 1. DEVELOPINGWEBAPIS USINGMIDDLEWAREINPHP7 by Senior Software Engineer , a Rogue Wave Company (USA) , Turin, 15th June 2017 Enrico Zimuel Zend ApiConf
- 2. ABOUTME Developer since 1996 Senior Software Engineer at , a Company Core team of and and international speaker Research Programmer at Author of and Co-founder of Zend Rogue Wave Apigility ZF TEDx UvA books articles PUG Torino
- 4. 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
- 5. PHP7 Released: 3 December 2015 Previous major was , 13 July 2004PHP 5 Skipped PHP 6: Unicode failure Last release is (8 Jun 2017)7.1.6
- 6. PHP7PERFORMANCE PHP 7 is also faster than !Python 3
- 7. BENCHMARK $a = []; for ($i = 0; $i < 1000000; $i++) { $a[$i] = ["hello"]; } echo memory_get_usage(true); PHP 5.6 PHP 7 Memory Usage 428 MB 33 MB Execution time 0.49 sec 0.06 sec
- 8. MOVINGTOPHP7 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 tra c with same infrastructure switching to PHP 7 ( ) source source source
- 9. PHP7ISNOTONLYFAST! 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
- 10. WEBAPISINPHP7
- 11. HTTPIN/OUT
- 12. EXAMPLE Request: GET /api/version Response: HTTP/1.1 200 OK Connection: close Content-Length: 17 Content-Type: application/json { "version": "1.0" }
- 13. 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; } This is called lambda middleware.
- 14. DELEGATEINTERFACE namespace InteropHttpServerMiddleware; use PsrHttpMessageResponseInterface; use PsrHttpMessageServerRequestInterface; interface DelegateInterface { /** * @return ResponseInterface; */ public function process(ServerRequestInterface $request); } DelegateInterface is part of HTTP Middleware proposalPSR-15
- 16. EXPRESSIVE2.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 work ow (using ) Features: routing, dependency injection, templating, error handling Last release 2.0.3, 28th March 2017 zend-diactoros zend-stratigility
- 17. INSTALLATION You can install Expressive 2.0 using :composer composer create-project zendframework/zend-expressive-skeleton api Choose the default options during the installation
- 18. DEFAULT The skeleton has 2 URL as example: / and /api/ping The routes are registered in /con g/routes.php The middleware actions are stored in /src/App/Action
- 19. ROUTES $app->get('/', AppActionHomePageAction::class, 'home'); $app->get('/api/ping', AppActionPingAction::class, 'api.ping'); /con g/routes.php
- 20. APIMIDDLEWARE namespace AppAction; use InteropHttpServerMiddlewareDelegateInterface; use InteropHttpServerMiddlewareMiddlewareInterface; use ZendDiactorosResponseJsonResponse; use PsrHttpMessageServerRequestInterface; class PingAction implements MiddlewareInterface { public function process( ServerRequestInterface $request, DelegateInterface $delegate ) { return new JsonResponse(['ack' => time()]); } } /src/App/Action/PingAction.php
- 22. SERVICECONTAINER 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; /con g/container.php
- 23. THEEXPRESSIVEAPP 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(); }); /public/index.php
- 24. ROUTEARESTAPI $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');
- 25. RESTDISPATCHTRAIT use PsrHttpMessageServerRequestInterface; use InteropHttpServerMiddlewareDelegateInterface; 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 implemented } }
- 26. RESTMIDDLEWARE 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){ ... } } ApiActionUserAction.php
- 27. THANKS! More info: https://framework.zend.com/blog Contact me: enrico.zimuel [at] roguewave.com Follow me: @ezimuel This work is licensed under a . I used to make this presentation. Creative Commons Attribution-ShareAlike 3.0 Unported License reveal.js