nginx

Что такое nginx, знает, пожалуй, каждый web-разработчик. Если же вы только начинаете осваивать азы web-строительства, то более подробную информацию об использовании nginx вы можете почитать на сайте разработчика этого продукта. Существует несколько разных способов использования этого продукта, но сегодня я остановлюсь лишь на том, как установить этот сервер в вашу систему и настроить для работы с установленным ранее PHP+FPM.

Для начала необходимо скачать исходные тексты nginx. Их можно получить на сайте сервера, скачав архив с необходимой вам версией (в тексте рассматриваются примеры с версией nginx-0.7.62)

Распакуйте архив и, используя терминал, перейдите в директорию с исходными текстами. Для получения списка опций сборки, используйте команду

После того, как вы определитесь с опциями, сконфигурируйте пакте для сборки. Я, как указывал в одном из предыдущих руководств, устанавливаю пакеты для web-разработки в директорию /usr/local, и конфигурировал nginx с такими опциями:

Теперь запускаем сборку:

и установку

Как и раньше, для последующего удобства, делаем ссылку на установленный сервер:

Ну а теперь запускаем сервер:

Важно: по умолчанию nginx настроен на работу с 80-м портом, поэтому если у вас запущен встроенный в Leopard сервер Apache, nginx не запустится и выдаст ошибку. Поэтому предварительно убедитесь, что Apache выключен: это можно сделать запустив программу "Системные настройки" а затем, перейдя в раздел "Общий доступ", снять включение с сервиса "Общий веб-доступ".

Если вы не получили никакого уведомления об ошибке, и встроенный Apache у вас выключен, то nginx, вероятнее всего, нормально запустился. Теперь в любом браузере наберите адрес http://localhost и на экране появится приветствие, сообщающее о том, что nginx был благополучно запущен.

Если же вам требуется остановить сервер, то выполните в терминале команду

Для того, чтобы научить nginx работать с установленным ранее PHP+FPM, придётся выполнить несколько дополнительных шагов:

• создать в файловой директорию, в которой будет расположен ваш сайт
• внести изменения в файл настроек nginx
• запустить PHP+FPM
• перезапустить nginx

Теперь по порядку.
Для примера я буду использовать директорию /usr/local/site, но вы можете указать другой путь. Главное, не забудьте отредактировать указанные мною примеры, чтобы они соответствовали вашим реальным данным.
Итак, создайте директорию для сайта, и положите туда какой-нибудь php-файл (например, index.php который выведет на экран phpinfo(); )
Отредактируйте файл настроек nginx (/usr/local/nginx/conf/nginx.conf) поместив в него следующее содержимое:

user www;
worker_processes  1;
 
pid        /var/run/nginx.pid;
 
events {
    worker_connections  1024;
    use kqueue;
}
 
http {
    include       mime.types;
    default_type  text/html;
 
    keepalive_timeout                 65;
    client_header_timeout       3m;
    client_body_timeout         3m;
    send_timeout                3m;
    client_header_buffer_size   1k;
    large_client_header_buffers 4 4k;
    output_buffers              4 128k;
    postpone_output             1460;
    sendfile                    on;
    tcp_nodelay                 on;
    tcp_nopush                  on;
    send_lowat                  12000;
    gzip                        on;
    gzip_min_length             1100;
    gzip_buffers                4 8k;
    gzip_types                  text/plain;
    proxy_redirect      off;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    client_max_body_size 10M;
    client_body_buffer_size 512k;
    client_body_temp_path /tmp/client_body_temp;
    proxy_connect_timeout       180;
    proxy_send_timeout  180;
    proxy_read_timeout  180;
    proxy_send_lowat    12000;
    proxy_buffer_size   64k;
    proxy_buffers               4 128k;
    proxy_busy_buffers_size 256k;
    proxy_temp_file_write_size 256k;
    proxy_temp_path /tmp/proxy_temp;
 
     server {
          listen       80;
          server_name  localhost;
          index        index.php;
          root         /usr/local/site;
 
          location ~ \.php$ {
 
               fastcgi_pass  127.0.0.1:9000;
               fastcgi_index index.php;
               fastcgi_param SCRIPT_NAME $fastcgi_script_name;
               fastcgi_param REQUEST_URI $request_uri;
               fastcgi_param DOCUMENT_URI $document_uri;
               fastcgi_param DOCUMENT_ROOT $document_root;
               fastcgi_param REMOTE_ADDR $remote_addr;
               fastcgi_param REMOTE_PORT $remote_port;
               fastcgi_param SERVER_ADDR $server_addr;
               fastcgi_param SERVER_PORT $server_port;
               fastcgi_param SERVER_NAME $server_name;
               fastcgi_param SCRIPT_FILENAME  /usr/local/site$fastcgi_script_name;
               fastcgi_param QUERY_STRING $query_string;
               fastcgi_param REQUEST_METHOD $request_method;
               fastcgi_param CONTENT_TYPE $content_type;
               fastcgi_param PATH_INFO $request_uri;
               fastcgi_param CONTENT_LENGTH $content_length;
          }
     }
}

