Configuracion de Apache y PHP para aplicativos de la BVS

De wiki.bireme.org/es
Saltar a: navegación, buscar

Configuración de Apache 2.2.xx y PHP 5.3.x en ambientes Linux

Acerca de este capítulo

Este capítulo trata sobre la instalación de Apache y PHP para ser utilizado por los aplicativos de la BVS en ambientes Linux. Supone que la computadora tiene instalado un sistema operativo Linux estándar, sin interfaz gráfica (optimizado), sin web server por defecto y sin opción SELinux.

Este último es necesario para garantizar que el PHP pueda incluir una librería dinámica en Apache y por él cargala sin restricciones.

En modo que se pueda compilar e instalar todo el software descripto acá, se sugere que el administrador del servidor garantize la existéncia de las librerías y herramientas descriptas abajo.

Software ANSI C Compiler Perl5 Interpreter Flex v.2.5.4 iconv
PHP X X X
Apache X X

El uso de PHP en los productos de la BVS está orientado a la manipulación de datos y el procesamiento de documentos XML para su presentación a través de transformaciones usando archivos XSL.

Sus consultas pueden ser dirigidas a bvs.technical.support@listas.bireme.br.

Ejemplo de versiones probadas

  • Apache 2.2.11
  • PHP 5.3.x

Todos estos software deben ser compilados en el servidor. No se deben instalar por paquete auto-instalable como RPM etc. Las líneas recomendadas para la compilación son las siguientes:

Desempaquetando en el área estándar de código fuente

cd /usr/local/src
tar xvfzp apache_2.2.11.tar.gz
tar xvfzp php-5.3.x.tar.gz

Configurando e instalando el Apache

cd apache_2.2.11

Nótese que la línea de ejecución a continuación consiste de tres líneas de parámetros.

./configure --prefix=/usr/local/apache\
   --enable-so
   --enable-rewrite
make
make install
cd ..

Empezando el servício de Apache

  • Probando la configuración
/usr/local/apache/bin/apachectl configtest
  • Empezando el servício
/usr/local/apache/bin/apachectl start

Verificando el status de la instalación

  • Abra una ventana del navegador de internet de su preferencia y pruebe la URL con la IP del servidor. ej.:
http://200.100.1.100/
  • El resultado debe ser una pantalla parecida a la siguiente:
Apache22XPHP53Ximg01.jpg

Configurando e instalando el PHP

cd php-5.3.X

Empezando la configuración del PHP

Nótese que la línea de ejecución a continuación consiste de múltiples líneas de parámetros.

./configure --prefix=/usr/local/php \
 --with-apxs2=/usr/local/apache/bin/apxs --with-gd --with-zlib \
 --enable-mbstring --with-iconv --with-iconv-dir --enable-gd-native-ttf \
 --enable-ftp --with-xsl --enable-wddx --with-gettext \
 --with-kerberos --enable-soap --with-libxml-dir --with-xmlrpc \
 --with-libxml-dir=/usr 
make
make install

En el caso de ocurrir algún error con las librerías en la compilación del PHP, por favor, haga las siguientes verificaciones:

  • Ejemplo para SUSE
Zypper search gcc
Zypper search make
Zypper search libxml2
Zypper search libxml2-dev
Zypper search libpng12-dev
Zypper search libxslt1-dev
  • Ejemplo Fedora
yum search gcc
yum search make
yum search libxml2
yum search libxml2-dev
yum search libpng12-dev
yum search libxslt1-dev

El caso que alguna librería estée faltante, debese instalar con el comando adecuado de su sistema operativo.

Editando el archivo httpd.conf

vi /usr/local/apache/conf/httpd.conf
  • Verificar si se encuentra agregado el módulo en la lista de APIs del Apache conforme abajo:
LoadModule php5_module        modules/libphp5.so
  • Añada una linea que incluye el tipo de archivo php en la tabla MIME:
AddType application/x-httpd-php .php

Editando el archivo de configuración del PHP

Algunas versiones del PHP crean el archivo php.ini en el subdirectorio /usr/local/php/lib o /usr/local/php/lib/php.

IMPORTANTE

Si la versión utilizada no ha creado este archivo, copie el archivo php.ini-production del directorio de instalación (php-5.3.X) para /usr/local/php/lib con el nombre php.ini.

  • Ahora debe ser editado para cambiar/habilitar algunos parámetros.
vi php.ini
  • Activar la variable register_globals en el momento de crear el Virtual Host
php_flag register_globals on

Empezando nuevamente el servicio de Apache

/usr/local/apache/bin/apachectl start

Comprobando la instalación

El último paso para la configuración de PHP es asegurarse que APACHE está procesando correctamente los archivos PHP. Para esto crearemos un archivo nuevo con el nombre “info.php”.

  • El archivo info.php debe contener una línea con el siguiente texto:
<? phpinfo(); ?>
  • Grabe el archivo en el directorio de documentos configurado en su servidor Web. En una instalación estándar de APACHE este directorio se llama “htdocs”.
  • Inicie el servidor Web
/usr/local/apache/bin/apachectl start
  • Use su navegador de internet para visitar la URL:
http://localhost/info.php

Esta página debe mostrar información sobre su instalación de PHP.

Instalación simple de APACHE 2.2.x en ambiente Windows

Este capítulo tracta de la instalación de Apache para que pueda ser utilizado por los aplicativos BVS en ambientes Windows. Se asume la instalación en una computadora con Windows NT, 2000, o versiones superiores.

Obtención del software

El servidor Web puede obtenerse en el sitio de APACHE, http://www.apache.org/.

Instalación del APACHE

