<h2>File Contents: /home/planet5/www/wp-content/plugins/amp/src/Infrastructure/Injector/copy_of_SimpleInjector.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/amp/src/Infrastructure/Injector/copy_of_SimpleInjector.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Final class SimpleInjector.
 *
 * @package AmpProject\AmpWP
 */

namespace AmpProject\AmpWP\Infrastructure\Injector;

use AmpProject\AmpWP\Exception\FailedToMakeInstance;
use AmpProject\AmpWP\Infrastructure\Injector;
use AmpProject\AmpWP\Infrastructure\Instantiator;
use Exception;
use ReflectionClass;
use ReflectionParameter;

/**
 * A simplified implementation of a dependency injector.
 *
 * @since 2.0
 * @internal
 */
final class SimpleInjector implements Injector {

	/**
	 * Special-case index key for handling globally defined named arguments.
	 *
	 * @var string
	 */
	const GLOBAL_ARGUMENTS = &#039;__global__&#039;;

	/** @var array&lt;string&gt; */
	private $mappings = [];

	/** @var array&lt;object|null&gt; */
	private $shared_instances = [];

	/** @var array&lt;callable&gt; */
	private $delegates = [];

	/** @var array[] */
	private $argument_mappings = [
		self::GLOBAL_ARGUMENTS =&gt; [],
	];

	/** @var Instantiator */
	private $instantiator;

	/**
	 * Instantiate a SimpleInjector object.
	 *
	 * @param Instantiator|null $instantiator Optional. Instantiator to use.
	 */
	public function __construct( ?Instantiator $instantiator = null ) {
		$this-&gt;instantiator = null !== $instantiator
			? $instantiator
			: new FallbackInstantiator();
	}

	/**
	 * Make an object instance out of an interface or class.
	 *
	 * @param string $interface_or_class Interface or class to make an object
	 *                                   instance out of.
	 * @param array  $arguments          Optional. Additional arguments to pass
	 *                                   to the constructor. Defaults to an
	 *                                   empty array.
	 * @return object Instantiated object.
	 */
	public function make( $interface_or_class, $arguments = [] ) {
		$injection_chain = $this-&gt;resolve(
			new InjectionChain(),
			$interface_or_class
		);

		$class = $injection_chain-&gt;get_class();

		if ( $this-&gt;has_shared_instance( $class ) ) {
			return $this-&gt;get_shared_instance( $class );
		}

		if ( $this-&gt;has_delegate( $class ) ) {
			$delegate = $this-&gt;get_delegate( $class );
			$object   = $delegate( $class );
		} else {
			$reflection = $this-&gt;get_class_reflection( $class );
			$this-&gt;ensure_is_instantiable( $reflection );

			$dependencies = $this-&gt;get_dependencies_for(
				$injection_chain,
				$reflection,
				$arguments
			);

			$object = $this-&gt;instantiator-&gt;instantiate( $class, $dependencies );
		}

		if ( \array_key_exists( $class, $this-&gt;shared_instances ) ) {
			$this-&gt;shared_instances[ $class ] = $object;
		}

		return $object;
	}

	/**
	 * Bind a given interface or class to an implementation.
	 *
	 * Note: The implementation can be an interface as well, as long as it can
	 * be resolved to an instantiatable class at runtime.
	 *
	 * @param string $from Interface or class to bind an implementation to.
	 * @param string $to   Interface or class that provides the implementation.
	 * @return Injector
	 */
	public function bind( $from, $to ) {
		$this-&gt;mappings[ $from ] = $to;

		return $this;
	}

	/**
	 * Bind an argument for a class to a specific value.
	 *
	 * @param string $interface_or_class Interface or class to bind an argument
	 *                                   for.
	 * @param string $argument_name      Argument name to bind a value to.
	 * @param mixed  $value              Value to bind the argument to.
	 *
	 * @return Injector
	 */
	public function bind_argument(
		$interface_or_class,
		$argument_name,
		$value
	) {
		$this-&gt;argument_mappings[ $interface_or_class ][ $argument_name ] = $value;

		return $this;
	}

	/**
	 * Always reuse and share the same instance for the provided interface or
	 * class.
	 *
	 * @param string $interface_or_class Interface or class to reuse.
	 * @return Injector
	 */
	public function share( $interface_or_class ) {
		$this-&gt;shared_instances[ $interface_or_class ] = null;

		return $this;
	}

	/**
	 * Delegate instantiation of an interface or class to a callable.
	 *
	 * @param string   $interface_or_class Interface or class to delegate the
	 *                                     instantiation of.
	 * @param callable $callable           Callable to use for instantiation.
	 * @return Injector
	 */
	public function delegate( $interface_or_class, callable $callable ) {
		$this-&gt;delegates[ $interface_or_class ] = $callable;

		return $this;
	}

