Is it possible to build frankenphp docker on Alma Linux?

[geoidesic]

The provided docker image for frankenphp is based on Debian. I don't want to run Debian, I want to run Alma Linux, because that's what I've standardised around.

Is it possible to provide an alternate Dockerfile to enable this?

E.g. This is how I was running it with PHP-fpm and Caddy:

networks:
  web-network:
services:
  caddy:
    image: caddy:latest
    restart: on-failure
    volumes:
      - ./caddy/data:/data
      - ./caddy/config:/config
      - ./caddy/Caddyfile:/etc/caddy/Caddyfile
      - ./caddy/logs:/logs
      - ./app:/var/www/html
    ports:
      - "80:80"
      - "443:443"
    networks:
      - web-network
    # this bit allows caddy on docker to see the listener on the external (to docker) port 8080 (which listens locally on my laptop)
    extra_hosts:
      host.docker.internal: host-gateway
  php:
    build: ./php
    tty: true
    restart: on-failure
    volumes:
      - ./app:/var/www/html
      - ./php/conf.d/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
      - ./php/conf.d/error_reporting.ini:/usr/local/etc/php/conf.d/error_reporting.ini
      - ./php/conf.d/requests.ini:/usr/local/etc/php/conf.d/requests.ini
    networks:
      - web-network
    extra_hosts:
      host.docker.internal: host-gateway
    expose:
      - "9003"  # Expose the Xdebug port

The idea being that the build: ./php builds an image from a Dockerfile that starts from almalinux:9 AS base.

Have I got the wrong end of the stick?

[withinboredom]

We base the images off of the standard PHP images. You are welcome to build them off of another base image but install-php-extensions might not work and you'll have to install them the 'olde fashioned way.

[dunglas]

Can you change go build -tags=nobadger,nomysql,nopgx by go build -tags=nowatcher,nobrotli,nobadger,nomysql,nopgx?

The watcher and Brotli features require extra c libraries to install manually.

This is something we are polishing.

[withinboredom]

I'd also recommend a few more configure options:

./configure --with-bz2 --enable-ctype --with-curl --enable-filter --enable-mbstring --enable-pcntl --enable-phar --enable-posix --with-readline --enable-sockets --with-sodium --with-zlib --enable-intl --with-openssl --with-zip --with-pear --enable-gd --with-avif --with-webp --with-jpeg --with-xpm --with-gmp --enable-embed --enable-cli --enable-phar --with-mysqli --enable-opcache

replacing mysqli with whatever database you need (such as pdo and friends), along with removing/adding other features you want php to support. You can also dump ./configure --help for a full list. Keep in mind that --enable-* means no dependencies are needed, but --with-* means dependencies are needed. So --with-mysqli requires the headers for mysql installed and --with-curl needs the curl dev library installed. Some of those are supposed to be enabled by default, but my team tends to be explicit if we are using those features.

[geoidesic]

Ok thanks for all the feedback. Between that and ChatGPT's help, I got quite a bit further. Here's the Dockerfile I've ended up with:

# Base image for AlmaLinux 9 on AArch64
FROM almalinux:9 AS common
# Install EPEL and CBR repositories
RUN dnf -y update && \
    dnf clean all

RUN dnf install -y epel-release \
    && dnf config-manager --set-enabled crb \
    && dnf clean all

# Install dependencies
RUN dnf -y update && \
    dnf install -y \
    gcc \
    gcc-c++ \
    make \
    brotli-devel \
    tar \
    libticonv \
    bison \
    re2c \
    pkgconfig \
    openssl-devel \
    libxml2-devel \
    sqlite-devel \
    oniguruma-devel \
    libpng-devel \
    libjpeg-devel \
    libzip-devel \
    mlocate \
    bzip2-devel \
    libcurl-devel \
    libavif-devel \
    libwebp-devel \
    libXpm-devel \
    gmp-devel \
    libicu-devel \
    readline-devel \
    libsodium-devel \
    git 


    
# Download and install Go manually
WORKDIR /usr/src
RUN curl -LO https://go.dev/dl/go1.22.0.linux-amd64.tar.gz && \
    tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz && \
    rm go1.22.0.linux-amd64.tar.gz

# Add Go to PATH
ENV PATH="/usr/local/go/bin:${PATH}"

# Download and extract PHP source
WORKDIR /usr/src/php
RUN curl -L https://www.php.net/distributions/php-8.2.11.tar.gz | tar xz --strip-components=1