En ambiente Windows, la instalación del APACHE se realiza mediante un instalador y por ese motivo es extremadamente simple. Si no tiene experiencia en este tipo de programa es recomendable hacer la instalación propuesta por el sistema.

  • Pulse dos veces en el instalador de APACHE y siga las instrucciones en la pantalla. La instalación correcta del sistema deberá generar la siguiente configuración en su computadora.
  • Los programas de APACHE estarán instalados en
C:\PROGRAM FILES\Apache Software Foundation\Apache2.2

De no haber indicación en contrario, APACHE estará instado como un servicio automático de Windows; si la hubiere será necesario iniciar el servidor manualmente.

  • En cualquier caso, el acceso a la configuración y control de Apache puede realizarse a través de:
Start > Programs > Apache HTTP Server 2.2 > 
  • Las carpetas importantes de la instalación son las siguientes:
    • C:\PROGRAM FILES\Apache Software Foundation\Apache2.2\htdocs, en la que están almacenados todos los documentos que el servidor ofrecerá a sus visitantes
    • C:\PROGRAM FILES\Apache Software Foundation\Apache2.2\conf, donde está el archivo httpd.conf, responsable por la configuración del servidor.
    • C:\PROGRAM FILES\Apache Software Foundation\Apache2.2\cgi-bin, donde son almacenados programas específicos usados por el servidor para tener acceso a otros programas o dados. Básicamente el procedimiento de configuración consiste en editar el archivo httpd.conf agregando algunas líneas.

Antes de comenzar la configuración verifique si el servidor Web está funcionando correctamente. Si la instalación de APACHE acabó de hacerse la URL http://localhost/ debe mostar una página indicando que el servidor está funcionando.

Instalación simple de PHP 5.3.x en ambiente Windows

Sobre este capítulo

Este capítulo tracta de la instalación de PHP para que puede ser usado por los aplicativos de la BVS en ambientes Windows. Asume la instalación en una computadora Windows NT, 2000, o versiones superiores.

Obtención del software

La versión más nueva de PHP está disponible en http://www.php.net/.

IMPORTANTE:

Existen dos versiones de PHP para Windows, una que funciona solamente como CGI y otra que puede ser instalada como módulo. Recomendamos el uso de esta última cuando las aplicaciones serán usadas en alta carga de proceso.

Instalación de PHP

En el ambiente Windows, la instalación de PHP es muy simple. Es suficiente desempaquetar el archivo en una carpeta y copiar a los directorios del sistema de extensiones que PHP va a usar.

A continuación se presentan los pasos para una instalación de PHP compatible con los aplicativos de la BVS.

  • crear una carpeta “php” en el directorio raíz del disco duro, esto es "c:\php";
  • desempaquetar el archivo que contiene los componentes de PHP en el directorio creado en (a);
  • utilizar el archivo php.ini-production como base para la configuración de PHP. Vea la sección “Configuración de PHP”;
  • configurar el Apache para operar con programas escritos en PHP.
  • Configuración de PHP

Básicamente el procedimiento consiste en editar el archivo php.ini-dist, adjustar algunos parámetros y guardarlo con el nombre php.ini en el directorio del Windows.

  • Haga una copia del archivo c:\php\php.ini-production. Guárdelo como c:\php\php.ini;
  • Edite el archivo c:\php\php.ini (puede usar NOTEPAD) y ajuste los siguientes parámetros (busque la línea apropiada en el documento):
extension_dir = "/php/ext" 
extension=php_xmlrpc.dll
extension=php_xsl.dll
short_open_tag = On

Apache con PHP

Antes de comenzar la configuración verifique si el servidor Web está funcionando correctamente. Para hacer eso, basta utilizar su navegador y visitar la dirección del sitio Web.

  • Si la instalación de APACHE terminó de hacerse, la URL http://localhost/ debe mostrar una página indicando que su servidor está funcionando.
  • La configuración de APACHE se realiza editando el archivo httpd.conf que está disponible en la carpeta <path_to_apache>\conf\, por ejemplo: C:\APACHE\conf\.
  • Edite este archivo con un editor de texto (por ejemplo, NOTEPAD) y se agregarán algunas líneas que permitirán que APACHE pueda gerenciar los programas en PHP.
  • El archivo de configuración está estructurado en secciones. Verifique si las líneas incluidas están en la sección correcta. Como ya se mencionó, PHP puede funcionar en modo CGI o como un módulo de APACHE (pero no en ambos simultáneamente). La diferencia principal es que la segunda opción tiene mejor desempeño en alta carga de procesos.

IMPORTANTE

Para os aplicativos da BVS somente foi testado o modo de configuração como módulo do Apache.

PHP como módulo de APACHE

Para esta opción configure las siguientes líneas del archivo httpd.conf:

  • Agregar el módulo en la lista de APIs de Apache:
LoadModule php5_module ”c:\php\php5apache2_2.dll”
  • Una línea que incluye el tipo de archivo php en la tabla MIME:
AddType application/x-httpd-php .php 
  • Una línea que incluye el camiño para el php.ini:
PHPIniDir "C:/php”
  • Borrar una linea en <Directory />:
Deny from all

Verificación de la instalación

El último paso para la configuración de PHP es verificar si APACHE está procesando correctamente los archivos PHP. Para eso crearemos un archivo nuevo con el nombre “info.php”.

  • Verifique si el archivo realmente tiene la extensión php y no otra (Windows oculta las extensiones de los archivos que define como “conocidos”).
  • El archivo info.php debe contener una línea con el texto siguiente:
<? phpinfo(); ?> 
  • Grabe el archivo en el directorio de documentos configurado en su servidor Web. En una instalación patrón de APACHE el directorio se llama “htdocs”.
  • Reinicialice el servidor Web
Start > Programs > Apache Software Foundation > Restart Apache 
  • Use su navegador de Internet para visitar la URL:
http://localhost/info.php

Esta página debe mostrar información sobre su instalación de PHP.