Build Your Framework Like Constructicons - PHPKonf 2017

While we have a strong offering of full-stack frameworks and microframeworks, the rise of components and libraries combined with Composer allows us to easily build our own framework without reinventing the wheel. In this talk, I'll show you how the total can be more than the sum of the parts, such as Devastator was stronger than the individual Constructicons in Transformers.

Transcript

1. View Slide

2. BUILD YOUR FRAMEWORK
   LIKE CONSTRUCTICONS
   

   View Slide

3. HI, I'M STEFAN
   

   View Slide

4. HI, I'M STEFAN
   > Ingewikkeld
   

   View Slide

5. HI, I'M STEFAN
   > Ingewikkeld
   > former Zend Framework translator
   

   View Slide

6. HI, I'M STEFAN
   > Ingewikkeld
   > former Zend Framework translator
   > former Symfony Community Manager
   

   View Slide

7. View Slide

8. View Slide

9. View Slide

10. View Slide

11. View Slide

12. WAIT, WHAT?
    

    View Slide

13. WHO HAS BUILT THEIR
    OWN FRAMEWORK?
    

    View Slide

14. View Slide

15. WHO IS STILL USING A
    CUSTOM-BUILT
    FRAMEWORK?
    

    View Slide

16. View Slide

17. THE CASE FOR A
    FRAMEWORK
    

    View Slide

18. View Slide

19. View Slide

20. OPEN SOURCE
    

    View Slide

21. SO WHY WOULD WE BUILD IT OURSELVES?
    

    View Slide

22. SO WHY WOULD WE BUILD IT OURSELVES?
    > Custom needs
    

    View Slide

23. SO WHY WOULD WE BUILD IT OURSELVES?
    > Custom needs
    > Because we're developers (NIH)
    

    View Slide

24. SO WHY WOULD WE BUILD IT OURSELVES?
    > Custom needs
    > Because we're developers (NIH)
    > An open source framework is overkill
    

    View Slide

25. SO WHY WOULD WE BUILD IT OURSELVES?
    > Custom needs
    > Because we're developers (NIH)
    > An open source framework is overkill
    > As a learning experience
    

    View Slide

26. SURELY, THERE ARE MANY
    MORE REASONS
    

    View Slide

27. IT IS OK TO BUILD YOUR
    OWN FRAMEWORK
    

    View Slide

28. IT IS NOT OK TO WRITE
    ALL THE CODE FOR IT
    YOURSELF
    

    View Slide

29. WELL, ACTUALLY...
    

    View Slide

30. View Slide

31. WRONG MOVIE
    

    View Slide

32. YESTERDAY
    

    View Slide

33. YESTERDAY
    

    View Slide

34. COMPOSER
    

    View Slide

35. View Slide

36. View Slide

37. REQUEST AND
    RESPONSE
    

    View Slide

38. ROUTING
    

    View Slide

39. TEMPLATING
    

    View Slide

40. HANDLING
    CONFIGURATION
    

    View Slide

41. SENDING E-MAIL
    

    View Slide

42. DOING VALIDATION
    

    View Slide

43. THE CODE
    

    View Slide

44. COMPOSER INIT
    

    View Slide

45. COMPOSER INIT
    {
    "name": "stefankoopmanschap/constructicons",
    "authors": [
    {
    "name": "Stefan Koopmanschap",
    "email": "stefan@ingewikkeld.net"
    }
    ],
    "require": {}
    }
    

    View Slide

46. REQUEST AND RESPONSE
    

    View Slide

47. REQUEST AND RESPONSE
    > react/http
    

    View Slide

48. REQUEST AND RESPONSE
    > react/http
    > illuminate/http
    

    View Slide

49. REQUEST AND RESPONSE
    > react/http
    > illuminate/http
    > symfony/http-foundation
    

    View Slide

50. REQUEST AND RESPONSE
    composer require symfony/http-foundation
    

    View Slide

51. REQUEST AND RESPONSE
    "require": {
    "symfony/http-foundation": "^3.1"
    }
    

    View Slide

