$services
*/
protected array $services = array();
/**
* A list of created instances
*
* @var array $instances
*/
protected array $instances = array();
/**
* Prevents deserialization of this class to avoid callback replacement attacks.
*
* @param array $data The serialized data.
* @return void
* @throws \Exception Always throws an exception to prevent deserialization.
*/
public function __unserialize( array $data ): void {
throw new \Exception( 'Deserialization of Container is not allowed for security reasons.' );
}
/**
* The method for registering a new service.
*
* @param string $name The name of the service.
* @param callable $callback The callable that will be used to create the service.
* @return void
* @phpstan-template T of object
* @phpstan-param class-string $name
*/
public function set( string $name, callable $callback ): void {
$this->services[ $name ] = $callback;
}
/**
* Method for getting a registered service.
*
* @param string $name The name of the service.
* @return object The service instance.
* @throws \Exception If the service is not found.
* @phpstan-template T of object
* @phpstan-param class-string $name
* @phpstan-return T
*/
public function get( string $name ): object {
// Check if the service is already instantiated.
if ( isset( $this->instances[ $name ] ) ) {
/**
* Instance.
*
* @var T $instance Instance of requested service.
*/
$instance = $this->instances[ $name ];
return $instance;
}
// Check if the service is registered.
if ( ! isset( $this->services[ $name ] ) ) {
throw new \Exception( esc_html( "Service not found: $name" ) );
}
/**
* Instance.
*
* @var T $instance Instance of requested service.
*/
$instance = $this->services[ $name ]( $this );
$this->instances[ $name ] = $instance;
return $instance;
}
}