Instalação e Configuração do PHP

Use este procedimento para configurar o PHP para uso com o Console de Gerenciamento.

Antes de Iniciar

Requisitos:

Sobre Esta Tarefa

Siga as instruções nesta seção para configurar o PHP para o Apache HTTP Server ou outro servidor da Web. As instruções presumem que você já tenha transferido por download a versão obrigatória do PHP.

Instalar o PHP

Sobre Esta Tarefa

Esta seção descreve como compilar e instalar o PHP a partir da origem. Se houver uma instalação existente do PHP e você não quiser recompilá-la, precisará determinar apenas se os drivers apropriados do banco de dados estão instalados. Se for necessário instalar um driver de banco de dados, consulte a documentação do PHP do método de instalação a ser utilizado. Instale o driver do banco de dados a ser utilizado com o Build Forge, da seguinte forma:
  • DB2: driver ibm_db2
  • MySQL: driver mysqli
  • Oracle Instant Client: driver oci8
Nota: Atualmente, o cliente Oracle completo não é compatível com PHP oci8. Use o Oracle Instant Client somente.

Procedimento

  1. Configurar o PHP para instalação no diretório de trabalho recém-criado.
    $ ./configure --prefix=/usr/local/php-5.2.4 --with-<database>=shared \
    --with-apxs2 --with-ldap=shared --enable-mbstring --enable-shmop \
    --with-xml --with-zlib=shared
    Substitua --with-<database> da seguinte forma:
    • DB2: --with-ibm_db2[=dir]. Se =dir não for especificado, o valor padrão será utilizado:/home/db2inst1/sqllib
    • MySQL: --with-mysqli[=file]. O parâmetro de arquivo opcional é o nome do caminho para mysql_config.
    • Microsoft SQL Server: --with-mssql[=dir]
    • Oracle: Você deve executar uma instalação separada do Oracle Instant Client para usar o PHP oci8. Ao usar o Oracle Instant Client para conectar-se ao banco de dados, use --with-oci8=instantclient,lib em que lib é o caminho para o diretório lib do Instant Client.

    Observe o caractere de continuação de linha \ no bloco de código. Esta etapa especifica onde o PHP será instalado e com quais opções ele será instalado. Por padrão, ele é instalado em /usr/local. O exemplo mostra como colocá-lo em /usr/local/php-5.2.4. Este local é utilizado em exemplos posteriores.

  2. Compilar o PHP.
    $ make

    Esta etapa compila executáveis em seu diretório local.

  3. Instalar o PHP (como root).
    # make install
    Esta etapa deve ser desempenhada como um usuário que possui privilégios de gravação no diretório em que o Apache está instalado (/usr/local/apache-2.2.4 neste exemplo). Geralmente, isto é realizado como root. Sua configuração administrativa local pode variar.

Configurar o PHP

Procedimento

  1. Copiar arquivos de extensões para o diretório de extensões. Os arquivos de extensões para o banco de dados precisam ser copiados do repositório para o diretório de extensões ativo. O exemplo a seguir presume que o PHP está instalado em /usr/local/php-5.2.4. Observe que <datestamp> é uma cadeia de números.
    $ cd /usr/local/php-5.2.4/lib/php/extensions/no-debug-non-zts-<datestamp>/
    $ cp <db-extensions> ..
    Os arquivos <db-extensions> correspondem ao seu banco de dados do Build Forge, da seguinte forma:
    • DB2: ibm_db2.so
    • MySQL: mysql.so e mysqli.so
    • Oracle: oci8.so
  2. Edite o arquivo de configuração do PHP php.ini. O exemplo a seguir presume que o PHP está instalado em /usr/local/php-5.2.4:
    $ cd /usr/local/php-5.2.4/lib/
    $ vi php.ini
    Inclua as seguintes entradas:
    extension_dir=/usr/local/php-5.2.4/lib/php/extensions
    upload_tmp_dir=<directory>
    extension=<db-extension-so>
    Use o nome do arquivo <db-extensions-so> (ou os nomes de arquivo) para o seu nome do arquivo, da seguinte forma:
    • DB2: extension=ibm_db2.so
    • MySQL: duas entradas -
      extension=mysql.so
      extension=mysqli.so
    • Oracle: extension=oci8.so
    Nota: O diretório usado para upload_tmp_dir deve ser gravável pelo usuário como o qual o servidor da Web Apache é executado. Geralmente, este usuário é nobody, mas sua prática administrativa local pode variar.

Editar o Arquivo de Configuração do Apache

Procedimento

Edite o arquivo de configuração do Apache. Inclua informações sobre o PHP no httpd.conf.
cd <apache-dir>
vi httpd.conf
Inclua as seguintes linhas:
LoadModule php5_module modules/libphp5.so
AddHandler php5-script .php
AddType text/html .php
DirectoryIndex index.php

Identificar o Servidor Proxy

Sobre Esta Tarefa

Opcional: esta etapa é necessária somente se o Console de Gerenciamento precisar utilizar o servidor proxy para acessar seu banco de dados.

Procedimento

Edite o arquivo de configuração do PHP php.ini. Ele está localizado em <php-install>/lib; por exemplo /usr/local/php-5.2.4.

Inclua as seguintes entradas:

bf_proxyHost=<your_proxy_server_hostname>
bf_proxyPath=<your_proxy_path>
bf_symlinkPath=<symlink_to_proxy_path>

Feedback