8. díl - Kontaktní emailový formulář v PHP

PHP Základní konstrukce Kontaktní emailový formulář v PHP American English version English version

Unicorn College ONEbit hosting Tento obsah je dostupný zdarma v rámci projektu IT lidem. Vydávání, hosting a aktualizace umožňují jeho sponzoři.

V minulém dílu seriálu tutoriálů se základy PHP jsme dokončili podmínky. Na dnešek máme slíbený kontaktní formulář, do kterého návštěvníci našich stránek napíší vzkaz a ten se nám odešle emailem. Jedná se o velmi užitečný webový doplněk, díky kterému nás mohou uživatelé našich stránek lépe kontaktovat.

HTML část

Jako vždy bude aplikace rozdělena na 2 části. V tomto případě ovšem budou obě v jednom souboru mailform.php. Je to z toho důvodu, abychom měli při zpracování dat z formuláře přístupný i formulář. Pokud uživatel zadá něco špatně, vypíšeme nad formulář chybovou hlášku.

HTML část bude tedy obsahovat formulář, který bude mít následující prvky:

  • Jméno - Jméno návštěvníka (abychom věděli kdo nám píše)
  • Emailová adresa - Emailová adresa návštěvníka (abychom mu mohli odpovědět)
  • Zpráva - Zpráva od uživatele
  • Antispam - Ochrana proti spamu

Kromě ochrany proti spamu asi není co vysvětlovat. Řekněme si tedy o spamu více.

Spam

Jakmile vložíte na internet nějakou stránku s formulářem, objeví se časem roboti, kteří do formuláře začnou psát reklamu. Důvod je prostý, formulář někam něco odesílá a když do něj vloží odkaz na nějaké služby (často půjčky nebo pornografii), část lidí na tu reklamu klikne a služby si koupí.

Proti spamu se dá velmi účinně bránit. K zabezpečení formulářů se používá tzv. Turingův test, známý spíše pod pojmem Captcha. Účelem testu je položit takovou otázku, na kterou zná odpověď jen člověk. První captchy často zobrazovaly text na obrázku a předpokládalo se, že obrázek umí přečíst jen člověk. Postupem času však spameři vyvinuli poměrně sofistikované OCR čtečky, které umí obrázky číst lépe, než lidé. Není ovšem nic jednoduššího, než položit nějakou otázku (nejlépe česky), kterou spamboti neumějí. Bohatě nám bude stačit např. "Zadejte aktuální rok".

Formulář

Založte si tedy nový projekt a můžeme začít. HTML kód stránky s formulářem by mohl vypadat např. takto:

<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <title>Kontaktní formulář</title>
    </head>
    <body>
        <p>Můžete mě kontaktovat pomocí formuláře níže.</p>

        <form method="POST">
            <table>
                <tr>
                        <td>Vaše jméno</td>
                        <td><input name="jmeno" type="text" /></td>
                </tr>
                <tr>
                        <td>Váš email</td>
                        <td><input name="email" type="email" /></td>
                </tr>
                                <tr>
                        <td>Aktuální rok</td>
                        <td><input name="rok" type="number" /></td>
                </tr>
                </table>
                <textarea name="zprava"></textarea><br />

            <input type="submit" value="Odeslat" />
        </form>

    </body>
</html>

A výsledek:

Kontaktní formulář
localhost/mail­form.php

Formulář jsme vložili do tabulky, aby byly prvky hezky zarovnané. Dělá se to tak často, pokud chceme formulář rychle nastylovat. Všimněte si, že ve formuláři není vyplněný parametr action. Data se tedy odešlou na ten samý soubor, ve kterém je formulář.

PHP část

Na úplný začátek souboru vložíme PHP direktivu a pustíme se do programování:

<?php

?>

Validace

Každý formulář bychom měli zvalidovat. Validace je ověření, zda je správně vyplněný. Sice ještě neumíme ověřit, zda jsou v polích správné hodnoty, ale umíme zjistit, zda nejsou prázdná.

Kromě toho, že pole přišlo prázdné, je ještě jedna možnost - formulář se nemusel vůbec odeslat. S touto možností musíme počítat, jelikož máme zpracování i zobrazení ve stejném skriptu - uživatel mohl zatím jen zobrazit formulář a nic neodeslat. Z minulé lekce víme, že pokud napíšeme:

if ($_POST)

Provede se podmínka v případě, když pole není prázdné.

