2 new Symfony components: HttpClient and MIME

2 new Symfony components: HttpClient and MIME

9a22d09f92d50fa3d2a16766d0ba52f8?s=128

Fabien Potencier

March 01, 2019
Tweet

Transcript

  1. Back to the basics... Fabien Potencier @fabpot

  2. Process > proc_open() VarDumper > var_dump() VarExporter > var_export() Finder

    > *Iterator HttpFoundation > $_GET/$_POST HttpKernel > echo What's next?
  3. file_get_contents() no dependencies

  4. 3) Symfony HTTPClient Do HTTP requests, the powerful way Fabien

    Potencier @fabpot
  5. None
  6. None
  7. None
  8. None
  9. None
  10. None
  11. None
  12. None
  13. None
  14. None
  15. None
  16. Great DX - Great Perf - Great Design (auto) proxy

    configuration DNS cache pre-population 1st class error handling auto-gzip compression timeout management public key pinning progress callback extended info request abort HTTP/2-push IDN support Psr18Client time stats streaming base URI ...
  17. 379 requests in HTTP/2 0,3 s!

  18. None
  19. None
  20. What’s next? Your contrib! TraceableHttpClient, profiler panel, logger integration, mock

    client, record/replay, raw sockets, cookie jar, ...
  21. R.I.P. Goutte Integrates with battle-tested components HttpClient + BrowserKit +

    DomCrawler + CssSelector + HttpCache
  22. None
  23. None
  24. Back to the basics... part 4/n Fabien Potencier @fabpot

  25. 4) Symfony MIME Everything you need to create beautiful emails

    Fabien Potencier @fabpot
  26. Symfony Mime

  27. use Symfony\Component\Mime\Email; $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject')

    ->text('Some text message') ->html('<b>Some HTML message</b>') ->attach('doc.txt') ; The basics
  28. $email = (new Email()) ->from('fabien@symfony.com') ->to(new Address('fabien@sensiolabs.com')) ->addTo(new NamedAddress('fabien@sensiolabs.com', 'Fabien'))

    ->addCc('thomas@symfony.com', 'lucas@symfony.com') ->addCc(...['thomas@symfony.com', 'lucas@symfony.com']) ->subject('Some subject') ->text('Some text') ; from, to, cc, bcc
  29. $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text('Some text

    message') ->html('<b>Some HTML message</b>') ; echo strlen(serialize($email)); Email is a data object Only 2k vs 16k for Swiftmailer
  30. Why is it so different
 from Swiftmailer?

  31. $email = (new Email()) ->text('Some text message') ->html('<b>Some HTML message</b>')

    ; $email = (new \Swift_Message()) ->setBody('Some text message') ->addPart('<b>Some HTML message</b>', 'text/html') ; A better data object model 16k serialized 38 objects complex serialization "fixed" headers 2k serialized 7 objects simple serialization "dynamic" headers
  32. echo $email->toString(); sleep(2); $email->to('helene@symfony.com'); echo $email->toString(); Fixed vs dynamic headers

    Different
 set of headers Date, Boundary, Message-ID
  33. $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text(fopen('email.txt', 'r'))

    ->html(fopen('email.html', 'r')) ; echo $email->toString(); foreach ($email->toIterable() as $chunk) { echo $chunk; } String or resources, your choice
  34. // Email extends Message use Symfony\Component\Mime\Message; use Symfony\Component\Mime\Part\TextPart; use Symfony\Component\Mime\Header\Headers;

    $body = new TextPart('Some content'); $headers = (new Headers()) ->addMailboxListHeader('From', ['fabien@symfony.com']) ->addMailboxListHeader('To', ['fabien@sensiolabs.com']) ->AddTextHeader('Subject', 'Some subject') ; $email = new Message($headers, $body); And you get full control!
  35. $txt = new TextPart('Some content'); $html = new TextPart('<b>Some content</b>',

    'html'); $body = new AlternativePart($txt, $html); $email = new Message($headers, $body); Get creative
  36. A "complete" email multipart/mixed | |------------> multipart/related | | |

    |------------> multipart/alternative | | | | | ------------> text/plain | | | | | ------------> text/html | | | ------------> image/png | ------------> application/pdf ->text() ->html() ->embed() ->attach()
  37. $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->setBody($body) ;

    Mix several approaches
  38. $email ->attach('Some content', 'doc.txt', 'text/plain') ->attachFromPath('/path/to/doc.txt') ->attach(fopen('doc.txt', 'r'), 'doc.txt', 'text/plain')

    ; Attachments
  39. $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text('Some text')

    ->html('<b>The new logo: <img src="cid:logo.jpg"></b>') ->embedFromPath('logo-small.jpg', 'logo.jpg') ; Embeds
  40. // Email extends Message extends RawMessage use Symfony\Component\Mime\RawMessage; $message =

    new RawMessage($email->toString()); $message->toString(); Go raw! Serialize an email as a string instead of a PHP object
  41. Creating Emails with Twig Twig is perfect for emails aka,

    Twig is not dead and still very useful :)
  42. use Symfony\Bridge\Twig\Mime\Renderer; use Symfony\Bridge\Twig\Mime\TemplatedEmail; use Twig\Environment; use Twig\Loader\FilesystemLoader; use Symfony\Component\Mime\NamedAddress;

    $twig = new Environment($loader = new FilesystemLoader(__DIR__.'/templates')); $loader->addPath(__DIR__.'/images', 'images'); $email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->text('Some text content') ->htmlTemplate('simple.html.twig') ->context([ 'city' => 'Lille' ]) ; $renderer = new Renderer($twig); echo $renderer->render($email)->toString(); Native integration with Twig
  43. <p> Welcome <b>{{ email.toName }}</b> from {{ city }}! </p>

    <p> <img src="{{ email.image('@images/photo.jpg') }}"> </p> Native integration with Twig Symfony\Bridge\Twig\Mime\ WrappedTemplatedEmail Twig template name Template context
  44. {% do email.attach('@docs/doc.pdf') %} <p> Welcome <b>{{ email.toName }}</b>! </p>

    <p> <img src="{{ email.image('@images/photo.jpg') }}"> </p> Native integration with Twig
  45. {% do email.priority(5) %} <p> Welcome <b>{{ email.toName }}</b>! </p>

    <p> <img src="{{ email.image('@images/photo.jpg') }}"> </p> Native integration with Twig
  46. $email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->textTemplate('simple.txt.twig') ->htmlTemplate('simple.html.twig')

    ; Native integration with Twig
  47. $email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->template('simple.email.twig') ;

    Native integration with Twig
  48. {% block config %} {% do email.attach('@images/planfaidherbe.jpeg') %} {% endblock

    %} {% block subject %}Email Subject{% endblock %} {% block text %} Optional text representation {% endblock %} {% block html %} <p>Welcome <b>{{ email.toName }}</b>!</p> <p><img src="{{ email.image('@images/photo.jpg') }}"></p> {% endblock %} Native integration with Twig
  49. {% block text %} {% set formula = "2 >

    1?" %} {% autoescape false %} {{ formula }} {% endautoescape %} {% endblock %} {% block html %} {% set formula = "2 > 1?" %} {{ formula }} {% endblock %} Native integration with Twig HTML escape by default with the "name" strategy From: fabien@symfony.com To: Fabien <fabien@sensiolabs.com> MIME-Version: 1.0 Date: Thu, 28 Feb 2019 12:10:16 +0100 Message-ID: <7885775f35b0509444e99290be3216e2@symfony.com> Content-Type: multipart/alternative; boundary="_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_= --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_ Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable =20 2 > 1? =20 --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_ Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable =20 2 &gt; 1? --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_--
  50. Tip! If the Text part is empty, the Renderer automatically

    generates one
  51. But HTML in emails is hard Compatibility with email clients

    Inline CSS Responsive layout …
  52. use Twig\CssInliner\CssInlinerExtension; $twig->addExtension(new CssInlinerExtension()); {% filter inline_css %} <style> b

    { color: red } </style> <p> Welcome <b>{{ email.toName }}</b>! </p> {% endfilter %} Inlining CSS
  53. {% filter inline_css("@css/email.css") %} <style> b { color: red }

    </style> <p> Welcome <b>{{ email.toName }}</b>! </p> {% endfilter %} Inlining CSS
  54. use Twig\Markdown\MarkdownExtension; $twig->addExtension(new MarkdownExtension()); <p> {% filter markdown %} |

    Version | LTS? | Latest | | ------------- |:-------------:| -------:| | 1.0 | Yes | 1.0.1 | | 2.1 | No | 2.1.33 | {% endfilter %} </p> Use Markdown to simplify your templates
  55. use Twig\Inky\InkyExtension; $twig->addExtension(new InkyExtension()); Use Inky to simplify your HTML

    https://foundation.zurb.com/emails.html
  56. {% filter inky|inline_css(source("@zurb/stylesheets/main.css")) %} <container> <row class="header"> <columns> <spacer size="16"></spacer>

    <h4 class="text-center">Symfony Connect</h4> </columns> </row> <row> <columns> <spacer size="32"></spacer> <center><img width="100px" src="{{ email.image("@images/symfony.png") }}"></center> <spacer size="16"></spacer> <h1 class="text-center">Forgot Your Password?</h1> <spacer size="16"></spacer> <p class="text-center">It happens. Click the link below to reset it.</p> <button class="large expand" href="#">Reset Password</button> <hr/> <p><small><center><a href="#">unsubscribe here</a>.</small></center></p> </columns> </row> </container> {% endfilter %} Use Inky to simplify your HTML
  57. What about sending
 our emails now?

  58. Thank you! ❤