Nginx configuration for a wordpress blog in a subfolder of magento root

Nginx configuration for a wordpress blog in a subfolder of magento root

September 24, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Nginx configuration for a wordpress blog in a subfolder of magento root

Solving Nginx Configuration for WordPress Blog in Magento Subfolder

When integrating WordPress with your existing Magento store using a subdirectory setup, you may encounter challenges configuring the Nginx server block to accommodate both systems. This is a common issue that arises when trying to create multiple sites within the same environment.

Understanding Your Current Setup

In your current configuration, WordPress is installed in a subfolder named wp, which can be accessed at http://example.com/wp. You’ve also set up additional sites in this subfolder’s structure, such as Spanish (ca) and English (en) versions of the blog.

Analyzing Your Nginx Configuration

Let’s break down your existing Nginx configuration to understand what’s currently happening:

WordPress Location Block

location ^~ /wp {
    index index.php index.html index.htm;
    try_files $uri $uri/ /wp/index.php?q=$uri&$args;

    # Multisite
    if (!-e $request_filename) {
        rewrite /wp-admin$ $scheme://$host$uri/ permanent;
        rewrite ^/wp(/[^/]+)?(/wp-.*) /wp$2 last;
        rewrite ^/wp(/[^/]+)?(/.*\.php)$ /wp$2 last;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        fastcgi_pass 127.0.0.1:9000;
    }
}

This section is designed to handle WordPress requests within the wp subdirectory. It tries to serve static files first and then passes any requests that can’t be served to the PHP handler.

Magento Site Configuration

The configuration includes a snippet, snippets.d/magento-site, which handles Magento’s front-end processing:

location / {
    index       index.php;
    try_files   $uri $uri/ @handler;
    expires     30d;-
}

# ... (other location blocks)

This block is responsible for serving static content and routing requests to the index.php file, which then handles Magento’s front-end logic.

The Challenge: Multiple Sites in a Subdirectory

The main issue here lies in Nginx’s configuration for multiple sites within the same subfolder (wp). Currently, your rewrite rules are not properly handling the nested directory structure (i.e., ca and en) for each site.

Correcting Your Configuration

To resolve this issue, you need to modify your location block to properly handle requests for each specific site. Here’s an example of how to update your configuration:

server {
    server_name dev.example.com;
    access_log /var/log/nginx/example.access.log;
    error_log /var/log/nginx/example.error.log;
    root /var/www/example;

    location ^~ /wp {
        index index.php index.html index.htm;
        try_files $uri $uri/ /wp/index.php?q=$uri&$args;

        # Multisite
        if (!-e $request_filename) {
            rewrite ^/wp(/[^/]+)?(/wp-.*) /wp$2 last; 
            rewrite ^/wp(/[^/]+)?(/.*\.php)$ /wp$2 last;
        }

        location ~ \.php$ {
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME $request_filename;
            fastcgi_pass 127.0.0.1:9000;
        }
    }

    # Add this for each additional site in the subdirectory
    location ^~ /wp/ca {
        index index.php index.html index.htm;
        try_files $uri $uri/ /wp/ca/index.php?q=$uri&$args;

        # Multisite rules specific to 'ca'
        if (!-e $request_filename) {
            rewrite ^/wp/ca(/[^/]+)?(/wp-.*) /wp/ca$2 last;
            rewrite ^/wp/ca(/[^/]+)?(/.*\.php)$ /wp/ca$2 last;
        }

        location ~ \.php$ {
            # ... (remaining PHP handling remains the same)
        }
    }

    set             $mage_developer true;
    set             $mage_code es;
    set             $mage_type store;
    include         snippets.d/magento-site;-
}

In this updated configuration, I added a new location block for each additional site (in this case, Spanish ca) within the WordPress subdirectory. This block is designed to handle requests specific to that site.

Conclusion

When dealing with multiple sites in a subdirectory while using Nginx and Magento or other PHP-based systems, it’s crucial to properly configure your server blocks to handle each site individually. By creating dedicated location blocks for each site within the shared directory (wp), you ensure that requests are routed correctly based on the site-specific structure.

Remember, the key lies in understanding how Nginx processes requests and ensuring your configuration accurately maps URLs to the correct PHP handler or static files.

For more detailed guides on Nginx configuration with Magento, check out our comprehensive blog post at Laravel Company. This resource provides in-depth insights into optimizing your Nginx setup for improved performance and security.

Indexing Admin Configuration Errors

Our network