Setting Permalinks in WordPress is simple and flexible. Core WordPress checks to see if the Apache mod_rewrite module is loaded before fully enabling permalinks. If that check fails then it includes index.php in your permalink structure in order to make sure that WordPress still gets a chance to process URLs.
Servers using Nginx are able to do URL rewriting, but the check still fails, leaving index.php in the permalink. Fortunately a few lines of PHP in a plugin (I like to put it in wp-content/mu-plugins/nginx.php) can fix that:
add_filter( 'got_rewrite', 'nginx_has_rewrite', 999 );
function nginx_has_rewrite( $got_rewrite ) {
return TRUE;
}
Those few lines of PHP will tell WordPress that full URL rewriting is available on the server, so no more index.php in the permalink structure.
Before adding this make sure that you’ve already setup URL rewriting in your Nginx configuration.
Update: In the comments Sivel mentioned another alternative:
add_filter( 'got_rewrite', '__return_true', 999 );
The __return_true function was added during WP 3.0 development for exactly these sorts of things, where you want to just return TRUE for a filter. I like it.
There’s already a plugin that does this: http://wordpress.org/extend/plugins/nginx-compatibility/
Ah, good to see.
You can reduce that a little by using the following instead:
add_filter( ‘got_rewrite’, ‘__return_true’, 999 );
I like that!
You have curly quotes in your copy of Matt’s code. ;)
Ah, I need to beware of copy and paste results :-)
Nice catch, fixed.
I use nginx on my server, and I’ve never had this problem with permalinks.
I saw someone else mention this, it may be something that happened as part of the 3.0 development cycle.
You are correct, this something that was introduced as part of the 3.0 development cycle when bringing in WPMu. If you never touch your permalink structure after the upgrade to 3.0 you should be fine, but without adding this code it could introduce index.php into your permlaink structure.
That’s consistent with what I’ve seen so far.
Me too never had problem with this.
I am running 2 big MU’s with domain mapping and most blogs have their own permalink structure.
But with reference to other comments, if this is an issue with 3.0, thanks a lot Joseph in advance
I simply comment out line 92 and 93 in the wp-admin\options-permalink.php file
if ( ! got_mod_rewrite() && ! $iis7_permalinks )
$prefix = ‘/index.php’;
I strongly recommend NOT editing core WP files, too easy to loose or trash your changes during an upgrade.
In my WordPress was a some modification, and if core wordpress upgrade, I merge the upgrade to my SVN repo.
So I don’t loose this modification :)
I didn’t say it was impossible to keep them, but it is much less likely. If it can be done via a plugin it should be done via a plugin (in most cases).
Pingback: WordPress Pretty Permalinks with Nginx | Daniel Bachhuber's weblog
Thanks so much for this.