Основы синтаксиса

Файл настройки сервера nginx обычно назвается так:

/etc/nginx/nginx.conf

Директивы

Файл состоит из настроечных директив. Каждая директива должна размещаться в отдельной строке. Текст директивы должен завершаться точкой с запятой. В качестве разделителя между элементами директивы можно использовать пробел или знак табуляции. Директива выглядит так:

ИмяДирективы Значение [Значение2] [Значение3...];

Пример директив:

root /var/www;

index index.html index.htm;

fastcgi_param SCRIPT_FILENAME /var/www/index.php;

Блоки

Директивы объединяются в блоки настройки. Эти настроечные блоки могут следовать друг за другом, или могут быть вложены друг в друга. Блок выглядит так:

Заголовок Блока {

...
}

В файле nginx.conf есть главный блок, который явно никак не обозначен. Он расположен от начала файла nginx.conf и до его конца. Все блоки, описанные в nginx.conf являются подблоками главного блока. Все директивы, не относящиеся к подблокам, являются директивами главного блока.

Пример файла nginx.conf:

user www-data;

worker_processes 1;

events {

worker_connections 1024;

}

http {

include /etc/nginx/mime.types;

default_type application/octet-stream;

server {

listen 80;

server_name localhost;

}

}

В этом примере директивы user и worker_processes являются директивами главного блока. Блоки events и http являются подблоками главного блока. Блок server является подблоком блока http.

Включение текста других файлов

Файл настройки может "собираться" из нескольких файлов, которые подключаются через директиву include. В качестве параметра этой директивы можно указывать как конкретный файл, так и группу файлов с помощью файловой маски. В случае указания маски, файлы будут подключены в последовательности, в которой они были бы перечислены, еслиб для поиска использовалась bash-команда find.

Примеры:

include /etc/nginx/fastcgi_params;

include /etc/nginx/conf.d/*.conf;

include /etc/nginx/sites-enabled/*;

О директиве include следует думать так: на место, где прописана директива include вставляется текст файла (файлов), указаного в этой директиве.

Комментарии

Комментарии в тексте конфигурационного файла обозначаются с помощью символа решетки "#". Все, что следует правее этого символа до конца строки, считается комментарием, и пропускается парсером nginx.

Пример:

# Настройка параметров FastCGI

fastcgi_pass 127.0.0.1:9000; # Адрес и порт FastCGI сервиса