Framework PHP élégant, simple, léger, plaisant et flexible
Bienvenu dans le Framework Zephyrus! Ce framework est fondé sur un modèle pédagogique en s'orientant sur une structure MVC simple, une approche de programmation flexible laissant place à une extensibilité pour tous types de projet, une forte considération pour la sécurité applicative et une liberté de développement. Le tout offert depuis un noyeau orienté-objet élégant favorisant l'écriture d'un code de qualité propre et maintenable. Développement avec une philosophie de maintenir un plaisir à programmer en n'étant pas rigoureusement strict sur une utilisation figée où tout doit passer par une configuration et y être limité. Zephyrus s'insère à mi-chemin entre les plus petits frameworks et les monstres pour ainsi répondre aux besoins de la plupart des projets.
- Une structure de projet simple et intuitive basée sur une architecture Model-View-Controller.
- Traitement des vues avec le préprocesseur HTML Pug nativement intégré ou simplement du PHP natif.
- Approche pédagogique pour la conception élégante de classes et favorise une rétrocompatibilité avec les fonctionnalités natives de PHP comme l'utilisation des super-globales, de la session et autres.
- Routeur de requêtes simple et flexible basé sur des contrôleurs incluant une intégration facile de middlewares dans le flux d'une requête et d'un contrôleur du projet. Facilite la segmentation des responsabilités et la lecture d'une chaîne d'exécution.
- Plusieurs mécanismes de sécurité intégrés tel que les entêtes CSP, les jetons CSRF, protection XSS, détection d'intrusion (Expose), mécanisme d'authorisation et plus encore!
- Philosophie d'accès aux données depuis des courtiers manuellement définis offrant un contôle complet sur la construction des requêtes SQL et, par conséquent, une facilité de maintenance et d'optimisation.
- Approche simple pour intégrer des recherches, tris et pagination sur les requêtes manuelles.
- Système de validation de formulaires élégant et facilement extensible offrant une multitude de règles nativement sur les nombres, les chaînes, les fichiers téléversés, les dates, etc.
- Moteur unique simple et optimisé pour la gestion des chaînes de caractères depuis une structure JSON, le tout facilement organisé pour offrir une internationalisation.
- Configuration d’un projet rapide et flexible permettant des paramètres personnalisées utilisables facilement.
- Hautement extensibles facilement grâce à sa compatibilité avec les modules Composer.
- Plusieurs utilitaires rapides : cryptographie, validations, système de fichiers, gestionnaire d'erreurs, transport de messages, etc.
- Et plus encore !
Zephyrus nécessite PHP 7.1 ou plus. Présentement, supporte uniquement Apache comme serveur web (pour un autre type de serveur, il suffirait d’adapter les fichiers .htaccess). Le gestionnaire de dépendance Composer est également requis. La structure résultante de l’installation contient plusieurs exemples pour faciliter les premiers pas.
$ composer create-project zephyrus/framework nom_projet
$ mkdir nom_projet
$ cd nom_projet
$ wget https://github.com/dadajuice/zephyrus-framework/archive/vx.y.z.tar.gz
$ tar -xvf vx.y.z.tar.gz --strip 1
$ composer install
$ git clone https://github.com/dadajuice/zephyrus-framework.git
$ composer install
Il faut cependant installer préalablement docker pour être en mesure d'utiliser cet option. Pour plus de détails: Docker
$ composer install
$ docker-compose up
app/Models/Brokers/ClientBroker.php
<?php namespace Models\Brokers;
class ClientBroker extends Broker
{
public function findAll(): array
{
return $this->select("SELECT * FROM client");
}
public function findById($clientId): ?\stdClass
{
return $this->selectSingle("SELECT * FROM client WHERE client_id = ?", [$clientId]);
}
}app/Controllers/ExampleBroker.php
<?php namespace Controllers;
use Models\Brokers\ClientBroker;
class ExampleController extends ApiController
{
public function initializeRoutes()
{
$this->get("/clients", "index");
$this->get("/clients/{id}", "read");
}
public function index()
{
$broker = new ClientBroker();
return $this->success(['clients' => $broker->findAll()]);
}
public function read($clientId)
{
$broker = new ClientBroker();
$client = $broker->findById($clientId);
if (is_null($client)) {
return $this->abortNotFound();
}
return $this->success(['client' => $client]);
}
}<?php namespace Controllers;
use Models\Brokers\UserBroker;
use Zephyrus\Application\Rule;
class ExampleController extends ApiController
{
public function initializeRoutes()
{
...
$this->post("/users", "insert");
}
public function insert()
{
// Construire un objet Form depuis les données de la requête
$form = $this->buildForm();
// Appliquer une série de règles de validation sur les champs nécessaires. Il existe une grande quantité
// de validations intégrés dans Zephyrus. Consulter les Rule:: pour les découvrir.
$form->validate('firstname', Rule::notEmpty("Firstname must not be empty"));
$form->validate('lastname', Rule::notEmpty("Lastname must not be empty"));
$form->validate('birthdate', Rule::date("Date is invalid"));
$form->validate('email', Rule::email("Email is invalid"));
$form->validate('password', Rule::passwordCompliant("Password does not meet security requirements"));
$form->validate('password_confirm', Rule::sameAs("password", "Password doesn't match"));
$form->validate('username', Rule::notEmpty("Username must not be empty"));
$form->validate('username', new Rule(function ($value) {
return $value != "admin";
}, "Username must not be admin!"));
// Si la vérification échoue, retourner les messages d'erreur
if (!$form->verify()) {
return $this->error($form->getErrorMessages());
}
// Effectuer le traitement si aucune erreur n'est détectée (dans ce cas, ajouter l'utilisateur depuis
// un courtier et obtenir le nouvel identifiant).
$clientId = (new UserBroker())->insert($form->buildObject());
// Retourner au client l'identifiant du nouvel utilisateur
return $this->success(['client_id' => $clientId]);
}
}Veuillez communiquer en privé pour tout problème pouvant affecter la sécurité des applications créées avec ce framework.
Pour rapporter des bogues, demander l’ajout de nouvelles fonctionnalités ou faire des recommandations, n’hésitez pas à utiliser l’outil de gestion des problèmes de GitHub.
Vous pouvez contribuer au développement de Zephyrus en soumettant des PRs.
MIT (c) David Tucker