DOCSP-39180: Symfony Quick Start

source/includes/php-frameworks/symfony/Restaurant.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Document;
+
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ODM\MongoDB\Mapping\Annotations as ODM;
+
+#[ODM\Document(collection: 'restaurants')]
+class Restaurant
+{
+    #[ODM\Id]
+    public ?string $id = null;
+
+    #[ODM\Field]
+    public string $name;
+
+    #[ODM\Field]
+    public string $borough;
+
+    #[ODM\Field]
+    public string $cuisine;
+}

source/includes/php-frameworks/symfony/RestaurantController.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Document\Restaurant;
+use Doctrine\ODM\MongoDB\DocumentManager;
+use MongoDB\BSON\Regex;
+use Psr\Log\LoggerInterface;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Annotation\Route;
+
+class RestaurantController extends AbstractController
+{
+    private DocumentManager $dm;
+    private LoggerInterface $logger;
+
+    public function __construct(DocumentManager $dm, LoggerInterface $logger)
+    {
+        $this->dm = $dm;
+        $this->logger = $logger;
+    }
+
+    #[Route('/', name: 'restaurant_index', methods: ['GET'])]
+    public function index(Request $request): Response
+    {   
+        return $this->render('restaurant/index.html.twig');
+    }
+
+    #[Route('/restaurant/browse', name: 'restaurant_browse', methods: ['GET'])]
+    public function browse(Request $request): Response
+    {
+        $restaurantRepository = $this->dm->getRepository(Restaurant::class);
+        $queryBuilder = $restaurantRepository->createQueryBuilder();
+
+        $restaurants = $queryBuilder
+                ->field('borough')->equals('Queens')
+                ->field('name')->equals(new Regex('Moon', 'i'))
+                ->getQuery()
+                ->execute();
+
+        return $this->render('restaurant/browse.html.twig', ['restaurants' => $restaurants]);
+    }
+}

source/includes/php-frameworks/symfony/browse.html.twig

@@ -0,0 +1,18 @@
+{# templates/restaurant/browse.html.twig #}
+
+{% extends 'base.html.twig' %}
+
+{% block title %}
+    Search Restaurants
+{% endblock %}
+
+{% block body %}
+    <h1>Search Restaurants</h1>
+        {% for restaurant in restaurants %}
+            <p>
+                <span style="color:deeppink;"><b>Name: </b>{{ restaurant.name }}</span><br>
+                <b>Borough:</b> {{ restaurant.borough }}<br>
+                <b>Cuisine:</b> {{ restaurant.cuisine }}<br>
+            </p>
+        {% endfor %}
+{% endblock %}

source/includes/php-frameworks/symfony/doctrine_mongodb.yaml

@@ -0,0 +1,18 @@
+doctrine_mongodb:
+  auto_generate_proxy_classes: true
+  auto_generate_hydrator_classes: true
+  connections:
+    default:
+      server: "%env(resolve:MONGODB_URL)%"
+  default_database: "%env(resolve:MONGODB_DB)%"
+  document_managers:
+    default:
+      auto_mapping: true
+      mappings:
+        App:
+          dir: "%kernel.project_dir%/src/Document"
+          mapping: true
+          type: attribute
+          prefix: 'App\Document'
+          is_bundle: false
+          alias: App

source/includes/php-frameworks/symfony/index.html.twig

@@ -0,0 +1,7 @@
+{# templates/restaurant/index.html.twig #}
+
+{% extends 'base.html.twig' %}
+
+{% block body %}
+    <h1>Welcome to the Symfony MongoDB Quickstart!</h1>
+{% endblock %}

source/motor.txt

@@ -32,7 +32,8 @@ or set up a runnable project by following our tutorials.
 .. tip::
 
    If you do not need to access MongoDB in a non-blocking manner or from
-   co-routines, we recommend that you use the :doc:`PyMongo </pymongo>`
+   co-routines, we recommend that you use the `PyMongo
+   <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/>`__
    driver instead.
 
 - `Tutorial on using Motor with Tornado <http://motor.readthedocs.org/en/stable/tutorial-tornado.html>`__

source/php-drivers.txt

@@ -20,6 +20,7 @@ MongoDB PHP Driver
    :titlesonly:
 
    Laravel MongoDB <https://www.mongodb.com/docs/drivers/php/laravel-mongodb/current>
+   /php-frameworks/symfony
    /php-libraries
 
 .. contents:: On this page