Pré-TPI Samuel Roland

PHPUnit tests:

Documentations

• Project documentation
• Work Diary for every day of work

Prerequisites

Skills

You need to know how to develop with Laravel and Livewire, AlpineJS and TailwindCSS. The first 2 are the most important, you can learn the following ones on the go.

Tools

You need:

• PHP v8+
• MySQL v8+
• Git v2+
• An IDE for PHP

Setup

Environment setup

Configure your php.ini file to enable the following extensions:

• SQLITE
• PDO MySQL
• Openssl
• Curl

Project setup

1. Clone the repository and go inside:

   git clone https://github.com/samuelroland/galeriz.git
   cd galeriz

2. Install composer and node packages

   composer install
   npm install

3. Copy environment file and generate the app key

   cp .env.example .env
   php artisan key:generate

   Create a database called galeriz in your MySQL server, and fill the DB_USERNAME and DB_PASSWORD constants in .env.

4. Create the symbolic link for the public storage

   php artisan storage:link

5. Create the database tables

   php artisan migrate

6. If you want to develop Galeriz, you can seed the database with testing data

   php artisan db:seed

7. Later, if you want to migrate and seed the database

   php artisan migrate:fresh --seed

Run development server

1. You need to compile assets (CSS mostly) with mix with watch mode:

   npm run watch

   This uses Laravel Mix under the hood.

2. And in another, start the PHP server:

   php artisan server

3. You can now open your browser at localhost:8000 or the displayed adress, and you can login with [email protected] - password or you can create a new account.

Prepare for production

1. You need to compile assets (CSS mostly)

   npm run prod

2. You can now start an Apache or Nginx server on the public folder to serve your app to the world.