previousWprowadzenie (Previous) (Next) Mail::send()next

View this page in Last updated: Sun, 18 Oct 2009
English | Brazilian Portuguese | Chinese | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Turkish

Mail::factory()

Mail::factory() – tworzy instancję mailera

Synopsis

require_once 'Mail.php';

object &factory ( string $backend , array $params = array() )

Description

Tworzy instancję klasy specyficznej dla wybranej metody wysy³ania.

Parameter

  • string $backend - nazwa metody wysy³ania "mail" ,"smtp" , "sendmail"

  • array $params - tablica parametrów specyficznych dla danej metody wysy³ania.

    Lista parametrów dla metod

    • mail

      • Gdy wy³±czony jest tryb "safe mode", $params zostan± przekazane jako pi±ty parametr dla funkcji PHP mail(). Je¿eli $params jest tablic±, jej elementy zostan± po³±czone w ³añcuch tekstowy rozdzielone spacj±.

    • sendmail

      • $params["sendmail_path"] - Lokalizacja programu sendmail. Domy¶lna to /usr/bin/sendmail

      • $params["sendmail_args"] - Dodatkowe parametry do przekazania do sendmail. Domy¶lne to -i

    • smtp

      • $params["host"] - serwer z którym siê po³±czyæ. Domy¶lny to localhost

      • $params["port"] - port na który siê po³±czyæ. Domy¶lny to 25

      • $params["auth"] - czy u¿yæ uwierzytelnienia SMTP. Domy¶lna warto¶æ to FALSE

      • $params["username"] - nazwa u¿ytkownika do u¿ycia przy uwierzytelnieniu SMTP.

      • $params["password"] - has³o do u¿ycia przy uwierzytelnieniu SMTP.

      • $params["localhost"] - warto¶æ do przekazania przy wysy³aniu polecenia EHLO lub HELO. Domy¶lna to localhost

      • $params["timeout"] - maksymalny czas bezczynnego po³±czenia. Domy¶lny to NULL (brak)

      • $params["verp"] - czy u¿yæ VERP czy te¿ nie. Domy¶lna warto¶æ to FALSE

      • $params["debug"] - czy w³±czyæ debugowanie SMTP czy te¿ nie. Domy¶lna warto¶æ to FALSE

      • $params["persist"] - wskazuje czy po³±czenie SMTP powinno byæ nawi±zane ci±gle pomiêdzy wieloma wywo³aniami metody send().

Return value

object - specyficzna instancja klasy Mail lub obiekt PEAR_Error, przy niepowodzeniu

Throws

Possible PEAR_Error values
Kod b³êdu Wiadomo¶æ b³êdu Powód Rozwi±zanie
NULL "Unable to find class for driver xxx " Nie znaleziono klasy dla ¿±danego mailera. Sprawd¼ parametr $backend , je¿eli jest prawid³owy przeinstaluj i/lub zaktualizuj pakiet Mail.

Note

This function should be called statically.

previousWprowadzenie (Previous) (Next) Mail::send()next

Download Documentation Last updated: Sun, 18 Oct 2009
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
Note by: Joe
There is hard-coded -f option in Mail_sendmail->send so it is impossible to set it using $params['sendmail_args']. It is hard-coded to -f$from.

In my case it caused 'X-Authentication-Warning' in mail headers.
Note by: shaun@shaunfreeman.co.uk
When sending mail via smtp be careful with the $params["auth"] option, the docs say it set it either to true or false, but in my case this didn't work and only when I set it to the actual authentication method of the server it worked. In my case I had to set it to:

$params["auth"] = "PLAIN";

This little problem had me going around in circles for 2 weeks!