Dále bychom měli počítat i s tím, že se formulář neodeslal celý, ale jen jeho část. Potřebujeme tedy zjistit, zda v $_POST existují jednotlivé proměnné. K tomu v PHP slouží funkce isset().

POZOR! Mnoho začátečníků používá k ověření toho, zda se něco odeslalo, následující kód:

if ($_POST['jmeno'])
{
        // ...
}

To je ovšem špatně a pokud se formulář neodeslal, PHP vypíše ošklivou chybu, jelikož čteme z neexistující proměnné. Tito začátečníci si místo toho, aby kód opravili, vypnou výpis chyb v PHP. Později sem chodí a diví se, že jim něco nefunguje a nemohou chyby najít.

Když už jsme u nastavení chyb, tak musí být vždy takové, že jsou na lokálním serveru (na vašem počítači při testování) zapnuté a na produkci (na internetu) vždy vypnuté. Jen tak odhalíte při testování většinu problémů a na produkci vám nikdo díky viditelné chybové hlášce nebude napadat aplikaci. Chyby lze zapínat a vypínat v php.ini, někdy ovšem na produkci nemusíme mít k tomuto nastavení přístup a existuje k tomu nějaký přepínač v administrátorském rozhraní daného webhostingu.

Validace formuláře by mohla vypadat asi takto:

$hlaska = '';
if ($_POST) // V poli _POST něco je, odeslal se formulář
{
        if (isset($_POST['jmeno']) && $_POST['jmeno'] &&
                isset($_POST['email']) && $_POST['email'] &&
                isset($_POST['zprava']) && $_POST['zprava'] &&
                isset($_POST['rok']) && $_POST['rok'] == date('Y'))
        {
                // Sem přijde odeslání emailu
        }
        else
                $hlaska = 'Formulář není správně vyplněný!';
}

Celý kód je v podmínce, která kontroluje, zda je něco v poli $_POST. Pokud se nic neodeslalo, není co zpracovávat. Další složená podmínka kontroluje, zda byla odeslána jednotlivá pole a zda v nich je nějaký text. U roku samozřejmě kontrolujeme, zda je aktuální. Ve skriptu používáme proměnnou $hlaska, kam vložíme hlášku pro uživatele v případě, že se validace nepovedla. Tu později vypíšeme v HTML části skriptu.

Zpracování

Samotné odeslání emailu není složité. Slouží k tomu funkce mb_send_mail(), která narozdíl od starší funkce mail() podporuje UTF-8 kódování. K funkcím s prefixem mb_ se ještě dostaneme, nyní nám musí stačit, že pokud je chceme používat, často musíme na úplném začátku souboru nastavit kódování:

<?php
mb_internal_encoding("UTF-8");

Přejděme dovnitř naší podmínky s validací a umístěme tam odeslání emailu a nastavení zprávy pro uživatele:

$hlavicka = 'From:' . $_POST['email'];
$hlavicka .= "\nMIME-Version: 1.0\n";
$hlavicka .= "Content-Type: text/html; charset=\"utf-8\"\n";
$adresa = [email protected]';
$predmet = 'Nová zpráva z mailformu';
$uspech = mb_send_mail($adresa, $predmet, $_POST['zprava'], $hlavicka);
if ($uspech)
{
        $hlaska = 'Email byl úspěšně odeslán, brzy vám odpovíme.';
}
else
        $hlaska = 'Email se nepodařilo odeslat. Zkontrolujte adresu.';

Do několika proměnných si připravíme hlavičku, adresu, kam se má email odeslat (tu si samozřejmě nastavte na svou) a předmět. Jak vypadá hlavička je dané a nemusíte nad tím přemýšlet, podstatná je jen proměnná v prvním řádku, která určuje odesílatele emailu. Email potom vypadá jako že přišel z této adresy, i když ho odeslalo PHP z vašich stránek. Funkce mb_send_mail() vrací true pokud se odeslání podařilo a false pokud selhalo. Tuto hodnotu si uložíme do proměnné $uspech a nastavíme podle ní hlášku.

Úprava formuláře

Vraťme se k našemu formuláři a vložme těsně nad tag form další PHP sekvenci, ve které vypíšeme proměnnou $hlaska, pokud v ní něco je:

<?php
        if ($hlaska)
                echo('<p>' . $hlaska . '</p>');
?>

