Commit realizado el 12:13:52 08-04-2024

wp-content/plugins/web-stories/includes/Infrastructure/ServiceContainer.php

@@ -0,0 +1,74 @@
+<?php
+/**
+ * Interface ServiceContainer.
+ *
+ * @link      https://www.mwpd.io/
+ *
+ * @copyright 2019 Alain Schlesser
+ * @license   MIT
+ */
+
+/**
+ * Original code modified for this project.
+ *
+ * @copyright 2021 Google LLC
+ * @license   https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
+ */
+
+declare(strict_types = 1);
+
+namespace Google\Web_Stories\Infrastructure;
+
+use ArrayAccess;
+use Countable;
+use Google\Web_Stories\Exception\InvalidService;
+use Traversable;
+
+/**
+ * The service container collects all services to manage them.
+ *
+ * This is based on PSR-11 and should extend that one if Composer dependencies
+ * are being used. Relying on a standardized interface like PSR-11 means you'll
+ * be able to easily swap out the implementation for something else later on.
+ *
+ * @internal
+ *
+ * @since 1.6.0
+ *
+ * @see https://www.php-fig.org/psr/psr-11/
+ */
+interface ServiceContainer extends Traversable, Countable, ArrayAccess {
+
+	/**
+	 * Find a service of the container by its identifier and return it.
+	 *
+	 * @since 1.6.0
+	 *
+	 * @throws InvalidService If the service could not be found.
+	 *
+	 * @param string $id Identifier of the service to look for.
+	 * @return Service Service that was requested.
+	 */
+	public function get( string $id ): Service;
+
+	/**
+	 * Check whether the container can return a service for the given
+	 * identifier.
+	 *
+	 * @since 1.6.0
+	 *
+	 * @param string $id Identifier of the service to look for.
+	 */
+	public function has( string $id ): bool;
+
+	/**
+	 * Put a service into the container for later retrieval.
+	 *
+	 * @since 1.6.0
+	 *
+	 * @param string  $id      Identifier of the service to put into the
+	 *                         container.
+	 * @param Service $service Service to put into the container.
+	 */
+	public function put( string $id, Service $service ): void;
+}