Project 7 : BileMo (Application developer - PHP / Symfony - OpenClassrooms)

Context

• Create a web service exposing an API for BileMo.
• BileMo is a company offering a wide selection of high-end cell phones
• Sell exclusively in B2B
• Provide access to the catalog via an API to all platforms that want it

Technical Requirements

Framework & Bundles

• Framework : Symfony 5.4.7
• willdurand/hateoas-bundle : Generate hypermedia links to create a self-discovering API
• lexik/jwt-authentication-bundle : Create stateless authentication with a token
• nelmio/api-doc-bundle : Create API documentation with annotations

Web Server

• PHP 7.2.5 or higher
• PHP extensions : Ctype, iconv, JSON, PCRE, Session, SimpleXML and Tokenizer
• SQL DBMS
• Versions used in this project
  • Apache 2.4.46
  • MySQL 5.7.34
  • PHP 8.1.4

Composer

• How to install Composer ?

Installation

1. Download or clone the project

• Download zip files or clone the project repository with github - GitHub documentation

2. Edit .env file

# SQL DBMS
DATABASE_URL="mysql://username:password@host:port/dbname"

3. Set your PHP version

• List and select PHP version (minimum 7.2.5)

symfony local:php:list

• Set your PHP version

echo 8.1.4 > .php-version

4. Install packages needed

Run your terminal at root project

composer install

5. Create database and tables

php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate

6. Load fixtures with pictures and avatar

php bin/console doctrine:fixtures:load

7. Generate SSL keys for JWT Token

php bin/console lexik:jwt:generate-keypair

8. Test

• Go to https://127.0.0.1:8000/api/doc and follow the instructions

Great ! You are ready to use BileMo API :)