As far as I know there exists no working precompiled version of php_dbase.dll, that works with PHP 5.4, so I offer the file for download.

php_dbase.php (PHP 5.4.1 VC9 x86 TS Windows)

Fatal error: Allowed memory size of 16777216 bytes exhausted
(tried to allocate 6123456 bytes)
in {........}/class.phpmailer.php on line 1262

Paměťový limit je 16 MB, skript jej celý vyčerpá.

Zjevným řešením by bylo navýšit paměťový limit v PHP. Ne vždy je tu ta možnost. Proto přichází na řadu řešení spočívající v úpravě zdrojového kódu phpmaileru.

Když se podíváte na řádek, označený v předchozí chybové hlášce, uvidíte tam něco takového:

$encoded = chunk_split(base64_encode($str), 76, $this->LE);

Tento kód vezme data z proměnné $str (4 MB), provede base64_encode, která data nafoukne na 5.3 MB, a takto upravená data předá funkci chunk_split, která udělá další kopii, přičemž za každý 76. bajt vloží ukončení řádku. Proměnná $encoded tak bude obsahovat něco kolem 5.9 MB dat. Když to všechno spočítáme, dostaneme se na 15.2 MB, což je 16 MB hranici nebezpečně blízko.

Přitom by stačilo využít toho, že není třeba uschovávat původní data. Předmětný řádek by se dal přepsat na:

$b64 = base64_encode($str);
unset($str);
$encoded = chunk_split($b64, 76, $this->LE);
unset($b64);

Pomocí unset()ů na druhém a čtvrtém řádku uvolníme proměnné, které již nepotřebujeme. Po prvním řádku zabereme 4 MB + 5,3 MB paměti. Po druhém řádku už jenom 5,3 MB (4 MB část smažeme). Po třetím řádku pak máme 5,3 MB + 5,9 MB s tím, že na čtvrtém řádku 5,3 MB opět uvolníme.

Nevýhodou zmíněného postupu je fakt, že si smažeme obsah proměnných $str a $b64. Pokud s těmito proměnnými chceme později pracovat, máme smůlu.

MIME určuje dva možné způsoby zápisu diakritiky do hlaviček. První je takzvaný „quoted-printable“, druhým pak „base64″. Obecný formát pro zápis je:

=?znaková sada?X?kódovaný text?=

kde „znaková sada“ určuje znakovou sadu původního textu (utf-8, windows-1250 atd.), X označuje, která ze dvou uvedených metod kódování byla použita (Q = quoted-printable, B = base64), a poslední částí je samotný text, zakódovaný uvedenou metodou.

Quoted-printable

Toto kódování přiřazuje každému bajtu vstupního textu tři bajty výstupu. Prvním znakem je rovnítko (=), následuje hexadecimální reprezentace ASCII kódu ukládaného znaku. Písmeno A se tedy zakóduje jako =41, písmeno Z jako =5A, písmeno á jako =E1. Aby nebyl kódovaný text zbytečně nafouknutý, stačí takto kódovat pouze znaky mimo rozsah tisknutelných znaků US-ASCII (tedy znaky s ordinálními hodnotami od 33 do 126), pochopitelně s výjimkou rovnítka, které se kódovat musí.

Vícebajtové znaky vícebajtových kódování (např. UTF-8) se zapisují po jednotlivých bajtech – český znak s diakritikou v UTF-8 tedy vyprodukuje =XY=XZ (tedy 6 znaků).

V PHP se dá quoted-printable vyrobit pomocí funkce imap_8bit(), celý předmět pak například pomocí
$predmet = "=?utf-8?Q?".imap_8bit($predmet)."?=";

kde $predmet je řetězec v UTF-8.

Base64

Toto kódování převádí posloupnost tří osmibitových znaků na čtyři znaky s šestibitovým kódováním. Výsledný text tedy není jednoduše čitelný (na rozdíl od quoted-printable, které se většinou dá dekódovat pouhým pohledem). V PHP nám k tomuto účelu poslouží funkce base64_encode(). Celý kód pro řetězec v UTF-8:

$predmet = "=?utf-8?B?".base64_encode($predmet)."?=";

Za prvé – musíte includovat nějaký soubor (v našem příkladu třeba s nastavením přihlašovacích údajů k databázi).

Za druhé – musíte tento soubor includovat pomocí relativní cesty (tzn. např. include './nastaveni.php';).

V čem tedy vězí problém? Skript spouštěný přes konzoli (přes CLI verzi PHP) nevezme jako aktuální adresář ten, ve kterém je umístěn skript, nýbrž ten, který mu předá shell. PHP tedy nemůže najít includovaný soubor (protože se dívá do špatného adresáře) a include selže.

Jak z toho ven? Je to jednoduché. Používejte absolutní adresování, nejlépe založené na skutečném umístění souboru. Konkrétně tedy například

