More fixes

Author: javiereguiluz

rate_limiter.rst

@@ -75,7 +75,7 @@ enforce different levels of service (free or paid):
             authenticated_api:
                 strategy: token_bucket
                 limit: 5000
-                rate: { interval: '1 hour', amount: 5000 }
+                rate: { interval: '15 minutes', amount: 500 }
 
 .. note::
 
@@ -106,12 +106,12 @@ the number of requests to the API::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
-    use Symfony\Component\RateLimiter\LimiterInterface;
+    use Symfony\Component\RateLimiter\Limiter;
 
     class ApiController extends AbstractController
     {
         // the variable name must be: "rate limiter name" + "limiter" suffix
-        public function index(LimiterInterface $anonymousApiLimiter)
+        public function index(Limiter $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -141,7 +141,7 @@ the number of requests to the API::
     and check the rate limiter once for all requests.
 
 In other scenarios you may want instead to wait as long as needed until a new
-token is available. In those cases, use the ``reserve()`` and ``wait()`` methods::
+token is available. In those cases, use the ``wait()`` method::
 
     // src/Controller/LuckyController.php
     // ...
@@ -153,7 +153,10 @@ token is available. In those cases, use the ``reserve()`` and ``wait()`` methods
             $limiter = $authenticatedApiLimiter->create($request->getClientIp());
 
             // this blocks the application until the given number of tokens can be consumed
-            $limiter->consume(1)->wait();
+            do {
+                $limit = $limiter->consume(1);
+                $limit->wait();
+            } while (!$limit->isAccepted());
 
             // ...
         }
@@ -176,7 +179,7 @@ Symfony application. If you prefer to change that, use the ``lock`` and
             anonymous_api_limiter:
                 # ...
                 # the value is the name of any cache pool defined in your application
-                storage: 'app.redis_cache'
+                cache_pool: 'app.redis_cache'
                 # or define a service implementing StorageInterface to use a different
                 # mechanism to store the limiter information
                 storage: 'App\RateLimiter\CustomRedisStorage'