Instalando Nginx Com Suporte a PHP5 e MySQL no Debian Lenny

Versão 1.0
Autor: Falko Timme

Nginx (pronunciado “engine x”) é um servidor HTTP de alto desempenho, gratuito e de código aberto. O Nginx é conhecido por sua estabilidade, rico conjunto de recursos, configuração simples e baixo consumo de recursos. Este tutorial mostra como você pode instalar o Nginx em um servidor Debian Lenny com suporte a PHP5 (através do FastCGI) e suporte a MySQL.

Não dou nenhuma garantia de que isso funcionará para você!

1 Nota Preliminar

Neste tutorial, uso o nome do host server1.example.com com o endereço IP 192.168.0.100. Essas configurações podem diferir para você, então você deve substituí-las onde for apropriado.

2 Instalando MySQL 5.0

Para instalar o MySQL, executamos

aptitude install mysql-server mysql-client

Você será solicitado a fornecer uma senha para o usuário root do MySQL - essa senha é válida para o usuário root@localhost, bem como para [email protected], então não precisamos especificar uma senha root do MySQL manualmente mais tarde:

Nova senha para o usuário “root” do MySQL: <– suaSenhaRootSQL
Repita a senha para o usuário “root” do MySQL: <– suaSenhaRootSQL

3 Instalando Nginx

O Nginx está disponível como um pacote para Debian Lenny, que podemos instalar da seguinte forma:

aptitude install nginx

Inicie o nginx em seguida:

/etc/init.d/nginx start

Digite o endereço IP ou nome do host do seu servidor web em um navegador (por exemplo, http://192.168.0.100), e você deve ver a página de boas-vindas do nginx:

4 Instalando PHP5

Podemos fazer o PHP5 funcionar no nginx através do FastCGI. Felizmente, o Debian Lenny fornece um pacote PHP5 habilitado para FastCGI que instalamos assim (junto com alguns módulos PHP5 como php5-mysql que você precisa se quiser usar MySQL a partir de seus scripts PHP):

aptitude install php5-cgi php5-mysql php5-curl php5-gd php5-idn php-pear php5-imagick php5-imap php5-mcrypt php5-memcache php5-mhash php5-ming php5-pspell php5-recode php5-snmp php5-sqlite php5-tidy php5-xmlrpc php5-xsl

Em seguida, abra /etc/php5/cgi/php.ini e adicione a linha cgi.fix_pathinfo = 1 bem no final do arquivo:

vi /etc/php5/cgi/php.ini

| [...] cgi.fix_pathinfo = 1 |

Não há pacote de daemon FastCGI autônomo para Debian Lenny, portanto, usamos o programa spawn-fcgi do lighttpd. Instalamos o lighttpd da seguinte forma:

aptitude install lighttpd

Você verá uma mensagem de erro dizendo que o lighttpd não pode iniciar porque a porta 80 já está em uso:

Starting web server: lighttpd2009-03-19 15:58:09: (network.c.300) can't bind to port: 80 Address already in use  
 failed!

É assim que deve ser, porque o nginx já está ouvindo na porta 80. Execute

update-rc.d -f lighttpd remove

para que o lighttpd não inicie na inicialização.

Instalamos o lighttpd porque precisamos apenas de um programa que vem com o pacote, /usr/bin/spawn-fcgi, que podemos usar para iniciar processos FastCGI. Dê uma olhada em

spawn-fcgi --help

para saber mais sobre isso.

Para iniciar um daemon PHP FastCGI ouvindo na porta 9000 no localhost e executando como o usuário e grupo www-data, executamos o seguinte comando:

/usr/bin/spawn-fcgi -a 127.0.0.1 -p 9000 -u www-data -g www-data -f /usr/bin/php5-cgi -P /var/run/fastcgi-php.pid

Claro, você não quer digitar esse comando manualmente sempre que inicializar o sistema, então para que o sistema execute o comando automaticamente na inicialização, abra /etc/rc.local…

vi /etc/rc.local

… e adicione o comando no final do arquivo (antes da linha de saída):

| [...] /usr/bin/spawn-fcgi -a 127.0.0.1 -p 9000 -u www-data -g www-data -f /usr/bin/php5-cgi -P /var/run/fastcgi-php.pid [...] |

5 Configurando nginx

A configuração do nginx está em /etc/nginx/nginx.conf, que abrimos agora:

vi /etc/nginx/nginx.conf

A configuração é fácil de entender (você pode aprender mais sobre isso aqui: http://wiki.codemongers.com/NginxFullExample e aqui: http://wiki.codemongers.com/NginxFullExample2)

Primeiro (isso é opcional) aumente o número de processos de trabalho e defina o keepalive_timeout para um valor razoável:

| [...] worker_processes 5; [...] keepalive_timeout 2; [...] |

Os hosts virtuais são definidos em contêineres server {}. O vhost padrão é definido no arquivo /etc/nginx/sites-available/default - vamos modificá-lo da seguinte forma:

vi /etc/nginx/sites-available/default

| [...] server { listen 80; server_name _; access_log /var/log/nginx/localhost.access.log; location / { root /var/www/nginx-default; index index.php index.html index.htm; } location /doc { root /usr/share; autoindex on; allow 127.0.0.1; deny all; } location /images { root /usr/share; autoindex on; } #error_page 404 /404.html; # redirecionar páginas de erro do servidor para a página estática /50x.html # error_page 500 502 503 504 /50x.html; location = /50x.html { root /var/www/nginx-default; } # proxy os scripts PHP para o Apache ouvindo em 127.0.0.1:80 # #location ~ \.php$ { #proxy_pass http://127.0.0.1; #} # passar os scripts PHP para o servidor FastCGI ouvindo em 127.0.0.1:9000 # location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /var/www/nginx-default$fastcgi_script_name; include fastcgi_params; } # negar acesso a arquivos .htaccess, se o diretório raiz do documento do Apache # coincidir com o do nginx # location ~ /\.ht { deny all; } } [...] |

servername ; torna isso um vhost padrão catchall (claro, você também pode especificar um nome de host aqui como www.example.com).

Na parte location /, adicionei index.php à linha de índice. root /var/www/nginx-default; significa que o diretório raiz do documento é o diretório /var/www/nginx-default.

A parte importante para o PHP é o trecho location ~ .php$ {}. Descomente-o para habilitá-lo. Certifique-se de que você altere a linha fastcgi_param para fastcgi_param SCRIPT_FILENAME /var/www/nginx-default$fastcgi_script_name; (substitua /var/www/nginx-default pelo diretório raiz do seu vhost) porque, caso contrário, o interpretador PHP não encontrará o script PHP que você chama em seu navegador.

Certifique-se de que haja alguns espaços entre include e fastcgi_params; - no arquivo padrão isso é escrito como uma palavra, o que é um bug.

Agora salve o arquivo e reinicie o nginx:

/etc/init.d/nginx restart

Agora crie o seguinte arquivo PHP na raiz do documento /var/www/nginx-default:

vi /var/www/nginx-default/info.php

| |

Agora chamamos esse arquivo em um navegador (por exemplo, http://192.168.0.100/info.php):

Como você pode ver, o PHP5 está funcionando, e está funcionando através do FastCGI, como mostrado na linha Server API. Se você rolar mais para baixo, verá todos os módulos que já estão habilitados no PHP5, incluindo o módulo MySQL:

6 Links

nginx: http://nginx.net/
nginx Wiki: http://wiki.codemongers.com/Main
PHP: http://www.php.net
MySQL: http://www.mysql.com
Debian: http://www.debian.org/