include './nastaveni.php';

nahraďte za

include dirname(__FILE__).'/nastaveni.php';

A vše poběží tak, jak má.

Instalace

Postup instalace PHPmaileru je popsán ve starším článku, nebudu jej zde tedy opakovat.

Tři typy příloh

PHPmailer umožňuje k e-mailové zprávě připojit tři typy příloh – souborové, řetězcové a vložené. Souborové přílohy se vytvářejí ze souboru, ke kterému má skript přístup – obvykle se bude jednat třeba o PDF soubor s objednávkou, fotku apod. Řetězcová příloha spočívá v přiložení řetězce k e-mailu, přičemž tento řetězec se příjemci bude jevit jako soubor. Posledním typem jsou vložené přílohy, které se používají k přikládání obrázků, které se zobrazí v těle HTML e-mailu.

Souborové přílohy

Prvním typem přílohy je samotný soubor. K e-mailu jej připojíme pomocí konstrukce:

$mail->AddAttachment($soubor, $jmeno, $kodovani, $mimeTyp);

kde $soubor určuje název souboru, který se k e-mailu přikládá (včetně absolutní nebo relativní cesty). Název souboru je jediným povinným parametrem. Druhý parametr $jmeno obsahuje název souboru, který se zobrazí příjemci. To je užitečné v situacích, kdy potřebujeme přiložit soubor pod jiným jménem, než pod kterým je uložen v systému souboru. Třetí parametr, $kodovani, určuje způsob, jakým se obsah souboru zakóduje v těle e-mailu – možnosti jsou "base64", "quoted-printable", "8bit", "7bit", "binary" – doporučuji ponechat "base64", což je také výchozí hodnota. Poslední parametr určuje MIME typ – buď uveďte vlastní, nebo ponechte výchozí hodnotu "application/octet-stream".

Tímto způsobem můžete vložit i více souborů.

Příklad použití může vypadat například takto:

$mail->AddAttachment("./nabidky/nabidka-cez.pdf", "nabidka.pdf");
$mail->AddAttachment("./vop/vop.doc", "obchodni-podminky.doc");

Řetězcové přílohy

Tento typ příloh využijete v případě, že nemáte obsah přílohy uložen v souboru, nýbrž v proměnné. Syntaxe je velmi podobná, jako při vkládání souborů:

$mail->AddStringAttachment($retezec, $jmeno, $kodovani, $mimeTyp);

Oproti vkládání souborů jsou zde dva rozdíly – první parametr určuje proměnnou, v níž jsou uložena data, a druhý parametr, tentokráte povinný, označuje jméno souboru, pod kterým se řetězec do e-mailu uloží. Význam a výchozí hodnoty ostatních parametrů jsou shodné.

Příklad použití může vypadat například takto:

// do proměnné $objednavka vložíme potvrzení objednávky ve formátu HTML
$mail->AddStringAttachment($objednavka, "objednavka.html");
// $mail->Body = "V přiloženém souboru objednavka.html naleznete
rekapitulaci vaší objednávky.";

Vložené přílohy

Tento typ příloh slouží například k vkládání obrázků, ale i zvuků nebo videí, na které se lze odkazovat z těla HTML e-mailu. Syntaxe pro přidání vložené přílohy je následující:

$mail->AddEmbeddedImage($soubor, $cid, $jmeno, $kodovani, $mimeTyp);

Vidíme, že oproti výše uvedeným metodám přibyl jeden parametr. Prvním parametrem je jméno obrázku (včetně absolutní nebo relativní cesty), druhým je tzv. CID, jméno, pod kterým bude obrázek dostupný v HTML těle e-mailu. Další parametry mají stejný význam, jako u obou předcházejících metod. Hodnotu posledního parametru, $mimeTyp, je vhodné nastavit tak, aby reflektovala typ vloženého souboru (pro JPG obrázek nastavit "image/jpeg", pro PNG nastavit "image/png" atd.). Na obrázek, vložený tímto způsobem, se v HTML kódu e-mailu odkazuje pomocí <img src='cid:cid-jmeno' alt='popisek obrazku'>.

Například na obrázek přiložený pomocí

$mail->AddEmbeddedImage("./images/logo-cez.png", "cez", "logo.png", "base64", "image/png");

se v těle HTML e-mailu odkážu pomocí <img src='cid:cez' alt='logo ČEZu'>.

Konkrétní ukázka na závěr

Na závěr uvedu kompletní kód, který přes SMTP server odešle e-mail, který bude obsahovat přiložený soubor.

