Skip to content

Modernize mod_php installation guide - #5743

Open
rbowen wants to merge 1 commit into
php:masterfrom
rbowen:apache-httpd-doc
Open

Modernize mod_php installation guide#5743
rbowen wants to merge 1 commit 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
2.x installs of PHP on Linux and Unix-like systems.
</para>

&warn.apache2.compat;

@lacatoire lacatoire Aug 7, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

warn.apache2.compat is used only here, so if you delete this one, you should remove it from the language-snippets.ent.
But by deleting this entity, you will delete the lonely linkend="faq.installation.apache2" of all the doc, making this page an orphan. So maybe you could reference this link somewhere in your parapgraph.

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.

2 participants