Behandling af ajax POST-forespørgsler i PHP

Da jeg udviklede ajax Vue.js applikationer, fandt jeg efter flere år endelig ud af hvordan man bruger ajax i PHP og hvordan man modtager data ved hjælp af POST-metoden.

Den superglobale variabel $_POST er kun tilgængelig for formularer

I PHP er superglobalvariablen $_POST almindeligvis tilgængelig til at opbevare de indsendte data fra en formular.

Det er relativt nemt at bruge.

På HTML-siden skal du oprette en formular:

<form action="process.php" method="post">
    Jméno: <input type="text" name="username">
    <input type="submit" value="Odeslat">
</form>

Og i filen process.php kan værdierne så tilgås som array-elementer:

echo htmlspecialchars($_POST['brugernavn'] ?? '');

Varsling:

Med denne enkle fremgangsmåde vil alle måske føle, at POSTed data automatisk defineres som array-indekser i variablen $_POST. Men det er ikke sandt!

Grunden til, at data, der sendes fra en formular med POST-metoden, skrives til variablen $_POST, er faktisk, at browseren automatisk sender HTTP-headeren 'Content-Type': 'application/x-www-form-urlencoded', når HTML-formularen sendes.

Uden en korrekt indstillet header kan værdierne simpelthen ikke tilgås, og vi er nødt til at bruge en trickløsning.

Afsendelse af data via ajax

Når vi forsøger at sende data ved hjælp af ajax, skal vi ændre fremgangsmåden en smule på PHP-siden. Du kan læse diskussionen på Facebook for at få flere oplysninger.

I javascript kan du f.eks. bruge axios-biblioteket til at sende data ved hjælp af ajax. Du kan nemt bruge det ved at linke javascript fra CDN-serveren og bruge det med det samme:

<script src="https://unpkg.com/axios/dist/axios.min.js"></script>

<script>
    axios.post('/api/form-process', {
        username: 'Jméno uživatele'
    })
    .then(response => {
        // Zpracování odpovědi z API
        alert(response.data.message); // Vyhodí hlášku se zprávou
    });
</script>

I dette enkle tilfælde kaldes URL-adressen '/api/form-process' ved hjælp af ajax, og POST-metoden overfører objektet { brugernavn: 'Brugernavn' }. Biblioteket selv håndterer allerede logistikken i forbindelse med overførslen af dataene automatisk, så de sendes serialiseret som Json. På frontend-udviklersprog kaldes dette json payload.

På PHP-siden ville jeg forvente at bruge det som en formular (det var trods alt en POST-metode):

echo htmlspecialchars($_POST['brugernavn'] ?? '');

I dette tilfælde vil feltet $_POST dog være tomt, og der vil ikke blive overført data. Variablen $_POST bruges kun til data, der hentes fra formularer (det kan du se på HTTP-headeren, som vi ikke smed væk).

Så i dette tilfælde skal vi hente dataene direkte fra HTTP-forespørgslen, og derfor bruges trick-løsningen til det. Den er derefter nem at bruge:

$data = json_decode(file_get_contents('php://input'), true);

echo htmlspecialchars($data['brugernavn'] ?? '');

header('Content-Type: application/json');
echo json_encode([
    'besked' => 'Serveren krybende',
]);
die;

Som et eksempel giver jeg også et simpelt javascript-svar. Det vigtige er at angive HTTP-headeren 'Content-Type: application/json' korrekt og afslutte scriptet, når alle data er blevet sendt.

Håndhævelse af brugen af $_POST

Hvis du stadig ønsker at behandle de indsendte data direkte som en formular, er der en måde at overføre dem på. I dette tilfælde skal du ændre oprettelsen af selve ajax-forespørgslen og sende HTTP-headerne korrekt:

axios.post(
    '/api/form-process',
    {
        username: 'Jméno uživatele'
    },
    {
        headers: {'Content-Type': 'application/x-www-form-urlencoded'}
    }
).then(response => {
    // Nějaké zpracování
});

I dette tilfælde vil behandlingen på PHP-siden dog ikke være behagelig, fordi vi stadig skal rette dataene og konvertere dem til et array.

Det lykkedes mig at finde på denne gyser:

if (\count($_POST) === 1
    && preg_match('/^\{.*\}$/', $post = array_keys($_POST)[0])
    && ($json = json_decode($post)) instanceof \stdClass
) {
    foreach ($json as $key => $value) {
        $_POST[$key] = $value;
        unset($_POST[$post]);
    }
}

echo htmlspecialchars($_POST['brugernavn'] ?? '');

Det er dog langt bedre at holde sig til den første metode og bruge metoden 'php://input' til at hente data.

Jan Barášek   Více o autorovi

Autor článku pracuje jako seniorní vývojář a software architekt v Praze. Navrhuje a spravuje velké webové aplikace, které znáte a používáte. Od roku 2009 nabral bohaté zkušenosti, které tímto webem předává dál.

Rád vám pomůžu:

Kontakt