PHP y Word: agregar listas, tablas e imágenes usando PHPWord

En este post vamos a seguir trabajando con documentos de Word a través de PHP con la librería PHPWord.

Hoy vamos a ver cómo trabajar con listas, tablas e imágenes (locales o de internet).

Recuerda leer la primera parte para ver cómo instalar la librería y cómo agregar cosas básicas.

Listas

Para agregar un elemento de una lista primeramente se debe crear una sección, y después llamar a addListItem con el texto y, opcionalmente, como segundo argumento, la profundidad.

La profundidad de una lista es el número de tabulaciones que tiene. Veamos el siguiente ejemplo:

Listas y profundidades con phpword

Como tercer argumento se acepta una fuente en forma de arreglo, y como cuarto argumento un arreglo indicando el estilo de la lista, dentro del cual podemos especificar, por ejemplo, el tipo de “decorador” de la lista.

Los decoradores o indicadores de la lista son esos puntos que van a la izquierda. Están definidos en PhpOffice\PhpWord\Style\ListItem con unas constantes.

El documento generado se puede ver aquí, dentro del código se generaron muchas listas con múltiples tipos.

Tablas con PHPWord

Las tablas se agregan a una sección con addTable; antes de ello se pueden registrar estilos de tablas (con addTableStyle($nombreDeEstilo, $estiloComoArreglo)) para usarlos más tarde al llamar a addTable($nombreDeEstilo)

Para agregar una fila se llama al método addRow de la tabla, y para agregar una celda a esa fila se llama al método addCell de la tabla, igualmente.

El método addCell devuelve una celda a la que le podemos adjuntar todo tipo de contenido, por ejemplo, texto, con addText.

En el código se crean 3 tablas con distintos estilos, la primera se renderiza manualmente y se centra, la segunda con un ciclo y la tercera con un arreglo.

Puedes ver el documento aquí, el cual se ve así:

Tablas con PHPWord

Los estilos (márgenes, colores, etcétera) se personalizan en el código.

Colocar imágenes dentro del documento de Word

Para agregar una imagen a un documento se debe crear una sección y a la sección agregarle la imagen con el método addImage que recibe dos argumentos: la ruta de la imagen y opcionalmente un arreglo con los estilos de la imagen.

La ruta de la imagen puede ser una URL de internet, solo hay que tener cuidado con no pasar esta URL desde la entrada del usuario por esas cosas de la seguridad. También puede ser la ruta de una imagen local.

El arreglo de los estilos es para personalizar algunas cosas como la altura y la anchura de la imagen.

Dentro del código agregamos encabezados, texto e imágenes para que al final resulte en algo así:

Imágenes y texto a documento de Word con PHPWord

La tercer imagen es traída de internet desde la ruta https://picsum.photos/200/300.

Puedes ver el documento aquí. Las imágenes están en la misma ruta que el script de PHP, y puedes ver todo el contenido en el repositorio de GitHub.

Conclusión

Esta es la parte 2 de 3 del tutorial con PHPWord. Hemos visto cómo trabajar con listas, tablas e imágenes.

En la siguiente parte vamos a ver cómo poner marcas de agua, tablas de contenido (o índices, así les llamo yo) y gráficas de barras.

Recuerda que la parte 1 del tutorial está aquí, y que la documentación oficial está en este enlace.

Actualización: aquí está la parte 3.