layers-ports-and-adapters-workshop
layers-ports-and-adapters-workshop copied to clipboard
Sandbox project for the "Advanced Web Application Architecture" training.
Sandbox project for the "Advanced Web Application Architecture" training
You'll find all the available training programs here: https://matthiasnoback.nl/training/
Installation
On most machines the easiest way to install this project is with Docker. If you have trouble running Docker, or just want to use the PHP runtime that's installed on your machine already, take a look at option 2 below.
Option 1: Docker
Requirements
- Docker Engine
- Docker Compose
- Git
- Bash
Getting started
- Clone this repository (
git clone [email protected]:matthiasnoback/layers-ports-and-adapters-workshop.git
) andcd
into it. - Run
bin/install
. - Open http://localhost:8080 in a browser. You should see the homepage of the meetup application.
If port 8080 is no longer available on your local machine, modify docker-compose.yml
to publish to another port:
ports:
# To try port 8081:
- "8081:8080"
Running development tools
- Run
bin/composer.sh
to use Composer (e.g.bin/composer.sh require symfony/var-dumper
). - Run
bin/run_tests.sh
to run the tests. - Run
bin/deptrac.sh
to analyze dependencies. - Run
bin/meetup.sh
to use the CLI tool for scheduling meetups.
Cleaning up after the workshop
- Run
bin/cleanup
to remove all containers for this project, their images, and their volumes. - Remove the project directory.
- If you don't use Docker normally, you can shut it down or uninstall it too.
Option 2: With PHP and Composer
Requirements
- PHP (>=7.4)
- Composer
- Git
- Bash
Getting started
- Clone this repository (
git clone [email protected]:matthiasnoback/layers-ports-and-adapters-workshop.git
) andcd
into it. - Run
composer install --prefer-dist
. - Start the webserver by running
php -S 0.0.0.0:8080 -t public/
, and keep this process running. - Open http://localhost:8080/ in a browser. You should see the homepage of the meetup application.
- Optionally install deptrac.
Running development tools
- Run
./run_tests.sh
to run all the tests (make sure that you also still have the webserver running). - Run
./meetup
to work with the command-line version of this application.
Cleaning up after the workshop
- Just remove the project directory.