Install on a new Sylius project

Netgen provides an uptodate installation of Sylius with Netgen Layouts pre-installed. The installation is based on Sylius Standard Edition, ready to be used as a base for your new project.

This installation can later be used to upgrade to future versions of Sylius by following official upgrade instructions.

Create a database

Create a database for your project with:

CREATE DATABASE sylius_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;

Use Composer

Install Composer and execute the following from a directory of your choice:

$ composer create-project netgen/layouts-sylius-site my_project
$ cd my_project

Create a .env.local file in the project root directory to specify database connection details:

DATABASE_URL=mysql://user:pass@127.0.0.1/sylius_%kernel.environment%

Finally, run the Sylius install wizard:

$ php bin/console sylius:install
$ yarn install
$ yarn build

Import Netgen Layouts database tables

Run the following command from the project root to import Netgen Layouts database tables:

# If you use Doctrine Migrations 3
$ php bin/console doctrine:migrations:migrate --configuration=vendor/netgen/layouts-core/migrations/doctrine.yaml

# If you use Doctrine Migrations 2
$ php bin/console doctrine:migrations:migrate --configuration=vendor/netgen/layouts-core/migrations/doctrine2.yaml

Start the app

You can use the web server included with Symfony CLI to serve the app:

$ symfony server:ca:install # For HTTPS support, only needs to be ran once
$ symfony server:start

After that, open https://127.0.0.1:8000 in your browser to run the app.

What next?

Read up on how to achieve various developer tasks in Netgen Layouts by visiting the Cookbook docs section.