Kalaxia

Setup

Dependencies

• Docker and Docker Compose
• We recommend using Symfony CLI on your local environment. Otherwise you can adapt the given commands to be executed inside your PHP-FPM container.
• If you want to do this, you will need to have PHP 8.4 installed in your host system with the following extensions :
  • curl
  • redis
  • amqp
  • xml
  • dom
  • simplexml
  • zip
  • intl
  • pdo-mysql

Procedure

First, clone the repository on your local environment :

git clone git@github.com:Kern046/asylamba-game.git kalaxia

Move to the cloned repository and then move to the adequate branch (don't hesitate to ask which one it is currently since we are not using master for now)

cd kalaxia
git checkout {branch} # Insert the current main branch, which is currently changing regularly

Launch the Docker containers :

docker compose up -d

Then, install the project dependencies and setup the database :

# Install the PHP dependencies
symfony composer install
# Install the frontend dependencies
symfony console importmap:install
# Setup the database schema using Doctrine ORM
symfony console doctrine:schema:update --force --complete
# Initialize a new game data in Kalaxia (players, map systems, planets...)
# If you launch this on
symfony console app:hephaistos:populate-database

If you prefer to launch the commands inside your Docker container, just type docker exec -it kalaxia_app sh and then replace symfony console with php bin/console in the given commands.

Currently investigating a connection issue between Symfony CLI running on the host and the database.

If you are working on the UI, launch Tailwind watcher :

symfony console tailwind:build --watch

Troubleshooting

Failing symfony composer install :

Solution :

mkdir config/doctrine/hephaistos

---

If the command populate-database fails, you try again and obtain this issue :

Solution :

Increase your MEMORY_LIMIT inside php.ini if it is currently 256M and then reboot your Symfony server and Docker. Then launch :

symfony console doctrine:schema:drop --force
symfony console doctrine:schema:update --force --complete
symfony console app:hephaistos:populate-database

The commmand populate-database may take time.