Universidade Federal de Santa Catarina -UFSC Centro Acadêmico de Engenharia de Controle e Automação CAECA Setor de Informática Guia de Instalação e Configuração do Apache, PHP, MySQL e phpmyadmin emwindows VERSÃO 1.1 Cleiton Moya de Almeida cleitonmoya@yahoo.com.br www.cleitonmoya.com Florianópolis, 03 de novembro de 2006.
Conteúdo 0. CONSIDERAÇÕES... 3 1. APACHE 2.2.3... 4 1.1. DOWNLOAD E INSTALAÇÃO... 4 1.2. TESTE... 4 1.3. CONFIGURAÇÃO... 5 2. PHP 5.2.0... 6 2.1. DOWNLOAD E INSTALAÇÃO... 6 2.1. INTEGRAÇÃO COM O APACHE... 6 2.1. TESTE... 7 3. MYSQL 5.0.27... 7 3.1. CONFIGURAÇÕES PRELIMINARES DO APACHE E PHP... 7 3.2. DOWNLOAD E INSTALAÇÃO... 7 3.3 TESTE... 8 4. PHPMYADMIN 2.9.0.2... 10 4.1 DOWNLOAD E INSTALAÇÃO... 10 4.2 CONFIGURAÇÃO... 10 4.2 TESTE... 10 7. REFERÊNCIAS... 11 2
0. Considerações Este guia foi escrito a fim de permitir de maneira rápida a instalação, configuração e integração do Apache, PHP, mysql e phpmyadmin principais ferramentas presentes num servidor web utilizando o sistema operacional Windows. Por se tratar de um guia passo-a-passo, não tem o intuito de fornecer detalhes aprofundados sobre tais processos. Tais detalhes podem ser obtidos em documentações dos desenvolvedores. As seguintes versões de softwares foram utilizadas: Apache 2.2.3 PHP 5.2.0 MySQL 5.0.27 phpmyadmin 2.9.0.2 Windows XP Professional SP2 Em versões muito diferentes, pode haver mudanças em alguns procedimentos. Neste caso, recomenda-se a leitura dos manuais de instalação de cada software, listados na seção de referências. A distribuição deste material pode ser feita de maneira livre, contanto que seja mantida no documento o nome, endereço de e-mail e site do autor. Cleiton Moya de Almeida 3
1. Apache 2.2.3 1.1. Download e Instalação 1. Entre em http://httpd.apache.org/download.cgi. Faça o download do instalador da última versão para Windows (Win32 Binary MSI Installer). Após o término do download, execute o arquivo de instalação. Uma tela semelhante à abaixo deverá aparecer. 2. Prossiga clicando no botão "Next", aceitando os termos da licença de uso e, na tela de Informações do Servidor ("Server Information"), onde é solicitado "Network Domain", "Server Name" e "Administrator's Email Address", informe, respectivamente: "localdomain", "localhost" e o seu endereço de e-mail. Escolha se deseja rodar o servidor como serviço do sistema para todos ou apenas o atual usuário. 1.2. Teste Para testar a instalação, primeiramente, certifique-se de que o Apache esteja em execução. Abra o seu navegador e digite o seguinte endereço: http://localhost. Este é o endereço do seu servidor web local. Uma página como esta abaixo deverá aparecer, indicando que você instalou corretamente o Apache em seu sistema. 4
1.3. Configuração 1. Deve-se alterar o diretório onde se encontra o site. Como exemplo utilizamos o diretório C:\caeca.As seguintes modificações no arquivo httpd.conf (arquivo de configuração do Apache) são necessárias: 1.1 Localize The directory out e modique o diretório Document Root, conforme abaixo. Observe o sentido da barra / que devem ser escritos os endereços (padrão unix): # The directory out of which you will serve your documents DocumentRoot <C:/caeca> 1.2 Localize This should be changed e modique o diretório Document Root, conforme abaixo: # This should be changed to whatever you set DocumentRoot to. <Directory C:/caeca > 1.3 Localize ScriptAlias e modique o diretório, conforme abaixo. Não esqueça da última / depois de caeca : ScriptAlias /cgi-bin/ "C:/caeca/cgi-bin/" 1.4 Localize ScriptAliased e modique o diretório, conforme abaixo: <Directory C:/caeca/cgi-bin > 2. Salve o arquivo e reinicie o Apache. Agora, ao ser acessado http://localhost o servidor exibirá a página index.html que estiver no diretório configurado anteriormente, no caso C:\caeca. 5
2. PHP 5.2.0 2.1. Download e Instalação 1. Efetue o download do pacote com os arquivos do PHP para Windows, no seguinte endereço: http://www.php.net/downloads.php 2. Na seção Windows Binaries, faça o download do pacote zip de instalação do PHP, neste caso PHP 5.2.0 zip Package. 3. Após o download, crie uma pasta C:\php\ e descompacte os arquivos do pacote em tal pasta. Verifique se os subdiretórios do arquivo zip foram criados. A estrutura da pasta C:\php deve ser semelhante a mostrada abaixo: 2.1. Integração com o Apache 1. Faça uma cópia do arquivo php.ini-recommended e renome-a para php.ini. Abra tal arquivo no bloco de notas e faça as seguintes modificações: a. Doc_root = C:\caeca b. Procure a linha: ; Directory in which the loadable extensions (modules) reside. Altere extension_dir = "./" para extension_dir = "C:\php\ext" c. Descomente as seguintes extensões: ;extension=php_mbstring.dll ;extension=php_gd2.dll Para isso, basta tirar o caracter de ponto-e-vírgula do início da linha. d. Altere a linha: short_open_tag = Off para short_open_tag = On e. Procure a linha: ;session.save_path = "N;/path" Descomente-a e altere para session.save_path = "C:\WINDOWS\Temp" 6
2. Inclua, no final do arquivo de configuração do Apache httpd.conf, as seguintes linhas: # Configure PHP5 to run with Apache2 LoadModule php5_module "c:/php/php5apache2_2.dll" AddType application/x-httpd-php.php PHPIniDir "C:/php" 3. Salve o arquivo httpd.conf e reinicie o servidor apache. 2.1. Teste Para testar a instalação do PHP, crie um arquivo qualquer com extensão.php (info.php, por exemplo), na pasta base do seu servidor Web Apache (c:\caeca, por exemplo) e, dentro dele digite o seguinte código: <? phpinfo();?> Através de um navegador web, acesso o arquivo criado(certifique-se de que o servidor Apache esteja em execução): http://localhost/info.php Uma tela com informações sobre configurações do PHP deverá ser exibida, como indicado abaixo: 3. MySQL 5.0.27 3.1. Configurações preliminares do Apache e PHP 1. Abra o arquivo php.ini e descomente a seguinte linha, retirando o ponto-e-vírgula: ;extension=php_mysql.dll 2. copie o arquivo libmysql.dll para a pasta C:\Apache\bin 3. Reinicie o servidor Apache. 3.2. Download e Instalação 1. Faça o download do mysql em http://dev.mysql.com/downloads/, escolhendo a versão Windows (x86). Após isso, descompacte o arquivo de instalação e execute-o. 7
2. Com a tela inicial aberta, pressione Next. Na próxima tela, escolha a instalação Custom e clique em Next. Aceite todas as opções padrões, a menos que você já tenha experiência com banco-de-dados e saiba exatamente o que significa cada opção. 3. Na tela de registro no site da mysql, marque a opção Skip Sign-Up e clique em Next. 4. Para finalizar, marque a opção Configure the MySQL Server now e clique em Finish. 5. A próxima tela mostra o MySQL Server Instance Configuration Wizard. Pressione Next. 6. Marque a opção Standard Configuration. Pressione novamente Next. 7. Na tela que surgir, marque as opções: Install As Windows Service, Launch the MySQL Server automatically e Include Bin Directory in Windows PATH. Em Service Name, escolha a expressão MySQL e pressione Next. 8. Agora, defina a senha padrão do MySQL. Preencha e confirme. Deixe marcada a opção Enable root access from remote machines e pressione Next. 9. Para concluir, clique no botão Execute. Aguarde a aplicação das configurações. 10. Se uma mensagem de erro aparecer, provavelmente você estará usando um firewall, o que limitará acessos externos ao seu banco-de-dados. Clique no botão Retry para reiniciar o teste. Clique em Finish. 3.3 Teste 1. Vá em Iniciar > Todos os programas > MySQL > MySQL Server 5.0 > MySQL Command Line Client. 2. No Prompt de comando, digite sua senha criada durante a instalação e dê Enter. 8
3. Se tudo correr bem, você estará dentro do prompt do MySQL, aparecerá uma tela de boas vindas e a versão do MySQL: 5.0.27-community-nt. 4. Para testar definitivamente se o banco está de pé, digite o seguinte comando: show databases;(com ponto e vírgula). 5. Esse comando deve lhe fornecer uma lista de bancos de dados. O MySQL cria automaticamente dois bancos de dados, denominados mysql e test. 6. Feche a janela do MySQL Command Line Client com o comando exit ou quit 9
4. phpmyadmin 2.9.0.2 O phpmyadmin é uma ferramenta escrita em PHP que permite a execução de tarefas do MySQL sem precisar recorrer à linha de comando. 4.1 Download e Instalação 1. Baixe o phpmyadmin 2.9.0.2 em http://www.phpmyadmin.net/home_page/downloads.php 2. Descompacte os arquivos em C:\Apache\htdocs e renomeie a pasta phpmyadmin-2.9.0.2 para phpmyadmin 4.2 Configuração 1. Abra o arquivo config.default.php localizado em C:\Apache\htdocs\phpMyAdmin\libraries e procure a linha: $cfg['pmaabsoluteuri'] = ''; Altere-a para $cfg['pmaabsoluteuri'] = 'http://localhost/phpmyadmin'; 2. Procure a linha: $cfg['servers'][$i]['password'] = ''; // MySQL password e coloque sua senha: $cfg['servers'][$i]['password'] = 'senha'; 3. Salve o arquivo config.default.php 4.2 Teste Para iniciar o phpmyadmin, abra o browser e digite, na barra de endereços: http://localhost/phpmyadmin/index.php Se tudo estiver bem, você verá a tela do phpmyadmin, mostrando as versões carregadas: MySQL - 5.0.22-community-nt e phpmyadmin - 2.9.0.2 10
7. Referências [1] Apache HTTP Server Documentation http://httpd.apache.org/docs/ [2] PHP Documentation http://www.php.net/docs.php [3] MySQL Documentation http://dev.mysql.com/doc/ [4] phpmyadmin Documentation http://www.phpmyadmin.net/home_page/docs.php [5] cleitonmoya.com http://www.cleitonmoya.com/ 11