Hoja de cálculo con contenido agregado con PHP

Crear archivo de Excel con PHP y PHPSpreadsheet

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.

Encantado de ayudarte


Estoy disponible para trabajar en tu proyecto, modificar el programa del post o realizar tu tarea pendiente, no dudes en ponerte en contacto conmigo.

No te pierdas ninguno de mis posts

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.

26 comentarios en “Crear archivo de Excel con PHP y PHPSpreadsheet”

  1. Buenas, pues mi duda es que todo el ejemplo me funciona perfecto en mi localhost y cuando lo subo a mi servidor web no funciona para que se descargue el archivo, y ademas si hice la prueba de que lo guarde para ver si esta funcionando la libreria y si me guarda mi archivo que creo de excel en mi servidor web, pero cuando pongo la opcion para que se descargue no se me descarga y mas bien me salen muchos simbolos extraños en mi explorador web.

  2. A mi me pasó lo mismo, yo uso Office 365, y activé la compatibilidad con 2003, y así no me dio errores, después de crear el $writer.
    $writer->setOffice2003Compatibility(true);
    Por otro lado, he tenido que quitar también las propiedades del documento, se ve que no se cargan bien en Excel 365, y tampoco podía cargar el título ni setCellValueByColumnAndRow.
    A partir de ahí fue todo bien

    1. No cargues las propiedades del documento, y no uses el setTitle, ni el setCellValueByColumnAndRow, y cuando crees el $writer, añade en la siguiente línea la compatibilidad con 2003
      $writer->setOffice2003Compatibility(true);
      Así es como a mí no me daba ningún error al abrirlo

  3. Hola,muy bueno el tutorial. Tengo varias preguntas.
    1- Descargué spreadsheet y composer, pero no tengo el archivo autoload.php, tengo que descargarlo de algún lugar ?
    2- Utilizas éste código “..require __DIR__ . “/vendor/autoload.php”;..” , tengo que crear la carpeta /vendor/ ?
    3- Qué archivos irían dentro de esa carpeta ?
    4- Debo copiar toda la carpeta Spreadsheet dentro de la carpeta de mi proyecto ?

    Muchas gracias.

    1. Hola. Necesitas usar composer, eso responde a tus 4 preguntas; por favor mira los posts que indico para comenzar a usar composer e instalar las dependencias.
      Saludos 🙂

    1. Me parece que composer está disponible en Mac. Puedes instalarlo para instalar a su vez phpspreadhseet y listo. Luego tendrías que importar el vendor/autoload.php en tu proyecto.
      Saludos 🙂

  4. Hola,
    Yo abro un archivo a partir de una plantilla que tiene 5 hojas,
    Dependiendo de los datos, necesito eliminar algunas hojas.
    Lo estoy haciendo con: $spreadsheet->removeSheetByIndex($nh);

    Aunque siempre sale el libro con las hojas que quiero, lo curioso es que en algunos casos me sale error de excel, dice que “hemos encontrado un problema con contenido de . Si confia en el origen de este libro, haga click en Si”.
    Al dar Si, genera una ventana con errores:
    Excel ha completado la validación y reparación en nivel de archivo. Puede que se hayan reparado o descartado algunas partes de este libro.
    Parte quitada: Opciones de impresión.
    Parte quitada: Forma de dibujo.

    El libro queda como yo lo quiero.
    Lo que quiero es quitarle estos errores.
    Si abro el libro con LibreOffice, no me genera ninguna alerta.

    Qué será???

    1. Hola, no lo sé, no me ha pasado, pero lo que se me ocurre es en lugar de eliminar la hoja, crear un nuevo libro y si la hoja sí sirve, la agregas a este nuevo, luego exportas el nuevo y listo.
      Es decir, no elimines, mejor crea uno nuevo.
      Saludos 🙂

  5. BUenas tardes, genial tutorial, mi problema es que algo falla en el uso del autolodad y no se define el metodo setCellValue.

    Lo instale con composer y cuando pruebo los ejemplos desde:

    php -S localhost:8000 -t vendor/phpoffice/phpspreadsheet/samples

    funcionan bien.

    Hay algo no muy bien con los namespace porque new spreadsheet funciona, pero para IOFactory tengo que usar:

    PhpOffice\PhpSpreadsheet\IOFactory::load( $cNombreHojaCalculo );

    Alguien sabe que puede pasar? (Lee y graba los arhivos)
    pero para instanciar objeto que graba tuve que hacer:

    new PhpOffice\PhpSpreadSheet\Writer\Xls( $oPlanilla );

    Desde ya muchas gracias.

  6. 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. Hola Omar si lo solucione, antes de l save(‘php://output’); debes agregar la siguiente línea de código ” ob_end_clean(); “

  7. 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

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

  9. 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

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

Dejar un comentario