laravel-alpine

从kamerk22/laravel-alpine分叉

运行在PHP-FPM上的Laravel PHP框架，基于Alpine基础Docker镜像 🐳

!SIZE

仓库选项

您可从GHCR（GitHub容器仓库）或DockerHub仓库拉取镜像

• GHCR镜像： ghcr.io/eightsystems/laravel-alpine
• DockerHub镜像： 8sistemas/laravel-alpine

可用版本/标签

可使用以下格式的版本标签：

version-tag 示例：8.4-alpine3.20-mysql-nginx

从Docker仓库拉取镜像

拉取Docker镜像命令：

docker pull 8sistemas/laravel-alpine:8.3-alpine3.20-mysql

使用方法

从当前目录运行：

docker run -v $(pwd):/var/www 8sistemas/laravel-alpine:8.3-alpine3.20-mysql "composer install --prefer-dist"

包含内容

• Composer（v2 - 来自Docker***镜像）
• CRON（预安装并配置支持Laravel调度器）
• Supervisor的Go端口实现
  • 详情参见Supervisord.md
• ARM64版本
• Nginx“模块化”配置。参见NGINX-Files.md
• PHP和NGINX的Prometheus exporter（若通过环境变量ENABLE_PROMETHEUS_EXPORTER_RUNNER=1启用）。参见Prometheus-Scrapper.md
  • 默认情况下，php-fpm_exporter运行在9090端口，nginx prometheus exporter运行在9190端口。
    • nginx-prometheus-exporter:0.10
    • php-fpm_exporter:2.0.4
• 密钥管理器环境变量扩展器
  • 参见Secrets-Environment-Expander.md
• 修改用户/组UID和GID
  • 当容器需要连接共享NFS服务器且需匹配UID/GID时非常有用。
  • 参见Change-User-Uid-And-Gid.md
• PHP生产环境ini配置
  • 参见php.ini
• Opcache支持
  • 参见opcache.ini
• 可使用www-data（Linux UID 82，GID 82）用户以降权方式运行
• 内存占用小
  • 启用Prometheus Exporter的8.1-alpine3.16-mysql-nginx镜像空闲时内存占用约65MB
    • 支持容器以低至128MB内存运行，仍为应用留有空间。
• 只读文件系统支持（部分必要路径需使用tmpfs）
  • 示例Docker-compose文件
  • 示例Kubernetes POD Yaml

其他详情

• Alpine基础镜像版本3.16和3.20
• 使用DockerHub PHP基础镜像
• 每两周进行安全扫描（使用Anchore）
• 所有标签均支持Supervisor的supervisorctl

PHP扩展

这些扩展是运行Laravel 8.x及以上版本所需的基础扩展（含部分附加扩展）

• pdo
• mysqli（mysql镜像）
• pdo_mysql（mysql镜像）
• pgsql（pgsql镜像）
• pdo_pgsql（pgsql镜像）
• sockets
• json（PHP 8.0+除外，因已内置）
• intl
• xml
• bz2
• pcntl
• bcmath
• exif
• zip
• redis
• event
• calendar
• imagick
• soap
• gmp

附加扩展

• opcache
• gettext
• mbstring
• mcrypt（<8.4版本）
• gd（支持jpeg、png、freetype、gif和webp）
• XDebug（含-xdebug标签的镜像）
• opentelemetry（需在Dockerfile中通过docker-php-ext-enable opentelemetry启用）

添加其他PHP扩展

可通过运行docker-ext-install命令添加额外PHP扩展。添加时需安装所需扩展的依赖。

FROM 8sistemas/laravel-alpine:8.4-alpine3.20-mysql
USER root
RUN docker-php-ext-install memcached
USER www-data

添加自定义CRON

FROM 8sistemas/laravel-alpine:8.4-alpine3.20-mysql
RUN echo '* * * * * /usr/local/bin/php  /var/www/artisan another:command >> /dev/null 2>&1' >> /etc/crontabs/www-data

添加自定义Supervisor配置

可在/etc/supervisor.d/目录下添加自定义Supervisor配置文件（用于Laravel Queue或Laravel Horizon），文件扩展名为*.ini。默认情况下，此镜像已在Supervisor中添加php-fpm和crond进程。

例如：为Laravel Horizon创建horizon.ini文件

[program:horizon]
process_name=%(program_name)s
command=php /var/www/artisan horizon
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0

在Docker镜像中添加：

FROM 8sistemas/laravel-alpine:8.4-alpine3.20-mysql
USER root
ADD horizon.ini /etc/supervisor.d/
USER www-data

更多Supervisor配置详情参见[***]

Docker权限

如示例docker-compose和kube文件所示，基本可移除所有capabilities，但运行CRON需保留setuid和setgid权限；若移除这些权限，需在Dockerfile中通过rm -f /etc/supervisor.d/01_crond.ini禁用CRON。

CRON运行时，即使容器默认以www-data (82)用户运行，仍需使用sudo提升至root权限。因此添加了/etc/sudoers.d/crond-www-data配置，内容如下：

ALL ALL = (root) NOPASSWD: /usr/sbin/crond'

这允许任何用户运行crond命令，以避免过度开放权限。

故障排除/问题/贡献

欢迎在GitHub仓库提交issue。