	/**
	 * Make an object instance out of an interface or class.
	 *
	 * @param InjectionChain $injection_chain    Injection chain to track
	 *                                           resolutions.
	 * @param string         $interface_or_class Interface or class to make an
	 *                                           object instance out of.
	 * @return object Instantiated object.
	 */
	private function make_dependency(
		InjectionChain $injection_chain,
		$interface_or_class
	) {
		$injection_chain = $this-&gt;resolve(
			$injection_chain,
			$interface_or_class
		);

		$class = $injection_chain-&gt;get_class();

		if ( $this-&gt;has_shared_instance( $class ) ) {
			return $this-&gt;get_shared_instance( $class );
		}

		if ( $this-&gt;has_delegate( $class ) ) {
			$delegate = $this-&gt;get_delegate( $class );
			return $delegate( $class );
		}

		$reflection = $this-&gt;get_class_reflection( $class );
		$this-&gt;ensure_is_instantiable( $reflection );

		$dependencies = $this-&gt;get_dependencies_for(
			$injection_chain,
			$reflection
		);

		$object = $this-&gt;instantiator-&gt;instantiate( $class, $dependencies );

		if ( \array_key_exists( $class, $this-&gt;shared_instances ) ) {
			$this-&gt;shared_instances[ $class ] = $object;
		}

		return $object;
	}

	/**
	 * Recursively resolve an interface to the class it should be bound to.
	 *
	 * @param InjectionChain $injection_chain    Injection chain to track
	 *                                           resolutions.
	 * @param string         $interface_or_class Interface or class to resolve.
	 * @return InjectionChain Modified Injection chain
	 * @throws FailedToMakeInstance If a circular reference was detected.
	 */
	private function resolve(
		InjectionChain $injection_chain,
		$interface_or_class
	) {
		if ( $injection_chain-&gt;is_in_chain( $interface_or_class ) ) {
			// Circular reference detected, aborting.
			throw FailedToMakeInstance::for_circular_reference(
				$interface_or_class,
				$injection_chain
			);
		}

		$injection_chain = $injection_chain-&gt;add_resolution( $interface_or_class );

		if ( \array_key_exists( $interface_or_class, $this-&gt;mappings ) ) {
			return $this-&gt;resolve(
				$injection_chain,
				$this-&gt;mappings[ $interface_or_class ]
			);
		}

		return $injection_chain-&gt;add_to_chain( $interface_or_class );
	}

	/**
	 * Get the array of constructor dependencies for a given reflected class.
	 *
	 * @param InjectionChain  $injection_chain   Injection chain to track
	 *                                           resolutions.
	 * @param ReflectionClass $reflection        Reflected class to get the
	 *                                           dependencies for.
	 * @param array           $arguments         Associative array of directly
	 *                                           provided arguments.
	 * @return array Array of dependencies that represent the arguments for the
	 *                                           class&#039; constructor.
	 */
	private function get_dependencies_for(
		InjectionChain $injection_chain,
		ReflectionClass $reflection,
		$arguments = []
	) {
		$constructor = $reflection-&gt;getConstructor();
		$class       = $reflection-&gt;getName();

		if ( null === $constructor ) {
			return [];
		}

		return \array_map(
			function ( ReflectionParameter $parameter ) use ( $injection_chain, $class, $arguments ) {
				return $this-&gt;resolve_argument(
					$injection_chain,
					$class,
					$parameter,
					$arguments
				);
			},
			$constructor-&gt;getParameters()
		);
	}

	/**
	 * Ensure that a given reflected class is instantiable.
	 *
	 * @param ReflectionClass $reflection Reflected class to check.
	 * @return void
	 * @throws FailedToMakeInstance If the interface could not be resolved.
	 */
	private function ensure_is_instantiable( ReflectionClass $reflection ) {
		if ( ! $reflection-&gt;isInstantiable() ) {
			throw FailedToMakeInstance::for_unresolved_interface( $reflection-&gt;getName() );
		}
	}