Теперь, если у вас не запущен PHP, запустите его. Как это сделать, написано в этом руководстве. Осталось перезапустить nginx с новыми настройками

По идее, если вы не меняли настройки FPM, PHP должен работать у вас на 9000-м порту, а nginx будет принимать все соединения на 80-м и перенаправлять их на PHP, так что попытавшись открыть адрес http://localhost вы получите не приветствие nginx, а результат работы вашего php-скрипта.

Memcached

Собственно, сборка Memcached довольно проста, но требует некоторой подготовки. В частности, для работы Memcached необходимо библиотека libevent, которую нужно установить при помощи уже знакомого вам по одному из предыдущих руководств MacPorts. Выполните в терминале команду

Теперь необходимо скачать исходники (их можно взять на этой странице [http://danga.com:80/memcached/download.bml]) и распаковать их.
Далее всё, как обычно:

Теперь запускаем:

Чтобы остановить Memcached, выполните команду

Но недостаточно только установить этот daemon, — необходимо так же научить установленный у вас PHP работать с ним. Это делается при помощи внешнего расширения для PHP, которое нужно собрать, а затем указать PHP на необходимость его использования. Эта библиотека называется memcache и её исходные коды доступны для скачивания на этой странице. Скачайте и распакуйте архив. Теперь, используя терминал, перейдите в директорию с исходными текстами и подготовьте их к сборке, выполнив команду

Дальше конфигурация:

Важно подчеркнуть, что в опции --with-php-config обязательно нужно указать путь к утилите php-config вашего PHP, иначе библиотека будет сконфигурирована для PHP, установленного в Mac OS X Leopard по умолчанию.

После конфигурации выполните сборку и установку:

Теперь нужно указать вашему PHP на необходимость подключения нового расширения. Если вы устанавливали PHP используя это руководство, то файл php.ini расположен у вас в директории /usr/local/php/lib/

Отредактируйте его, дописав в конец файла всего одну строчку:

Сохраните php.ini и перезапустите PHP. Теперь, чтобы убедиться, что у вас включена поддержка memcache, можете выполнить команду

Установка Xdebug

Xdebug — это расширение для PHP, позволяющее более детально отслеживать и анализировать работу PHP. Подробнее почитать об этом расширении, если вы с ним ещё не сталкивались, можно на странице документации по адресу xdebug.org/docs/. Сборка этого расширения практически такая же, как и сборка расширения memcache, речь о котором шла немного выше в этой теме. Скачайте с этой страницы архив с исходниками и распакуйте его. Перейдите в директорию с исходными текстами и выполните там команду:

Теперь нужно сконфигурировать расширение:

Как и в случае с memcache, очень важно указать правильный путь к php-config.
Теперь выполните сборку и установку расширения:

Осталось последнее действие: необходимо указать PHP использовать при работе Xdebug. Для этого откройте на редактирование php.ini и добавьте в конец файла вот такую строку

Теперь перезапустите PHP. Вот и всё, можете профилировать ваш код и искать в нём "узкие" места.

Заключение

Это последнее руководство в серии про среду web-разработки, в котором нужно что-то компилировать. В заключительном посте я лишь приведу список тех приложений, с которыми мне доводилось работать под Mac OS X, и которые себя с той или иной стороны хорошо зарекомендовали.
Комментарии к предыдущим сообщениям явно показывают, что без проблем пройти по всем, описанным мною шагам, удалось не всем. Это нормально, потому что сборка продукта из исходных текстов далеко не всегда проходит гладко от начала и до самого конца. И мне остаётся лишь надеяться, что у вас не возникнет непреодолимых препятствий на этом пути.

Связанные записи

• Среда web-разработки на Mac OS X Leopard (часть 2) (26)
• Среда web-разработки на Mac OS X Leopard (часть 4 – последняя) (5)
• Среда web-разработки на Mac OS X Leopard (часть 1) (27)
• Среда web-разработки на Mac OS X Leopard (вступление) (1)
• Результаты опроса (0)

Установка библиотек

Итак, для начала нужно определиться, с чем собирать PHP. Лично для моих задач важна поддержка работы с изображениями (GD2) и шрифтами (Type 1 и Freetype), которые, в свою очередь, потребуют установки в систему ряда библиотек. Так что с них, пожалуй, и начнём. Для установки нужных библиотек, воспользуйтесь знакомой по предыдущим постам утилитой из пакета MacPorts и выполните в терминале следующее.

Эта команда установит в систему библиотеки для работы с графикой (в число которых входят libjpeg, libpng, libfreetype, libxpm и ряд других, необходимых для GD). Теперь установим t1lib (если поддержка шрифтов Adobe™ Type 1 вам не требуется. пропустите этот шаг, но тогда потом уберите из конфигурации PHP, которая будет описана ниже, опцию --with-t1lib)

Сборка PHP с патчем FPM

Теперь необходимо скачать исходники PHP и PHP-FPM. На странице с доступными пакетами выбираете тот, который вам необходим (в описываемом мною случае, 5.3.0), скачиваете (ориентирйтесь на надпись Complete Source Code), распаковываете директорию php-5.3.0. Теперь с сайта PHP-FPM нужно скачать менеджер процессов для той версии PHP, которую вы планируете устанавливать (в описываемом мною случае, php-fpm-0.6-5.3.0) и после скачивания, распаковываете его рядом с исходниками PHP.
Откройте терминал и перейдите в директорию, которая содержит папки с исходниками указанных продуктов. Нужно создать патч FPM, применить его к исходникам PHP, а затем подготовить место для необходимых при сборке файлов. Все необходимые для этого команды я привожу одной строкой, которую вы можете выполнить в терпинале:

Вот и всё, подготовительный этап закончен, теперь можно конфигурировать и собирать PHP. Как и в случае с базами данных, чтобы ознакомиться со списком всех доступных при конфигурации опций, нужно выполнить команду ./configure с параметром --help, находясь в каталоге с исходниками PHP.

После того, как определились, запускаете конфигуратор с нужными параметрами. В описываемом случае я устанавливаю PHP в директорию /usr/local/php-5.3.0, а также указываю местоположение необходимых мне библиотек:

О нормальном завершении конфигурации можно судить по тому, что у вас на экране терминала отсутствует слово Error и присутствует предложение "Thank you for using PHP". Если же есть какие-то ошибки, внимательно читайте, что именно не устраивает конфигуратор, или задавайте вопросы.
Если конфигурация завершилась нормально, запускайте компиляцию:

Если и после этого ошибки отсутствуют (как я вам тогда завидую!), можно устанавливать PHP:

Тут уже проблем возникнуть попросту не должно. Теперь, чтобы запустить PHP, потребуется произвести начальную конфигурацию PHP-FPM. С этим менеджером процессов сразу поставляется стартовая конфигурация, но в ней закомментированы поля, отвечающие за пользователя и группу, от имени которого должен работать PHP. Чтобы исправить этот недочёт, откройте любым текстовым редактором, который умеет сохранять plain-text файлы (ни в коем случае не Word!!!) файл php-fpm.conf, расположенный в директории /usr/local/php-5.3.0/etc/. Например так:

И найдите там такие строки:

Уберите с них комментарии, и укажите нужное значение (я использую www).
Осталось сделать пару последних штрихов:
скопируйте файл с дефолтными настройками из директории с исходниками в директорию с установленным PHP

создайте ссылку на ваш PHP (я это делаю исключительно для удобства, этот шаг необязательный)

Вот и всё, теперь можно запускать PHP.

Чтобы убедиться, что он запущен, можно поискать его в процессах:

Чтобы остановить все запущенные процессы (например, при изменении настроек), нужно выполнить следующую команду

На этом можно заканчивать, поскольку теперь у вас установлен PHP.
Безусловно, в этом уроке описано далеко не всё. Например, PHP-FPM можно собрать как самостоятельное приложение, и управлять процессом запуска PHP через него. А можно обойтись и вовсе без FPM. Как бы там ни было, я не ставил своей целью рассказать ВСЁ, поскольку это не имеет смысла: необходимую информацию можно почерпнуть как на официальном сайте PHP, так и на страницах PHP-FPM. Но я всё же рассчитываю, что данная статья покажет, в каком направлении искать, и кому-то сильно сэкономит время.

Ну а в следующей статье, как и обещал, напишу про nginx, memcached и xdebug.

Связанные записи

• Среда web-разработки на Mac OS X Leopard (часть 3) (12)
• Среда web-разработки на Mac OS X Leopard (часть 1) (27)
• Среда web-разработки на Mac OS X Leopard (часть 4 – последняя) (5)
• Среда web-разработки на Mac OS X Leopard (вступление) (1)
• Странные трюки с размером файла в Finder (13)