Export do Open XML v PHP

Jakub Vrána 26. 2. 2007

Kancelářský balík firmy Microsoft umožňuje ve verzi 2007 pracovat s novým formátem souborů založeným na technologiích XML a ZIP. Je dobře dokumentovaný a standardizovaný (probíhá ISO schvalovací proces), a proto se hodí pro export dat z webových aplikací mnohem lépe než starší binární formáty.

Pravděpodobně nejužitečnější a obvykle také nejpožadovanější je export tabulkových dat do Excelu. Krátce po uvedení Office 2007 vznikla třída PHPExcel, která umožňuje právě tento druh exportu. Třída je od začátku konstruována tak, aby bylo možné výsledek uložit do různých formátů, jediný podporovaný je ale zatím Excel 2007. Díky této třídě není nutné do podrobností studovat sáhodlouhou normu a lze použít jednoduché API.

Příklad

Na jednoduchém příkladu si ukážeme, jak se s touto třídou pracuje. Naším cílem bude vytvořit export přehledu kurzů měn pro daný den ve všech směnárnách. Na listech budou uloženy jednotlivé měny, v řádcích směnárny a ve sloupcích jednotlivé kurzy. Data vybereme z MySQL databáze z tabulek currencies (měny), subjects (směnárny) a quotations (kurzy) a uložíme je do pole $quotations. Po vytvoření základního Excelovského objektu a nastavení jeho vlastností odebereme automaticky vytvořený list. Následně postupně pro každou měnu vytvoříme nový list, nastavíme mu titulek a hlavičky a pro všechny směnárny vypíšeme jejich kurzy. Nakonec sešit uložíme do souboru s koncovkou  .xlsx.

<?php
include "PHPExcel.php";
include "PHPExcel/Writer/Excel2007.php";

$date = "2007-02-14";

