The document introduces PSR-7 and middleware in Zend Expressive. It discusses PSR-7 interfaces like RequestInterface and ResponseInterface that define HTTP messages. It also covers middleware and how middleware can be used to add functionality like authentication. Zend Expressive is introduced as a framework that uses PSR-7 and middleware. It has features like routing, dependency injection and templating. Examples are given of creating middleware for authentication, downloading files, and handling unavailable pages. The document concludes by thanking the reader and providing contact details.

1. PSR-7‫و‬middleware-‫ها‬‫معرفی‬ ‫و‬end Expressive

2. ‫عربی‬ ‫میالد‬
8‫برنامه‬ ‫سال‬
‫نویس‬PHP
‫دهنده‬ ‫توسعه‬BSS/CRM
milad.arabi@gmail.com
@ooghry
Linkedin

3. microphp.org
I am a PHP developer
• I am not a Zend Framework or Symfony or CakePHP developer
• I think PHP is complicated enough
I like building small things
• I like building small things with simple purposes
• I like to make things that solve problems
• I like building small things that work together to solve larger problems
I want less code, not more
• I want to write less code, not more
• I want to manage less code, not more
• I want to support less code, not more
• I need to justify every piece of code I add to a project
I like simple, readable code
• I want to write code that is easily understood
• I want code that is easily verifiable

7. ‫دنیای‬PHP‫سال‬ ‫در‬
2016

8. http://www.php-fig.org/members/

9. PHP Standards Recommendations
PSR-0(DEPRECATED) Autoloading
PSR-1 Basic coding standard
PSR-2 Coding style
PSR-3 Logger
PSR-4 Autoloading
PSR-5(DRAFT) PHPDoc Standard
PSR-6 Caching Interface
PSR-7 HTTP Message Interface
PSR-8(DRAFT) Huggable Interface
PSR-9(DRAFT) Security Advisories

10. <?php
namespace SymfonyComponentHttpFoundation;
class Request
{
public static function createFromGlobals()
{
$request = self::createRequestFromFactory(
$_GET,
$_POST,
array(),
$_COOKIE,
$_FILES,
$server
);
return $request;
}
}

11. <?php
namespace ZendHttpPhpEnvironment;
class Request extends HttpRequest
{
public function __construct()
{
$this->setEnv(new Parameters($_ENV));
if ($_GET) {
$this->setQuery(new Parameters($_GET));
}
if ($_POST) {
$this->setPost(new Parameters($_POST));
}
if ($_COOKIE) {
$this->setCookies(new Parameters($_COOKIE));
}
if ($_FILES) {
// convert PHP $_FILES superglobal
$files = $this->mapPhpFiles();
$this->setFiles(new Parameters($files));
}
$this->setServer(new Parameters($_SERVER));
}
}

13. HTTP Message Interface
• PsrHttpMessageMessageInterface
o PsrHttpMessageResponseInterface
o PsrHttpMessageRequestInterface
 PsrHttpMessageServerRequestInterface
• PsrHttpMessageStreamInterface
• PsrHttpMessageUploadFileInterface
• PsrHttpMessageUriInterface

14. Message
ResponseRequestStream
Uploaded File Server Request URI
extends

15. Wrapper
Local filesystem file://
HTTP Address http:// https://
FTP ftp:// ftps://
SSL ssl:// tls://
MySQL tcp://
Zip zip://
MongoDB mongodb://
PHP php://input php://output
php://temp php://memory
<?php
file_get_contents('local_file.json');
file_get_contents('http://site.com/file.json');

16. Middleware
http://stackphp.com/

17. https://zend-expressive.readthedocs.io/en/latest/getting-started/features/

18. function(
RequestInterface $request,
ResponseInterface $response,
callable $next=null
):ReponseInterface

19. <?php
namespace Mine;
class XClacksOverhead
{
public function __invoke($request, $response, $next)
{
$response = $next($request, $response);
return $response->withHeader(
'X-Clacks-Overhead',
'GNU Terry Pratchett'
);
}
}

20. Zend Framework
https://github.com/zendframework

21. zend-diactoros
https://github.com/zendframework/zend-diactoros
PSR-7 HTTP Message implementation
zend-stratigility
https://github.com/zendframework/zend-stratigility
Middleware for PHP built on top of PSR-7

22. Zend Expressive
•Routing interface
•CountainerInterface
•Templating Interfaceoptional
•Error handlingoptional
composer create-project zendframework/zend-expressive-skeleton

24.  ZendExpressiveRouterRouterInterface
• public function addRoute(Route $route);
• public function match(Request $request);
• public function generateUri($name, array $substitutions = []);
 InteropContainerContainerInterface
• public function get($id);
• public function has($id);
 ZendExpressiveTemplateTemplateRendererInterface
• public function render($name, $params = []);
• public function addPath($path, $namespace = null);
• public function getPaths();
• public function addDefaultParam($templateName, $param, $value);
 ZendStratigilityFinalHandler

27. .1‫از‬ ‫استفاده‬ ‫با‬ ‫نصب‬composer
.2‫تعریف‬VirtualHost
.3‫فایل‬ ‫ویرایش‬hosts‫ویندوز‬