<?php
  require "class.phpmailer.php";
  $mail = new PHPMailer();
  $mail->IsSMTP();  // k odeslání e-mailu použijeme SMTP server
  $mail->Host = "adresa.smtp.serveru";  // zadáme adresu SMTP serveru
  $mail->SMTPAuth = true;               // nastavíme true v případě, že server vyžaduje SMTP autentizaci
  $mail->Username = "jmenouzivatele";   // uživatelské jméno pro SMTP autentizaci
  $mail->Password = "heslo";            // heslo pro SMTP autentizaci
  $mail->From = "skript@example.com";   // adresa odesílatele skriptu
  $mail->FromName = "Testovací skript"; // jméno odesílatele skriptu (zobrazí se vedle adresy odesílatele)

  $mail->AddAddress("prvni.prijemce@example.com");  // přidáme příjemce
  $mail->AddAddress("druhy.prijemce@example.net", "Jméno druhého příjemce");  // a klidně i druhého, včetně jména

  $mail->IsHTML(true);  // bude to HTML e-mail
  $mail->Subject = "První mail poslaný pomocí PHPMaileru";    // nastavíme předmět e-mailu

  // nastavíme HTML tělo e-mailu
  $mail->Body = "Ahoj ahoj!

<img src='cid:cez' alt='logo ČEZU'>V přílohách ti posílám dva soubory - první je nabídka pro ČEZ, druhým jsou všeobecné obchodní podmínky.";
  // nastavíme textové tělo e-mailu
  $mail->AltBody = "Ahoj ahoj!\n\nV přílohách ti posílám dva soubory - první je nabídka pro ČEZ, druhým jsou všeobecné obchodní podmínky.";
  $mail->WordWrap = 50;   // je vhodné taky nastavit zalomení (po 50 znacích)
  $mail->CharSet = "utf-8";   // nastavíme kódování, ve kterém odesíláme e-mail

  // vložíme první soubor
  $mail->AddAttachment("./nabidky/nabidka-cez.pdf", "nabidka.pdf");
  // vložíme druhý soubor
  $mail->AddAttachment("./vop/vop.doc", "obchodni-podminky.doc");
  // vložíme obrázek, na který jsme se odkázali výše
  $mail->AddEmbeddedImage("./images/logo-cez.png", "cez", "logo.png", "base64", "image-png");

  if(!$mail->Send()) {  // odešleme e-mail
     echo 'Došlo k chybě při odeslání e-mailu.';
     echo 'Chybová hláška: ' . $mail->ErrorInfo;
  }
  else
  {
     echo 'E-mail byl v pořádku odeslán.';
  }
?>

To je pro dnešek vše – pokud máte dotazy nebo vám něco nefunguje, pište do komentářů.

Nakonec mě napadlo prozkoumat nastavení direktivy open_basedir. Bylo to ono, stačilo doplnit adresář s includem a vše se najednou rozběhlo. Jen by mě zajímalo, proč se v tomto případě nevypíše hláška typu „open_basedir restriction in effect…“ – ale asi by to tak bylo příliš jednoduché.

Skript je velmi jednoduchý – použitím cURL se přihlásí do Backlinks a pak pomocí regulárních výrazů zjistí počty odkazů a zůstatek a tyto hodnoty vypíše na obrazovku.

V komentářích uvítám připomínky a doplnění.

Aktuální verzi skriptu si můžete stáhnout.
Poslední aktualizace: 2008-09-16

Historie aktualizací

2008-09-16
- první veřejná verze

$adresa = "http";
if (isset($_SERVER['HTTPS']) && !empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] != "off") $adresa .= "s";
$adresa .= "://".$_SERVER['SERVER_NAME'].$_SERVER['REQUEST_URI'];

(pozor, pokud máte v adrese i částečný identifikátor – část od prvního výskytu znaku # dál – není možno v PHP hodnotu tohoto identifikátoru výše uvedeným způsobem zjistit)

Musela nastoupit hrubá síla a použití cURL s parsováním HTML. Oproti použití stabilního API je tu samozřejmě problém, že mé řešení přestane fungovat se změnou formátu stránky, nicméně pořád je to lepší než drátem do oka.

Jak to celé funguje? Paypal používá protokol HTTPS, cookies a zasílání přihlašovacích údajů metodou POST. Nic, co by cURL nezvládlo. Jak tedy postupovat?

Nejdříve si vytvoříme cURL element a nastavíme mu příslušné parametry.

  $ch = curl_init("https://www.paypal.com/us/cgi-bin/webscr?cmd=_login-submit&dispatch=5885d80a13c0db1f38432c9462fe731381a7a80e09148cd4c582693e11bdcccd");
  curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
  curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
  curl_setopt($ch, CURLOPT_HEADER, 0);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
  curl_setopt($ch, CURLOPT_COOKIEFILE, "cookies.txt");
  curl_setopt($ch, CURLOPT_COOKIEJAR, "cookies.txt");
  curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)");
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt($ch, CURLOPT_POSTFIELDS, "login_email=vas@email.cz&login_password=heslo");

