Steps taken to run RAWeb (framework branch) locally

raweb-locally.md

Here are the steps I (meleu) took to run the RAWeb (framework branch) locally on my Linux machine. Smart readers can probably use a similar approach to do the same on Windows.

Download and Install XAMPP

Check here: https://www.apachefriends.org/download.html

Note: prefer to download the pack with PHP 7.2+

clone project to webroot

# be sure to have git installed before using this command
git clone --branch framework https://github.com/retroachievements/RAWeb.git RAWeb
cd RAWeb

create a RAWeb database

# launch mysql
mysql -u root

# when in mysql (or MariaDB) prompt, create RAWeb database
create database RAWeb;

create a .env file

# copy and modify .env file for your local environment
# (use copy instead of cp command on Windows)
cp .env.example .env

# edit and adjust .env file contents 
# (db credentials, app url, for static url use the same as app url)
# if you didn't create a user/password for database use
# DB_DATABASE=RAWeb
# DB_USERNAME=root
# DB_PASSWORD=

install php dependencies

php composer.phar install

generate local encryption key

php artisan key:generate

setup and install database

php artisan migrate

create fake data

php artisan db:seed

refresh database

php artisan migrate:fresh --seed

launch the database daemon

# with XAMPP on Linux the command should be something like this:
sudo /opt/lampp/bin/mysql.server start

run server (a proper local webserver setup is recommended)

php artisan serve