winzik/docker/desktop/Dockerfile
David Nurdin 1e0a9fad24 Cryo save points freeze the whole program, whatever the game (no code of it): JumPHP\Cryo\ProcessFreeze
- "Freeze here" stops the game loop, Application::run() freezes every value reachable from the globals and statics
  (cryo_freeze include globals + statics: the application, engine, scenes, loop and timers, the game's services) and
  runs the loop again; JUMPHP_CRYO_THAW thaws it in Application::boot() before anything is built, which returns the
  thawed application: the game goes on exactly where it was
- native parts made again at the thaw: window and SDL renderer opened by the new process, textures from their recipe
  (Sdl::$recipes: file or picture; render targets blank, redrawn), fonts, sounds and the music playing, gamepads
  (cryo_register_resource + cryo_on_thaw / replaceClass); files signed with a key of the project
- the scene save point stays next to it, used when the whole program can not be resumed (code changed, OpenGL)
- SceneManager params by class (no WeakMap), the container's compiler and private-method closures out of the freeze
- ext-cryo a9c891d (php-cryo): typed properties holding a frozen value (closure, resource, __wakeup object, excluded
  object) come back; DESKTOP_REV 11
- IDE: each save point says "whole program" / "scene only" (why); docs/ide.md, docs/cryo.md

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-15 11:18:43 +01:00

97 lines
5.7 KiB
Docker

# JumPHP desktop runtime: native PHP 8.5 + the SDL extensions, built from the SAME forks and commits
# as the WebAssembly engine (docker/engine-wasm), so a game sees the exact same SDL API on both targets.
# Also used for composer, phpunit, phpstan and headless smoke tests (SDL dummy drivers).
FROM php:8.5-cli-bookworm
ARG PHP_SDL_REF=89855c8f4f63b77f9a548007b9c4afe366785b4b
ARG SDL_IMAGE_REF=fd798eb2c52b7be5874a30334d1d255436aa686e
ARG SDL_MIXER_REF=f75a31826f4484bb4af31c1a1a4cdf1463aae8b2
ARG SDL_TTF_REF=d2c634c509aa0b14168f55128435d9519d34d0e3
# OpenGL / OpenAL bindings (JumPHP\Gl\OpenGl, JumPHP\Audio\Audio3d): same commits and patch as the wasm engine
ARG PHP_OPENGL_REF=438798d5f0a5347a59d13252611556792cc2a1b8
ARG PHP_OPENAL_REF=6f78e95120ffe2cd30813a78ca66eaedde310314
RUN apt-get update && apt-get install -y --no-install-recommends \
git unzip pkg-config \
libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev libsdl2-mixer-dev \
libpng-dev libzip-dev \
libgl1-mesa-dri libegl1 libgles2 libpulse0 \
libgl-dev libopenal-dev libopenal1 xvfb \
xclip wl-clipboard \
&& rm -rf /var/lib/apt/lists/*
# Mesa of bookworm-backports (25.x): bookworm's own 22.3 does not know recent GPUs (AMD Strix Halo / RDNA 3.5: "radeonsi: unknown family_id",
# then the window is drawn by the CPU, llvmpipe, and a big window lags); the host's /dev/dri is passed to the run (bin/jumphp run). Even Mesa 25 on
# bookworm's LLVM 15 cannot compile for gfx1151 ("LLVM doesn't support gfx1151"): for those GPUs bin/jumphp run sets MESA_LOADER_DRIVER_OVERRIDE=zink
# (OpenGL over Vulkan: RADV does not use LLVM), hence mesa-vulkan-drivers
RUN echo "deb http://deb.debian.org/debian bookworm-backports main" > /etc/apt/sources.list.d/backports.list \
&& apt-get update \
&& apt-get install -y --no-install-recommends -t bookworm-backports libgl1-mesa-dri libglx-mesa0 libegl-mesa0 libgbm1 libglapi-mesa mesa-vulkan-drivers libvulkan1 \
&& rm -rf /var/lib/apt/lists/*
LABEL jumphp.rev="11"
RUN docker-php-ext-configure gd \
&& docker-php-ext-install -j"$(nproc)" gd bcmath pcntl zip
# docker/ext (named build context "ext"): the JumPHP patch of php-sdl (wheel, text input events)
COPY --from=ext php-sdl-events.patch /usr/src/php-sdl-events.patch
# the continuous music stream on SDL_mixer's output (JumPHP_StreamOpen...): the same functions as in the WebAssembly engine
COPY --from=ext php-sdl-mixer-stream.patch /usr/src/php-sdl-mixer-stream.patch
# fetch <repo> <ref> <dir>: one pinned commit, no history
RUN set -eux; \
fetch() { mkdir -p "$3" && cd "$3" && git init -q && git remote add origin "https://$1.git" \
&& git fetch -q --depth 1 origin "$2" && git checkout -q FETCH_HEAD; }; \
fetch git.jumphp.net/jumphp/php-sdl "$PHP_SDL_REF" /usr/src/ext-sdl; \
(cd /usr/src/ext-sdl && git apply /usr/src/php-sdl-events.patch); \
sed -i 's/zend_exception_get_default()/zend_ce_exception/g' /usr/src/ext-sdl/src/*.c /usr/src/ext-sdl/src/*.h; \
fetch github.com/kea/php-sdl-image "$SDL_IMAGE_REF" /usr/src/ext-sdl_image; \
fetch github.com/kea/php-sdl-mixer "$SDL_MIXER_REF" /usr/src/ext-sdl_mixer; \
(cd /usr/src/ext-sdl_mixer && git apply /usr/src/php-sdl-mixer-stream.patch); \
fetch github.com/kea/php-sdl-ttf "$SDL_TTF_REF" /usr/src/ext-sdl_ttf; \
build() { cd "$1" && phpize && ./configure $2 CFLAGS="-O2 -Werror=implicit-function-declaration" && make -j"$(nproc)" && make install; }; \
build /usr/src/ext-sdl --with-sdl; \
build /usr/src/ext-sdl_image --with-sdl_image; \
build /usr/src/ext-sdl_mixer --with-sdl_mixer; \
build /usr/src/ext-sdl_ttf --enable-sdl_ttf; \
docker-php-ext-enable sdl sdl_image sdl_mixer sdl_ttf; \
rm -rf /usr/src/ext-* /usr/src/php-sdl-events.patch /usr/src/php-sdl-mixer-stream.patch; \
php -m | grep -iE '^(sdl|sdl_image|sdl_mixer|sdl_ttf|gd)$'
# docker/ext (named build context "ext"): the JumPHP patch of PHP-OpenGL
COPY --from=ext php-opengl.patch /usr/src/php-opengl.patch
COPY --from=ext jumphp-xvfb /usr/local/bin/jumphp-xvfb
RUN set -eux; \
fetch() { mkdir -p "$3" && cd "$3" && git init -q && git remote add origin "https://$1.git" \
&& git fetch -q --depth 1 origin "$2" && git checkout -q FETCH_HEAD; }; \
fetch github.com/Ponup/php-opengl "$PHP_OPENGL_REF" /usr/src/ext-opengl; \
fetch github.com/Ponup/php-openal "$PHP_OPENAL_REF" /usr/src/ext-openal; \
cd /usr/src/ext-opengl && git apply /usr/src/php-opengl.patch; \
build() { cd "$1" && phpize && ./configure $2 CFLAGS="-O2 -Werror=implicit-function-declaration" && make -j"$(nproc)" && make install; }; \
build /usr/src/ext-opengl --with-opengl; \
build /usr/src/ext-openal --with-openal; \
docker-php-ext-enable opengl openal; \
rm -rf /usr/src/ext-* /usr/src/php-opengl.patch; \
php -m | grep -iE '^(opengl|openal)$'
# ext-cryo (docker/ext/cryo): the same extension as in the browser engine (snapshots, CryoReader, freeze / thaw,
# restart, fork pool, sandboxes, Cryo\Engine, metrics)
COPY --from=ext cryo /usr/src/ext-cryo
RUN set -eux; \
cd /usr/src/ext-cryo && phpize && ./configure --enable-cryo CFLAGS="-O2 -Werror=implicit-function-declaration" \
&& make -j"$(nproc)" && make install && docker-php-ext-enable cryo; \
rm -rf /usr/src/ext-cryo; \
php -m | grep -i '^cryo$'
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
# same limits as the browser build would hit first: keep the desktop honest
RUN { echo 'memory_limit=512M'; echo 'error_reporting=E_ALL'; echo 'display_errors=stderr'; } \
> /usr/local/etc/php/conf.d/zz-jumphp.ini
ENV COMPOSER_HOME=/tmp/composer \
COMPOSER_CACHE_DIR=/tmp/composer-cache \
JUMPHP_PLATFORM=desktop
WORKDIR /game
CMD ["php", "app.php"]