Instalando Nginx Com Suporte a PHP5 e MySQL no Debian Squeeze

Versão 1.0
Autor: Falko Timme
Siga-me no Twitter

Nginx (pronunciado “engine x”) é um servidor HTTP gratuito, de código aberto e de alto desempenho. 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 Squeeze 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 apropriado.

2 Instalando MySQL 5

Para instalar o MySQL, executamos

apt-get 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: <– sua-senharoottmysql
Repita a senha para o usuário “root” do MySQL: <– sua-senharoottmysql

3 Instalando Nginx

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

apt-get install nginx

Inicie o nginx em seguida:

/etc/init.d/nginx start

O diretório raiz do documento padrão do nginx é /var/www, que ainda não existe; portanto, devemos criá-lo da seguinte forma:

mkdir /var/www  
 chown www-data:www-data /var/www

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 seguinte página:

Você recebe um erro 403 proibido porque não há uma página de índice em /var/www.

4 Instalando PHP5

Podemos fazer o PHP5 funcionar no nginx através do FastCGI. Felizmente, o Debian Squeeze 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 o MySQL em seus scripts PHP):

apt-get install php5-cgi php5-mysql php5-curl php5-gd php5-idn php-pear php5-imagick php5-imap php5-mcrypt php5-memcache 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 descomente a linha cgi.fix_pathinfo=1:

vi /etc/php5/cgi/php.ini

| [...] ; cgi.fix_pathinfo fornece suporte *real* para PATH_INFO/PATH_TRANSLATED para CGI. O comportamento anterior do PHP era definir PATH_TRANSLATED como SCRIPT_FILENAME, e não entender o que é PATH_INFO. Para mais informações sobre PATH_INFO, consulte as especificações cgi. Definir isso como 1 fará com que o PHP CGI corrija seus caminhos para se conformar à especificação. Um valor de zero faz com que o PHP se comporte como antes. O padrão é 1. Você deve corrigir seus scripts para usar SCRIPT_FILENAME em vez de PATH_TRANSLATED. ; http://php.net/cgi.fix-pathinfo cgi.fix_pathinfo=1 [...] |

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

apt-get install lighttpd

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

Iniciando servidor web: lighttpd2011-02-24 01:43:18: (network.c.358) não pode vincular à porta:  80 Endereço já em uso  
  falhou!  
 invoke-rc.d: initscript lighttpd, ação "start" falhou.

É assim que deve ser, porque o nginx já está escutando 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 escutando 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 o 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; ## escutar por ipv4 listen [::]:80 default ipv6only=on; ## escutar por ipv6 server_name _; access_log /var/log/nginx/localhost.access.log; location / { root /var/www; 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 escutando em 127.0.0.1:80 # #location ~ \.php$ { #proxy_pass http://127.0.0.1; #} # passar os scripts PHP para o servidor FastCGI escutando em 127.0.0.1:9000 # location ~ \.php$ { try_files $uri =404; fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /var/www$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 que captura tudo (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; significa que o diretório raiz do documento é o diretório /var/www.

A parte importante para o PHP é a estrofe location ~ .php$ {}. Descomente-a para habilitá-la. Certifique-se de que você alterou a linha fastcgi_param para fastcgi_param SCRIPT_FILENAME /var/www$fastcgi_script_name; (substitua /var/www 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 erro.

Agora salve o arquivo e reinicie o nginx:

/etc/init.d/nginx restart

Agora crie o seguinte arquivo PHP no diretório raiz do documento /var/www:

vi /var/www/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/
Wiki do nginx: http://wiki.codemongers.com/Main
PHP: http://www.php.net/
MySQL: http://www.mysql.com/
Debian: http://www.debian.org/

Sobre o Autor

Falko Timme é o proprietário da Timme Hosting (hospedagem web nginx ultra-rápida). Ele é o principal mantenedor do HowtoForge (desde 2005) e um dos desenvolvedores principais do ISPConfig (desde 2000). Ele também contribuiu para o livro da O’Reilly “Administração de Sistema Linux”.