Configuración e instalación PHP

Utilice este procedimiento para configurar PHP para su uso con la Consola de gestión.

Antes de empezar

Requisitos:

Acerca de esta tarea

Siga las instrucciones de esta sección para configurar PHP para Apache HTTP Server u otro servidor web. Las instrucciones dan por hecho que ya ha descargado la versión necesaria de PHP.

Instalar PHP

Acerca de esta tarea

Esta sección describe cómo compilar e instalar PHP de la fuente. Si tiene una versión existente de PHP y no desea volver a compilarla, sólo necesita determinar si los controladores apropiados de la base de datos están instalados. Si necesita instalar un controlador de base de datos, consulte la documentación PHP acerca del método de instalación que debe usar. Instale el controlador de la base de datos para utilizar con Build Forge, del siguiente modo:
  • DB2: controlador ibm_db2
  • MySQL: controlador mysqli
  • Oracle Instant Client: controlador oci8
Nota: Actualmente, el cliente completo de Oracle no es compatible con PHP oci8. Utilice sólo Oracle Instant Client.

Procedimiento

  1. Configure PHP para la instalación en el directorio de trabajo que acaba de crear.
    $ ./configure --prefix=/usr/local/php-5.2.4 --with-<basededatos>=shared \
    --with-apxs2 --with-ldap=shared --enable-mbstring --enable-shmop \
    --with-xml --with-zlib=shared
    Sustituya --with-<basededatos> de la forma siguiente:
    • DB2: --with-ibm_db2[=dir]. Si =dir no se especifica, se usa el valor predeterminado:/home/db2inst1/sqllib
    • MySQL: --with-mysqli[=archivo]. El parámetro de archivo opcional es el nombre de la vía de acceso para mysql_config.
    • Microsoft SQL Server: --with-mssql[=dir]
    • Oracle: Debe instalar una instalación independiente de Oracle Instant Client para utilizar PHP oci8. Si utiliza Oracle Instant Client para conectarse a la base de datos, use --with-oci8=instantclient,lib donde lib es la vía de acceso para el directorio Instant Client lib.

    Tenga en cuenta el carácter de continuación de línea \ en el bloque de código. Este paso especifica dónde se instalará PHP y con qué opciones se instalará. Se instala en /usr/local de manera predeterminada. El ejemplo muestra cómo ponerlo en /usr/local/php-5.2.4. Esta ubicación se utiliza en ejemplos posteriores.

  2. Compile PHP.
    $ make

    Este paso compila los ejecutables en el directorio local.

  3. Instale PHP (hágalo como root).
    # make install
    Este paso se debe realizar como un usuario con privilegios de escritura en el directorio donde está instalado Apache (/usr/local/apache-2.2.4 en este ejemplo). Normalmente se realiza como root. La configuración de administración local puede variar.

Configurar PHP

Procedimiento

  1. Copie los archivos de extensión al directorio de extensión. Es necesario copiar los archivos de extensión para la base de datos desde el repositorio hasta el directorio de extensiones activas. El ejemplo siguiente presupone que PHP está instalado en /usr/local/php-5.2.4. Tenga en cuenta que <indicación_fecha_y_hora> es una serie de números.
    $ cd /usr/local/php-5.2.4/lib/php/extensions/no-debug-non-zts-<indicación
    fecha_hora>/
    $ cp <extensiones-bd> ..
    Los archivos <extensiones-bd> se corresponden con la base de datos para Build Forge, de la forma siguiente:
    • DB2: ibm_db2.so
    • MySQL: mysql.so y mysqli.so
    • Oracle: oci8.so
  2. Edite el archivo de configuración de PHP php.ini. El ejemplo siguiente presupone que PHP está instalado en /usr/local/php-5.2.4:
    $ cd /usr/local/php-5.2.4/lib/
    $ vi php.ini
    Añada las entradas siguientes:
    extension_dir=/usr/local/php-5.2.4/lib/php/extensions
    upload_tmp_dir=<directorio>
    extension=<extensions-bd-so>
    Utilice el nombre del archivo <extensiones-bd-so> (o nombres de archivos) para la base de datos, de la forma siguiente:
    • DB2: extension=ibm_db2.so
    • MySQL: dos entradas -
      extension=mysql.so
      extension=mysqli.so
    • Oracle: extension=oci8.so
    Nota: El usuario con el que se ejecuta el servidor web de Apache debe poder grabar en el directorio utilizado para upload_tmp_dir. Habitualmente este usuario es nobody, pero la práctica de administración local puede variar.

Editar archivo de configuración de Apache

Procedimiento

Edite el archivo de configuración de Apache. Añada información sobre PHP en httpd.conf.
cd <dir-apache>
vi httpd.conf
Añada las líneas siguientes:
LoadModule php5_module modules/libphp5.so
AddHandler php5-script .php
AddType text/html .php
DirectoryIndex index.php

Identificar el servidor proxy

Acerca de esta tarea

Opcional: este paso sólo es necesario si la Consola de gestión necesita utilizar un servidor proxy para acceder a su base de datos.

Procedimiento

Edite el archivo de configuración de PHP php.ini. Está ubicado en <instal-php>/lib, por ejemplo /usr/local/php-5.2.4.

Añada las entradas siguientes:

bf_proxyHost=<nombre_host_servidor_su_proxy>
bf_proxyPath=<vía_acceso_su_proxy>
bf_symlinkPath=<enlace_simbólico_a_vía_acceso_proxy>

Comentarios