Důležitý je hlavně poslední řádek, kde je potřeba správně nastavit váš přihlašovací e-mail a heslo na paypal. Jakmile máme vše nastaveno, můžeme provést požadavek. Ten zašle paypalu vaše přihlašovací údaje a zpět vrátí stránku, která zobrazuje „průběh přihlašování“.

$data = curl_exec($ch);

V proměnné $data tak máme obsah této stránky. Z té vykousneme adresu úvodní stránky, na kterou nás tato stránka přesměruje. Použijeme k tomu regulární výraz (potřebujeme získat obsah proměnné login_access).

if (preg_match("/login_access=(\d+)\"/", $data, $regs)) {

Jakmile tuto hodnotu získáme, vypneme zasílání POST dat, změníme URL na novou hodnotu a provedeme další cURL požadavek. Ten nám již vrátí úvodní stránku se zůstatky účtu.

    $url = "https://www.paypal.com/cz/cgi-bin/webscr?cmd=_login-done&login_access=".$regs[1];
    curl_setopt($ch, CURLOPT_POST, 0);
    curl_setopt($ch, CURLOPT_URL, $url);
    $data = curl_exec($ch);

Ze získané stránky pomocí regulárních výrazů vykousneme zůstatek v korunách, dolarech a celkový zůstatek převedený na koruny. (V případě, že máte zůstatky v jiných měnách, je potřeba regulární výrazy upravit.

    if (preg_match("/
(\d+\.\d+) CZK<\/td>/", $data, $regs)) $czk = $regs[1];
    if (preg_match("/
\$(\d+\.\d+) USD<\/td>/", $data, $regs)) $usd = $regs[1];
    if (preg_match("/
(\d+\.\d+) CZK<\/td>/", $data, $regs)) $total = $regs[1];

V proměnných $czk, $usd a $total pak máme uloženo množství prostředků v jednotlivých měnách a můžeme si je uložit např. do databáze.

V komentářích uvítám připomínky a doplnění.

Aktuální verzi skriptu si můžete stáhnout.
Poslední aktualizace: 2008-09-10

Historie aktualizací

2008-09-10

- první veřejná verze

Co budeme potřebovat?

• PHP 5 s povoleným rozšířením php_openssl.dll
• Swift Mailer (instalace popsána dále)
• účet na gmailu

Instalace Swift Maileru

Z webové stránky Swift Maileru si stáhneme aktuální verzi – v době psaní článku je to 3.3.3 z března 2008. Stáhneme verzi pro PHP 5. K dispozici jsou dva balíčky – jeden zabalený zipem, druhý gzipem. Oba balíčky jsou funkčně rovnocenné, vyberte si podle vlastní chuti (většinou zip pro Windows, gzip pro Unixové systémy). Po rozbalení uvidíme několik souborů a adresářů. Pro zprovoznění nám stačí zkopírovat adresář lib buď do do include_path (do adresáře, který najdeme v souboru php.ini) nebo přímo do adresáře naší aplikace. První způsob nám umožní vkládat Swift Mailer do našich aplikací pomocí require_once "lib/Swift.php";, u druhé metody budeme muset pro každou aplikaci zkopírovat soubor do adresáře aplikace a potom vkládat pomocí require_once "./lib/Swift.php";.

Zbývá jen podotknout, že u většiny hostingů zřejmě nebude možné zkopírovat soubory do include_path, na druhou stranu by měl být webhoster schopen na požádání Swift Mailer nainstalovat.

Jak odeslat e-mail přes gmailí SMTP?

V této části si ukážeme jednoduchý kód pro poslání e-mailu a tento si okomentujeme.

<?php
  require_once "lib/Swift.php";   // require potøebných souborù
  require_once "lib/Swift/Connection/SMTP.php";
  $smtp = new Swift_Connection_SMTP("smtp.gmail.com", // pøipoj se přes smtp.gmail.com
    Swift_Connection_SMTP::PORT_SECURE,   // zabezpečené spojení
    Swift_Connection_SMTP::ENC_TLS);      // pomocí TLS
  $smtp->setUsername("example@gmail.com");  // uživatelské jméno (pro SMTP autorizaci)
  $smtp->setPassword("password");           // heslo
  $swift = new Swift($smtp);              // vytvoøíme objekt Swift Maileru
  $msg = new Swift_Message("Pøedmìt e-mailu",  // vytvoøíme novou zprávu
  "Zdar, toto je testovací e-mail pøes Swiftmailer a gmail SMTP server");
  $msg->setCharset("utf-8");           // nastavíme kódování

  // zkusíme odeslat
  if ($swift->send($msg, "e-mail@prijemce.cz", "e-mail@odesilatele.cz")) echo "sent";
  else echo "error";
?>