No mundo da programação é raro o dia em que não nos deparamos com um ou outro obstáculo, sendo o desafio e a superação do mesmo algo que nos leva a fazer o que fazemos, seja com ou sem ajuda. Pois bem, à dias foi necessário exportar para um ficheiro uma listagem de determinado site. Até aqui tudo bem, sem problemas. A maneira mais simples seria criar em tempo real um ficheiro csv (ficheiro de valores separados por vírgulas) que pode ser aberto sem problemas no Excel, OpenOffice ou LibreOffice. Mas além de ser simples este tipo de ficheiro é bastante limitado e não nos permite definir quaisquer formatações para uma melhor aparência/facilidade de leitura, pois é um mero ficheiro de texto.
Depois de pesquisar e testar várias alternativas eis que cheguei ao “Santo Graal”: PHPExcel
O nome diz quase tudo, trata-se de uma classe para PHP para criar ficheiros Excel completamente personalizáveis. Fiquei literalmente de boca aberta com a potencialidade desta classe, pois tudo o que pode fazer no Excel normal é possível fazer nesta classe, desde colocar texto a negrito até colocar fórmulas de cálculo nas células.
Podem efectuar o download desta classe em PHPExcel Downloads (recommended download). Este download é muito completo, pois contém ficheiros de exemplo da sua utilização e uma documentação excelente onde nada é deixado ao acaso, o que me deixou impressionado.
Vou aqui demonstrar alguns exemplos do que podemos fazer com esta classe e recomendo vivamente a utilização doKomodo Edit 6 como ferramenta open source de desenvolvimento em PHP.
Para termos disponível a classe PHPExcel basta enviarmos para o nosso servidor a pasta “Classes” do PHPExcel. Uma vez feito isto a classe pode ser usada em qualquer parte do nosso site, bastando para isso fazer uma chamada à classe:
1 2 | // Obter acesso à classe PHPExcel require_once ‘Classes/PHPExcel.php’; |
Aqui o caminho correcto para a classe depende onde colocaram a pasta “Classes“, por isso certifiquem-se do caminho correcto.
De seguida vamos criar um objecto de modo a usar a classe:
1 2 | // Criar um novo objecto PHPExcel $objPHPExcel = new PHPExcel(); |
Neste momento já podemos aceder a todas as funcionalidades da classe PHPExcel usando, aqui como exemplo, o objecto $objPHPExcel.
Podemos definir as propriedades comuns/normais de um ficheiro Excel:
1 2 3 4 5 6 7 8 | // As várias propriedades do documento que podemos definir $objPHPExcel->getProperties()->setCreator(“Autor do Documento”) ->setLastModifiedBy(“Modificado por…”) ->setTitle(“O Título”) ->setSubject(“O Assunto”) ->setDescription(“A Descrição”) ->setKeywords(“As Palavras Chave”) ->setCategory(“A Categoria”); |
Caso seja necessário, ou por ser mais prático, podemos inserir dados consecutivos em várias células sem limites
1 2 3 4 | // Inserir dados nas células A1 e A2 $objPHPExcel->setActiveSheetIndex(0) ->setCellValue(‘A1’, ‘Título do Exemplo da Classe PHPExcel (vai ficar a negrito)’) ->setCellValue(‘A2’, ‘uma excelente classe (vai ficar em itálico a azul)’); |
E sempre que o desejarmos podemos definir a formatação quer das células (tipo de letra, cor, alinhamento) quer das colunas/linhas (ajuste automático da altura/largura), sem esquecer a possibilidade de desenhar limites em torno de uma célula ou de um conjunto de células:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | // Definir a largura da coluna A para automático/auto-ajustar $objPHPExcel->getActiveSheet()->getColumnDimension(‘A’)->setAutoSize(true); // Formatar a célula A1 a negrito $objPHPExcel->getActiveSheet()->getStyle(‘A1’)->getFont()->setBold(true); // Formatar a célula A2 a itálico $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getFont()->setItalic(true); // Formatar a cor do texto da célula A2 a azul $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getFont()->getColor()->setARGB(PHPExcel_Style_Color::COLOR_BLUE); // Formatar o topo da célula A2 com uma borda $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getBorders()->getTop()->setBorderStyle(PHPExcel_Style_Border::BORDER_THICK); // Colocar uma borda em torno da área A1:A5 $objPHPExcel->getActiveSheet()->getStyle(‘A1:A5’)->getBorders()->getOutline()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN); |
Usar fórmulas também é uma realidade:
1 2 3 4 5 | // Usar fórmulas $objPHPExcel->setActiveSheetIndex(0) ->setCellValue(‘A3’, ’15’) ->setCellValue(‘A4’, ’20’) ->setCellValue(‘A5’, ‘=A3+A4’); |
Depois de termos tudo o que queremos no ficheiro temos de indicar a criação do ficheiro com base nos dados guardados até ao momento no objecto $objPHPExcel:
1 2 | // Indicação da criação do ficheiro $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, ‘Excel5’); |
E para que se obtenha este documento gerado em tempo real damos indicação para o mesmo abrir no browser (seja para visualização no browser seja para download)
1 2 3 4 5 | // Encaminhar o ficheiro resultante para abrir no browser ou fazer download header(‘Content-Type: application/vnd.ms-excel’); header(‘Content-Disposition: attachment;filename=”teste.xls”‘); header(‘Cache-Control: max-age=0’); $objWriter->save(‘php://output’); |
Ficheiro criado com a classe PHPExcel
Estas são apenas algumas das muitas funcionalidades disponíveis nesta incrível classe PHPExcel à espera de serem exploradas.
Para que possam testar este mesmo código, fica aqui o código exemplo completo:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | <?php // Obter acesso à classe PHPExcel require_once ‘Classes/PHPExcel.php’; // Criar um novo objecto PHPExcel $objPHPExcel = new PHPExcel(); // As várias propriedades do documento que podemos definir $objPHPExcel->getProperties()->setCreator(“Autor do Documento”) ->setLastModifiedBy(“Modificado por…”) ->setTitle(“O Título”) ->setSubject(“O Assunto”) ->setDescription(“A Descrição”) ->setKeywords(“As Palavras Chave”) ->setCategory(“A Categoria”); // Inserir dados nas células A1 e A2 $objPHPExcel->setActiveSheetIndex(0) ->setCellValue(‘A1’, ‘Título do Exemplo da Classe PHPExcel (vai ficar a negrito)’) ->setCellValue(‘A2’, ‘uma excelente classe (vai ficar em itálico a azul)’); // Definir a largura da coluna A para automático/auto−ajustar $objPHPExcel->getActiveSheet()->getColumnDimension(‘A’)->setAutoSize(true); // Formatar a célula A1 a negrito $objPHPExcel->getActiveSheet()->getStyle(‘A1’)->getFont()->setBold(true); // Formatar a célula A2 a itálico $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getFont()->setItalic(true); // Formatar a cor do texto da célula A2 a azul $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getFont()->getColor()->setARGB(PHPExcel_Style_Color::COLOR_BLUE); // Formatar o topo da célula A2 com uma borda $objPHPExcel->getActiveSheet()->getStyle(‘A2’)->getBorders()->getTop()->setBorderStyle(PHPExcel_Style_Border::BORDER_THICK); // Colocar uma borda em torno da área A1:A5 $objPHPExcel->getActiveSheet()->getStyle(‘A1:A5’)->getBorders()->getOutline()->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN); // Usar fórmulas $objPHPExcel->setActiveSheetIndex(0) ->setCellValue(‘A3’, ’15’) ->setCellValue(‘A4’, ’20’) ->setCellValue(‘A5’, ‘=A3+A4’); // Indicação da criação do ficheiro $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, ‘Excel5’); // Encaminhar o ficheiro resultante para abrir no browser ou fazer download header(‘Content-Type: application/vnd.ms-excel’); header(‘Content-Disposition: attachment;filename=”teste.xls”‘); header(‘Cache-Control: max-age=0’); $objWriter->save(‘php://output’); ?> |
Façam bom uso desta classe pois tem muita potencialidade!
Em caso de questões, dúvidas ou sugestões, deixe um comentário no final da página.
Fonte: http://interessespessoais.com/programacaoweb/
