Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
Wordpress

WordPress: Fix Permalinks 404ing After Switching PHP Versions

- 16.11.26 - ErcanOPAK

📝 WordPress: Fix Permalinks 404ing After Switching PHP Versions

Pretty permalinks depend on the web server correctly rewriting every request to index.php, and on many managed hosts that rewrite logic is tied to a specific PHP-FPM pool socket baked into the vhost configuration. Switching a site’s PHP version from the hosting control panel can silently leave the web server’s own config pointed at the old PHP-FPM socket – the panel updates its displayed version label, but nothing forces the underlying fastcgi_pass or proxy directive to follow – so PHP itself keeps running fine while every URL except the literal homepage starts returning a 404.

🔎 The Problem

# vhost before the PHP version switch
fastcgi_pass unix:/run/php/php7.4-fpm.sock;

# vhost after switching PHP version in the hosting control panel
# (the panel updated its displayed version label, not this line)
fastcgi_pass unix:/run/php/php7.4-fpm.sock;   # still the old socket

# php8.3-fpm pool is now running; the php7.4-fpm socket is gone ->
# every rewritten URL (anything but the literal homepage) -> 404

✅ Fix: Resave Permalinks and Confirm the Socket Actually Changed

  • After changing the PHP version, go to Settings > Permalinks in wp-admin and click Save without changing anything – this forces WordPress to regenerate its rewrite rules against the currently active PHP handler.
  • If the host manages the web server config outside wp-admin, check that its fastcgi_pass or proxy_pass socket path actually points at the new PHP version’s socket, not just that the panel’s version label changed.
  • Clear any full-page cache after resaving permalinks, since a cached 404 response for a URL can keep being served even after the rewrite rule itself is fixed.

🚨 Why This Is Dangerous

  • Assuming a PHP version switch only affects execution speed, not rewrite routing, can leave a site silently 404ing on every post and page for hours while both visitors and search crawlers hit the broken URLs.

A PHP version switch moves which socket serves your site – if nothing told the web server’s rewrite rules, they’re still pointed at the one that’s gone.

— WordPress Admin

Related posts:

WordPress: Recover a Site After an Auto-Update Breaks the Admin Dashboard

WordPress: Recover a Site After an Auto-Update Breaks the Admin Dashboard

WordPress: Fix a Custom Gutenberg Block Losing Its Saved Attributes After a Plugin Update Because th...

WordPress: Fix a Custom Gutenberg Block Losing Its Saved Attributes After a Plugin Update Because th...

WordPress: Fix a Block Theme's theme.json Settings That Get Replaced Instead of Merged Because the C...

WordPress: Fix a Block Theme's theme.json Settings That Get Replaced Instead of Merged Because the C...

Views: 2

Post navigation

The AI Prompt That Finds Every Caller Broken by a Signature Change
Git: Fix git blame Naming the Wrong Author After Autosquash

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (607)
  • Average of all values in a column that are not zero in SQL (569)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (546)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com