$quotations = array();
$result = mysql_query("
    SELECT quotations.*, currencies.mark, subjects.name
    FROM quotations
    INNER JOIN currencies ON quotations.currency_id = currencies.id
    INNER JOIN subjects ON quotations.subject_id = subjects.id
    WHERE quotations.quotation_date = '$date'
    ORDER BY currencies.mark, subjects.name
");
while ($row = mysql_fetch_assoc($result)) {
    $quotations[$row["mark"]][] = $row;
}
mysql_free_result($result);

$excel = new PHPExcel;
$excel->getProperties()->setCreator("Jakub Vrána");
$excel->getProperties()->setLastModifiedBy("Jakub Vrána");
$excel->getProperties()->setTitle("Akcie $date");
$excel->removeSheetByIndex(0);

$columns = array("name" => "A", "d_quotation_buy" => "B", "d_quotation_sale" => "C", "v_quotation_buy" => "D", "v_quotation_sale" => "E");
foreach ($quotations as $mark => $rows) {
    $sheet = $excel->createSheet();
    $sheet->setTitle($mark);
    $sheet->getColumnDimension('A')->setWidth(30); // nastavení šířky prvního sloupce
    $sheet->setCellValue("A1", "Směnárna");
    $sheet->setCellValue("B1", "Devizy nákup");
    $sheet->setCellValue("C1", "Devizy prodej");
    $sheet->setCellValue("D1", "Valuty nákup");
    $sheet->setCellValue("E1", "Valuty prodej");
    foreach ($rows as $i => $row) {
        foreach ($columns as $key => $sl) {
            $sheet->setCellValue($sl . ($i + 2), $row[$key]);
        }
    }

    // doplnění průměru a formátování
    foreach ($columns as $sl) {
        $sheet->setCellValue($sl . ($i + 3), ($sl == "A" ? "Průměr" : "=AVERAGE($sl" . "2:$sl" . ($i + 2) . ")"));
        $sheet->getStyle($sl . 1)->getFont()->setBold(true);
        $sheet->getStyle($sl . ($i + 3))->getFont()->setBold(true);
    }
}

$writer = new PHPExcel_Writer_Excel2007($excel);
$writer->save("$date.xlsx");
?> 

Všechny texty se ukládají v kódování UTF-8.

Obsah vytvořeného souboru

OpenXML

Vytvořený soubor je běžný archiv ve formátu ZIP, pouze má jinou koncovku. Počáteční bod, ze kterého se odvíjí vše ostatní, leží v souboru _rels/.rels. To je jednoduchý XML soubor, který se odkazuje na ostatní zdroje dat spolu s uvedením jejich typu. Druhým vstupním bodem je soubor [Content_Types].xml, kde je uveden výčet všech typů obsažených v souboru. V adresáři docProps/ vygenerovaného souboru jsou uloženy informace o dokumentu (principiálně mohou být kdekoliv, záleží na tom, co je uvedeno v souboru _rels/.rels) a v adresáři xl/ je vlastní pracovní sešit s jednotlivými listy. Ten opět obsahuje soubor _rels/.rels, dále seznam jednotlivých listů v souboru workbook.xml, použité styly v souboru styles.xml a textové řetězce v sharedStrings.xml. V Excelu jsou totiž textové řetězce uloženy odděleně, což šetří místo a usnadňuje lokalizaci, na druhou stranu to ale samozřejmě zesložiťuje proces načítání a ukládání dat (alternativně lze řetězce uložit i přímo do listu, ale z výše uvedených důvodů to sám Excel nedělá). Data jednotlivých listů jsou uložena v XML souborech v adresáři  worksheets/.

Použitá organizace souborů je poměrně přehledná a jednotlivé části jsou od sebe dobře odděleny, což umožňuje jak poměrně jednoduché načítání, tak i zapisování dat. Pokud použijeme zmiňovanou knihovnu, tak se tím ale nemusíme vůbec zabývat.

Našli jste v článku chybu?
120na80.cz: Bonbon si schovejte na přistání

Bonbon si schovejte na přistání

DigiZone.cz: Starci na chmelu jsou restaurovaní do 4K

Starci na chmelu jsou restaurovaní do 4K

Měšec.cz: Se stavebkem k soudu už (většinou) nemusíte

Se stavebkem k soudu už (většinou) nemusíte

Měšec.cz: Udali ho na nelegální software a přišla Policie

Udali ho na nelegální software a přišla Policie

Měšec.cz: Do ostravské MHD bez jízdenky. Stačí vaše karta

Do ostravské MHD bez jízdenky. Stačí vaše karta

Měšec.cz: Cool karta: recenze předplacenky

Cool karta: recenze předplacenky

Lupa.cz: eIDAS: Nepřehnali jsme to s výjimkami?

eIDAS: Nepřehnali jsme to s výjimkami?

Měšec.cz: TEST: Vyzkoušeli jsme pražské taxikáře

TEST: Vyzkoušeli jsme pražské taxikáře

Měšec.cz: Investice do drahých kovů - znáte základní chyby?

Investice do drahých kovů - znáte základní chyby?

Vitalia.cz: Sobotní masakr žrádla, chlastu a zábavy

Sobotní masakr žrádla, chlastu a zábavy

Podnikatel.cz: Rozhodnuto! Pracující senior penzi nezdaní

Rozhodnuto! Pracující senior penzi nezdaní

120na80.cz: Úpal vs. úžeh. Co dělat?

Úpal vs. úžeh. Co dělat?

Lupa.cz: Největší torrentový web KickassTorrents padl

Největší torrentový web KickassTorrents padl

DigiZone.cz: Hra o trůny: natáčení 7. řady posunuto

Hra o trůny: natáčení 7. řady posunuto

Lupa.cz: Japonská invaze. Proč SoftBank kupuje ARM?

Japonská invaze. Proč SoftBank kupuje ARM?

Podnikatel.cz: Místa, kde hází podnikání klacky pod nohy

Místa, kde hází podnikání klacky pod nohy

Vitalia.cz: Za zánět močových cest mohou plavky

Za zánět močových cest mohou plavky

Podnikatel.cz: Daň z nemovitosti? Změny budou v říjnu

Daň z nemovitosti? Změny budou v říjnu

Podnikatel.cz: Kanceláře jako kóje? Špatný vtip

Kanceláře jako kóje? Špatný vtip

Měšec.cz: Co s reklamací, když e-shop krachuje?

Co s reklamací, když e-shop krachuje?