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.

widgety

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?
Vitalia.cz: V Kauflandu už začaly Vánoce

V Kauflandu už začaly Vánoce

Podnikatel.cz: Letáky? Lidi zuří, ale ony stále fungují

Letáky? Lidi zuří, ale ony stále fungují

DigiZone.cz: Světový pohár v přímém přenosu na ČT

Světový pohár v přímém přenosu na ČT

DigiZone.cz: Mordparta: trochu podchlazený 87. revír

Mordparta: trochu podchlazený 87. revír

Vitalia.cz: Tesco nabízí desítky tun jídla zdarma

Tesco nabízí desítky tun jídla zdarma

Podnikatel.cz: Byla finanční manažerka, teď cvičí jógu

Byla finanční manažerka, teď cvičí jógu

DigiZone.cz: Nova opět stahuje „milionáře“

Nova opět stahuje „milionáře“

Vitalia.cz: Voda z Vltavy před a po úpravě na pitnou

Voda z Vltavy před a po úpravě na pitnou

DigiZone.cz: Ginx TV: pořad o počítačových hráčích

Ginx TV: pořad o počítačových hráčích

Vitalia.cz: Muž, který miluje příliš. Ženám neimponuje

Muž, který miluje příliš. Ženám neimponuje

Lupa.cz: Jak se prodává firma za miliardu?

Jak se prodává firma za miliardu?

Vitalia.cz: Jak Ondra o astma přišel

Jak Ondra o astma přišel

Vitalia.cz: Fyzioterapeutka: Chůze naboso? Rozhodně ano!

Fyzioterapeutka: Chůze naboso? Rozhodně ano!

DigiZone.cz: Digi Slovakia zařazuje stanice SPI

Digi Slovakia zařazuje stanice SPI

Lupa.cz: Jak levné procesory změnily svět?

Jak levné procesory změnily svět?

Vitalia.cz: Tradiční čínská medicína a rakovina

Tradiční čínská medicína a rakovina

DigiZone.cz: Numan Two: rozhlasový přijímač s CD

Numan Two: rozhlasový přijímač s CD

Root.cz: Hořící telefon Samsung Note 7 zapálil auto

Hořící telefon Samsung Note 7 zapálil auto

DigiZone.cz: Technisat připravuje trojici DAB

Technisat připravuje trojici DAB

Vitalia.cz: 5 chyb, které děláme při skladování potravin

5 chyb, které děláme při skladování potravin