DOCSP-39180: Symfony Quick Start

source/includes/php-frameworks/Restaurant.php

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

source/includes/php-frameworks/RestaurantController.php

@@ -0,0 +1,59 @@
+<?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
+{
+    // DocumentManager instance
+    private $_documentManager;
+    private $_logger;
+    /**
+     * __construct -
+     * 
+     * This function is responsible for initializing the RestaurantController class.
+     * 
+     * @param DocumentManager $_documentManager - The document manager
+     * @param LoggerInterface $_logger          - The logger interface
+     * 
+     * @return void
+     */
+    public function __construct(DocumentManager $_documentManager, LoggerInterface $_logger)
+    {
+        $this->_documentManager = $_documentManager;
+        $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->_documentManager->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/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