update mercure documentation

Author: azjezz

mercure.rst

@@ -159,20 +159,26 @@ service, including controllers::
  namespace App\Controller;
 
  use Symfony\Component\HttpFoundation\Response;
- use Symfony\Component\Mercure\PublisherInterface;
+ use Symfony\Component\Mercure\HubInterface;
  use Symfony\Component\Mercure\Update;
 
  class PublishController
  {
- public function __invoke(PublisherInterface $publisher): Response
+ private $hub;
+
+ public function __construct(HubInterface $hub)
+ {
+ $this->hub = $hub;
+ }
+
+ public function __invoke(): Response
  {
  $update = new Update(
  'http://example.com/books/1',
  json_encode(['status' => 'OutOfStock'])
  );
 
- // The Publisher service is an invokable object
- $publisher($update);
+ $this->hub->publish($update);
 
  return new Response('published!');
  }
@@ -294,22 +300,25 @@ by using the ``AbstractController::addLink`` helper method::
  // src/Controller/DiscoverController.php
  namespace App\Controller;
 
- use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
  use Symfony\Component\HttpFoundation\JsonResponse;
  use Symfony\Component\HttpFoundation\Request;
- use Symfony\Component\WebLink\Link;
+ use Symfony\Component\Mercure\Discovery;
 
- class DiscoverController extends AbstractController
+ class DiscoverController
  {
- public function __invoke(Request $request): JsonResponse
+ private $discovery;
+
+ public function __construct(Discovery $discovery)
  {
- // This parameter is automatically created by the MercureBundle
-  $hubUrl = $this->getParameter('mercure.default_hub');
+ $this->discovery = $discovery;
+ }
 
+ public function __invoke(Request $request): JsonResponse
+ {
  // Link: <http://localhost:3000/.well-known/mercure>; rel="mercure"
- $this->addLink($request, new Link('mercure', $hubUrl));
+ $this->discovery->addLink($request);
 
- return $this->json([
+ return new JsonResponse([
  '@id' => '/books/1',
  'availability' => 'https://schema.org/InStock',
  ]);
@@ -347,12 +356,18 @@ of the ``Update`` constructor to ``true``::
  namespace App\Controller;
 
  use Symfony\Component\HttpFoundation\Response;
- use Symfony\Component\Mercure\PublisherInterface;
  use Symfony\Component\Mercure\Update;
 
  class PublishController
  {
- public function __invoke(PublisherInterface $publisher): Response
+ private $hub;
+
+ public function __construct(HubInterface $hub)
+ {
+ $this->hub = $hub;
+ }
+
+ public function __invoke(): Response
  {
  $update = new Update(
  'http://example.com/books/1',
@@ -362,7 +377,7 @@ of the ``Update`` constructor to ``true``::
 
  // Publisher's JWT must contain this topic, a URI template it matches or * in mercure.publish or you'll get a 401
  // Subscriber's JWT must contain this topic, a URI template it matches or * in mercure.subscribe to receive the update
- $publisher($update);
+ $this->hub->publish($update);
 
  return new Response('private update published!');
  }
@@ -417,39 +432,34 @@ And here is the controller::
  // src/Controller/DiscoverController.php
  namespace App\Controller;
 
- use Lcobucci\JWT\Configuration;
- use Lcobucci\JWT\Signer\Hmac\Sha256;
- use Lcobucci\JWT\Signer\Key;
- use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
- use Symfony\Component\HttpFoundation\Cookie;
  use Symfony\Component\HttpFoundation\Request;
  use Symfony\Component\HttpFoundation\Response;
- use Symfony\Component\WebLink\Link;
+ use Symfony\Component\Mercure\Authorization;
+ use Symfony\Component\Mercure\Discovery;
 
- class DiscoverController extends AbstractController
+ class DiscoverController
  {
+ private $discovery;
+ private $authorization;
+
+ public function __construct(Discovery $discovery, Authorization $authorization)
+ {
+ $this->discovery = $discovery;
+ $this->authorization = $authorization;
+ }
+
  public function __invoke(Request $request): Response
  {
- $hubUrl = $this->getParameter('mercure.default_hub');
- $this->addLink($request, new Link('mercure', $hubUrl));
-
- $key = Key\InMemory::plainText('mercure_secret_key'); // don't forget to set this parameter! Test value: !ChangeMe!
- $configuration = Configuration::forSymmetricSigner(new Sha256(), $key);
-
- $token = $configuration->builder()
- ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
- ->getToken($configuration->signer(), $configuration->signingKey())
- ->toString();
-
- $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
- $cookie = Cookie::create('mercureAuthorization')
- ->withValue($token)
- ->withPath('/.well-known/mercure')
- ->withSecure(true)
- ->withHttpOnly(true)
- ->withSameSite('strict')
- ;
- $response->headers->setCookie($cookie);
+ $this->discovery->addLink($request);
+
+ $response = new JsonResponse([
+ '@id' => '/demo/books/1',
+ 'availability' => 'https://schema.org/InStock'
+ ]);
+
+ $response->headers->setCookie(
+ $this->authorization->createCookie($request, ["http://example.com/books/1"])
+ );
 
  return $response;
  }
@@ -464,15 +474,17 @@ Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
 Instead of directly storing a JWT in the configuration,
-you can create a service that will return the token used by
-the ``Publisher`` object::
+you can create a token provider that will return the token used by
+the ``HubInterface`` object::
 
- // src/Mercure/MyJwtProvider.php
+ // src/Mercure/MyTokenProvider.php
  namespace App\Mercure;
 
- final class MyJwtProvider
+ use Symfony\Component\Mercure\JWT\TokenProviderInterface;
+
+ final class MyTokenProvider implements TokenProviderInterface
  {
- public function __invoke(): string
+ public function getToken(): string
  {
  return 'the-JWT';
  }
@@ -489,7 +501,8 @@ Then, reference this service in the bundle configuration:
  hubs:
  default:
  url: https://mercure-hub.example.com/.well-known/mercure
- jwt_provider: App\Mercure\MyJwtProvider
+ jwt:
+ provider: App\Mercure\MyTokenProvider
 
  .. code-block:: xml
 
@@ -499,8 +512,9 @@ Then, reference this service in the bundle configuration:
  <hub
  name="default"
  url="https://mercure-hub.example.com/.well-known/mercure"
- jwt-provider="App\Mercure\MyJwtProvider"
- />
+ >
+ <jwt provider="App\Mercure\MyTokenProvider"/>
+ </hub>
  </config>
 
  .. code-block:: php
@@ -512,7 +526,9 @@ Then, reference this service in the bundle configuration:
  'hubs' => [
  'default' => [
  'url' => 'https://mercure-hub.example.com/.well-known/mercure',
- 'jwt_provider' => MyJwtProvider::class,
+ 'jwt' => [
+ 'provider' => MyJwtProvider::class,
+ ]
  ],
  ],
  ]);