Laravel Vapor+Docker环境下DomPDF自定义字体staging不生效求助

DevOps 小满

2026-7-5

解决Laravel Vapor + DomPDF自定义字体回退问题

问题核心原因

部署到Vapor的Docker环境后，DomPDF无法正确读取public/fonts下的字体文件，导致自动回退到Helvetica。这主要是因为：

Alpine Linux镜像默认缺少字体管理工具，无法识别自定义字体路径
容器内的文件路径与本地环境存在差异，public_path()生成的路径未被DomPDF正确解析

解决方案（Dockerfile修改）

在现有Dockerfile中添加以下命令，将字体安装到系统字体目录并更新缓存：

FROM laravelphp/vapor:php81

# 安装字体管理工具fontconfig
RUN apk add imagemagick imagemagick-dev php81-pecl-imagick fontconfig \
    && pecl install imagick \
    && docker-php-ext-enable imagick

# 创建系统字体目录（若不存在）
RUN mkdir -p /usr/share/fonts/truetype/custom

# 将项目public/fonts下的字体文件复制到系统字体目录
COPY public/fonts/ /usr/share/fonts/truetype/custom/

# 更新字体缓存，让系统识别新安装的字体
RUN fc-cache -fv

COPY . /var/task

配套CSS调整（可选更可靠）

如果不想依赖系统字体，也可以修改CSS中的字体路径为容器内的绝对路径：

@font-face {
    font-family: caveat;
    font-style: normal;
    font-weight: normal;
    src: url('/var/task/public/fonts/caveat.ttf') format('truetype');
}

@font-face {
    font-family: Arial;
    font-style: normal;
    font-weight: normal;
    src: url('/var/task/public/fonts/Arial.ttf') format('truetype');
}