Jak posílat textové zprávy pomocí PHP

() translation by (you can also view the original English article)

Zasílání textových zpráv se stalo extrémně rozšířeným po celém světě - do té míry, do které rostoucí počet webových aplikací integroval zprávy SMS, které uživatelům upozorňují na události, prodeje nebo kupony přímo prostřednictvím svých mobilních zařízení.

V tomto tutoriálu se budeme zabývat základy posílání textových zpráv pomocí PHP.

Přehled

Odesílání textové zprávy (SMS) je skutečně snadné.

Níže je zjednodušený diagram, jak lze odeslat zprávu z webové aplikace do bezdrátového zařízení.

Projdeme si to hezky za sebou:

Zpráva se složí pomocí webové aplikace, která je uložena a spuštěna na serveru HTTP a posílána prostřednictvím internetu ("cloud") jako e-mailová zpráva.
E-mail je přijímán službou Short Message Service Gateway (SMS brána), která konvertuje zprávu z e-mailové zprávy na SMS zprávu.
Zpráva SMS je pak předána Středisku služeb krátkých zpráv (SMSC), což je server, který směruje data na konkrétní mobilní zařízení.
Zpráva se konečně přenáší přes bezdrátovou síť příjemci.

Většina bezdrátových sítí má SMS bránu, přes kterou mohou být e-mailové zprávy odesílány jako textové zprávy do mobilního zařízení. To je hezké, protože z hlediska vývojáře je zdarma - ovšem pro koncového uživatele to není bezplatná služba. Poplatky se stále vztahují na příjemce zprávy a zprávy odeslané e-mailem budou účtovány jako textová zpráva, která není v síti.

E-mail na SMS

Chcete-li poslat SMS e-mailem, budete obvykle vyžadovat pouze dvě věci:

Telefonní číslo nebo jedinečný identifikátor mobilního zařízení, které chcete oslovit.
A doménové jméno bezdrátové sítě (mnohé z nich naleznete v tomto seznamu e-mailů na adresy SMS)

Pro většinu operátorů lze dodržovat následující pravidla:

1	phoneNumber@domainName.com

phoneNumber je telefonní číslo mobilního zařízení, které zprávu odesílá, a domainName.com je adresa brány SMS sítě.

Chcete-li poslat text na adresu Mr. Example, můžete jednoduše přidat 3855550168@vtext.com do libovolného e-mailového klienta, zadejte zprávu a stiskněte poslat. Tímto odešlete textovou zprávu na telefonní číslo +1 (385) 555-0168 v síti Verizon.

Například si pošlu textovou zprávu pomocí služby Gmail.

Když telefon obdrží zprávu, měl by to vypadat takto:

Docela úžasné!

PHP funkce `mail`

Vezměme věci o krok dál. Pomocí brány SMS můžeme poslat textovou zprávu e-mailem pomocí PHP funkce mail. Funkce mail ma následující signaturu:

1	bool mail ( string $to , string $subject , string $message [, string $additional_headers [, string $additional_parameters ]] )

Více o tom můžete přečíst zde.

$to definuje přijímač nebo přijímače zprávy. Platné příklady zahrnují:
- user@example.com
- user1@example.com, user2@example.com
- User <user@example.com>
- User1 <user1@example.com>, User2 <user2@example.com>
$subject je jasný; měl by to být řetězec obsahující požadovaný předmět. SMS však nevyžaduje předmět.
$message je zpráva, která má být doručena. Jak je uvedeno v příručce PHP, "každý řádek by měl být oddělen LF (\ n). Řádky by neměly být větší než 70 znaků. "

Pro replikaci dřívějších funkcí bychom mohli napsat následující PHP kód:

1	mail( '3855550168@vtext.com', '', 'Testing' );

Testovací jízda

Spusťme test s PHP, abychom se ujistili, že je vše správně nastaveno a že funkce mail ve skutečnosti pošle textovou zprávu. Pomocí následujícího kódu můžeme spustit:

<?php

var_dump( mail( '##########@vtext.com', '', 'This was sent with PHP.' ) ); // bool(true)

?>

Když telefon obdrží zprávu, vypadá to takto:

Pokud se vyskytne chyba, přečtěte si část týkající se odstraňování problémů.

Jak je vidět na obrázku výše, zpráva ukazuje, že je z Gmailu. Je to proto, že všechny své odchozí zprávy směřuji z mého místního serveru přes tuto službu. Bohužel, od tohoto psaní jsem byl neúspěšný při změně záhlaví From odrážející alternativní adresu. Zdá se, že hlavičky e-mailu jsou odstraněny a nahrazeny záhlavími, které připravuje brána SMS. Pokud někdo ví o řešení, prosím, zanechte komentář a dejte nám ostatním vědět!

Přidání použitelnosti

Označení

Se základy z cesty, vezmeme si tento nápad a zabalíme ho do uživatelského rozhraní. Nejprve vytvoříme jednoduchý formulář:

