Skip to content

Add the bundled System V IPC extensions - #268

Merged
csandanov merged 1 commit into
masterfrom
feature/sysv-ipc-extensions
Nov 9, 2026
Merged

csandanov merged 1 commit into
masterfrom
feature/sysv-ipc-extensions

Conversation

@csandanov

Copy link
Copy Markdown
Member

Problem

Nextcloud running on these images warns that the sysvsem PHP module is missing. Without it, Nextcloud cannot limit how many image previews it generates at the same time, so a burst of preview requests can use far more CPU and memory than intended. Users cannot add the module themselves.

Cause

The module ships with PHP itself, but the images never turned it on. Production images remove the PHP source code and build tools at the end of the build, so a derived image has nothing to compile it from.

Solution

The PHP 8 images now include sysvsem along with its two companion modules, sysvshm (shared memory) and sysvmsg (message queues). These let PHP processes in the same container coordinate with each other. Debian and Ubuntu PHP packages enable all three by default, so applications tested there will find them here too. They need no extra system libraries and add about 200 KB to the image. Nothing changes for applications that don't use them.

Closes #267

Changes

  • 8/Dockerfile: add sysvmsg, sysvsem, and sysvshm to the bundled docker-php-ext-install list for PHP 8.2–8.5.
  • 8/tests/php_modules/*: expect the three modules.
  • 8/tests/functional/local.php: functional checks for a message queue round trip, a single-holder semaphore that refuses a second holder, and a shared memory write and read.
  • README.md, 8/tests/README.md: list the modules and the new checks.

Validation

  • Built 8.5 production (arm64) locally. php -m lists all three modules, and each .so is 66 KB after stripping.
  • make test against that image passed, including the module list comparison and the new sysvmsg, sysvsem, and sysvshm functional checks.
  • The other PHP versions, amd64, and the dev variants were not built locally. CI covers them.

Follow-up

A new image revision tag is needed after merge to publish the change.

Enable sysvsem, sysvshm, and sysvmsg in the PHP 8 images. They ship with PHP and need no extra libraries. Production images remove the PHP sources and build tools, so they cannot be added downstream.

Nextcloud uses sysvsem to limit concurrent preview generation and warns when it is missing. Debian and Ubuntu PHP packages enable all three by default.

Add them to the expected module lists and add functional checks for a message round trip, an exclusive semaphore, and shared memory.
@csandanov
csandanov merged commit 21ec0e9 into master Nov 9, 2026
36 checks passed
@csandanov
csandanov deleted the feature/sysv-ipc-extensions branch November 9, 2026 16:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add the bundled sysvsem extension to the PHP 8 images

1 participant