Introdução

Este tutorial mostra de forma objetiva como instalar, configurar e testar um servidor web com Apache, PHP e Firebird no Windows 10.

Para escrever este tutorial usamos Firebird 2.5 + PHP 7.4 + Apache 2.4, todos de 64 bits, mas as instruções aqui contidas devem funcionar para outras versões com pouca ou nenhuma alteração, desde que não misture versões de 32 e 64 bits na mesma configuração.

Baixe, instale e teste o Firebird

• Baixe o instalador do Firebird 2.5:
  • 32 bits: Firebird-2.5.9.27139_0_Win32.exe
  • 64 bits: Firebird-2.5.9.27139_0_x64.exe
• Rode o instalador do Firebird e faça uma instalação padrão. Isto deverá instalar dois serviços do Firebird, os quais deverão aparecer na ferramenta Serviços do Windows como:
  • Firebird Guardian - DefaultInstance
  • Firebird Server - DefaultInstance
• Crie um banco de dados para testes.
  • Abra o Prompt de Comando do Windows.
  • Crie um diretório para armazenar o banco de dados:

    md c:\sistema\

  • Vá para a subpasta bin do Firebird:
    • 32 bits:

      cd "\Program Files (x86)\Firebird\Firebird_2_5\bin"

    • 64 bits:

      cd "\Program Files\Firebird\Firebird_2_5\bin"

  • Execute o utilitário de SQL interativo do Firebird:

    isql.exe

  • Execute os comandos abaixo para criar um banco de dados para testes. Cada comando deverá terminar com ponto-e-vírgula e será executado quando pressionar ENTER.

    CREATE DATABASE 'c:\sistema\teste.fdb' user 'SYSDBA' password 'masterkey';
    CREATE TABLE Pessoa(Id INTEGER, Nome VARCHAR(50));
    COMMIT;
    INSERT INTO Pessoa(Id, Nome) VALUES(1, 'DANIEL');
    INSERT INTO Pessoa(Id, Nome) VALUES(2, 'VINICIUS');
    COMMIT;
    

  • Para sair do ISQL basta digitar o comando abaixo e teclar ENTER:

    QUIT;

Baixe, instale e configure o PHP

• Baixe o pacote zip do PHP 7.4:
  • 32 bits: php-7.4.24-Win32-vc15-x86.zip
  • 64 bits: php-7.4.24-Win32-vc15-x64.zip
• Para instalar o PHP basta extrair os arquivos do pacote ZIP para uma pasta, conforme segue:
  • Crie uma pasta com nome php no diretório raiz da unidade C:

    c:\php

  • Extraia o conteúdo do pacote zip do PHP para a pasta criada no passo anterior.
• Ajuste as configurações do PHP:
  • Acesse a pasta do PHP (c:\php).
  • Crie uma cópia do php.ini-development com o nome php.ini.
  • Abra o arquivo php.ini em seu editor preferido.
  • Localize e descomente as configurações abaixo, removendo o ponto-e-vírgula do início da linha.
    • Driver PDO para Firebird:

      extension=pdo_firebird

    • Biblioteca GD, usada para processamento de imagens:

      extension=gd2

    • Biblioteca MBString, para processamento de strings multi-bytes:

      extension=mbstring

  • Caso queira que o PHP não reporte erros do tipo E_NOTICE, localize a diretiva error_reporting e a configure como abaixo:

    error_reporting = E_ALL & ~E_NOTICE

  • Salva as alterações e feche o arquivo php.ini.

Baixe, instale e configure o Apache

• Baixe o pacote zip do Apache 2.4:
  • 32 bits: httpd-2.4.48-win32-VS16.zip
  • 64 bits httpd-2.4.48-win64-VS16.zip
• Instale o Apache seguindo as instruções abaixo:
  • Crie uma pasta com nome apache no diretório raiz da unidade C: (c:\apache).
  • Extraia o conteúdo do pacote ZIP do Apache e copie o conteúdo da pasta Apache24 para a pasta c:\apache.
