Skip to content

docs: add migration guide#2275

Open
alexandre-daubois wants to merge 1 commit intophp:mainfrom
alexandre-daubois:migrate-guide
Open

docs: add migration guide#2275
alexandre-daubois wants to merge 1 commit intophp:mainfrom
alexandre-daubois:migrate-guide

Conversation

@alexandre-daubois
Copy link
Member

People at conferences often come by and ask how it is to migrate from FPM to FrankenPHP.

I think that a page "Migrating from..." would be very reassuring for newcomers. It only covers simple cases, but most complex ones can be handled by LLMs if necessary.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds a new migration guide (docs/migrate.md) to help users transitioning from a traditional PHP-FPM + Nginx/Apache setup to FrankenPHP. The guide is structured as a step-by-step walkthrough covering web server config replacement, PHP configuration, pool/thread sizing, Docker migration, and optional worker mode.

Changes:

  • Added a comprehensive migration guide with side-by-side comparisons of PHP-FPM and FrankenPHP configurations
  • Covers 5 migration steps: web server config, PHP config, pool size, Docker, and worker mode
  • Includes a summary of components that can be removed after migration

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@alexandre-daubois alexandre-daubois force-pushed the migrate-guide branch 2 times, most recently from 689d018 to 8d7ec3d Compare March 13, 2026 08:35
Copy link
Contributor

@henderkes henderkes left a comment

Choose a reason for hiding this comment

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

last one, rest is good for me

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.

6 participants