meline-p / blog_php

Blog in PHP with MVC Architecture

Blog PHP

Welcome to my PHP blog!

---

Installation

Download the ZIP from Github or clone the project :

git clone "https://github.com/meline-p/blog_php"

Composer

Install all components by running the following command:

composer install

Database

Import the provided SQL file from the /database/blog_php.sql directory.

Change the environment variables DB_USERNAME, DB_PASSWORD and DB_UNIX_SOCKET according to your SQL configuration in the .env file.

MailDev

MailDev installation : https://github.com/maildev/maildev

Install MailDev with npm :

npm install -g maildev

---

Usage

Terminal 1 : Launch the website

php -S localhost:8080 -t public

Access the site at http://localhost:8080/.

Terminal 2 : Launch MailDev

maildev

Access the MailDev interface at http://localhost:1080/.

---

Documentation

To generate documentation, use phpDocumentor. You can download the latest PHAR file from https://phpdoc.org/phpDocumentor.phar and put it at the root of the project. Execute this command:

php phpDocumentor.phar run -d ./src -t docs/

Access the generated documentation in the docs/index.html directory. Launch Go Live on Visual Studio Code and access the online documentation in the docs directory.

blog_php's Issues

Data Isolation

Separate the PHP code from the HTML code

Controllers Repositories Entities

Creation of controllers, repositories, and entities.

CSRF

Implementation of csrf_token to protect against CSRF attacks.

Export SQL Database

Export the SQL database with users, posts, comments, and roles.

Create the Admin Page - Edit/Delete a post

Are you sure you want to delete this post?

Sequence Diagrams

Database connection

Add a .env file

Authentication and comment

Users must log in to leave a comment

Use Case Diagrams

Complete the course "Concevez votre site web avec PHP et MySQL"

Create the Admin Page - Add user

Use MailDev

Use MailDev to receive messages from the contact form

Create the Admin Page - Edit user

The code aesthetics and creation of a template

Opening PHP tag <?php in files that contain only PHP code for proper database management (naming conventions, use of English). Creation of a layout template.

Creation of alert messages.

Creation of alert messages to handle errors and validation.

Installation of PHP CS Fixer

Rework Router and Controller

Namespaces & POO

Creation of namespaces, updating the router and views. Updating entities with fromSql, init, update, delete, and restore functions

Create the home page - Contact Form

• last name / first name
• e-mail
• message

Create the Admin Page - Edit a post

• title
• the chapo
• author
• content

Security

• user logins
• security of data received from users
• password hashing for the database
• pre-insertion checks for user information in the database

Creation of documentation

phpdocumentor

Create the page displaying a post

• title
• the chapo
• the content
• the author
• last modified date
• form to add comments (submitted for validation)
• list of validated and published comments

Create the Admin Page - Delete/Restore User

Dashboard

Improvement of the dashboard :

• Displaying the number of published, draft post, etc. (for users, and also for comments.)
• Creating an information alert if there are pending comments
• Responsive Admin section

Create the Admin Page - Comments

Approve or reject a comment,
Delete a comment, or restore it

Version no MVC

Create the Admin Page - Add a post

• title
• the chapo
• the content
• the author

Class Diagram

Create the page listing all posts

• title
• last modified date
• the chapo
• a link to the post

Create the Github repository for the project

Create the page displaying a post - Comments Form

Add permission if user is logged in

Setting up Composer

Create the Admin page - Dashboard

• number of posts
• number of comments
• number of messages

lateral menu :

• posts
• comments
• messages
• users
• roles

Complete the course "Adoptez une architecture MVC en PHP"

SymfonyInsight

Attaining at least a silver medal

Create the user login/registration page

Create the home page

• last name
• first name
• photo and/or logo
• catch phrase
• menu
• link to the resume in PDF format
• social networks
• in the footer: link to access the admin page