Hotovo. Váš formulář by měl nyní odesílat emaily a zobrazovat chybové hlášky. Musíte to ale vyzkoušet spíše tak, že si ho nahrajete někam na webhosting. V XAMPPu ve výchozím nastavení není odesílání emailů funkční, i když jde nastavit v konfiguračním souboru. Pokud máte s nastavením problémy, nevadí, prostě si formulář někam nahrajte (třeba na webhosting OneBit) a vyzkoušejte ho online.

Kontaktní formulář
localhost/mail­form.php

Příště formulář dokončíme. Pokud jste měli s nějakou částí problém, níže jsou zdrojové kódy ke stažení.


 

Stáhnout

Staženo 3619x (1.2 kB)
Aplikace je včetně zdrojových kódů v jazyce php

 

 

Článek pro vás napsal David Čápka
Avatar
Jak se ti líbí článek?
22 hlasů
Autor pracuje jako softwarový architekt a pedagog na projektu ITnetwork.cz (a jeho zahraničních verzích). Velmi si váží svobody podnikání v naší zemi a věří, že když se člověk neštítí práce, tak dokáže úplně cokoli.
Unicorn College Autor se informační technologie naučil na Unicorn College - prestižní soukromé vysoké škole IT a ekonomie.
Aktivity (5)

 

 

Komentáře
Zobrazit starší komentáře (176)

Avatar
Pavel Šrytr
Člen
Avatar
Pavel Šrytr:11. března 17:05

Aha, děkuji za trpělivost. Myslel jsem že hodnotu kontroluje isset.

 
Odpovědět 11. března 17:05
Avatar
IT Man
Redaktor
Avatar
Odpovídá na Pavel Šrytr
IT Man:11. března 17:31

Mrkni se přímo na tu funkci do manuálu: http://php.net/…on.isset.php

Odpovědět 11. března 17:31
Usmívej se, zítra už tvůj kód nemusí fungovat!
Avatar
Jiří Fencl
Člen
Avatar
Jiří Fencl:11. března 22:12

Hlavni rozdil mezi isset a pouzitim primo (napr $_POST ['email']) pri testovani existence promenne je ten, ze ti muze php bez testovani pres isset vyhodit hlaseni (notify) o neexistenci klice 'email' v poli $_POST primo na vystup zrovna tam, kde je konkretni kus kodu, coz je nekdy dost neprijemne. Zalezi na tom, jak je pro php nastaveno vypisovani chyb (viz error_reporting a ini_set - display errors]

 
Odpovědět 11. března 22:12
Avatar
Peter Schoeller:13. března 8:31

