feat: modernize getting started (#1529)

Author: dunglas

distribution/index.md

@@ -10,7 +10,7 @@
 
 ## Introduction
 
-API Platform contains [a **PHP** library (Core)](../core/index.md) to create fully featured hypermedia (or [GraphQL](../core/graphql.md)) web APIs supporting industry-leading standards: [JSON-LD](https://json-ld.org/) with [Hydra](https://www.hydra-cg.com/), [OpenAPI](../core/swagger.md)...
+API Platform contains [a **PHP** library (Core)](../core/index.md) to create fully featured hypermedia (or [GraphQL](../core/graphql.md)) web APIs supporting industry-leading standards: [JSON-LD](https://json-ld.org) with [Hydra](https://www.hydra-cg.com), [OpenAPI](../core/swagger.md)...
 
 API Platform also provides ambitious **JavaScript** tools to create web and mobile applications based on the most popular frontend technologies in a snap. These tools parse the documentation of the API (or of any other API supporting Hydra or OpenAPI).
 
@@ -43,7 +43,7 @@ API Platform uses these model classes to expose and document a web API having a
 * hypermedia/[HATEOAS](https://en.wikipedia.org/wiki/HATEOAS) and content negotiation support ([JSON-LD](https://json-ld.org) and [Hydra](https://www.hydra-cg.com/), [JSON:API](https://jsonapi.org/), [HAL](https://tools.ietf.org/html/draft-kelly-json-hal-08)...)
 * [GraphQL support](../core/graphql.md)
 * Nice UI and machine-readable documentations ([Swagger UI/OpenAPI](https://swagger.io), [GraphiQL](https://github.com/graphql/graphiql)...)
-* authentication ([Basic HTTP](https://en.wikipedia.org/wiki/Basic_access_authentication), cookies as well as [JWT](https://jwt.io/) and [OAuth](https://oauth.net/) through extensions)
+* authentication ([Basic HTTP](https://en.wikipedia.org/wiki/Basic_access_authentication), cookies as well as [JWT](../core/jwt.md) and [OAuth](https://oauth.net) through extensions)
 * [CORS headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS)
 * security checks and headers (tested against [OWASP recommendations](https://www.owasp.org/index.php/REST_Security_Cheat_Sheet))
 * [invalidation-based HTTP caching](../core/performance.md)
@@ -141,7 +141,7 @@ That being said, keep in mind that API Platform is 100% independent of the persi
 best suit(s) your needs (including NoSQL databases or remote web services) by implementing the [right interfaces](../core/data-providers.md). API Platform even supports using several persistence
 systems together in the same project.
 
-### Using Symfony and Composer
+### Using Symfony CLI
 
 Alternatively, the API Platform server component can also be installed directly on a local machine.
 **This method is recommended only for users who want full control over the directory structure and the installed
@@ -153,12 +153,12 @@ The rest of this tutorial assumes that you have installed API Platform using the
 next section if it's your case.
 
 API Platform has an official Symfony Flex recipe. It means that you can easily install it from any Symfony
-application using [Composer](https://getcomposer.org/):
+application using [the Symfony binary](https://symfony.com/download):
 
 Create a new Symfony project:
 
 ```console
-composer create-project symfony/skeleton bookshop-api
+symfony new bookshop-api
 ```
 
 Enter the project directory:
@@ -170,20 +170,20 @@ cd bookshop-api
 Install the API Platform's server component in this skeleton:
 
 ```console
-composer require api
+symfony composer require api
 ```
 
 Then, create the database and its schema:
 
 ```console
-bin/console doctrine:database:create
-bin/console doctrine:schema:create
+symfony console doctrine:database:create
+symfony console doctrine:schema:create
 ```
 
 And start the built-in PHP server:
 
 ```console
-php -S 127.0.0.1:8000 -t public
+symfony serve
 ```
 
 All JavaScript components are also [available as standalone libraries](https://github.com/api-platform?language=javascript)
@@ -202,7 +202,7 @@ You'll need to add a security exception in your browser to accept the self-signe
 for this container when installing the framework.
 
 Later you will probably replace this welcome screen by the homepage of your Next.js application. If you don't plan to create
-a Progressive Web App, you can remove the `pwa/` directory and the related lines in `docker-compose*.yaml` (don't do it
+a Progressive Web App, you can remove the `pwa/` directory as well as the related lines in `docker-compose*.yml` and in `api/docker/caddy/Caddyfile` (don't do it
 now, we'll use this container later in this tutorial).
 
 Click on the "API" button, or go to `https://localhost/docs/`:
@@ -269,7 +269,7 @@ class Book
     public string $author = '';
 
     /** The publication date of this book. */
-    public ?\DateTimeInterface $publicationDate = null;
+    public ?\DateTimeImmutable $publicationDate = null;
 
     /** @var Review[] Available reviews for this book. */
     public iterable $reviews;
@@ -311,7 +311,7 @@ class Review
     public string $author = '';
 
     /** The date of publication of this review.*/
-    public ?\DateTimeInterface $publicationDate = null;
+    public ?\DateTimeImmutable $publicationDate = null;
 
     /** The book this review is about. */
     public ?Book $book = null;
@@ -387,19 +387,19 @@ Modify these files as described in these patches:
      public string $title = '';
 
      /** The description of this book. */
-+    #[ORM\Column(type: "text")]
++    #[ORM\Column(type: 'text')]
      public string $description = '';
 
      /** The author of this book. */
 +    #[ORM\Column]
      public string $author = '';
 
      /** The publication date of this book. */
-+    #[ORM\Column(type: "datetime")]
++    #[ORM\Column]
      public ?\DateTimeInterface $publicationDate = null;
 
      /** @var Review[] Available reviews for this book. */
-+    #[ORM\OneToMany(mappedBy: 'book', targetEntity: 'Review', cascade: ['persist', 'remove'])]
++    #[ORM\OneToMany(targetEntity: Review::class, mappedBy: 'book', cascade: ['persist', 'remove'])]
      public iterable $reviews;
 
      public function __construct()
@@ -419,27 +419,27 @@ Modify these files as described in these patches:
  class Review
  {
      /** The id of this review. */
-     #[ORM\Id, ORM\Column, ORM\GeneratedValue]
++    #[ORM\Id, ORM\Column, ORM\GeneratedValue]
      private ?int $id = null;
 
      /** The rating of this review (between 0 and 5). */
-+    #[ORM\Column(type: "smallint")]
++    #[ORM\Column(type: 'smallint')]
      public int $rating = 0;
 
      /** The body of the review. */
-+    #[ORM\Column(type: "text")]
++    #[ORM\Column(type: 'text')]
      public string $body = '';
 
      /** The author of the review. */
 +    #[ORM\Column]
      public string $author = '';
 
      /** The date of publication of this review.*/
-+    #[ORM\Column(type: "datetime")]
-     public ?\DateTimeInterface $publicationDate = null;
++    #[ORM\Column]
+     public ?\DateTimeImmutable $publicationDate = null;
 
      /** The book this review is about. */
-+    #[ORM\ManyToOne(targetEntity: "Book", inversedBy: "reviews")]
++    #[ORM\ManyToOne(inversedBy: 'reviews')]
      public ?Book $book = null;
 
      public function getId(): ?int
@@ -585,17 +585,17 @@ Modify the following files as described in these patches:
 +    #[Assert\NotBlank]
      public string $title = '';
 
-     #[ORM\Column]
+     #[ORM\Column(type: 'text')]
 +    #[Assert\NotBlank]
      public string $description = '';
 
      #[ORM\Column] 
 +    #[Assert\NotBlank]
      public string $author = '';
 
-     #[ORM\Column]  
+     #[ORM\Column]
 +    #[Assert\NotNull]
-     public ?\DateTimeInterface $publicationDate = null;
+     public ?\DateTimeImmutable $publicationDate = null;
 ```
 
 `api/src/Entity/Review.php`
@@ -619,9 +619,9 @@ Modify the following files as described in these patches:
 
      #[ORM\Column] 
 +    #[Assert\NotNull]
-     public ?\DateTimeInterface $publicationDate = null;
+     public ?\DateTimeImmutable $publicationDate = null;
 
-     #[ORM\ManyToOne(inverdedBy: 'reviews')] 
+     #[ORM\ManyToOne(inversedBy: 'reviews')] 
 +    #[Assert\NotNull]
      public ?Book $book = null;