Skip to content

Modernize mod_php/Apache httpd installation guide - #5743

Open
rbowen wants to merge 3 commits into
php:masterfrom
rbowen:apache-httpd-doc
Open

Modernize mod_php/Apache httpd installation guide#5743
rbowen wants to merge 3 commits into
php:masterfrom
rbowen:apache-httpd-doc

Conversation

@rbowen

@rbowen rbowen commented Aug 7, 2026

Copy link
Copy Markdown
  • Add warning: mod_php should not be used for new installations; recommend PHP-FPM with mod_proxy_fcgi for all modern deployments
  • Remove all Apache 2.2 references (EOL since 2017)
  • Remove PHP 7 LoadModule example (EOL)
  • Correct MPM guidance: event is the default since 2.4, prefork is only needed for mod_php without ZTS
  • Note that major distributions already default to PHP-FPM
  • Use correct project name (Apache httpd) throughout

- Add warning: mod_php should not be used for new installations;
  recommend PHP-FPM with mod_proxy_fcgi for all modern deployments
- Remove all Apache 2.2 references (EOL since 2017)
- Remove PHP 7 LoadModule example (EOL)
- Correct MPM guidance: event is the default since 2.4, prefork
  is only needed for mod_php without ZTS
- Note that major distributions already default to PHP-FPM
- Use correct project name (Apache httpd) throughout
@rbowen

rbowen commented Aug 7, 2026

Copy link
Copy Markdown
Author

FWIW, I used to be a php docs committer. I might still be. But it's been ... well, a long time, since I did any thing here, so likely the record has been purged. I've been meaning to do this for a very long time.

Comment thread install/unix/apache2.xml
@rbowen rbowen changed the title Modernize mod_php installation guide Modernize mod_php/Apache httpd installation guide Aug 7, 2026
@rbowen

rbowen commented Aug 7, 2026

Copy link
Copy Markdown
Author

Clearly, I've forgotten some details about editing the docs. Addressing DocBook errors.

@rbowen

rbowen commented Aug 7, 2026

Copy link
Copy Markdown
Author

FWIW, php doc-base/configure.php ran clean before I made these changes, so I'm a little confused by the error, but here's hoping ...

@hmochhabber-cmd hmochhabber-cmd left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

appendices/migration85.xml

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.

3 participants