1.x

• Basic implementation of plugin initializer
• docs: improve documentation
• docs: improve API method documentation
• chore: improve composer package definition and readme
• feat(wip): allow private hooks calls
• improve into wp-hook and some additional unfinished things
• feat: moving toward actual implementation
• refactor: hookable driver should belong to separate package
• refactor: HookProvider also belongs to another package
• refactor: remove PluginHeaderData
• feat: add VERY simple command to cache plugin data
• refactor: rename header parser implementation
• refactor: simplify package
• refactor: remove unused tests
• chore: add static analysis
• feat: add initial bindings for wp-builder compatibility
• chore: add editorconfig
• fix: passthrough container definitions argument
• fix: use absolute cache path
• fix: don't use hook and global variable
• refactor: remove method, which can be replaced with get_path
• refactor: reorder definition loading, change config key name
• fix: correct cache path
• feat: add hook driver backward compatible with wp-builder
• fix: throw exception on failed load
• feat: add check for optional package
• chore: add config files
• feat: large rework, needs followup

src/Kernel.php

+<?php
+declare( strict_types=1 );
+
+namespace WPDesk\Init;
+
+use DI\Container;
+use DI\ContainerBuilder as DiBuilder;
+use Psr\Container\ContainerInterface;
+use WPDesk\Init\Binding\Binder\CallableBinder;
+use WPDesk\Init\Binding\Binder\CompositeBinder;
+use WPDesk\Init\Binding\Binder\HookableBinder;
+use WPDesk\Init\Binding\Binder\StoppableBinder;
+use WPDesk\Init\Binding\Loader\CompositeBindingLoader;
+use WPDesk\Init\Configuration\Configuration;
+use WPDesk\Init\DependencyInjection\ContainerBuilder;
+use WPDesk\Init\Extension\ExtensionsSet;
+use WPDesk\Init\HookDriver\CompositeDriver;
+use WPDesk\Init\HookDriver\GenericDriver;
+use WPDesk\Init\HookDriver\HookDriver;
+use WPDesk\Init\HookDriver\LegacyDriver;
+use WPDesk\Init\Util\PhpFileLoader;
+use WPDesk\Init\Plugin\Header;
+use WPDesk\Init\Util\Path;
+use WPDesk\Init\Plugin\DefaultHeaderParser;
+use WPDesk\Init\Plugin\HeaderParser;
+use WPDesk\Init\Plugin\Plugin;
+
+final class Kernel {
+
+	/** @var string|null Plugin filename. */
+	private $filename;
+
+	/** @var Configuration */
+	private $config;
+
+	/** @var PhpFileLoader */
+	private $loader;
+
+	/** @var HeaderParser */
+	private $parser;
+
+	/** @var ExtensionsSet */
+	private $extensions;
+
+	public function __construct(
+		string $filename,
+		Configuration $config,
+		ExtensionsSet $extensions
+	) {
+		$this->filename   = $filename;
+		$this->config     = $config;
+		$this->extensions = $extensions;
+		$this->loader     = new PhpFileLoader();
+		$this->parser     = new DefaultHeaderParser();
+	}
+
+	public function boot(): void {
+		$cache_path = $this->get_cache_path( 'plugin.php' );
+		try {
+			$plugin_data = $this->loader->load( $cache_path );
+		} catch ( \Exception $e ) {
+			// If cache not found, load data from memory.
+			// Avoid writing files on host environment.
+			// Generate cache with command instead.
+			$plugin_data = $this->parser->parse( $this->filename );
+		}
+
+		$plugin = new Plugin( $this->filename, new Header( $plugin_data ) );
+
+		$container = $this->initialize_container( $plugin );
+		$container->set( Plugin::class, $plugin );
+		$container->set( Configuration::class, $this->config );
+
+		$this->prepare_driver( $container )->register_hooks();
+	}
+
+	private function get_cache_path( string $path = '' ): string {
+		return (string) ( new Path( $this->config->get( 'cache_path', 'generated' ) ) )->join( $path )->absolute(
+			rtrim( plugin_dir_path( $this->filename ), '/' ) . '/'
+		);
+	}
+
+	private function get_container_name( Plugin $plugin ): string {
+		return str_replace( '-', '_', $plugin->get_slug() ) . '_container';
+	}
+
+	private function initialize_container( Plugin $plugin ): Container {
+		$original_builder = new DiBuilder();
+
+		// If there's a cache file, use it as we are in production environment.
+		// Otherwise, build the container from scratch and use live version, without compilation.
+		if ( file_exists( $this->get_cache_path( $this->get_container_name( $plugin ) . '.php' ) ) ) {
+			$original_builder->enableCompilation(
+				$this->get_cache_path(),
+				$this->get_container_name( $plugin )
+			);
+			return $original_builder->build();
+		}
+
+		$builder = new ContainerBuilder( $original_builder );
+
+		foreach ( $this->extensions as $extension ) {
+			$extension->build( $builder, $plugin, $this->config );
+		}
+
+		return $builder->build();
+	}
+
+	private function prepare_driver( ContainerInterface $container ): HookDriver {
+		$loader = new CompositeBindingLoader();
+		foreach ( $this->extensions->bindings( $container ) as $bindings ) {
+			$loader->add( $bindings );
+		}
+
+		$driver = new GenericDriver(
+			$loader,
+			new StoppableBinder(
+				new CompositeBinder(
+					new HookableBinder( $container ),
+					new CallableBinder( $container )
+				),
+				$container
+			)
+		);
+
+		if ( class_exists( \WPDesk_Plugin_Info::class ) ) {
+			$driver = new CompositeDriver(
+				$driver,
+				new LegacyDriver( $container )
+			);
+		}
+
+		return $driver;
+	}
+}