Aller au contenu principal
Version: Next

Response

Le helper Response simplifie l'envoi de réponses HTTP depuis les contrôleurs Elementum.

Installation​

use Elementum\Helpers\Response;

Méthodes​

send(int $code): void​

Définit le code de statut HTTP.

Paramètres :

  • $code (int) : Code HTTP (ex: 200, 404, 500)

Exemple :

// Pour une 404
Response::send(404);
return $this->render('errors/404.html.twig');

// Pour une 500
Response::send(500);
info

Pour le code 404, Response::send() appelle également $wp_query->set_404() en interne.


json(array $data): void​

Encode les données en JSON et arrête immédiatement l'exécution.

Paramètres :

  • $data (array) : Données à encoder

Exemple :

Response::json([
    'success' => true,
    'message' => 'Élément créé avec succès',
    'data' => $element
]);
info

Équivalent à wp_send_json() de WordPress.

Cas d'usage​

Dans un contrôleur AJAX​

use Elementum\Helpers\Response;

public function handleAjax()
{
    // Validation
    if (!$this->isValid()) {
        Response::send(400);
        Response::json(['error' => 'Données invalides']);
    }
    
    // Traitement
    $result = $this->process();
    
    // Réponse
    Response::json([
        'success' => true,
        'data' => $result
    ]);
}

Dans une route API​

use Elementum\Helpers\Response;

#[Api('/api/elements', methods: ['GET'])]
public function list()
{
    $elements = $this->getElements();
    
    if (empty($elements)) {
        Response::send(404);
        Response::json(['error' => 'Aucun élément trouvé']);
    }
    
    Response::json(['data' => $elements]);
}

Voir aussi​