<!DOCTYPE html>
 <head>
   <meta charset="utf-8" />
  </head>
  <body>
   <div id="container">
    <h1>Sending SMS with PHP</h1>
    <form action="" method="post">
     <ul>
      <li>
       <label for="phoneNumber">Phone Number</label>
       <input type="text" name="phoneNumber" id="phoneNumber" placeholder="3855550168" /></li>
      <li>
      <label for="carrier">Carrier</label>
       <input type="text" name="carrier" id="carrier" />
      </li>
      <li>
       <label for="smsMessage">Message</label>
       <textarea name="smsMessage" id="smsMessage" cols="45" rows="15"></textarea>
      </li>
     <li><input type="submit" name="sendMessage" id="sendMessage" value="Send Message" /></li>
    </ul>
   </form>
  </div>
 </body>
</html>

Styl

Dále přidáme nějaké CSS:

body {
 margin: 0;
 padding: 3em 0;
 color: #fff;
 background: #0080d2;
 font-family: Georgia, Times New Roman, serif;
}

#container {
 width: 600px;
 background: #fff;
 color: #555;
 border: 3px solid #ccc;
 -webkit-border-radius: 10px;
 -moz-border-radius: 10px;
 -ms-border-radius: 10px;
 border-radius: 10px;
 border-top: 3px solid #ddd;
 padding: 1em 2em;
 margin: 0 auto;
 -webkit-box-shadow: 3px 7px 5px #000;
 -moz-box-shadow: 3px 7px 5px #000;
 -ms-box-shadow: 3px 7px 5px #000;
 box-shadow: 3px 7px 5px #000;
}

ul {
 list-style: none;
 padding: 0;
}

ul > li {
 padding: 0.12em 1em
}

label {
 display: block;
 float: left;
 width: 130px;
}

input, textarea {
 font-family: Georgia, Serif;
}

To nám vytvoří jednoduchý formulář:

Skript

Nejdůležitější součástí je PHP skript. Napíšeme tenhle kód:

<?php

if ( isset( $_REQUEST ) && !empty( $_REQUEST ) ) {
 if (
 isset( $_REQUEST['phoneNumber'], $_REQUEST['carrier'], $_REQUEST['smsMessage'] ) &&
  !empty( $_REQUEST['phoneNumber'] ) &&
  !empty( $_REQUEST['carrier'] )
 ) {
  $message = wordwrap( $_REQUEST['smsMessage'], 70 );
  $to = $_REQUEST['phoneNumber'] . '@' . $_REQUEST['carrier'];
  $result = @mail( $to, '', $message );
  print 'Message was sent to ' . $to;
 } else {
  print 'Not all information was submitted.';
 }
}

?>
<!DOCTYPE html>

Scénář nejprve zkontroluje, zda byl formulář předložen.
Pokud ano, zkontroluje, jestli byly odeslány proměnné phoneNumber, carrier a smsMessage. To je užitečné v případě, že na stránce může být více než jeden formulář.
Je-li k dispozici phoneNumber, carrier a smsMessage, phoneNumber a carrier nejsou prázdné, je vhodné pokoušet se odeslat zprávu.
Argument zprávy ve funkci mail by měl mít délku 70 znaků na řádek. Zprávu můžeme rozdělit do 70 znaků pomocí funkce wordwrap.
phoneNumber a carrier jsou spojeny a pak je zpráva odeslána pomocí funkce mail.
Pokud chybí data nebo je nelze ověřit, skript jednoduše vrátí Ne všechny informace byly předloženy.
Konečně, mail vrátí boolean, který označuje, zda byl úspěšný nebo ne. Hodnota je uložena v $result v případě, že musím ověřit, zda byla zpráva skutečně odeslána.

Poznámka: Metoda mail upozorňuje pouze na to, zda byla zpráva odeslána nebo ne. Neposkytuje způsob, jak zkontrolovat, zda zpráva byla úspěšně přijata příjemcem serveru nebo poštovní schránkou.

Konečný kód

<?php

if ( isset( $_REQUEST ) && !empty( $_REQUEST ) ) {
 if (
 isset( $_REQUEST['phoneNumber'], $_REQUEST['carrier'], $_REQUEST['smsMessage'] ) &&
  !empty( $_REQUEST['phoneNumber'] ) &&
  !empty( $_REQUEST['carrier'] )
 ) {
  $message = wordwrap( $_REQUEST['smsMessage'], 70 );
  $to = $_REQUEST['phoneNumber'] . '@' . $_REQUEST['carrier'];
  $result = @mail( $to, '', $message );
  print 'Message was sent to ' . $to;
 } else {
  print 'Not all information was submitted.';
 }
}

