wip

Author: chrisbbreuer

README.md

@@ -21,7 +21,13 @@ use Meema\CloudFront\Facades\CloudFront;
 
 // run any of the following CloudFront methods:
 $client = CloudFront::getClient(); // exposes the AWS CloudFront client
-$result = CloudFront::invalidate(array $items, int $quantity = 1, string $distributionId = null);
+
+$items = ['/some-path.jpg', '/another/path.png'];
+$result = CloudFront::invalidate($items, string $distributionId = null);
+
+// invalidates everything, which is the equivalent to a item path of `/*`.
+$result = CloudFront::reset();
+
 $message = CloudFront::getInvalidation(string $invalidationId, string $distributionId = null);
 $messages = CloudFront::listInvalidations(string $distributionId = null)
 ```

src/CloudFront.php

@@ -45,13 +45,16 @@ public function getClient(): CloudFrontClient
     /**
      * Bust an item/s in CloudFront's cache.
      *
-     * @param array $items
-     * @param int $quantity
+     * @param array|string $items
      * @param string|null $distributionId
      * @return \Aws\Result
      */
-    public function invalidate(array $items, int $quantity = 1, string $distributionId = null)
+    public function invalidate($items, string $distributionId = null)
     {
+        if (is_string($items)) {
+            $items[] = $items;
+        }
+
         return $this->client->createInvalidation([
             'DistributionId' => $distributionId ?? config('cloudfront.distribution_id'),
             'InvalidationBatch' => [
@@ -60,12 +63,23 @@ public function invalidate(array $items, int $quantity = 1, string $distribution
                 'CallerReference' => microtime(true),
                 'Paths' => [
                     'Items' => $items,
-                    'Quantity' => $quantity,
+                    'Quantity' => count($items),
                 ],
             ],
         ]);
     }
 
+    /**
+     * Remove every item out of your CloudFront distribution.
+     *
+     * @param string|null $distributionId
+     * @return \Aws\Result
+     */
+    public function reset(string $distributionId = null)
+    {
+        return $this->invalidate('/*', $distributionId ?? config('cloudfront.distribution_id'));
+    }
+
     /**
      * Get a cache "invalidation".
      *

src/Contracts/CloudFront.php

@@ -7,12 +7,19 @@ interface CloudFront
     /**
      * Delete items in your CloudFront cache .
      *
-     * @param array $items
-     * @param int $quantity
+     * @param array|string $items
      * @param string|null $distributionId
      * @return \Aws\Result
      */
-    public function invalidate(array $items, int $quantity = 1, string $distributionId = null);
+    public function invalidate($items, string $distributionId = null);
+
+    /**
+     * Delete everything in your CloudFront cache .
+     *
+     * @param string|null $distributionId
+     * @return \Aws\Result
+     */
+    public function reset(string $distributionId = null);
 
     /**
      * Delete items in your CloudFront cache .

src/Facades/CloudFront.php

@@ -6,7 +6,8 @@
 
 /**
  * @method static \Aws\CloudFront\CloudFrontClient getClient()
- * @method static \Aws\Result invalidate(array $items, int $quantity = 1, string $distributionId = null)
+ * @method static \Aws\Result invalidate(array|string $items, string $distributionId = null)
+ * @method static \Aws\Result reset(string $distributionId = null)
  * @method static string getInvalidation(string $invalidationId, string $distributionId = null)
  * @method static array listInvalidations(string $distributionId = null)
  */