Installing the project

(Version Tela Botanica)

Cloning the project

git clone https://gitlab.com/slack_lpm/cel2-services.git

Installing depencies

In the project root folder, launch the composer install with the following options:

For dev:

composer install

For prod:

APP_ENV=prod composer install --no-dev --optimize-autoloader

Editing configuration

The default configuration are located in the .env file at root folder of the project. You have to create an '.env.prod' file to override the environment variables which suit your setup.

Editing elasticsearch instance URL

The communication with elasticsearch is managed by FOSElasticaBundle.

You can change the ES instance URL in the config/packages/fos_elastica.yaml file.

Editing database credentials and mysql instance

Configure your database connection:

DATABASE_URL=mysql://db_username:db_paswword@db_server_host:db_server_port/db_name

Editing the CORS policy

CORS feature is managed by NelmioCorsBundle.

The configuration file is config/packages/nelmio_cors.yaml. You may want to edit the settings for the '^/api/' path.

Creating the database

Run the sql script located in the 'sql' folder of the project.

Dev: populating the DB and elasticsearch index with dev/test data

Run the data fixture to populate the DB:

php bin/console doctrine:fixtures:load -v

To populate the index by scanning the whole DB, run the following:

php bin/console fos:elastica:populate -v

Dev: launching the app on the test server

You can do so by issuing the following command:

php bin/console server:start

Or, if the 80 port is already used:

php bin/console server:start *:8080

Stopping the server is done by issuing:

php bin/console server:stop

Prod: Deploying on server

You can then follow the symfony manual depending on the server you want to deploy on: https://symfony.com/doc/current/deployment.html

Deleting generated temporary files

In production, a cleanup script must be executed periodically (crontabed) to delete useless generated temporary files (PDF tags, proxied responses from external Web services, photo archives...). The path where they are stored is given by the "TMP_FOLDER" entry of the .env file. An example of such a script is given below (deletes files older than two days) :

find /path/to/tmp/folder/ -type f -mtime +2 -exec rm {} \;