52. INDEX.PHP AND COMPOSER
    require(
    __DIR__ . ' /../vendor/autoload.php'
    );
    

    View Slide

53. REQUEST AND RESPONSE
    use \Symfony\Component\HttpFoundation\Request;
    use \Symfony\Component\HttpFoundation\Response;
    $request = Request::createFromGlobals();
    $response = new Response(
    'Hello ' . $request->get('name', 'world')
    );
    $response->send();
    

    View Slide

54. /?NAME=STEFAN
    RESULTS IN
    HELLO STEFAN
    

    View Slide

55. View Slide

56. ROUTING
    

    View Slide

57. ROUTING
    > symfony/routing
    

    View Slide

58. ROUTING
    > symfony/routing
    > illuminate/routing
    

    View Slide

59. ROUTING
    > symfony/routing
    > illuminate/routing
    > zendframework/zend-router
    

    View Slide

60. ROUTING
    > symfony/routing
    > illuminate/routing
    > zendframework/zend-router
    > nikic/fast-route
    

    View Slide

61. ROUTING
    composer require nikic/fast-route
    

    View Slide

62. ROUTING
    $dispatcher = FastRoute\simpleDispatcher(
    function(FastRoute\RouteCollector $r) use ($request) {
    $r->addRoute('GET', '/hello', function() use ($request) {
    $response = new Response(
    'Hello ' . $request->get('name', 'world')
    );
    $response->send();
    });
    $r->addRoute('GET', '/goodbye', function() use ($request) {
    $response = new Response(
    'Goodbye ' . $request->get('name', 'world')
    );
    $response->send();
    });
    }
    );
    

    View Slide

63. ROUTING
    $dispatcher = FastRoute\simpleDispatcher(
    function(FastRoute\RouteCollector $r) use ($request) {
    // do stuff here
    }
    );
    

    View Slide

64. ROUTING
    $r->addRoute('GET', '/hello', function() use ($request) {
    $response = new Response(
    'Hello ' . $request->get('name', 'world')
    );
    $response->send();
    });
    $r->addRoute('GET', '/goodbye', function() use ($request) {
    $response = new Response(
    'Goodbye ' . $request->get('name', 'world')
    );
    $response->send();
    });
    

    View Slide

65. ROUTING
    $r->addRoute('GET', '/hello', function() use ($request) {
    $response = new Response(
    'Hello ' . $request->get('name', 'world')
    );
    $response->send();
    });
    $r->addRoute('GET', '/goodbye', function() use ($request) {
    $response = new Response(
    'Goodbye ' . $request->get('name', 'world')
    );
    $response->send();
    });
    

    View Slide

66. ROUTING
    $r->addRoute('GET', '/hello', function() use ($request) {
    $response = new Response(
    'Hello ' . $request->get('name', 'world')
    );
    $response->send();
    });
    $r->addRoute('GET', '/goodbye', function() use ($request) {
    $response = new Response(
    'Goodbye ' . $request->get('name', 'world')
    );
    $response->send();
    });
    

    View Slide

67. ROUTING
    $routeInfo = $dispatcher->dispatch(
    $request->getMethod(),
    $request->getRequestUri()
    );
    if (is_callable($routeInfo[1])) {
    $routeInfo[1]();
    }
    

    View Slide

68. ROUTING
    $routeInfo = $dispatcher->dispatch(
    $request->getMethod(),
    $request->getRequestUri()
    );
    if (is_callable($routeInfo[1])) {
    $routeInfo[1]();
    }
    

    View Slide

69. ROUTING
    $r->addRoute('GET', '/hello[/{name}]', function($params) use ($request) {
    $name = $params['name'] ?? 'world';
    $response = new Response(
    'Hello ' . $name
    );
    $response->send();
    });
    $r->addRoute('GET', '/goodbye[/{name}]', function() use ($request) {
    $name = $params['name'] ?? 'world';
    $response = new Response(
    'Goodbye ' . $name
    );
    $response->send();
    });
    

    View Slide

70. ROUTING
    if (is_callable($routeInfo[1])) {
    $params = ($routeInfo[2]) ?? [];
    $routeInfo[1]($params);
    }
    

    View Slide

