Nginx: Serve multiple Laravel apps with same url but two different sub locations in Linux

During one of the deployment on linux server, I came across some sort of your challenge. It was as follow

  • <base_url> : One Laravel project needs to served on this.
  • <base_url>/<sub_url> : Another Laravel project needs to be served on this.

Of course this can be extended to any number of Laravel projects which follows <base_url>/<unique_sub_url> concept.

Now let’s dive into actual implementation

# Nginx.conf
# App 1(Path: /var/www/html/app1, Url: http://www.mywebsite.com)
# App 2(Path: /var/www/html/app2, Url: http://www.mywebsite.com/app2)
server {
    # Listing port and host address
    # If 443, make sure to include ssl configuration for the same.
    listen 80; 
    listen [::]:80;

    server_name www.mywebsite.com;

    # Default index pages
    index index.php;

    # Root for / project
    root /var/www/html/app1/public;

    # Handle main root / project
    location / {
        #deny all;
        try_files $uri $uri/ /index.php?$args;
    }

    # Handle app2 project, just replicate this section for further projects app3, app4 
    # by just replacing app2 with appropriate tag(app3/app4)
    location /app2 {
        # Root for this project
        root /var/www/html/app2/public;

        # Rewrite $uri=/app2/xyz back to just $uri=/xyz
        rewrite ^/app2/(.*)$ /$1 break;

        # Try to send static file at $url or $uri/
        # Else try /index.php (which will hit location ~\.php$ below)
        try_files $uri $uri/ /index.php?$args;
    }

    # Handle all locations *.php files (which will always be just /index.php)
    # via factcgi PHP-FPM unix socket
    location ~ \.php$ {
        # At this point, $uri is /index.php, $args=any GET ?key=value and $request_uri = /app2/xyz.
        # But we don't want to pass /app2/xyz to PHP-FPM, we want just /xyz to pass to fastcgi REQUESTE_URI below. 
        # This allows laravel to see /app2/xyz as just /xyz in its router.  
        # So laravel route('/xyz') responds to /app2/xyz as you would expect.
        set $newurl $request_uri;
        if ($newurl ~ ^/app2(.*)$) {
                set $newurl $1;
                root /var/www/html/app2/public;
        }

        # Pass all PHP files to fastcgi php fpm unix socket
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        # Use php fpm sock which is installed on your machine like php7.2, php5.6
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock; 
        fastcgi_index index.php;
        include fastcgi_params;
        # Here we are telling php fpm to use updated route that we've created to properly
        # response to laravel routes.
        fastcgi_param REQUEST_URI $newurl;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
    }

    # Deny .ht* access
    location ~ /\.ht {
        deny all;
    }
}

Note: When we’re using session based laravel setup, all the route generator functions(url(), route()) use hostname www.mywebsite.com as root url, not www.mywebsite.com/app2. To resolve this issue please do following changes in laravel app.

  1. Define APP_URL in .env file as APP_URL="www.mywebsite.com/app2"
  2. Go to RouteServiceProvider which is located at app/Providers/RouteServiceProvider and force laravel to use APP_URL as root url for your app.
public function boot()
{
    parent::boot();
    // Add following lines to force laravel to use APP_URL as root url for the app.
    $strBaseURL = $this->app['url'];
    $strBaseURL->forceRootUrl(config('app.url'));
}

Update: Make sure to run php artisan config:clear or php artisan config:cache command to load the updated value of APP_URL.

For windows: Multiple Laravel Applications Using Nginx – Windows

Leave a Comment