?>
<!DOCTYPE html>
 <head>
   <meta charset="utf-8" />
   <style>
    body {
     margin: 0;
     padding: 3em 0;
     color: #fff;
     background: #0080d2;
     font-family: Georgia, Times New Roman, serif;
    }

    #container {
     width: 600px;
     background: #fff;
     color: #555;
     border: 3px solid #ccc;
     -webkit-border-radius: 10px;
     -moz-border-radius: 10px;
     -ms-border-radius: 10px;
     border-radius: 10px;
     border-top: 3px solid #ddd;
     padding: 1em 2em;
     margin: 0 auto;
     -webkit-box-shadow: 3px 7px 5px #000;
     -moz-box-shadow: 3px 7px 5px #000;
     -ms-box-shadow: 3px 7px 5px #000;
     box-shadow: 3px 7px 5px #000;
    }

    ul {
     list-style: none;
     padding: 0;
    }

    ul > li {
     padding: 0.12em 1em
    }

    label {
     display: block;
     float: left;
     width: 130px;
    }

    input, textarea {
     font-family: Georgia, Serif;
    }
   </style>
  </head>
  <body>
   <div id="container">
    <h1>Sending SMS with PHP</h1>
    <form action="" method="post">
     <ul>
      <li>
       <label for="phoneNumber">Phone Number</label>
       <input type="text" name="phoneNumber" id="phoneNumber" placeholder="3855550168" /></li>
      <li>
      <label for="carrier">Carrier</label>
       <input type="text" name="carrier" id="carrier" />
      </li>
      <li>
       <label for="smsMessage">Message</label>
       <textarea name="smsMessage" id="smsMessage" cols="45" rows="15"></textarea>
      </li>
     <li><input type="submit" name="sendMessage" id="sendMessage" value="Send Message" /></li>
    </ul>
   </form>
  </div>
 </body>
</html>

Odstraňování problémů

Chyba Localhost

Chcete-li používat funkci mail, musíte mít spuštěn poštovní server. Pokud tuto funkci provozujete na webovém hostiteli, pravděpodobně jste v pohodě. Pokud si však nejste jisti, doporučuji mluvit s administrátorem. To platí i pro osobní počítače. Takže pokud se vám objevují chyby jako ..

1	Warning: mail() [function.mail]: Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set() in C:\wamp\www\sms\mail-test.php

.. budete muset nainstalovat a konfigurovat poštovní server. To je mimo rozsah tohoto tutoriálu. Pokud však pracujete na místním počítači, může tento problém vyřešit přepnutí na něco podobného jako XAMPP. Můžete také nainstalovat Mercury Mail podél WAMP, MAMP nebo na systém LAMP (nebo SAMP nebo OAMP atd.) (To je spousta "AMP").

PHPMailer

Další možností (což je metoda, kterou dávám přednost) je použít PHPMailer. Níže je příklad, jak používat PHPMailer pro připojení k SMTP serveru Gmailu a odeslat zprávu.

Použití je stejně jednoduché jako zařazení třídy do skriptu.

require 'class.phpmailer.php';

// Instantiate Class
$mail = new PHPMailer();

// Set up SMTP
$mail->IsSMTP();                // Sets up a SMTP connection
$mail->SMTPDebug  = 2;          // This will print debugging info
$mail->SMTPAuth = true;         // Connection with the SMTP does require authorization
$mail->SMTPSecure = "tls";      // Connect using a TLS connection
$mail->Host = "smtp.gmail.com";
$mail->Port = 587;
$mail->Encoding = '7bit';       // SMS uses 7-bit encoding

// Authentication
$mail->Username   = "email.address@gmail.com"; // Login
$mail->Password   = "password"; // Password

// Compose
$mail->Subject = "Testing";     // Subject (which isn't required)
$mail->Body = "Testing";        // Body of our message

// Send To
$mail->AddAddress( "##########@vtext.com" ); // Where to send it
var_dump( $mail->send() );      // Send!

Toto by mělo vytisknout něco podobného:

Může to trvat trochu víc, než nastavíte připojení v závislosti na vaší situaci. Pokud plánujete používat službu Gmail, společnost Google poskytla informace o připojení.

Závěr

Existuje nesčetné množství způsobů, jak splnit úkol odesílání SMS prostřednictvím webové aplikace. Tato metoda je skutečně určena pro malý objemem (s největší pravděpodobností méně než 1 000 textových zpráv za měsíc) a vývojáři, kteří chtějí mokré nohy bez vybíjení hotovosti. Mezi další možnosti patří:

Použití zprostředkovatele brány SMS
- Vyhledávání Google vrátí spoustu možností.
- Většina poskytovatelů SMS brány obsahuje rozhraní API pro odesílání zpráv prostřednictvím webové aplikace.
- Obvykle se můžete přihlásit za službu za přijatelnou cenu, za předpokladu, že plánujete poslat alespoň 1000 SMS zpráv za měsíc.
- Můžete si pronajmout krátké kódové číslo.
Použití modemu GSM
- To může být nákladný a pomalý způsob, jak to udělat, protože musíte koupit modem a uzavřít smlouvu s bezdrátovou sítí
- Budete také muset použít sadu příkazů AT (Hayes).
Použijte přímé připojení k bezdrátové síti, což bude vyžadovat silné vyjednávání a spoustu peněz.

Tento tutoriál není v žádném případě komplexním přehledem odesílání textových zpráv pomocí PHP; ale mělo by to pro začátek stačit. Doufám, že vás tento tutoriál zaujal. Děkuji moc za čtení!