README

Installation du projet

Via Composer :

composer create-project thomas-claireau/php-p5-openclassrooms

Dans le cas où vous téléchargez directement le projet (ou encore avec git clone), effectuez un composer install à la racine du projet.

Installez ensuite les dépendances front du projet. Placez-vous dans le répertoire public :

npm install

Serveur de développement

Pour lancer le serveur de développement, effectuez un npm run serve.

Au préalable, assurez-vous d'avoir configuré un virtual host.

Pour changer l'url du host, rendez vous dans public/_webpack/config.js et changez la valeur de proxyTarget.

Si vous ne disposez pas d'url pour le host, vous pouvez utiliser la suivante (dans config.js) : http://recette.thomas-claireau.fr

Site en production

Pour voir une version du site en production, suivez l'url suivante.

Envoi des mails

Si vous souhaitez utilisé un serveur de mail afin d'envoyer des mails, vous pouvez le configurer dans ~src/Controller/setup/configMail_sample.php. Une fois vos informations rentrée, vous devrez renommer le fichier en configMail.php

Remarque

Accès base de données

Le projet est livré sur Packagist sans base de données. Cela signifie qu'il faut que vous ajoutiez un dossier config à la racine du projet.

Dans ce dossier, ajoutez le fichier db.php en respectant le format suivant :

<?php

$HOST = ''; // le host de votre projet
$DB_NAME = ''; // le nom de la base de donnée
$DB_USER = ''; // l'identifiant d'accès
$DB_PASS = ''; // le mot de passe d'accès
$DB_DSN = "mysql:host={$HOST};dbname={$DB_NAME}";

define('DB_DSN', $DB_DSN);
define('DB_USER', $DB_USER);
define('DB_PASS', $DB_PASS);

define('DB_OPTIONS', array(PDO::ATTR_DEFAULT_FETCH_MODE => 
PDO::FETCH_ASSOC, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION));

Injection SQL

Pour obtenir une structure similaire à mon projet au niveau de la base de données, je vous joins aussi dans le dossier config un fichier db.sql qui se chargera de construire la base de données pour vous.

Contexte

Ça y est vous avez sauté le pas ! Le monde du développement web avec PHP est à portée de main et vous avez besoin de visibilité pour pouvoir convaincre vos futurs employeurs/clients en un seul regard. Vous êtes développeur PHP, il est donc temps de montrer vos talents au travers d’un blog à vos couleurs.

Description du besoin

Le projet est donc de développer votre blog professionnel. Ce site web se décompose en deux grands groupes de pages :

les pages utiles à tous les visiteurs
les pages permettant d’administrer votre blog.

Voici la liste des pages qui devront être accessibles depuis votre site web :

la page d'accueil
la page listant l’ensemble des blogs posts
la page affichant un blog post
la page permettant d’ajouter un blog post
la page permettant de modifier un blog post
les pages permettant de modifier/supprimer un blog post
les pages de connexion/enregistrement des utilisateurs

Vous développerez une partie administration qui devra être accessible uniquement aux utilisateurs inscrits et validés.

Les pages d’administration seront donc accessible sur conditions et vous veillerez à la sécurité de la partie administration.

Commençons par les pages utiles à tous les internautes.

Sur la page d’accueil il faudra présenter les informations suivantes :

Votre nom et prénom
Une photo et/ou un logo
Une phrase d’accroche qui vous ressemble ( exemple : “Martin Durand, le développeur qu’il vous faut !”)
Un menu permettant de naviguer parmi l’ensemble des pages de votre site web
Un formulaire de contact (à la soumission de ce formulaire, un email avec toutes ces informations vous serons envoyé) avec les champs suivants :
- nom/prénom
- email de contact
- message
un lien vers votre CV au format pdf
et l’ensemble des liens vers les réseaux sociaux où l’on peut vous suivre (Github, LinkedIn, Twitter…).

Sur la page listant tous les blogs posts (du plus récent au plus ancien), il faut afficher les informations suivantes pour chaque blog post :

