with your

Size: px

Start display at page:

Download "with your"

Andrew Hensley
6 years ago
Views:

1 with your

2 It s-a me, Ryan! > Lead of the Symfony documentation team > Writer for KnpUniversity.com > Symfony fanboy/evangelist > Husband of the much more > Father to my more handsome son, Beckett knpuniversity.com twitter.com/weaverryan

3 You have a

4 You know

5 Drupal 8 leverages: > Object-Oriented Principles > Namespaces > Routes & Controllers* > Service Container* > Events & Event Listeners* > Drupal Console* * come from Symfony

7 Symfony is a collection of small PHP libraries (the

8 The Symfony Framework is glue that makes these components work

9 Drupal is glue that makes these components work

10 Drupal = Route & Controller System + Container full of many services (objects) that do EVERYTHING & give all CMS

11 Symfony = Route & Controller System + Container full of almost zero

12 Imagine Drupal where you uninstalled every single module (including core) That s

13 Symfony is lean & mean but you can install all the features you

14 Let s code! Follow the code at:

15 composer create-project symfony/skeleton dcon18

18 @weaverryan

19 Hello Symfony Flex!

20 15 files No

21 Let s start the built-in PHP web

22 @weaverryan

23 Create an API

24 Step 1: Controller (i.e. function that builds the page) <?php // src/controller/songcontroller.php namespace App\Controller; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; class SongController extends AbstractController { public function apiwritesong() { return $this->json([ 'I rode my truck, through some mud', ]); }

25 Step 2: Route (i.e. URL that points to the controller) # config/routes.yaml song_api_write_song: path: /api/songs controller:

26 * YES! No need to rebuild any

27 Your project is small - service container - routing system - < 50

28 Your project is small > no templating > no database/orm > no logging > no koopa troopas

29 Need something? Install it! Drupal modules = Symfony

30 Install annotations

31 composer require annotations

32 An alias (see symfony.sh)

33 @weaverryan

34 Recipes

35 Step 1 (of 1): Controller & Hey! Annotations! Like <?php // src/controller/songcontroller.php //... class SongController extends AbstractController { /** */ public function apiwritesong() { return $this->json([ 'I rode my truck, through some mud', ]); } } Drupal Plugins!

36 Let s render a template!

37 composer require twig

39 Automated configuration Twig # config/packages/twig.yaml twig: paths: templates/ directory created automatically

40 Create a new HTML page // src/controller/songcontroller.php //... /** */ public function writeanothersong() { $song = 'Back-road, boot-scooting, honkey-tonkin CMS'; return $this->render('song/anothersong.html.twig', [ 'song' => $song, ]); } {# templates/song/anothersong.html.twig #} {% extends 'base.html.twig' %} {% block body %} <h1>{{ song }}</h1> {% endblock %}

41 @weaverryan

42 Drupal Console? Symfony has

43 php bin/console debug:twig

44 php bin/console debug:router

45 Better debugging tools! (e.g. devel for

46 composer require debug

48 @weaverryan

49 @weaverryan

50 More bundles means more services (e.g. the logger

51 Fetching Services in Drupal ( the cheating way) public function writeanothersong() { $logger = \Drupal::getContainer()->get('logger'); $logger->debug($song); //... } or you can / should use dependency injection and update a services YML file

52 Fetching Services in Symfony use Psr\Log\LoggerInterface; //... public function writeanothersong(loggerinterface $logger) { $logger->debug($song); //... } Just ask for the service you need

53 php bin/console debug:autowiring

54 Organizing Code // src/service/songgenerator.php namespace App\Service; class SongGenerator { public function generatesong($noun) { $title = '...'; // magic song generator return $title; } }

55 Organizing Code // src/controller/songcontroller.php use App\Service\SongGenerator; //... /** */ public function apiwritesong(songgenerator $songgenerator) { return $this->json([ $songgenerator->generatesong('truck'), ]); }

56 Let s add a Database!

57 composer require doctrine

60 .env settings.php #.env ###> doctrine/doctrine-bundle ### # Configure other settings in config/packages/doctrine.yaml DATABASE_URL=mysql://root:VERYSECURE@ :3306/dcon2018_symfony ###< doctrine/doctrine-bundle ### php bin/console doctrine:database:create (creates a db but it s empty for now)

61 composer require maker php bin/console list make

62 Doctrine *also* has entities one Entity class = one DB

63 php bin/console make:entity

64 php bin/console make:entity

65 // src/entity/countrysong.php namespace App\Entity; use Doctrine\ORM\Mapping as ORM; class CountrySong { /** */ private $id; /** length=255) */ private $title; //... gettitle(), settitle(), etc methods }

66 php bin/console make:migration // src/migrations/version php class Version extends AbstractMigration { public function up(schema $schema) { $this->addsql('create TABLE country_song (id INT AUTO_INCREMENT NOT NULL, title VARCHAR(255) NOT NULL, PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci ENGINE = InnoDB'); } public function down(schema $schema) { //... holds the opposite } }

67 php bin/console doctrine:migrations:migrate

68 Let s create an API endpoint to save new country

$php use Doctrine\ORM\EntityManagerInterface; /** * @Route("/api/songs", methods="post") */ public function apiwritesong(songgenerator $generator, EntityManagerInterface $em) { $song = new$

69 // src/controller/songcontroller.php use Doctrine\ORM\EntityManagerInterface; /** methods="post") */ public function apiwritesong(songgenerator $generator, EntityManagerInterface $em) { $song = new CountrySong(); $song->settitle($generator->generatesong('truck')); $em->persist($song); $em->flush(); return $this->json([ 'title' => $song->gettitle(), 'id' => $song->getid(), ]); }

70 Hmm creating the JSON was too much

71 public function apiwritesong(songgenerator $gen, EntityManagerInterface $em) { $song = new CountrySong(); $song->settitle($gen->generatesong('truck')); $em->persist($song); $em->flush(); return $this->json($song); } does that work?. noop

72 composer require serializer public function apiwritesong(songgenerator $gen, EntityManagerInterface $em) { $song = new CountrySong(); $song->settitle($gen->generatesong('truck')); $em->persist($song); $em->flush(); return $this->json($song); }

73 GET /api/songs/{id} // src/controller/songcontroller.php /** methods="get") */ public function apigetsong(countrysong $song) { return $this->json($song); }

74 Let s generate a

75 php bin/console make:crud

76 php bin/console make:crud

77 @weaverryan

78 @weaverryan Security

79 composer require security-checker

80 bin/console security:check Flex will also give you a warning if you try to install a package with a known security vulnerability

81 @weaverryan

82 @weaverryan Bonus: API Platform

83 composer require api // src/entity/countrysong.php //... /** */ class CountrySong { //.. }

84 @weaverryan

89 Bonus: Admin

90 composer require admin # config/packages/easy_admin.yaml easy_admin: entities: # List the classes you want to manage - App\Entity\CountrySong

91 @weaverryan

92 Bonus: Webpack

93 Drupal & Symfony great, awkward,

94 Drupal Symfony Routing & Controllers Container (many services) (few services) Plugins modules bundles Console Tool Drupal Console bin/console OOP, namespaces, Composer, etc

95 Symfony Starts Tiny grows with you > twig > doctrine > api > logging > cache > debug > more at symfony.sh

96 Have a project that doesn t need a CMS?

97 Try Symfony! (it ll make you even better at Drupal anyways) github.com/weaverryan/drupalcon18-symfony-for-drupalers

98 THANK YOU DRUPALCON! Ryan Free Symfony Video Tutorial:

The Quick Tour Version: master

The Quick Tour Version: master What could be better to make up your own mind than to try out Symfony yourself? Aside from a little time, it will cost you nothing. Step by step you will explore the Symfony