GSMA Service Provider Simulator

BASE STRUCTURE

  build/		contains docker container config
  runtime/
    |-- bash/		Bash history (composer cache, bash commands history)
    |-- mysql/		MySQL databases for docker container
  src/			Laravel application code (Project)

INSTALLATION

Project can be setup with Docker.

(If you have a Mac machine - we recommend to run docker under Vagrant)

1. Clone repository
2. Navigate to your project directory
3. Run make init, this command will copy important files from examples:
   • .env
   • docker-compose.yml
   • src/.env
   • build/nginx-server.conf
4. Check .env files for correct configurations.
5. Run a test run to build containers and init DB: make test-run. After containers up press "Ctrl+C" to exit.
6. Run containers with make run
7. Add to your /etc/hosts file: 127.0.0.1 itp-sp.test
8. Run installation make install

Docker PHP Container

To get inside PHP container to run composer/php commands run this command:

make php-bash

Inside PHP container there is also GNU Make utility, run make without any parameters to get available commands list.

Prettier usage

To run prettier install nodejs on your machine and run:

npm run prettier

Using telescope for check incoming requests

In src/.env set TELESCOPE_ENABLED=true

Run

make php-bash

Inside PHP container run

php artisan telescope:install

php artisan migrate

Site access:

Access your site via URL: http://itp-sp.test:8087

You're ready to write your code!