Project 5 : Blog PHP (Application developer - PHP / Symfony - OpenClassrooms)

CONFIGURATION REQUIRE

1. Web Server

a. Minimum requirement

• PHP7 with openssl extension enabled
• SQL DBMS

b. Versions used in this project :

• Apache 2.4.51
• MySQL 8.0.27
• PHP 7.4.26

2. SMTP Server

• Used for contact form

3. Composer

a. How to install Composer ?

b. Production packages

• twig/twig : 3.3
• phpmailer/phpmailer : 6.5
• devcoder-xyz/php-dotenv : 1.1

c. Development packages

• squizlabs/php_codesniffer : 3.6

4. CSS Framework

• Bootstrap 5.1.3 (load in templates/layout.twig)

5. Icons toolkit

• Font-awesome 6 (load in templates/layout.twig)

Installation

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

2. Create database

1. In your DBMS create a new database named blog
2. Import blog.sql file in your DBMS (file available here : sql/blog.sql)

3. Configure SMTP server

• Go to app/utils folder and complete the .env file with your SMTP informations
• Exceptionally for this project, the .env file is filled but normally an empty file like the code below is provided to avoid sharing sensitive data

HOST =
USERNAME =
PASSWORD =
RECIPIENT =
RECIPIENT_NAME =
SUBJECT =

4. Configure access to the database

Go to database folder and add your DBMS informations on line 20, 25 and 30

private const DSN = 'mysql:dbname=blog;host=localhost'
private const USERNAME = 'root'
private const PASSWORD = ''

5. Install Composer dependencies

Use the command below to install all the packages needed to run the blog

$ composer install

6. Customize the homepage

1. Go to app/public/index.php at line 13 to 20 to see the code below

// Used in homepage.twig
define('CREATOR_NAME', 'Your Name');
define('QUOTE', 'Your favorite quote');
define('QUOTE_AUTHOR', 'Author of your favorite quote');

// Used in layout.twig
define('GITHUB_LINK', 'https://github.com/your_name');
define('LINKEDIN_LINK', 'https://www.linkedin.com/in/your_name');
define('TWITTER_LINK', 'https://twitter.com/your_name');

2. Define CREATOR_NAME value to display your name
3. Define the QUOTE and the QUOTE_AUTHOR value to display your favorite quote
4. Define GITHUB_LINK to display your GitHub link into the footer
5. Define LINKEDIN_LINK to display your Linkedin link into the footer
6. Define TWITTER_LINK to display your Twitter link into the footer
7. Choose your avatar image, rename it to creator-avatar.png and place it to app/public/avatars folder
8. Choose your CV, rename it to cv.pdf and place it app/public/cv folder

7. Create your admin account

1. Launch the server
2. Create an account on the signup page
3. Go to your DBMS
4. Set is_validate to 1
5. Set is_admin to 1

---

Great ! Now you can connect to the blog and create your first post :)