• Ajuste as configurações do Apache:
  • Abra o arquivo de configuração do Apache no seu editor preferido:

    c:\apache\conf\httpd.conf

  • Localize e descomente a configuração abaixo, removendo o caractere # do início da linha. Esta configuração tem relação com o arquivo .htaccess que é usado para sobrescrever configurações do Apache para um site específico.

    LoadModule rewrite_module modules/mod_rewrite.so

  • Localize esta linha:

    Define SRVROOT "c:/Apache24"

    e altere-a para:

    Define SRVROOT "c:\apache"

  • Localize as linhas abaixo:

    DocumentRoot "${SRVROOT}/htdocs"
    <Directory "${SRVROOT}/htdocs">

    e modifique conforme exemplo a seguir, informando o endereço do diretório raiz do seu site.

    DocumentRoot "c:\diretorioDoSite"
    <Directory "c:\diretorioDoSite">

  • Localize todas as linhas iguais a esta:

    AllowOverride none

    e modifique-as para:

    AllowOverride All

  • Adicione as configurações relativas ao PHP no final do arquivo de configurações do Apache. O nome do arquivo DLL e os diretórios podem ser diferentes, dependendo das versões utilizadas e do local de local de instalação do PHP.

    LoadModule php7_module "C:\php\php7apache2_4.dll"
    <IfModule php7_module>
    	DirectoryIndex index.html default.php index.php
    	AddHandler application/x-httpd-php .php
    	PHPIniDir "C:\php"
    </IfModule>
    

  • Instale o Apache como um serviço do Windows:
    • Abra o Prompt de Comando como Administrador.
    • Vá para a subpasta bin do Apache:

      cd c:\apache\bin

    • Instale o Apache como um serviço. O serviço instalado deverá aparecer como Apache na ferramenta Serviços do Windows, onde poderá ser iniciado, parado e reiniciado, conforme necessário.

      httpd.exe -k install

    • Se preferir também poderá usar os comandos abaixo para iniciar, parar e reiniciar o serviço do Apache:

      httpd.exe -k start
      httpd.exe -k stop
      httpd.exe -k restart

  • Copie a biblioteca cliente do Firebird (arquivo fbclient.dll) da subpasta bin do Firebird para a subpasta bin do Apache.
  
  

  Teste tudo!

  • Crie um arquivo com o nome teste.php no diretório raiz do site, conforme configurado no Apache, com o conteúdo abaixo:

    <html>
    <body>
    <?php
    	$banco = 'firebird:dbname=localhost:C:\sistema\teste.fdb';
    	$usuario = 'SYSDBA';
    	$senha = 'masterkey';
    	$conexao = new PDO($banco, $usuario, $senha);
    	$consulta = $conexao->query('select id, nome from pessoa');
    	foreach($consulta->fetchAll(PDO::FETCH_OBJ) as $registro)
    		echo $registro->ID . ' - ' . $registro->NOME . '<br>';
    ?>
    </body>
    </html>
    

  • Abra o navegador e teste o acesso ao script:

    localhost/teste.php

  • Se tudo estiver certo, deverá listar as pessoas cadastradas.
  
  

  Possível problema

  O Firebird 2.5 para Windows foi desenvolvido em Microsoft Visual C++ 2005 e por isto depende dos arquivos msvcp80.dll e msvcr80.dll. Já o Firebird 3.0 foi desenvolvido em Microsoft Visual C++ 2010, o que o faz depender dos arquivos msvcp100.dll e msvcr100.dll. Por essa razão, pode ser necessário colocar cópia desses arquivos na subpasta bin do Apache ou instalar um os pacotes de runtime do Microsoft Visual C++ disponíveis nos links abaixo, conforme a versão do Firebird que estiver usando.

  • Para Firebird 2.5: Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Update
  • Para Firebird 3.0: Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update
  
  

  Conclusão

  Espera-se com este tutorial que o leitor tenha conseguido executar todos os procedimentos e testes com sucesso, mas se ainda não conseguiu, não desanime. Revise todos os passos desde o início para identificar algo que eventualmente tenha sido feito diferente do que foi explicado. Se ainda assim não obter êxito, uma alternativa é buscar solução na internet e compartilhar conosco para que este tutorial seja atualizado.