mirror of
https://github.com/NixOS/nixpkgs.git
synced 2024-12-25 03:17:13 +00:00
178ec8974f
By default in Nginx, if you want to override a single fastcgi_param, you have to override all of them. This is less of a big deal if you're editing the Nginx configuration directly, but when you're generating the Nginx configuration with Nix it can be very annoying to bloat your configuration repeating the default values of FastCGI parameters every time. This patch adds a fastcgiParams option to Nginx locations. If any parameters are set through this, all the default values will be included as well, so only the ones that are changing need to be supplied. There's no way to use fastcgiParams to actually override all parameters if that's what you want, but I think that's a niche use case and it's still possible using extraConfig, which up until now was the only option Nginx allows the fastcgi_param directive in http and server scopes as well as location, but here I only support location. It would be possible to support the others, but I don't think it's worth it. It would be a possible future enhancement if somebody has a need for it.
133 lines
3.3 KiB
Nix
133 lines
3.3 KiB
Nix
# This file defines the options that can be used both for the Nginx
|
|
# main server configuration, and for the virtual hosts. (The latter
|
|
# has additional options that affect the web server as a whole, like
|
|
# the user/group to run under.)
|
|
|
|
{ lib }:
|
|
|
|
with lib;
|
|
|
|
{
|
|
options = {
|
|
basicAuth = mkOption {
|
|
type = types.attrsOf types.str;
|
|
default = {};
|
|
example = literalExample ''
|
|
{
|
|
user = "password";
|
|
};
|
|
'';
|
|
description = ''
|
|
Basic Auth protection for a vhost.
|
|
|
|
WARNING: This is implemented to store the password in plain text in the
|
|
Nix store.
|
|
'';
|
|
};
|
|
|
|
basicAuthFile = mkOption {
|
|
type = types.nullOr types.path;
|
|
default = null;
|
|
description = ''
|
|
Basic Auth password file for a vhost.
|
|
Can be created via: <command>htpasswd -c <filename> <username></command>.
|
|
|
|
WARNING: The generate file contains the users' passwords in a
|
|
non-cryptographically-securely hashed way.
|
|
'';
|
|
};
|
|
|
|
proxyPass = mkOption {
|
|
type = types.nullOr types.str;
|
|
default = null;
|
|
example = "http://www.example.org/";
|
|
description = ''
|
|
Adds proxy_pass directive and sets recommended proxy headers if
|
|
recommendedProxySettings is enabled.
|
|
'';
|
|
};
|
|
|
|
proxyWebsockets = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
example = true;
|
|
description = ''
|
|
Whether to supporty proxying websocket connections with HTTP/1.1.
|
|
'';
|
|
};
|
|
|
|
index = mkOption {
|
|
type = types.nullOr types.str;
|
|
default = null;
|
|
example = "index.php index.html";
|
|
description = ''
|
|
Adds index directive.
|
|
'';
|
|
};
|
|
|
|
tryFiles = mkOption {
|
|
type = types.nullOr types.str;
|
|
default = null;
|
|
example = "$uri =404";
|
|
description = ''
|
|
Adds try_files directive.
|
|
'';
|
|
};
|
|
|
|
root = mkOption {
|
|
type = types.nullOr types.path;
|
|
default = null;
|
|
example = "/your/root/directory";
|
|
description = ''
|
|
Root directory for requests.
|
|
'';
|
|
};
|
|
|
|
alias = mkOption {
|
|
type = types.nullOr types.path;
|
|
default = null;
|
|
example = "/your/alias/directory";
|
|
description = ''
|
|
Alias directory for requests.
|
|
'';
|
|
};
|
|
|
|
return = mkOption {
|
|
type = types.nullOr types.str;
|
|
default = null;
|
|
example = "301 http://example.com$request_uri";
|
|
description = ''
|
|
Adds a return directive, for e.g. redirections.
|
|
'';
|
|
};
|
|
|
|
fastcgiParams = mkOption {
|
|
type = types.attrsOf types.str;
|
|
default = {};
|
|
description = ''
|
|
FastCGI parameters to override. Unlike in the Nginx
|
|
configuration file, overriding only some default parameters
|
|
won't unset the default values for other parameters.
|
|
'';
|
|
};
|
|
|
|
extraConfig = mkOption {
|
|
type = types.lines;
|
|
default = "";
|
|
description = ''
|
|
These lines go to the end of the location verbatim.
|
|
'';
|
|
};
|
|
|
|
priority = mkOption {
|
|
type = types.int;
|
|
default = 1000;
|
|
description = ''
|
|
Order of this location block in relation to the others in the vhost.
|
|
The semantics are the same as with `lib.mkOrder`. Smaller values have
|
|
a greater priority.
|
|
'';
|
|
};
|
|
};
|
|
}
|