# Configure PHP for FrankenPHP build
RUN ./configure \
    --enable-embed \
    --enable-zts \
    --disable-zend-signals \
    --enable-zend-max-execution-timers \
    --with-bz2 --enable-ctype --with-png --with-curl --enable-filter --enable-mbstring --enable-pcntl --enable-phar --enable-posix --with-readline --enable-sockets --with-sodium --with-zlib --enable-intl --with-openssl --with-zip --with-pear --enable-gd --with-avif --with-webp --with-jpeg --with-xpm --with-gmp --enable-embed --enable-cli --enable-phar --with-mysqli --with-pdo_mysql --enable-opcache  && \
    make -j"$(nproc)" && \
    make install

    
# Set environment variables for cross-compiling on ARM64
ENV GOARCH=arm64 \
CGO_ENABLED=1

# Download and compile FrankenPHP with adjusted flags for ARM64
WORKDIR /usr/src
# Build FrankenPHP binary
RUN curl -L https://github.com/dunglas/frankenphp/archive/refs/heads/main.tar.gz | tar xz && \
    cd frankenphp-main/caddy/frankenphp && \
    CGO_CFLAGS="$(php-config --includes)" \
    CGO_LDFLAGS="$(php-config --ldflags | sed 's/-m64//') $(php-config --libs)" \
    go build -tags=nowatcher,nobrotli,nobadger,nomysql,nopgx

# Using xcaddy for additional modules (uncomment and modify to include extra Caddy modules)
# RUN curl -fsSL https://github.com/caddyserver/xcaddy/releases/latest/download/xcaddy_linux_arm64 -o /usr/local/bin/xcaddy && \
#     chmod +x /usr/local/bin/xcaddy && \
#     XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s -extldflags \'-Wl,-z,stack-size=0x80000\'" xcaddy build \
#         --output /usr/local/bin/frankenphp \
#         --with github.com/dunglas/frankenphp/caddy \
#         --with github.com/dunglas/mercure/caddy \
#         --with github.com/dunglas/vulcain/caddy


# Final stage to copy the binary to a clean image
FROM almalinux:9
ENV LD_LIBRARY_PATH="/usr/local/lib:${LD_LIBRARY_PATH}"

# Copy compiled PHP and FrankenPHP binary from builder stage
COPY --from=common /usr/local/bin/php /usr/local/bin/php
COPY --from=common /usr/src/frankenphp-main/caddy/frankenphp/frankenphp /usr/local/bin/frankenphp
COPY --from=common /usr/lib64/ /usr/lib64/
COPY --from=common /usr/local/lib/libphp.so /usr/local/lib/



# Set worker mode to keep container active
ENV FRANKENPHP_CONFIG="worker /app/index.php"

# Expose necessary ports
EXPOSE 80 443

# Default command
CMD ["/usr/local/bin/frankenphp"]

However, it doesn't stay up. I'm launching it via docker compose with this yml:

  frankenphp:
    build:
      context: .
      dockerfile: php/caddy/frankenphp/Dockerfile
    ports:
      - "80:80"
      - "443:443"
      - "2019:2019"
    volumes:
      - ./app:/app
    extra_hosts:
      host.docker.internal: host-gateway

The logs:

frankenphp-1 exited with code 0 

I also tried mapping the Caddyfile

  frankenphp:
  build:
    context: .
    dockerfile: php/caddy/frankenphp/Dockerfile
  ports:
    - "80:80"
    - "443:443"
    - "2019:2019"
  volumes:
    - ./app:/app
    - ./php/caddy/frankenphp/Caddyfile:/etc/frankenphp/Caddyfile 
  extra_hosts:
    host.docker.internal: host-gateway

But that didn't make any difference.

[dunglas]

The run subcommand is missing in your CMD entry. Calling frankenphp without a subcommand will just display the lot of available subcommands.

[geoidesic]

Amazing! Got it working Tx!

I removed this: ENV FRANKENPHP_CONFIG="worker /app/index.php" as I'm not sure that's appropriate when routing via Caddyfile

[geoidesic]

One last problem. The docker compose doesn't seem to be quite working. I.e. I can't connect to the mysql service from the frankenphp service. When I do ping mysql from the frankenphp service it says:

sh-5.1# ping mysql
ping: mysql: Name or service not known

Any ideas?

[geoidesic]

Ah... nvm... I was missing the network declaration in the frankenphp service definition.