Mail::send()

Mail::send() – wysyła email

Synopsis

require_once 'Mail.php';

mixed send ( mixed $recipients , array $headers , string $body )

Description

Wysyła email. Metoda send() udostępniana jest przez obiekt zwrócony z metody factory()

Parameter

  • mixed $recipients - odbiorcy, w formie tablicy lub łañcucha tekstowego rozdzielonego przecinkami.

  • array $headers - asocjacyjna tablica nagłówków. Nazwa nagłówka stanowi klucz, natomiast wartością jest wartość nagłówka.

  • string $body - treść właściwa emaila.

Return value

boolean - TRUE lub obiekt PEAR_Error, przy niepowodzeniu

Throws

Possible PEAR_Error values
Nazwa mailera Kod błędu Wiadomość błędu Powód Rozwiązanie
sendmail NULL "No from address given." Tablica $headers wymaga conajmniej wpisu from. Dodaj nagłówek From:
<?php
$headers
['From'] = '[email protected]';
?>
sendmail NULL "From address specified with dangerous characters." Wpis "from" w tablicy $headers zawiera jeden lub więcej znaków, które mogą być niezgodne z zaleceniami RFC Sprawdź wprowadzone adresy na znaki takie jak: spacje lub ; lub & lub ` (odwrotny apostrof)
sendmail NULL "sendmail [path to sendmail] not executable" Niewłaściwa ścieżka do programu sendmail. Nie znaleziono tam pliku wykonywalnego sendmail. Sprawdź wpis $param['sendmail_path'] w wywołaniu Mail::factory(). Jeżeli używany jest inny mailer niż sendmail, np. qmail, sprawdź jego instalację. Zazwyczaj powinna ona zawierać nakładkę symulującą sendmail.
sendmail NULL "sendmail returned error code code" Sendmail zwrócił błąd, który musi zostać obsłużony. Zobacz do dokumentacji odpowiedniego mailera.
smtp PEAR_MAIL_SMTP_ERROR_CREATE "Failed to create a Net_SMTP object" Niepowodzenie przy tworzeniu instancji klasy Przeinstaluj/zaktualizuj pakiet Net_SMTP.
smtp PEAR_MAIL_SMTP_ERROR_CONNECT "Failed to connect to host:port" Połączenie z serwerem SMTP się nie powiodło Sprawdź wpisy $param['port'] oraz $param['host'] w wywołaniu Mail::factory().
smtp PEAR_MAIL_SMTP_ERROR_AUTH "method authentication failure" Uwierzytelnienie się nie powiodło Sprawdź wpisy $param['auth'], $param['username'] oraz $param['password'] w wywołaniu Mail::factory(). Upewnij się iż używasz poprawnej metody uwierzytelnienia dla danego serwera SMTP.
smtp PEAR_MAIL_SMTP_ERROR_FROM "No From: address has been provided" Tablica $headers wymaga conajmniej wpisu from. Dodaj nagłówek From:
<?php
$headers
['From'] = '[email protected]';
?>
smtp PEAR_MAIL_SMTP_ERROR_SENDER "Failed to set sender: from" Ustawienie adresu nadawcy się nie powiodło Sprawdź zgodność z zaleceniami RFC adresu nadawcy oraz połączenie SMTP.
smtp PEAR_MAIL_SMTP_ERROR_RECIPIENT "Failed to add recipient: recipient " Wysłanie adresu odbiorcy się nie powiodło Sprawdź zgodność z zaleceniami RFC adresu odbiorcy oraz połączenie SMTP.
smtp PEAR_MAIL_SMTP_ERROR_DATA "Failed to send data" Treść wiadomości email nie może zostać wysłana Sprawdź zgodność z zaleceniami RFC treści wiadomości oraz połączenie SMTP.

Note

This function can not be called statically.

Example

<?php
include('Mail.php');

$recipients '[email protected]';

$headers['From']    = '[email protected]';
$headers['To']      = '[email protected]';
$headers['Subject'] = 'Wiadomo&sacute;&cacute; testowa';

$body 'Wiadomo&sacute;&cacute; testowa';

$params['sendmail_path'] = '/usr/lib/sendmail';

// Utworzenie obiektu mail przy u&zdot;yciu metody Mail::factory
$mail_object =& Mail::factory('sendmail'$params);

$mail_object->send($recipients$headers$body);
?>