Auth service

---

Getting deploy

---

versions

• php version 8.3.2 or greater
• nodejs version is greater 16.14 and small or equal 20.
• mysql 8.4

---

procedure

• composer install
• yarn install
• copy .env.example.prod as .env
  • Set DB config
  • Set the right domain name
  • Set email config
• php artisan key:generate
• php artisan migrate
• php artisan passport:client --personal
• php artisan passport:password --password
• supervisor config
  • copy .etc/supervisor/queue-base.conf (and fix projetc path in file)
  • copy .etc/supervisor/schedule.conf (and fix projetc path in file)
• yarn prod

PHP Laravel (Docker) environment

Requirements

• Docker version 18.06 or later
• Docker compose version 1.22 or later
• An editor or IDE
• MySQL Workbench

Note: OS recommendation - Linux Ubuntu based.

Components

1. Nginx 1.25
2. PHP 8.3 fpm
3. MySQL 8
4. Laravel 10
5. Mailpit (only for debug emails on dev environment)

Setting up Docker and docker-compose

1.For installing Docker please follow steps mentioned on page install on Ubuntu linux or install on Mac/Windows.

2.For installing docker-compose as Linux Standalone binary please follow steps on the page install compose if you are using Linux OS.

Note 1: Please run next cmd after above step 2 if you are using Linux OS: sudo usermod -aG docker $USER

Note 2: If you are using Docker Desktop for MacOS 12.2 or later - please enable virtiofs for performance (enabled by default since Docker Desktop v4.22).

Setting up DEV environment

1.You can clone this repository from Gitlab.

Note: Delete storage/mysql-data folder if it is exists.

2.Add domain to local hosts file:

127.0.0.1    localhost

3.Configure /docker/dev/xdebug-main.ini (Linux/Windows) or /docker/dev/xdebug-osx.ini (MacOS) (optional):

• In case you need debug only requests with IDE KEY: PHPSTORM from frontend in your browser:

xdebug.start_with_request = no

Install locally in Firefox extension "Xdebug helper" and set in settings IDE KEY: PHPSTORM

• In case you need debug any request to an api (by default):

xdebug.start_with_request = yes

4.Build, start and install the docker images from your terminal:

make build
make start
make composer-install
make env-dev

Note: If you want to change default docker configurations (web_port, etc...) - open .env file, edit necessary environment variable value and stop, rebuild, start docker containers.

5.Make sure that you have installed migrations/seeds:

make migrate
make seed

6.Set key for application:

make key-generate

7.In order to use this application, please open in your browser next urls:

• http://localhost
• http://localhost:8025 (Mailpit)

Setting up PROD environment locally

1.You can clone this repository from Gitlab.

Note: Delete storage/mysql-data and vendor folder if it is exists.

2.Edit docker-compose-prod.yml and set necessary user/password for MySQL.

3.Edit env.prod and set necessary user/password for MySQL.

Note: If you want to change default docker configurations (web_port, etc...) - create uncommitted .env file, copy data from .env.prod, edit necessary environment variable value.

4.Build, start and install the docker images from your terminal:

make build-prod
make start-prod

5.Make sure that you have installed migrations:

make migrate-no-test

6.Set key for application:

make key-generate

Getting shell to container

After application will start (make start) and in order to get shell access inside laravel container you can run following command:

make ssh

Note 1: Please use next make commands in order to enter in other containers: make ssh-nginx, make ssh-supervisord, make ssh-mysql.

Note 2: Please use exit command in order to return from container's shell to local shell.

Building containers

In case you edited Dockerfile or other environment configuration you'll need to build containers again using next commands:

make down
make build
make start

Note: Please use environment-specific commands if you need to build prod environment, more details can be found using help make help.

Start and stop environment containers

Please use next make commands in order to start and stop environment:

make start
make stop

Note: For prod environment need to be used next make commands: make start-prod, make stop-prod.

Stop and remove environment containers, networks

Please use next make commands in order to stop and remove environment containers, networks:

make down

Note: Please use environment-specific commands if you need to stop and remove prod environment, more details can be found using help make help.

Additional main command available

make build
make build-prod

make start
make start-prod

make stop
make stop-prod

make down
make down-prod

make restart
make restart-prod

make env-dev

make ssh
make ssh-root
make ssh-nginx
make ssh-supervisord
make ssh-mysql

make composer-install-no-dev
make composer-install
make composer-update

make key-generate

make info
make help

make logs
make logs-nginx
make logs-supervisord
make logs-mysql

make drop-migrate
make migrate-no-test
make migrate

make seed

make phpunit
make report-code-coverage

make phpcs
make ecs
make ecs-fix
make phpmetrics
make phpcpd
make phpstan
make phpinsights

etc....

Notes: Please see more commands in Makefile

Architecture & packages

• Laravel 11
• phpunit
• laravel-ide-helper
• scriptsdev
• composer-bin-plugin
• ergebnis/composer-normalize
• composer-unused
• composer-require-checker
• security-advisories
• php-coveralls
• easy-coding-standard
• PhpMetrics
• phpstan
• phpinsights
• rector

Guidelines

• Commands
• Development
• Testing
• IDE PhpStorm configuration
• Xdebug configuration