Download the PHP package motana/multikernel without Composer

MotanaMultikernelBundle

This bundle extends a Symfony3 project by the ability to use multiple apps in the same project directory, all running with the same front controller and bin/console.

Routing within the apps will work as usual, which means already existing routes will continue to work. Each app will be made available with its kernel name as URL prefix by the front controller. The bin/console replacement is able to run commands like cache:clear, cache:pool:clear and assets:install for all apps in one run, which will make the SensioDistributionBundle run those commands for all apps when running composer install or composer update.

Since the BootKernel is a modified Symfony Kernel with almost all features disabled, the penalty of having a prefixed extra kernel is rather small.

Installation

Step 1: Download the bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

in a shell.

Step 2: Enable the bundle

Enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project. Make sure it is registered after the SensioGeneratorBundle:

Step 3: Use the commands of the bundle to convert your project

Open a command console, enter your project directory and execute the following command to convert your project:

How the filesystem structure is changed

Running the multikernel:convert command will make the following changes to the filesystem structure of the project:

• A boot kernel skeleton will be created into the apps/ subdirectory of your project
• All found apps will be copied to apps/<DIR_NAME>
• The kernel of every app will be modified to run with the BootKernel
• Configuration of the apps are modified to reflect the filesystem structure changes
• The front controller and bin/console are replaced

After all modifications have taken place, the original app directories and also all files and directories under var/cache/, var/logs and var/sessions are removed.

The command makes the following changes to each app kernel to make it work in a multikernel environment:

• Use clauses are replaced to use classes from the MotanaMultikernelBundle
• The methods getCacheDir(), getLogDir() and registerContainerConfiguration() are removed

The command changes the configuration of each app for a changed directory scheme under var/:

• Caches for each kernel are stored in var/cache/<KERNEL_NAME>/<ENVIRONMENT_NAME>/
• Logs for each kernel are stored in var/logs/<KERNEL_NAME>/<ENVIRONMENT_NAME>.log
• Sessions for each kernel are stored in var/sessions/<KERNEL_NAME>/

After running the multikernel:convert command, run the following commands on a shell:

Configuration

The following settings can be used in apps/config/config.yml to configure the BootKernel:

Testing your project

To reflect the changes in the filesystem structure and routing, your phpunit.xml needs to be updated as follows:

Change the KERNEL_CLASS setting to BootKernel

To select a kernel in your tests extending Symfony\Bundle\FrameworkBundle\Test\WebTestCase simply prefix the kernel name to the URL used in the test.

Credits

Portions of this bundle are based on work of Fabien Potencier <[email protected]> and Jean-François Simon <[email protected]>.

License

This bundle is licensed under the MIT license - see the LICENSE file for details.