fir

Sapin

Sapin. Un cadre PHP MVC léger.

Le framework FIR a commencé comme micro-tramework dans le but d'être utilisé dans des projets privés, les points les plus forts étant extrêmement rapides et faciles à utiliser. Le FIR ne remplace pas les cadres professionnels, mais si vous souhaitez construire rapidement une application ProtoTipe, faites quelques pages ajaxes et effectuez quelques appels de base de données, FIR devrait être une bonne option.

Caractéristiques

Back-end

• Extrêmement rapide (temps exécutif 3MS)
• Extrêmement léger (30 Ko)
• Modèle MVC
• Routage dynamique (avec URL propre)
• Support des aides (chargement paresseux)
• Prise en charge des bibliothèques (chargement paresseux)
• Support de Middlewares (chargement paresseux)
• Support du compositeur (chargement paresseux)
• Système linguistique (chargement paresseux)
• Entièrement à l'espace de nom
• Style de codage PSR-2
• Protection du CSRF pour les formulaires

L'extrémité avant

• Chargement dynamique de la page (ajax)
• jQuery inclus
• Bootstrap inclus

Documentation

Exigences

Logiciel	Modules
Php> = 7	mbString
Apache> = 2	mod_rewrite
Mysql> = 5

Installation

1. Exécuter composer create-project pricop/fir /your-project
2. Importez le fichier fir.sql dans votre base de données.
3. Ouvrez le fichier app/includes/config.php et mettez à jour les valeurs YOURDBUSER , YOURDBNAME , YOURDBPASS , https://localhost/your-project avec vos propres informations.

Vous pouvez désormais accéder à votre site Web à l'aide de l'URL que vous avez définie dans APP_PATH .

---

Contrôleurs

Création d'un nouveau contrôleur

• Les contrôleurs peuvent être créés dans le dossier /app/controllers .
• Les contrôleurs doivent étendre la classe Controller de base, par exemple: class Auth extends Controller {} .
• Chaque contrôleur doit avoir une méthode publique, appelée index, par exemple: public function index() {} .

Chargement d'un modèle

• Pour charger un nouveau modèle, utilisez la méthode $this->model('Example') .

Retourner une vue

• Pour retourner une vue, à l'intérieur de vos méthodes, vous renverriez ['content' => $this->view->render($data, 'auth/register')] , où $data est un objet d'arrivée qui contient les données qui sont transmises aux vues, tandis que 'auth/register' serait le chemin de la vue.

Routage

• Les routes sont mappées en fonction du nom du contrôleur et de ses méthodes publiques, lorsqu'une méthode publique est manquante, elle sera automatiquement par défaut la méthode index du contrôleur.

Supplémentaire

• Vous pouvez accéder au chemin URL actuel à l'intérieur des contrôleurs en utilisant la propriété $this->url .
• Vous pouvez accéder aux chaînes de langage à l'intérieur des contrôleurs en utilisant la propriété $this->lang .

Exemple

 namespace Fir  Controllers ;

class Auth extends Controller
{
    public function index ()
    {
        return [ ' content ' => $ this -> view -> render ( $ data , ' auth/index ' )];
    }
    
    public function register ()
    {
        return [ ' content ' => $ this -> view -> render ( $ data , ' auth/register ' )];
    }
}

---

Modèles

Créer un modèle

• Les modèles peuvent être créés dans le dossier /app/models .
• Les modèles doivent étendre la classe Model de base, par exemple: class Auth extends Model {} .
• Vous pouvez accéder à l'objet de base de données en utilisant la propriété $this->db .

Exemple

 namespace Fir  Models ;

class Auth extends Model
{
    public function get ()
    {
        // SQL query here
    }
}

---

Vues

Créer une vue

• Des vues peuvent être créées dans le dossier /public/theme/views .

Accéder aux données dans les vues

• L'objet $data Array contient toutes les données transmises des contrôleurs.

Supplémentaire

• Vous pouvez échapper aux chaînes dans les vues en utilisant la fonction e , par exemple: e('Example') .
• Vous pouvez afficher des messages stockés dans $_SESSION['message'] en utilisant la méthode $this->message() .
• Vous pouvez afficher une chaîne de langage dans des vues en utilisant la méthode $this->lang('key') .
• Vous pouvez rendre l'entrée de jeton CSRF pour vos formulaires à l'aide de la méthode $this->token() .
• Pour afficher la liste complète des aides disponibles pour les vues, voir app/core/View.php .

Exemple

 <?php
defined ( ' FIR ' ) OR exit ();
?>

<?= e ( " Hello World " ) ?> 

Enveloppement

Bien que cette documentation puisse être plus étendue, le code est bien commenté et la plupart des choses que vous devez savoir peuvent être trouvées directement dans les exemples fournis dans le cadre.

Codage heureux.