le titre
la date de dernière modification
le châpo
et un lien vers le blog post

Sur la page présentant le détail d’un blog post, il faut afficher les informations suivantes :

le titre
le chapô
le contenu
l’auteur
la date de dernière mise à jour
le formulaire permettant d’ajouter un commentaire (soumis pour validation)
les listes des commentaires validés et publiés

Sur la page permettant de modifier un blog post, l’utilisateur a la possibilité de modifier les champs titre, chapô, auteur et contenu.

Dans le footer menu, il doit figurer un lien pour accéder à l’administration du blog.

Contraintes

Cette fois-ci nous n’utiliserons pas WordPress. Tout sera développé par vos soins. Les seuls lignes de code qui peuvent provenir d’ailleurs seront celles du thème Bootstrap que vous prendrez grand soin de choisir. La présentation, ça compte ! Il est également autorisé d’utiliser une ou plusieurs librairies externes à condition qu’elles soient intégrées grâce à Composer.

Attention, votre blog doit être navigable aisément sur un mobile (Téléphone mobile, phablette, tablette…). C’est indispensable :D Nous vous conseillons vivement d’utiliser un moteur de templating tel que Twig, mais ce n’est pas obligatoire.

Sur la partie administration, vous veillerez à ce que seul les personnes ayant le droit “administrateur” aient l’accès, les autres utilisateurs pourront uniquement commenter les articles (avec validation avant publication).

Important : Vous vous assurerez qu’il n’y a pas de failles de sécurité (XSS, CRSF, SQL injection, session hijacking, upload possible de script php…).

Votre projet doit être poussé et disponible sur Github. Je vous conseille de travailler avec des pull requests. Dans la mesure où la majorité des communications concernant les projets sur Github se font en anglais, il faut que vos commits soient en anglais.

Vous devrez créer l’ensemble des issues (tickets) correspondant aux tâches que vous aurez à effectuer pour mener à bien le projet.

Veillez à bien valider vos tickets pour vous assurer que ceux-ci couvrent bien toutes les demandes du projet. Donnez une estimation indicative en temps ou en points d’efforts (si la méthodologie agile vous est familière) et tentez de tenir cette estimation.

L’écriture de ces tickets vous permettront de vous accorder sur un vocabulaire commun et Il est fortement apprécié qu’ils soient écrits en anglais !

Nota Bene

Votre projet devra être suivi via SymfonyInsight, ou Codacy pour la qualité du code, vous veillerez à obtenir une médaille d'argent au minimum (pour SymfonyInsight), en complément le respect des PSR est recommandé afin de proposer un code compréhensible et facilement évolutif.

Dans le cas où une fonctionnalité vous semblerait mal expliquée ou manquante, parlez-en avec votre mentor afin de prendre une décision ensemble sur les choix que vous souhaiteriez prendre. Ce qui doit prévaloir doit être les délais.

✔️ Projet validé

Commentaire de l'évaluateur :

Évaluation globale du travail réalisé par l’étudiant (en spécifiant les critères non-validés si le projet est à retravailler) :

Site complet, projet bien mené tant sur la partie cadrage que technique. Très bon travail.

Évaluation des livrables selon les critères du projet :

Le cahier des charges rempli, le code, les schémas, la gestion sur github sont de qualité, rien à redire.

Évaluation de la présentation orale et sa conformité aux attentes :

La soutenance a été préparée et cela se sent. Bon support de présentation, bon débit de parole, c'est très bien.

Évaluation des nouvelles compétences acquises par l'étudiant :

développement d'une application en partant de 0
développement avec architecture MVC
requêter une bdd

Points positifs (au moins 1) :

qualité apporté à chaque livrable
soutenance bien préparée

Axes d'amélioration (au moins 1) :

continuer sur cette lancée, approfondir la technique en incluant des techniques plus poussées comme les requêtes ajax pour charger plus d'articles

thomas-claireau / php-p5-openclassrooms

Maintainers

Details