php / php/php-src

Building `--with-fpm` without `--prefix` adds `NONE` to include path in `php-fpm.conf.default`

Open
#20,845 4 comments 0 reactions 1 assignee View on GitHub

@bukka is already working on this.

Since Jan 6, 2026.

Bug Category: Build System SAPI: fpm Status: Needs Triage
Dominant language
C
Stars
40.4k
Forks
8.1k
Avg merge
2d 13h
Merged PRs (30d)
96

Description

Description

There's a small bug while building php-fpm, but with no prefix definition. After build process you get an /usr/local/etc/php-fpm.conf.default, but the include path is wrong;

# current
include=NONE/etc/php-fpm.d/*.conf

# should
include=/usr/local/etc/php-fpm.d/*.conf

To solve this, you can simply run ./configure with --prefix=/usr/local flag.

I searched a bit in the code & think there's a missing default setting in C, but I'm too stupid for that language :-) Found out following lines of code, may this will help a bit for faster debugging :-)
https://github.com/php/php-src/blob/master/sapi/fpm/php-fpm.conf.in#L142
https://github.com/php/php-src/blob/master/sapi/fpm/config.m4#L502
https://github.com/php/php-src/blob/master/main/build-defs.h.in#L28

PS: There's an old workaround in current official docker images for that, seems they were too frustrated a) trying a rebuild with prefix flag & b) opening an issue :D
https://github.com/docker-library/php/blob/master/8.5/alpine3.23/fpm/Dockerfile#L211
PS²: Is it possible to generate the config-files without ´.default` suffix? :)

PHP Version
even before php8 era
Operating System

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.