14

I can't notice any difference if in my config file I set

 fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;

Or:

 fastcgi_param  SCRIPT_FILENAME    $request_filename;

What do they do respectively? Is one of the two better than the other?

Thanks in advance.

24

Here's what the documentation says:

$request_filename

This variable is equal to path to the file for the current request, formed from directives root or alias and URI request;

$document_root

This variable is equal to the value of directive root for the current request;

$fastcgi_script_name

This variable is equal to the URI request or, if if the URI concludes with a forward slash, then the URI request plus the name of the index file given by fastcgi_index. It is possible to use this variable in place of both SCRIPT_FILENAME and PATH_TRANSLATED, utilized, in particular, for determining the name of the script in PHP.

As written here, there's at least a difference when using fastcgi_index or fastcgi_split_path_info. Maybe there are more ... that's what I know of right now.

Example

You get the request /info/ and have the following configuration:

fastcgi_index  index.php;
fastcgi_param  SCRIPT_FILENAME  /home/www/scripts/php$fastcgi_script_name;

SCRIPT_FILENAME would equal /home/www/scripts/php/info/index.php, but using $request_filename it would just be /home/www/scripts/php/info/.

The configuration of fastcgi_split_path_info is important as well. See here for further help: http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_split_path_info

  • This doesn't seem to be true (not anymore, at least). See the answer by Steely Wing. – Rimas Kudelis Sep 5 '18 at 19:38
  • @RimasKudelis I haven't used this in quite a while, but the documentation hasn't changed, so I expect it still to work - maybe your fastcgi_split_path_info needs a tweak. The answer by Steely Wing seems to be sorely based on experience, not on the documentation. – SimonSimCity Sep 6 '18 at 6:23
  • yes, and my comment is also based on experience. I tried adjusting fastcgi_split_path_info to exclude my alias prefix by putting it outside the two captures, but it didn't seem to have any effect. Whereas passing $request_filename as SCRIPT_FILENAME works like a charm, regardless of whether or not an alias is involved. – Rimas Kudelis Sep 7 '18 at 19:38
  • Actually, I can't understand why NginX documentation even suggests to concatenate two strings to form SCRIPT_FILENAME in the first place, when $request_filename contains the actual file name resolved, without any extras appended. The example above is actually incorrect, since $request_filename in fact does contain a file name as opposed to just a path, even when that file was not requested explicitly. At least that's my conclusion as of yesterday. – Rimas Kudelis Sep 7 '18 at 19:47
4

If you using root directive

$document_root$fastcgi_script_name is equal to $request_filename.

If you use alias directive

$document_root$fastcgi_script_name will return the wrong path.

Example

If you have config

location /api/ {
    index  index.php index.html index.htm;
    alias /app/www/;
    location ~* "\.php$" {
        try_files      $uri =404;
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        # fastcgi_param  SCRIPT_FILENAME  $request_filename;
    }
}

Request /api/testing.php:

  • $document_root$fastcgi_script_name == /app/www//api/testing.php
  • $request_filename == /app/www/testing.php

Request /api/:

  • $document_root$fastcgi_script_name == /app/www//api/index.php
  • $request_filename == /app/www/index.php

And if you use $request_filename, you should set index using index directive, fastcgi_index will not work.

TLDR

I recommended use $request_filename for SCRIPT_FILENAME.

2

I guess those lines were taken from the 'fastcgi_params' file..

Basically you are not getting any errors when it comes to SCRIPT_FILENAME because it's already defined when you defined your root directive in your vhost file. So unless you defined it explicitly in your vhost file using fastcgi_param the value of SCRIPT_FILENAME would be taken from the root directive.. But ONE IMPORTANT POINT HERE. There is another variable that nginx needs in order to send the requests to the php server which is $fastcgi_script_name and you have to define it well in order to avoid repetitive URLs and errors with uri's that end with slash.

Conclusion:

To make everything work super nice, everyone should define SCRIPT_FILENAME explicitly either in 'fastcgi_params' file located in /etc/nginx folder or easily in the vhost of your site located in sites-available folder by including the following line in the php location block:

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

or included in the 'fastcgi_params' file as you wrote above, either way it's the same.. For more info for connecting ngnix to PHP-FPM go to:

https://www.nginx.com/resources/wiki/start/topics/examples/phpfcgi/

I hope it would help anyone in the future 'cuz it took me a lot of time to figure it out..

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.