Ahojte, viete mi poradit?
Mam modifikovany mailform z tejto stranky a chcel by som aby uzivatel mohol prilozit aj obrazok ako prilohu k mailu. Podla mojho kodu to funguje, ale odosiela to akukolvek prilohu, nie len image.

    mb_internal_encoding("UTF-8");

    $hlaska = '';
    if (isset($_GET['uspech'])){
                        $hlaska = 'Email bol úspešne odoslaný, čo najskôr vám odpovieme.';
                        $zpravaclass = 'bg-success';
                        }

                                        // file properties

                if(!isset($_FILES['image']['tmp_name']) && $_FILES['image']['tmp_name']){
                        $hlaska = 'Please select an file (max. 2MB)';
                        $zpravaclass = 'bg-danger';
                        }
                        else {

                        if(!empty($_FILES['image']['tmp_name']) && file_exists($_FILES['image']['tmp_name'])) {
                                $image= addslashes(file_get_contents($_FILES['image']['tmp_name']));
                                }
                        if(!empty($_FILES['image']['name']) && file_exists($_FILES['image']['name'])) {
                                $image_name = addslashes($_FILES['image']['name']);
                                }
                        if(!empty($_FILES['image']['tmp_name']) && file_exists($_FILES['image']['tmp_name'])) {
                                $image_size = getimagesize($_FILES['image']['tmp_name']);
                                }

                        if (isset($_FILES['image']['tmp_name']) && $_FILES['image']['tmp_name']==FALSE) {
                                $hlaska = "That's not an Image. Only the following file types are supported: .jpg, .jpeg, .gif, .bmp";
                                $zpravaclass = 'bg-danger';
                                }

                        if (isset($_FILES['image']['size']) && $_FILES['image']['size'] > 2097152) {
                                $hlaska = 'Sorry, your file is too large. Max filesize 2MB';
                                $zpravaclass = 'bg-danger';
                                }
                        }}

        if ($_POST) // V poli _POST něco je, odeslal se formulář
    {
        if (isset($_POST['jmeno']) && $_POST['jmeno'] &&
            isset($_POST['email']) && $_POST['email'] &&
            isset($_POST['zprava']) && $_POST['zprava'])

                {
            require_once '../phpmailer/PHPMailerAutoload.php';
                                $mail = new PHPMailer;
                                $mail->Host = 'smtp.gmail.com';
                                $mail->SMTPAuth = true;
                                $mail->Username = [email protected]';
                                $mail->Password = 'xxxxxxxxxxxxxxx'; // nastavenie v Google -> heslo aplikacii
                                $mail->SMTPSecure = 'tls';
                                $mail->Port = 587;

                                $mail->From = [email protected]';
                            $mail->FromName = 'Mailform';

                            $mail->addAddress([email protected]', 'admin');

                                $mail->CharSet = 'utf-8';
                                $mail->Subject = 'Nová správa z Mailform - ' .$_POST['jmeno'];
                                $mail->isHTML(true);

                                $mail->Body = '<p>' .$_POST['jmeno'] . ' (' . $_POST['email'] .')<br />';
                                $mail->Body .= 'poslal správu z Mailform</p>';
                                $mail->Body .= '<p>Správa: <br />';
                                $mail->Body .= $_POST['zprava']. '</p>';
                                $mail->Body .= "<p>email: " .$_POST['email']. "</p>";
                                $mail->AltBody = 'This is the plain text version.';
                                $mail->AddAttachment($_FILES['image']['tmp_name'], $_FILES['image']['name']);

                        if($mail->Send())
            {
                $hlaska = 'Email bol úspešne odoslaný, čo najskôr vám odpovieme.';
                header('Location: mailform.php?uspech=ano');
                                $zpravaclass = 'bg-success';
                exit;
            }
            else
                $hlaska = 'Email se nepodarilo odoslať. Skontrolujte adresu, alebo priložený súbor.';
                                $zpravaclass = 'bg-danger';
                }

        else
            $hlaska = 'Formulár nie je správne vyplnený!';
                $zpravaclass = 'bg-danger';

        }
?>

Ak zmenim

if ($_POST)

za

else ($_POST)

tak dostanem hlasky, ze to nie je image, resp subor je vacsi ako 2MB, ale zas sa neodosle email.
Kde moze byt chyba?

 
Odpovědět 13. března 8:31
Avatar
Jiří Fencl
Člen
Avatar
Odpovídá na Peter Schoeller
Jiří Fencl:13. března 22:17

Ahoj, musis ten soubor z formulare nejdriv ulozit na server funkci move_uploaded_file nez jej pouzijes jako prilohu

 
Odpovědět 13. března 22:17
Avatar
Odpovídá na Jiří Fencl
Peter Schoeller:16. března 15:05

tak nefunguje to ani cez upload :-S

 
Odpovědět 16. března 15:05
Avatar
Petr Marek
Člen
Avatar
Petr Marek:21. března 9:03

Stranka se aktualizuje po kazdem odeslani formulare, a proto se i skript spousti pri odeslani formulare? Nebo jakto, ze se skript spousti opakovane (meni se hlaska)

 
Odpovědět 21. března 9:03
Avatar
Petr Čumpelík:1. dubna 14:38

Dobrý den,
nevěděl by někdo, čím by mohlo být, že můj mailform nehlásí žádnou chybu, ale ani žádné e-maily neposílá. Je vytvořený dle tohoto článku.

 
Odpovědět 1. dubna 14:38
Avatar
IT Man
Redaktor
Avatar
Odpovídá na Petr Čumpelík
IT Man:1. dubna 17:44

Poskytovatel např. neumožňuje odeslání E-mailu.

Odpovědět 1. dubna 17:44
Usmívej se, zítra už tvůj kód nemusí fungovat!
Avatar
Jan Grunt
Člen
Avatar
Jan Grunt:10. dubna 17:37

Zdravím,

mám kontaktní mail formulář ve kterém zadávám jméno, příjmení, název firmy, ič, dič, email, tel. Chtěl bych použít ARES pro možné vyplnění tohoto formuláře.Pomocí DIČ.

Poradí někdo?

Dík

 
Odpovědět 10. dubna 17:37
Děláme co je v našich silách, aby byly zdejší diskuze co nejkvalitnější. Proto do nich také mohou přispívat pouze registrovaní členové. Pro zapojení do diskuze se přihlas. Pokud ještě nemáš účet, zaregistruj se, je to zdarma.

Zobrazeno 10 zpráv z 186. Zobrazit vše