29. Invokable Factory
<?php
class iClass
{
public function method1()
{
return time();
}
}
<?php
class fClass
{
private $adapter;
public function __construct($adapter)
{
$this->adapter=$adapter;
}
public function method1()
{
return $this
->adapter
->someMethod();
}
}
//--------------------------
class fClassFactory
{
public function __invoke()
{
$adapter=new NSAdapterClass;
return new fClass($adapter);
}
}

30. https://github.com/ooghry/Zend-Expressive-CoderConf

31. composer require zendframework/zend-db
config/autoload/db.global.php
config/autoload/db.local.php
config/autoload/routes.global.php
[
'name' => 'user.list',
'path' => '/list',
'middleware'=>AppActionListAction::class,
'allowed_methods' => ['GET'],
],
templates/app/list.html.twig
AppActionListAction
AppActionListActionFactory

32. <?php
namespace AppAction;
use InteropContainerContainerInterface;
use ZendDbAdapterAdapterInterface;
use ZendExpressiveTemplateTemplateRendererInterface;
class ListActionFactory
{
public function __invoke(ContainerInterface $container)
{
$template = ($container->has(TemplateRendererInterface::class))
? $container->get(TemplateRendererInterface::class)
: null;
$adapter = ($container->has(AdapterInterface::class))
? $container->get(AdapterInterface::class)
: null;
return new ListAction($template,$adapter);
}
}

33. <?php
namespace AppAction;
use ...
class ListAction
{
private $adapter;
private $template;
public function __construct(TemplateRendererInterface $template, $adapter)
{
$this->adapter = $adapter;
$this->template = $template;
}
public function __invoke(
ServerRequestInterface $request,
ResponseInterface $response,
callable $next = null
){
$statement = $this->adapter->query('select * from profile');
$users = $statement->execute();
return new HtmlResponse(
$this->template->render('app::list', ['users' => $users])
);
}
}

35. <?php
namespace AppAction;
use ZendDiactorosResponseJsonResponse;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
class PingAction
{
public function __invoke(
ServerRequestInterface $request,
ResponseInterface $response,
callable $next = null)
{
return new JsonResponse(['ack' => time()]);
}
}

37. config/autoload/middleware-pipeline.global.php
'always' => [
'middleware' => [
HelperServerUrlMiddleware::class,
AppMiddlewareAuthMiddleware::class,
],
'priority' => PHP_INT_MAX,
],
config/autoload/dependencies.global.php
'factories' => [
AppMiddlewareAuthMiddleware::class => AppMiddlewareAuthMiddlewareFactory::class,
],
App
Auth

38. src/App/Middleware/AuthMiddleware.php
<?php
namespace AppMiddleware;
use ...
class AuthMiddleware
{
private $helper;
public function __construct(UrlHelper $helper)
{
$this->helper=$helper;
}
public function __invoke(ServerRequestInterface $request, ResponseInterface $response, callable $next = null)
{
if($this->helper->generate('api.ping')!=$request->getUri()->getPath()) {
$auth = $this->parseAuth($request->getHeaderLine('Authorization'));
if (!$auth or !$this->checkUserPass($auth['user'], $auth['pass'])) {
return $response
->withHeader('WWW-Authenticate', 'Basic realm=""')
->withStatus(401);
}
}
$response = $next($request, $response);
return $response;
}
}

39. Download Middleware
config/autoload/routes.global.php
[
'name' => 'download',
'path' => '/download/{file:[_0-9a-zA-Z-]+.w{1,}}',
'middleware' => AppActionDownloadAction::class,
'allowed_methods' => ['GET'],
],
AppActionDownloadAction
class DownloadAction
{
public function __invoke($request, $response, $next = null)
{
$file='data'.$request->getUri()->getPath();
if(is_readable($file)){
return $response
->write(file_get_contents($file))
->withHeader(
'Content-Disposition',
'inline; filename="' . pathinfo($file,PATHINFO_BASENAME) . '"'
)
->withHeader('Content-type',pathinfo($file,PATHINFO_EXTENSION))
->withStatus(200);
}else{
return $next($request, $response);
}
}
}

41. App
Auth
Unavailable

42. config/autoload/middleware-pipeline.global.php
'middleware' => [
HelperServerUrlMiddleware::class,
AppMiddlewareUnavailableMiddleware::class,
AppMiddlewareAuthMiddleware::class,
],
AppMiddlewareUnavailableMiddleware
public function __invoke($request, $response, callable $next = null)
{
if (date('G') == '23' || (date('G') == '0' && date('i') < '30')) {
return new HtmlResponse($this->template->render('app::unavailable'));
}
$response = $next($request, $response);
return $response;
}
AppMiddlewareUnavailableMiddlewareFactory
templates/app/unavailable.html.twig
config/autoload/dependencies.global.php

44. ‫متشکرم‬
PSR-7‫و‬middleware-‫معرفی‬ ‫و‬ ‫ها‬Zend Expressive
‫عربی‬ ‫میالد‬
milad.arabi@gmail.com
@ooghry
Linkedin
https://github.com/ooghry/Zend-Expressive-CoderConf