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: Víte, co je svobodná menstruace?

Víte, co je svobodná menstruace?

Lupa.cz: Letní tip: stavebnice pro IoT za pár korun

Letní tip: stavebnice pro IoT za pár korun

DigiZone.cz: Sky Deutschland: dvakrát fotbal ve 4K

Sky Deutschland: dvakrát fotbal ve 4K

Lupa.cz: Měřičům síly hesla se nedá věřit. Víte proč?

Měřičům síly hesla se nedá věřit. Víte proč?

Měšec.cz: Kurzy platebních karet: vyplatí se platit? (TEST)

Kurzy platebních karet: vyplatí se platit? (TEST)

120na80.cz: Domácí HIV test vs. laboratoř

Domácí HIV test vs. laboratoř

Podnikatel.cz: Kauza z Vinohrad pokračuje. Policie se omlouvá

Kauza z Vinohrad pokračuje. Policie se omlouvá

DigiZone.cz: Hodlá Markíza skončit v DVB-T?

Hodlá Markíza skončit v DVB-T?

DigiZone.cz: ČTÚ červenec: rušení trochu vzrostlo

ČTÚ červenec: rušení trochu vzrostlo

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

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

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: Co s reklamací, když e-shop krachuje?

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

Podnikatel.cz: Česká pošta vycouvala ze služby ČP Cloud

Česká pošta vycouvala ze služby ČP Cloud

Lupa.cz: Co vzal čas: internetové kavárny a herny

Co vzal čas: internetové kavárny a herny

Podnikatel.cz: Youtuber? Za 15 tisíc dělat nebude

Youtuber? Za 15 tisíc dělat nebude

Podnikatel.cz: Pozor na vykuky, imitují služby České pošty

Pozor na vykuky, imitují služby České pošty

120na80.cz: Kam umístit silikony?

Kam umístit silikony?

Vitalia.cz: Na co si dát pozor při výběru dětských příkrmů

Na co si dát pozor při výběru dětských příkrmů

Měšec.cz: Ceny PHM v Evropě. Finty na úspory

Ceny PHM v Evropě. Finty na úspory

Lupa.cz: Samořídicí taxíky jsou tu. Začíná s nimi Uber

Samořídicí taxíky jsou tu. Začíná s nimi Uber