Wazi

« clair, ouvert, évident » en swahili

Wazi est un framework PHP pensé pour les développeurs qui veulent **comprendre** ce qu'ils utilisent tout en construisant de vraies applications. Pas de magie cachée : chaque comportement se suit dans l'éditeur par un clic, chaque erreur explique sa cause et la solution.

> **Wazi est en construction.** Ce qui est décrit ici fonctionne et est testé, mais l'API peut encore changer avant la version 1.0. Ce qui change d'une version à l'autre est dans le [journal des modifications](CHANGELOG.md). ## Ce que fait Wazi | | | | --- | --- | | **Routes et contrôleurs** | Adresses avec paramètres, routes écrites à côté de leur code (`#[Get('/notes/{id:int}')]`), dépendances fournies par le conteneur | | **Templates Kioo** | Des pages HTML ordinaires, quelques attributs en plus, tout ce qui s'affiche est échappé | | **Zones mises à jour** | Un formulaire ou un lien ne remplace qu'un morceau de la page, sans la recharger ; le contrôleur ne change pas, et tout marche sans JavaScript | | **Application installable** | Une commande crée le manifeste, le service worker et la page hors ligne ; aucune page n'est gardée en cache | | **Formulaires** | Protection contre la falsification de requête sans rien écrire, validation champ par champ | | **Base de données** | SQLite, MySQL, PostgreSQL ; du SQL en clair, des valeurs toujours à part, des migrations | | **Sessions et configuration** | Connexion, messages d'une page à l'autre, réglages et secrets hors du code | | **Console** | `wazi serve`, `wazi routes`, `wazi explain`, des générateurs, et vos propres commandes | | **Barre de débogage** | En développement, en bas de la page : la route, le code exécuté, les templates, la durée. Jamais un secret | | **Erreurs pédagogiques** | Chaque erreur dit ce qui s'est passé, pourquoi, et comment corriger | | **Sécurité par défaut** | Tout est protégé sans configuration ; désactiver une protection demande un geste explicite et local | ## Un premier exemple Une application tient dans un seul fichier : Quand le projet grandit, le même code se range en contrôleurs, en services et en templates, sans réécriture : ## La console

`wazi` lance le site, liste les routes, explique ce qu'une adresse traverse, crée un contrôleur ou une migration. Chaque commande s'explique avec `--help`. ## Essayer Il faut PHP 8.5 et Composer. Un projet se crée en une commande, à partir du [projet de départ](https://github.com/wazi-php/wazi-skeleton) : Puis ouvrez http://localhost:8000 : un site de trois pages, prêt à modifier. Pour lire le framework et ses exemples, récupérez ce dépôt : Trois applications à lancer et à lire, de la plus simple à la plus complète : La troisième, [la démonstration](examples/demo/README.md), montre une connexion, un carnet de notes par utilisateur, des formulaires protégés et des réglages. ## Documentation - [Le guide](docs/README.md), en dix-sept pages, de la première route à la mise en ligne. - [Le journal des modifications](CHANGELOG.md) : ce qui change d'une version à l'autre. - [Les décisions d'architecture](docs/decisions/) : pourquoi chaque pièce est faite comme elle l'est. ## Principes Ils tranchent toutes les décisions. Une fonctionnalité qui en viole un est refusée ou repensée. 1. **Transparence avant magie.** Tout se suit dans l'éditeur par un clic. 2. **Zéro configuration obligatoire.** Des valeurs par défaut sensées partout. 3. **Complexité progressive.** Un fichier au départ, une application structurée ensuite. 4. **Erreurs pédagogiques.** Quoi, pourquoi, comment corriger. 5. **Code source lisible.** Le cœur reste assez petit pour être lu. 6. **PHP moderne uniquement.** PHP 8.5 au minimum. 7. **Standards PSR respectés.** PSR-7, PSR-11, PSR-15, PSR-17. 8. **Sécurité stricte, jamais pénible.** Le défaut est sûr ; ce qui est dangereux demande un geste explicite, nommé et local. ## Kioo Kioo (« vitre » en swahili) est le langage de templates de Wazi : une page HTML ordinaire, avec quelques attributs en plus. Tout ce qui est affiché est échappé selon l'endroit où il se trouve. ## Architecture Les composants sont rangés en quatre couches. Une couche peut utiliser celles du dessous, jamais celles du dessus ; deux composants d'une même couche ne se connaissent pas. La règle est vérifiée par Deptrac à chaque changement. | Couche | Composants | | --- | --- | | Assemblage | `Kernel` | | Fonctionnalités | `Routing`, `Middleware`, `Errors`, `View`, `Console`, `Validation`, `Database`, `Debug` | | Fondations | `Http`, `Container`, `Config` | | Contrats | `Contracts` | Les seules dépendances d'exécution sont les paquets d'interfaces PSR. ## Sécurité Wazi applique une sécurité stricte par défaut. Pour signaler une faille, voir [SECURITY.md](SECURITY.md) : jamais dans une issue publique. ## Contribuer Le projet travaille sur des branches, fusionnées dans `main` par des demandes de fusion. Tout est expliqué dans [CONTRIBUTING.md](CONTRIBUTING.md). En participant, vous acceptez son [code de conduite](CODE_OF_CONDUCT.md). ## Licence [MIT](LICENSE)