Spin x Spatie Laravel PDF

[luchtech]

Good day!

As advised on the group chat, I am here to open up a discussion regarding Spatie Laravel PDF.

Before anything else, here are the relevant links for this discussion:

• Spatie Laravel PDF
• Browsershot Requirements

The Spatie Laravel PDF package enables us to create PDFs from Blade views in our Laravel apps. It uses Chromium behind the scenes. The problem is that the Spin PHP image does not have npm by default. In a Spin setup, there is another Docker container for node but that is not deployed in the production environment.

Right now, I have two paths: mess around with the Dockerfile.php or pick on of the non-Chromium-based alternatives. But as much as possible, I'd like to use this package if I can which is why I opened this discussion in the first place.

Thank you for reading and I hope you can share with me the solutions you come up with.

For reference, here's my current Dockerfile.php file:

############################################
# Base Image
############################################

# Learn more about the Server Side Up PHP Docker Images at:
# https://serversideup.net/open-source/docker-php/
FROM serversideup/php:8.3-fpm-nginx-alpine AS base

## Uncomment if you need to install additional PHP extensions
USER root
RUN install-php-extensions intl gd

############################################
# Development Image
############################################
FROM base AS development

# We can pass USER_ID and GROUP_ID as build arguments
# to ensure the www-data user has the same UID and GID
# as the user running Docker.
ARG USER_ID
ARG GROUP_ID

# Switch to root so we can set the user ID and group ID
USER root

# Trust the self-signed certificate
COPY .infrastructure/conf/traefik/dev/certificates/ssu-ca.pem /usr/local/share/ca-certificates/ssu-ca.crt
RUN update-ca-certificates

# Set the user ID and group ID for www-data
RUN docker-php-serversideup-set-id www-data $USER_ID:$GROUP_ID  && \
    docker-php-serversideup-set-file-permissions --owner $USER_ID:$GROUP_ID --service nginx

# Drop privileges back to www-data    
USER www-data

############################################
# CI image
############################################
FROM base AS ci

# Sometimes CI images need to run as root
# so we set the ROOT user and configure
# the PHP-FPM pool to run as www-data
USER root
RUN echo "user = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf && \
    echo "group = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf

############################################
# Production Image
############################################
FROM base AS deploy
COPY --chown=www-data:www-data . /var/www/html

# Create the SQLite directory and set the owner to www-data (remove this if you're not using SQLite)
RUN mkdir -p /var/www/html/.infrastructure/volume_data/sqlite/ && \
    chown -R www-data:www-data /var/www/html/.infrastructure/volume_data/sqlite/

# Ensure PHP-FPM gracefully stops
STOPSIGNAL SIGQUIT

USER www-data

[luchtech]

Related discussion: https://github.com/serversideup/spin-template-laravel-pro/discussions/23