Anfragen

Flight kapselt die HTTP-Anfrage in ein einzelnes Objekt, das wie folgt zugänglich ist:

$request = Flight::request();

Wenn du in einer Web-Anwendung mit einer Anfrage arbeitest, möchtest du normalerweise einen Header abrufen, oder einen $_GET- oder $_POST-Parameter, oder vielleicht sogar den rohen Anfragekörper. Flight bietet eine einfache Schnittstelle, um all diese Dinge zu erledigen.

Hier ein Beispiel, um einen Query-String-Parameter zu erhalten:

Flight::route('/search', function(){
    $keyword = Flight::request()->query['keyword'];
    echo "You are searching for: $keyword";
    // Eine Datenbank abfragen oder etwas anderes mit $keyword tun
});

Hier ein Beispiel für ein Formular mit einer POST-Methode:

Flight::route('POST /submit', function(){
    $name = Flight::request()->data['name'];
    $email = Flight::request()->data['email'];
    echo "You submitted: $name, $email";
    // In einer Datenbank speichern oder etwas anderes mit $name und $email tun
});

Das Anfrageobjekt bietet die folgenden Eigenschaften:

• body - Der rohe HTTP-Anfragekörper
• url - Die angefragte URL
• base - Das übergeordnete Unterverzeichnis der URL
• method - Die Anfragemethode (GET, POST, PUT, DELETE)
• referrer - Die Referrer-URL
• ip - Die IP-Adresse des Clients
• ajax - Ob es sich um eine AJAX-Anfrage handelt
• scheme - Das Server-Protokoll (http, https)
• user_agent - Browser-Informationen
• type - Der Inhaltstyp
• length - Die Inhaltslänge
• query - Query-String-Parameter
• data - Post-Daten oder JSON-Daten
• cookies - Cookie-Daten
• files - Hochgeladene Dateien
• secure - Ob die Verbindung sicher ist
• accept - HTTP-Accept-Parameter
• proxy_ip - Proxy-IP-Adresse des Clients. Scant das $_SERVER-Array nach HTTP_CLIENT_IP, HTTP_X_FORWARDED_FOR, HTTP_X_FORWARDED, HTTP_X_CLUSTER_CLIENT_IP, HTTP_FORWARDED_FOR, HTTP_FORWARDED in dieser Reihenfolge.
• host - Der Anfrage-Hostname
• servername - Der SERVER_NAME aus $_SERVER

Du kannst die Eigenschaften query, data, cookies und files als Arrays oder Objekte zugreifen.

Um einen Query-String-Parameter zu erhalten, kannst du tun:

$id = Flight::request()->query['id'];

Oder du kannst tun:

$id = Flight::request()->query->id;

Um den rohen HTTP-Anfragekörper zu erhalten, zum Beispiel bei PUT-Anfragen, kannst du tun:

$body = Flight::request()->getBody();

Wenn du eine Anfrage mit dem Typ application/json und den Daten {"id": 123} sendest, ist sie über die Eigenschaft data verfügbar:

$id = Flight::request()->data->id;

Du kannst das $_GET-Array über die Eigenschaft query zugreifen:

$id = Flight::request()->query['id'];

Du kannst das $_POST-Array über die Eigenschaft data zugreifen:

$id = Flight::request()->data['id'];

Du kannst das $_COOKIE-Array über die Eigenschaft cookies zugreifen:

$myCookieValue = Flight::request()->cookies['myCookieName'];

Es gibt einen Shortcut, um das $_SERVER-Array über die Methode getVar() zugreifen:

$host = Flight::request()->getVar('HTTP_HOST');

Du kannst hochgeladene Dateien über die Eigenschaft files zugreifen:

$uploadedFile = Flight::request()->files['myFile'];

Du kannst Datei-Uploads mit dem Framework verarbeiten, indem du Hilfsmethoden verwendest. Es kommt im Wesentlichen darauf an, die Dateidaten aus der Anfrage zu ziehen und sie an einen neuen Ort zu verschieben.

Flight::route('POST /upload', function(){
    // Wenn du ein Eingabefeld wie <input type="file" name="myFile"> hattest
    $uploadedFileData = Flight::request()->getUploadedFiles();
    $uploadedFile = $uploadedFileData['myFile'];
    $uploadedFile->moveTo('/path/to/uploads/' . $uploadedFile->getClientFilename());
});

Wenn du mehrere Dateien hochgeladen hast, kannst du durch sie iterieren:

Flight::route('POST /upload', function(){
    // Wenn du ein Eingabefeld wie <input type="file" name="myFiles[]"> hattest
    $uploadedFiles = Flight::request()->getUploadedFiles()['myFiles'];
    foreach ($uploadedFiles as $uploadedFile) {
        $uploadedFile->moveTo('/path/to/uploads/' . $uploadedFile->getClientFilename());
    }
});

Sicherheitshinweis: Validiere und saniere immer Benutzereingaben, insbesondere bei Datei-Uploads. Validiere immer die Erweiterungstypen, die du erlaubst, aber du solltest auch die "Magic Bytes" der Datei validieren, um sicherzustellen, dass es sich tatsächlich um den Dateityp handelt, den der Benutzer angibt. Es gibt Artikel und Bibliotheken verfügbar, um dabei zu helfen.

Du kannst Anfrage-Header mit der Methode getHeader() oder getHeaders() zugreifen:

// Vielleicht brauchst du den Authorization-Header
$host = Flight::request()->getHeader('Authorization');
// oder
$host = Flight::request()->header('Authorization');

// Wenn du alle Header abrufen möchtest
$headers = Flight::request()->getHeaders();
// oder
$headers = Flight::request()->headers();

Du kannst den rohen Anfragekörper mit der Methode getBody() zugreifen:

$body = Flight::request()->getBody();

Du kannst die Anfragemethode mit der Eigenschaft method oder der Methode getMethod() zugreifen:

$method = Flight::request()->method; // ruft tatsächlich getMethod() auf
$method = Flight::request()->getMethod();

Hinweis: Die Methode getMethod() zieht zuerst die Methode aus $_SERVER['REQUEST_METHOD'], dann kann sie überschrieben werden durch $_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'], falls vorhanden, oder $_REQUEST['_method'], falls vorhanden.

Es gibt ein paar Hilfsmethoden, um Teile einer URL für deine Bequemlichkeit zusammenzusetzen.

Vollständige URL

Du kannst die vollständige Anfrage-URL mit der Methode getFullUrl() zugreifen:

$url = Flight::request()->getFullUrl();
// https://example.com/some/path?foo=bar

Basis-URL

Du kannst die Basis-URL mit der Methode getBaseUrl() zugreifen:

$url = Flight::request()->getBaseUrl();
// Beachte, kein abschließender Slash.
// https://example.com

Du kannst eine URL an die Methode parseQuery() übergeben, um den Query-String in ein assoziatives Array zu parsen:

$query = Flight::request()->parseQuery('https://example.com/some/path?foo=bar');
// ['foo' => 'bar']