GAPM website

GAPM project

️ Each "Git Pull" + Setup Project ️

• Remember to composer update to update PHP outbuildings.
• Reward the DB if the file has been modified lately.
• Make sure the .env.local file is present
• Have a PHP version> = 8.0
• If Wampserver (Xampp, Uwamp, ...) make a virtual host

Description

Advancement: 85%

Facility

In order to install the project proper, it is imperative to follow the following steps:

Clone the project

To do this, you must first have a lunch on your machine.

1. Install Git.
2. Open a terminal (CMD, PowerShell, Git Bash, etc.).
3. Place yourself in the folder where you want to clone the project.
4. Clone the project with the following order:

git clone https://github.com/IUT-Orsay-LP-PRISM/GAPM-website.git

Install dependencies

The project mainly uses 2 dependent managers:

• Compose for php.
• NPM for NODEJS (ici v14.21.1).

Compose

Composing is the PHP outbuilding manager, it will allow us to directly integrate libraries into our project. Like, Phpmailer, an email sending system.

Installation to compose

Go to the composer site (link higher), then download "compose-setup.exe" and install it. Once it is installed, remember to restart your computer.

When your installation has been made, run the following order in the project file:

composer install

Do what is needed for installing the virtual host if you have wamps. Normally everything is good, you can now launch the project.

Attention ️ ::

However, no modification of the CSS will be possible. Indeed, to start the project just have to compose . The nude.js suite is necessary to compile the SCSS in CSS with webpack.

NPM - NODE.JS

NPM is the Nodejs outbuilding manager, it will allow us to directly integrate JavaScript libraries into our project. Future Libs of stats for example.

Installation of node.js

To be able to use NPM, you must download Nodejs, you must go to their site (link higher), then download the MSI ( node-v14.21.1-x64.msi or node-v14.21.1-x86.msi ) and install it. Once installed, remember to restart your PC.

Normally, everything is good, NPM will only serve you if you want to do CSS or JavaScript, except for only PHP it has no interest.

Use of nodejs - webpack

After installing NODEJS you can use WebPack to compile SCSS and JS files.

Webpack installation

npm install

Compilation of SCSS and JS files

Dé dev: Compile a file automatically with each modification

npm run dev 

Prod mode: Compiles all files only once

npm run build