Crear archivo de Excel con PHP y PHPSpreadsheet

Hoja de cálculo con contenido agregado con PHP

Introducción

Este es el primer post de muchos que espero hacer sobre trabajar con archivos de Excel u hojas de cálculo con PHP y la librería llamada PHPSpreadsheet.

Lo que veremos hoy será:

  1. Cómo descargar la librería, además de ver las opciones que necesita
  2. Escribir hola mundo
  3. Escribir propiedades de documentos

Nota: si no te gusta PHP o no quieres realizar la operación desde el servidor, puedes usar JavaScript del lado del cliente con TableExport.

Actualización

Mira la parte 2 de este tutorial: Leer archivos de Excel con PHP.

Sobre la librería

Antes de continuar quiero dejar en claro que toda la documentación está aquí. Si algo no queda claro o deseas profundizar en el tema te invito a leerla. El repositorio en GitHub es este.

Necesita la versión de PHP 5.6 o una más nueva, y las siguientes extensiones:

  • php_zip
  • php_xml
  • mb_string
  • dom (opcional)
  • php_gd2 (opcional)

Por cierto, esta es la sucesora de PHPExcel.

Descargar librería

Lo más recomendable es usar composer (aquí hay un tutorial de su instalación, y aquí puedes ver por qué usar Composer o cómo adaptarlo a tu proyecto). No importa si ya tenemos un proyecto con composer o si es uno nuevo, abrimos la terminal, nos ponemos en el lugar en donde esté y  ejecutamos:

composer require phpoffice/phpspreadsheet

Así como se ve en la imagen:

Instalar PhpSpreadsheet

Instalar PhpSpreadsheet

Luego, en caso de no estar incluyendo el autoload, lo incluimos:

require __DIR__ . "/vendor/autoload.php";

Más tarde indicamos que usaremos algunas clases con espacios de nombres:

use PhpOffice\PhpSpreadsheet\Spreadsheet;

use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

Y ya podemos comenzar a trabajar.

Crear documento y poner propiedades

Crearemos un documento, le pondremos algunas propiedades y veremos las cosas básicas.

Ahí no estamos agregando nada, simplemente creamos un nuevo documento y lo guardamos como nombre_del_documento.xlsx.

Las propiedades son opcionales, pero las puse para que veamos las posibilidades. En este caso se queda guardado en el mismo lugar en donde ejecutamos el script.

Mandar documento al navegador para que se descargue, en lugar de guardarlo

Puede que quieras saber cómo se puede descargar directamente. No te preocupes, la librería ya tiene un ayudante. Veamos cómo crear el documento y hacer que se descargue.

En lugar de usar el Writer usamos a IOFactory y mandamos toda la salida a php://output.

Nota sobre los encabezados: sería una larga plática hablar sobre HTTP, pero basta saber que no debemos imprimir otra cosa si queremos que el documento se descargue.

Y cuando digo nada me refiero a NADA, el script debe ejecutarse y salir sin que se imprima otra cosa, ni errores.

Para eso es el exit al final, para que no cometamos el error de incluir el archivo e imprimamos algo o cosas por el estilo.

Ah, por otro lado el creador dice que si queremos que funcione con internet explorer debemos agregar más encabezados, de manera que quede así:

Finalmente aquí un GIF de cómo se descarga el documento:

Descargar documento de Excel generado por PhpSpreadsheet

Descargar documento de Excel generado por PhpSpreadsheet

Revisar propiedades del documento

Al menos con Windows, así se ve lo que creamos:

Propiedades del documento creado con PhpSpreadsheet

Propiedades del documento creado con PhpSpreadsheet

Eso nos da a entender que sí está guardando las propiedades.

Agregar contenido al documento

Recordemos que un documento de estos puede tener muchas hojas. Y cada hoja tiene celdas que tienen una posición, por ejemplo A1, B5, etcétera.

Podemos ver a una hoja como un gigante arreglo bidimensional, o como una tabla.

Para modificar las celdas debemos obtener primero la hoja, pues un libro de estos se compone de hojas. Una vez que la tenemos, vemos que tenemos dos formas de modificar las celdas.

La primera (setCellValueByColumnAndRow) es la que recomiendo y prefiero: establecer el valor a partir de la columna y fila; usamos números como coordenadas; eso sí, deben ser a partir del 1, no del 0 como estamos acostumbrados siendo programadores.

El tercer argumento son los datos que le vamos a pasar, los cuales pueden ser de cualquier tipo que pueda mostrar el libro.

Existe una segunda forma y es usar las coordenadas con letras (setCellValue). Esto sólo recibe 2 argumentos, las coordenadas y los datos.

El nombre o título de la hoja puede ser cambiado opcionalmente con $hoja->setTitle("El título");, si no lo ponemos se pondrá Worksheet me parece.

Sin importar cómo, al final todos los cambios se guardan y el resultado se ve así:

Hoja de cálculo con contenido agregado con PHP

Hoja de cálculo con contenido agregado con PHP

Simple y poderoso, como todo debe ser.

Conclusiones y notas

Esto fue un primer acercamiento a PhpSpreadsheet, pero ya tenemos las bases con las que trabajar. Ya vimos cómo escribir documentos y descargarlos o guardarlos, cosa que omitiremos en los siguientes tutoriales.

A partir de esto ya nos damos una idea de cómo generar cosas más interesantes, porque una vez que tenemos acceso a las celdas podemos modificarlas a nuestro antojo.

Con esta librería podemos generar gráficas, poner fórmulas, establecer contraseñas y obviamente leer documentos, entre otras cosas.

13 pensamientos sobre “Crear archivo de Excel con PHP y PHPSpreadsheet”

  1. Hola Parzibyte, descarga el archivo pero al intentar abrir excel me dice esto = Excel no puede abrir el archivo “nombre_archivo.xlsx” porque el formato o la extension de este no son validos. Compuebe que el archivo no se a dañado y que la extension del mismo coincide con el formato del archivo.

    1. Hola amigo. Yo lo acabo de probar y funciona perfectamente, tal vez tienes una versión de Office distinta a la mía o cambiaste alguna parte de los headers o extensiones, recomiendo que verifiques

  2. GRacias por el artirulo!

    Lo unico qu eme queda por conseguir es que las fechas tipo “2019-10-23” que seria la de hoy en excel la reconozca como fecha. AUnque ponga formato fecha a la hora de usar filtros despues no discrima entre Año, mes y dia. Alguien sabe como poder hacerlo? 🙁

    GRacias!

    1. Hola, buen día. ¿A qué te refieres con “eso”? si te sale esa página es porque se está causando un error de servidor y no se está mostrando. Analiza los mensajes o logs de error, y trata de ver si tu código no tiene errores, ¿podrías compartirlo en un gist para analizarlo?
      Saludos

  3. Pingback: Crear documentos de Word con PHP y PHPWord - Parzibyte's blog

  4. Hola que tal, una pequeña duda, necesita crear un archivo excel con datos de una consulta php que tengo en otro archivo, utilizo mvc pero al momento de incluir el modelo que necesito $this->_ejemplo=$this->loadModel(‘ejemplo’); me da un error en el contenido del excel imprimiendo solo caracteres extraños alguna ayuda?

    1. Antes de crear el archivo de excel imprime tu información y verifica que sea la correcta. Cuando hayas verificado que la información es precisa entonces crea el archivo de Excel. En resumen, separa las cosas, ya que a veces los errores que se generan “ensucian” el archivo

  5. Pingback: Leer archivo de Excel con PHP y PHPSpreadSheet - Parzibyte's blog

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *