sergii-bubalo / bsa-2017-bebeep

Binary Studio Academy 2017 PHP group project

Getting started

Install the following packages prior to standing up your development environment:

• Git
• docker
• docker-compose

For Windows OS:

• You need to set the password for your user account, if you do not have one. During installation, Docker requests Sharing folders with the project, and for this you need to enter a password.
• Also possible problems with the firewall. Temporarily disable or add the Docker to the exceptions.

Clone this repository to your favorite repository source directory and cd inside.

Then type:

cp .env.example .env
docker-compose up -d
docker-compose run --rm composer install
docker-compose exec web php artisan key:generate
docker-compose exec web php artisan migrate:install

For Windows OS - winpty docker-compose exec web php artisan <your command>

Frontend part (SPA)

If you are using Windows OS, first of all, install windows-build-tools for better compile of native Node modules:

npm install --global windows-build-tools

Install all javascript packages:

npm install

Compile all resources:

Development

npm run dev

... with the automatically recompile

npm run watch

Production

npm run prod

Done. Go to:

http://localhost

Usage

After installation to start your containers you have only type next command:

docker-compose up -d web

If you want to run composer command you should use it within docker:

docker-compose run --rm composer <your command>

In order to execute artisan command use next syntax:

docker-compose exec web php artisan <your command>

Running tests:

docker-compose run --rm tests