	/**
	 * Resolve a given reflected argument.
	 *
	 * @param InjectionChain      $injection_chain  Injection chain to track
	 *                                              resolutions.
	 * @param string              $class            Name of the class to
	 *                                              resolve the arguments for.
	 * @param ReflectionParameter $parameter        Parameter to resolve.
	 * @param array               $arguments        Associative array of
	 *                                              directly provided
	 *                                              arguments.
	 * @return mixed Resolved value of the argument.
	 */
	private function resolve_argument(
		InjectionChain $injection_chain,
		$class,
		ReflectionParameter $parameter,
		$arguments
	) {
		if ( ! $parameter-&gt;hasType() ) {
			return $this-&gt;resolve_argument_by_name(
				$class,
				$parameter,
				$arguments
			);
		}

		$type = $parameter-&gt;getType();

		if ( null === $type ||
			( is_a( $type, &#039;ReflectionType&#039; ) &amp;&amp; method_exists( $type, &#039;isBuiltin&#039; ) &amp;&amp; $type-&gt;isBuiltin() )
		) {
			return $this-&gt;resolve_argument_by_name(
				$class,
				$parameter,
				$arguments
			);
		}

		$type = $type instanceof \ReflectionNamedType
			? $type-&gt;getName()
			: (string) $type;

		return $this-&gt;make_dependency( $injection_chain, $type );
	}

	/**
	 * Resolve a given reflected argument by its name.
	 *
	 * @param string              $class     Class to resolve the argument for.
	 * @param ReflectionParameter $parameter Argument to resolve by name.
	 * @param array               $arguments Associative array of directly
	 *                                       provided arguments.
	 * @return mixed Resolved value of the argument.
	 * @throws FailedToMakeInstance If the argument could not be resolved.
	 */
	private function resolve_argument_by_name(
		$class,
		ReflectionParameter $parameter,
		$arguments
	) {
		$name = $parameter-&gt;getName();

		// The argument was directly provided to the make() call.
		if ( \array_key_exists( $name, $arguments ) ) {
			return $arguments[ $name ];
		}

		// Check if we have mapped this argument for the specific class.
		if ( \array_key_exists( $class, $this-&gt;argument_mappings )
			&amp;&amp; \array_key_exists( $name, $this-&gt;argument_mappings[ $class ] ) ) {
			$value = $this-&gt;argument_mappings[ $class ][ $name ];

			// Closures are immediately resolved, to provide lazy resolution.
			if ( is_callable( $value ) ) {
				$value = $value( $class, $parameter, $arguments );
			}

			return $value;
		}

		// No argument found for the class, check if we have a global value.
		if ( \array_key_exists( $name, $this-&gt;argument_mappings[ self::GLOBAL_ARGUMENTS ] ) ) {
			return $this-&gt;argument_mappings[ self::GLOBAL_ARGUMENTS ][ $name ];
		}

		// No provided argument found, check if it has a default value.
		try {
			if ( $parameter-&gt;isDefaultValueAvailable() ) {
				return $parameter-&gt;getDefaultValue();
			}
		} catch ( Exception $exception ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch
			// Just fall through into the FailedToMakeInstance exception.
		}

		// Out of options, fail with an exception.
		throw FailedToMakeInstance::for_unresolved_argument( $name, $class );
	}

	/**
	 * Check whether a shared instance exists for a given class.
	 *
	 * @param string $class Class to check for a shared instance.
	 * @return bool Whether a shared instance exists.
	 */
	private function has_shared_instance( $class ) {
		return \array_key_exists( $class, $this-&gt;shared_instances )
			&amp;&amp; null !== $this-&gt;shared_instances[ $class ];
	}

	/**
	 * Get the shared instance for a given class.
	 *
	 * @param string $class Class to get the shared instance for.
	 * @return object Shared instance.
	 * @throws FailedToMakeInstance If an uninstantiated shared instance is
	 *                              requested.
	 */
	private function get_shared_instance( $class ) {
		if ( ! $this-&gt;has_shared_instance( $class ) ) {
			throw FailedToMakeInstance::for_uninstantiated_shared_instance( $class );
		}

		return (object) $this-&gt;shared_instances[ $class ];
	}

	/**
	 * Check whether a delegate exists for a given class.
	 *
	 * @param string $class Class to check for a delegate.
	 * @return bool Whether a delegate exists.
	 */
	private function has_delegate( $class ) {
		return \array_key_exists( $class, $this-&gt;delegates );
	}

	/**
	 * Get the delegate for a given class.
	 *
	 * @param string $class Class to get the delegate for.
	 * @return callable Delegate.
	 * @throws FailedToMakeInstance If an invalid delegate is requested.
	 */
	private function get_delegate( $class ) {
		if ( ! $this-&gt;has_delegate( $class ) ) {
			throw FailedToMakeInstance::for_invalid_delegate( $class );
		}

		return $this-&gt;delegates[ $class ];
	}

	/**
	 * Get the reflection for a class or throw an exception.
	 *
	 * @param string $class Class to get the reflection for.
	 * @return ReflectionClass Class reflection.
	 * @throws FailedToMakeInstance If the class could not be reflected.
	 */
	private function get_class_reflection( $class ) {
		try {
			return new ReflectionClass( $class );
		} catch ( Exception $exception ) {
			throw FailedToMakeInstance::for_unreflectable_class( $class );
		}
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Famp%2Fsrc%2FInfrastructure%2FInjector'>⬅ Back to Directory</a>