Home

Documentation de Magepattern à partir de la v3

Bienvenue dans la documentation Magepattern v3 Le toolkit PHP moderne pour les développeurs exigeants. Magepattern est un framework modulaire conçu pour la performance, la sécurité et la simplicité. Cette documentation détaille chaque composant du dossier src/Component.

HTTP Component

• Request – Gestion des superglobales.
• Session – Gestion sécurisée des jetons et fingerprints.
• CURL – Client HTTP, Upload/Download, JSON.
• IPMatcher – Filtrage, Blacklist, CIDR.
• Header – Codes HTTP, Cache, Content-Type.
• JSON - Encodage/Décodage robuste avec gestion d'exceptions.
• Url – Gestion des URLs courantes, résolution de chemins et génération de Slugs SEO.

Tool Component

• StringTool - Manipulation de chaînes, validation UTF-8 et slugs SEO.
• HTMLTool - Protection XSS, échappement JS et gestion des entités HTML.
• RSATool - Génération de tokens, UUIDs et identifiants uniques sécurisés.
• DateTool - Manipulation de dates, formats SQL et gestion des fuseaux horaires.
• ArrayTool – Gestion avancée des itérateurs, tri de collections et conversion récursive de données.
• FileTool – Gestion complète du système de fichiers : CRUD, récursivité, droits, cache et compression.
• FormTool – Interface unifiée de nettoyage, filtrage et sanitization des données de formulaires.
• LocalizationTool – Service hybride de gestion multilingue des pays, langues et devises, avec support d'injection (Smarty/JSON) et fallback de sécurité.

Flux & XML

• Sitemap - Génération de Sitemaps XML (Index, Pages et Images).
• XMLReader – Lecture et conversion de flux XML complexes vers PHP Array.

Debug & Système

• Logger - Journalisation multi-niveaux, archivage et profiling de performance.

Database (Persistance)

L'interface de gestion des données multi-pilotes.

• Layer : Façade PDO avec transactions, typage automatique et support MySQL/SQLite/PostgreSQL.

Philosophie du Framework

Le framework repose sur trois piliers fondamentaux :

Immuabilité & Sécurité : Utilisation de DateTimeImmutable, protection systématique contre les injections (XSS, CSRF) et typage strict (PHP 8.2+).

Modularité : Chaque composant est indépendant. Vous pouvez utiliser le Logger sans forcément charger le système de Sitemap.

Performance : Utilisation de Singleton pour les ressources lourdes et de méthodes statiques pour les utilitaires légers.

Conventions de nommage

Namespaces : Toujours calqués sur la structure des dossiers (Magepattern\Component...). Classes : PascalCase (ex: StringTool). Méthodes : camelCase (ex: isAlphaNumeric). Constantes : UPPER_SNAKE_CASE (ex: SQL_DATETIME).

Initialisation (Sans Composer)

Puisque Magepattern v3 utilise son propre système de chargement, l'intégration dans un projet se fait en une seule ligne.

// Inclure le point d'entrée du framework
require_once 'path/to/Magepattern/bootstrap.php';

// Les classes sont maintenant disponibles via leurs Namespaces
use Magepattern\Component\HTTP\Request;
use Magepattern\Component\Debug\Logger;