71. View Slide

72. TEMPLATING
    

    View Slide

73. TEMPLATING
    > zetacomponents/template
    

    View Slide

74. TEMPLATING
    > zetacomponents/template
    > eden/template
    

    View Slide

75. TEMPLATING
    > zetacomponents/template
    > eden/template
    > twig/twig
    

    View Slide

76. TEMPLATING
    composer require twig/twig
    

    View Slide

77. TEMPLATING
    $twigLoader = new Twig_Loader_Filesystem(
    __DIR__ . '/../views/'
    );
    $twig = new Twig_Environment($twigLoader, [
    'cache' => '/tmp/twigCache',
    ]);
    

    View Slide

78. TEMPLATING
    function(FastRoute\RouteCollector $r) use (
    $request, $twig
    ) {
    

    View Slide

79. TEMPLATING
    $r->addRoute(
    'GET',
    '/hello[/{name}]',
    function($params) use ($request, $twig) {
    $name = $params['name'] ?? 'world';
    $response = new Response(
    $twig->render('hello.twig', [
    'name' => $name
    ]
    )
    );
    $response->send();
    });
    

    View Slide

80. TEMPLATING
    hello.twig
    Hello {{ name }}
    goodbye.twig
    Goodbye {{ name }}
    

    View Slide

81. HANDLING CONFIGURATION
    

    View Slide

82. HANDLING CONFIGURATION
    > symfony/config
    

    View Slide

83. HANDLING CONFIGURATION
    > symfony/config
    > illuminate/config
    

    View Slide

84. HANDLING CONFIGURATION
    > symfony/config
    > illuminate/config
    > packaged/config
    

    View Slide

85. HANDLING CONFIGURATION
    > symfony/config
    > illuminate/config
    > packaged/config
    > werx/config
    

    View Slide

86. HANDLING CONFIGURATION
    $r->addRoute(
    'GET',
    '/contact',
    function() use ($request, $twig) {
    $response = new Response(
    $twig->render('contact.twig', [])
    );
    $response->send();
    }
    );
    

    View Slide

87. HANDLING CONFIGURATION
    
    Your name:
    
    Your e-mailaddress:
    
    Your message:
    
    
    
    
    
    

    View Slide

88. HANDLING CONFIGURATION
    $r->addRoute(
    'POST',
    '/contact',
    function() use ($request) {
    $mailbody = 'An e-mail was sent through the site with the following message: ' .
    $request->get('message') . "\n";
    $mailbody .= 'Sent by: ' .
    $request->get('name') .
    '<' . $request->get('email') . '>';
    mail(
    'my-email@example.org',
    'An e-mail from the site',
    $mailbody
    );
    $response = new \Symfony\Component\HttpFoundation\RedirectResponse('/hello');
    $response->send();
    }
    );
    

    View Slide

89. HANDLING CONFIGURATION
    composer require werx/config
    

    View Slide

90. HANDLING CONFIGURATION
    $configProvider = new \werx\Config\Providers\JsonProvider(
    __DIR__ . '/../config/'
    );
    $config = new \werx\Config\Container($configProvider);
    $config->load('config');
    

    View Slide

91. HANDLING CONFIGURATION
    $r->addRoute(
    'POST',
    '/contact',
    function() use ($request, $config)
    {
    

    View Slide

92. HANDLING CONFIGURATION
    mail(
    $config->get('contact_email'),
    'An e-mail from the site',
    $mailbody
    );
    

    View Slide

93. HANDLING CONFIGURATION
    mail(
    $config->get('contact_email'),
    'An e-mail from the site',
    $mailbody
    );
    

    View Slide

94. SENDING E-MAIL
    

    View Slide

95. SENDING E-MAIL
    > nette/mail
    

    View Slide

96. SENDING E-MAIL
    > nette/mail
    > zetacomponents/mail
    

    View Slide

97. SENDING E-MAIL
    > nette/mail
    > zetacomponents/mail
    > swiftmailer/swiftmailer
    

    View Slide

98. SENDING E-MAIL
    composer require swiftmailer/swiftmailer
    

    View Slide

99. SENDING E-MAIL
    $mailerTransport = Swift_SmtpTransport::newInstance(
    $config->get('mailer_server'),
    $config->get('mailer_port')
    )
    ->setUsername($config->get('mailer_username'))
    ->setPassword($config->get('mailer_password'))
    ;
    $mailer = Swift_Mailer::newInstance($mailerTransport);
    

    View Slide

100. SENDING E-MAIL
     $message = Swift_Message::newInstance('An e-mail from the site')
     ->setFrom([
     $request->get('email'),
     $request->get('name'),
     ])
     ->setTo([
     $config->get('contact_email'),
     ])
     ->setBody('An e-mail was sent through the site with the following message: ' .
     $request->get('message'))
     ;
     $mailer->send($message);
     

     View Slide

101. DOING VALIDATION
     

     View Slide

102. DOING VALIDATION
     > symfony/validator
     

     View Slide

103. DOING VALIDATION
     > symfony/validator
     > zendframework/zend-validator
     

     View Slide

104. DOING VALIDATION
     > symfony/validator
     > zendframework/zend-validator
     > particle/validator
     

     View Slide

105. DOING VALIDATION
     composer require particle/validator
     

     View Slide

106. DOING VALIDATION
     $contactMailValidator = new \Particle\Validator\Validator();
     $contactMailValidator
     ->required('name')
     ->string();
     $contactMailValidator
     ->required('email')
     ->email();
     $contactMailValidator
     ->required('message')
     ->string();
     

     View Slide

107. DOING VALIDATION
     $r->addRoute(
     'POST',
     '/contact',
     function() use ($request, $config, $mailer, $contactMailValidator, $twig) {
     $result = $contactMailValidator->validate([
     'name' => $request->get('name'),
     'email' => $request->get('email'),
     'message' => $request->get('message')
     ]);
     if ($result->isValid()) {
     // send e-mail and redirect
     }
     return new Response($twig->render('contact.twig', [
     'errors' => $result->getMessages(),
     ]));
     });
     

     View Slide

108. SUMMARY
     

     View Slide

109. SUMMARY
     > valid use cases for building your own framework
     

     View Slide

110. SUMMARY
     > valid use cases for building your own framework
     > Leverage the power of open source components and
     composer
     

     View Slide

111. SUMMARY
     > valid use cases for building your own framework
     > Leverage the power of open source components and
     composer
     > Only need a few lines of glue
     

     View Slide

112. SOME OTHER COMPONENTS YOU COULD THINK OF
     

     View Slide

113. SOME OTHER COMPONENTS YOU COULD THINK OF
     > DI (bitexpert/disco, symfony/dependency-injection,
     league/container)
     

     View Slide

114. SOME OTHER COMPONENTS YOU COULD THINK OF
     > DI (bitexpert/disco, symfony/dependency-injection,
     league/container)
     > Console (symfony/console, illuminate/console,
     webmozart/console)
     

     View Slide

115. SOME OTHER COMPONENTS YOU COULD THINK OF
     > DI (bitexpert/disco, symfony/dependency-injection,
     league/container)
     > Console (symfony/console, illuminate/console,
     webmozart/console)
     > http requests (Guzzle)
     

     View Slide

116. SOME OTHER COMPONENTS YOU COULD THINK OF
     > DI (bitexpert/disco, symfony/dependency-injection,
     league/container)
     > Console (symfony/console, illuminate/console,
     webmozart/console)
     > http requests (Guzzle)
     > logging (monolog/monolog)
     

     View Slide

117. View Slide

118. PHOTO CREDITS
     

     View Slide

119. PHOTO CREDITS
     > Foundation by Paul Sableman, cc-by 2.0
     

     View Slide

120. PHOTO CREDITS
     > Foundation by Paul Sableman, cc-by 2.0
     > Constructicon icons: James Peng
     

     View Slide

121. THANK YOU!
     QUESTIONS?
     HTTPS://LEFTONTHEWEB.COM
     @SKOOP
     

     View Slide