Application Configuration
For operating Shopsys Framework it is needed to have correctly set connections to external services via parameters.yml
config.
From the clean project, during composer installation process it will prompt you to set the values of parameters (app/config/parameters.yml
):
Name | Description |
---|---|
database_host |
access data of your PostgreSQL database |
database_port |
... |
database_name |
... |
database_user |
... |
database_password |
... |
elasticsearch_host |
host of your Elasticsearch |
redis_host |
host of your Redis storage (credentials are not supported right now) |
mailer_transport |
access data of your mail server |
mailer_host |
... |
mailer_user |
... |
mailer_password |
... |
mailer_disable_delivery |
set to true if you don't want to send any e-mails |
mailer_master_email_address |
set if you want to send all e-mails to one address (useful for development) |
mailer_delivery_whitelist |
set as array with regex text items if you want to have master e-mail but allow sending to specific addresses |
secret |
randomly generated secret token |
trusted_proxies |
proxies that are trusted to pass traffic, used mainly for production |
env(REDIS_PREFIX) |
separates more projects that use the same redis service |
env(ELASTIC_SEARCH_INDEX_PREFIX) |
separates more projects that use the same elasticsearch service |
Composer will then prompt you to set parameters for testing environment (app/config/parameters_test.yml
):
Name | Description |
---|---|
test_database_host |
access data of your PostgreSQL database for tests |
test_database_port |
... |
test_database_name |
... |
test_database_user |
... |
test_database_password |
... |
overwrite_domain_url |
overwrites URL of all domains for acceptance testing (set to ~ to disable) |
selenium_server_host |
with native installation the selenium server is on localhost |
test_mailer_transport |
access data of your mail server for tests |
test_mailer_host |
... |
test_mailer_user |
... |
test_mailer_password |
... |
shopsys.content_dir_name |
web/content-test/ directory is used instead of web/content/ during the tests |
Note
All default values use default ports for all external services like PostgreSQL database, elasticsearch, redis, ...
Tip
Host values can be modified or can be aliased for your Operating System via /etc/hosts
or C:\Windows\System32\drivers\etc\hosts