HowTo - Set up Database Connections

Edit on GitHub

Spryker provides flexible database connection configuration.

Single connection

Most probable use case and the Zed DB connection is a good example here.

For this you need to open environment config file (eg. APP_DIR/config/Shared/config_default-development_DE.php) and add the following parameters:

$config[PropelConstants::ZED_DB_USERNAME] = 'username';
$config[PropelConstants::ZED_DB_PASSWORD] = 'password';
$config[PropelConstants::ZED_DB_DATABASE] = 'database';
$config[PropelConstants::ZED_DB_HOST] = '';
$config[PropelConstants::ZED_DB_PORT] = 3306;
$config[PropelConstants::ZED_DB_ENGINE] = $config[PropelConstants::ZED_DB_ENGINE_MYSQL];

By default Spryker provides configuration for a single connection (two zed and default, but with the same configuration). The configuration you could find in APP_DIR/config/Shared/config_propel.php and it will look like the following:

$engine = $config[PropelConstants::ZED_DB_ENGINE];
$config[PropelConstants::PROPEL]['database']['connections']['default'] = $connections[$engine];
$config[PropelConstants::PROPEL]['database']['connections']['zed'] = $connections[$engine];

Multi connections

Custom case, which allows a project to have more than one connections to different DBs. To define a new connection find a Propel configuration APP_DIR/config/Shared/config_propel.phpand add the following (example for Postgres):

$config[PropelConstants::PROPEL]['database']['connections']['additional_db_connection'] = [
'adapter' => PropelConfig::DB_ENGINE_PGSQL,
'dsn' => 'pgsql:host=;port=5432;dbname=additional_db',
'user' => 'username',
'password' => 'password',
'settings' => [],

When a new connection is available you could use it in your schema file.