Configuration

Vous pouvez personnaliser certains comportements de Flight en définissant des valeurs de configuration à travers la méthode set.

Flight::set('flight.log_errors', true);

Paramètres de configuration disponibles

La liste suivante présente tous les paramètres de configuration disponibles :

  • flight.base_url ?string - Remplace l'URL de base de la requête. (par défaut : null)
  • flight.case_sensitive bool - Correspondance sensible à la casse pour les URLs. (par défaut : false)
  • flight.handle_errors bool - Autoriser Flight à gérer toutes les erreurs en interne. (par défaut : true)
  • flight.log_errors bool - Enregistrer les erreurs dans le fichier journal d'erreurs du serveur web. (par défaut : false)
  • flight.views.path string - Répertoire contenant les fichiers de modèle de vue. (par défaut : ./views)
  • flight.views.extension string - Extension du fichier de modèle de vue. (par défaut : .php)
  • flight.content_length bool - Définir l'en-tête Content-Length. (par défaut : true)
  • flight.v2.output_buffering bool - Utiliser la mise en mémoire tampon de sortie héritée. Voir migration vers v3. (par défaut : false)

Configuration du Chargeur

Il y a également un autre paramètre de configuration pour le chargeur. Cela vous permettra de charger automatiquement les classes avec _ dans le nom de la classe.

// Activer le chargement de classe avec des tirets bas
// Par défaut à true
Loader::$v2ClassLoading = false;

Variables

Flight vous permet de sauvegarder des variables afin qu'elles puissent être utilisées n'importe où dans votre application.

// Sauvegardez votre variable
Flight::set('id', 123);

// Ailleurs dans votre application
$id = Flight::get('id');

Pour vérifier si une variable a été définie, vous pouvez faire :

if (Flight::has('id')) {
  // Faire quelque chose
}

Vous pouvez effacer une variable en faisant :

// Efface la variable id
Flight::clear('id');

// Effacer toutes les variables
Flight::clear();

Flight utilise également des variables à des fins de configuration.

Flight::set('flight.log_errors', true);

Gestion des Erreurs

Erreurs et Exceptions

Toutes les erreurs et exceptions sont capturées par Flight et transmises à la méthode error. Le comportement par défaut est d'envoyer une réponse générique HTTP 500 Erreur Interne du Serveur avec des informations sur l'erreur.

Vous pouvez remplacer ce comportement selon vos besoins :

Flight::map('error', function (Throwable $error) {
  // Gérer l'erreur
  echo $error->getTraceAsString();
});

Par défaut, les erreurs ne sont pas enregistrées dans le serveur web. Vous pouvez activer cela en modifiant la configuration :

Flight::set('flight.log_errors', true);

Introuvable

Lorsqu'une URL est introuvable, Flight appelle la méthode notFound. Le comportement par défaut est d'envoyer une réponse HTTP 404 Non Trouvé avec un message simple.

Vous pouvez remplacer ce comportement selon vos besoins :

Flight::map('notFound', function () {
  // Gérer l'introuvable
});