|
|
 |
Capítulo 4. ConfiguraciónEl archivo de configuración
El archivo de configuración (llamado php3.ini en
PHP 3.0, y simplemente php.ini a partir del PHP 4.0)
es leído cuando arranca el PHP. Para las versiones de PHP como módulo
de servidor esto sólo ocurre una vez al arrancar el servidor web. Para
la versión CGI, esto ocurre en cada llamada.
Cuando se utiliza PHP como módulo Apache, también puede cambiar
los ajustes de configuración utilizando directivas en los archivos
de configuración del Apache y en los .htaccess.
Con el PHP 3.0 hay directivas Apache que se corresponden a cada uno
de los ajustes de configuración del php3.ini,
con la excepción que su nombre va precedido de "php3_".
Con el PHP 4.0 sólo hay unas pocas directivas de Apache que le
permiten cambiar los ajustes de configuración del PHP.
- php_value
nombre
valor
Fija el valor de la variable especificada. - php_flag
nombre
on|off
Fija una opción de configuración de tipo Boolean. - php_admin_value
nombre
valor
Fija el valor de la variable especificada. Los ajustes de
configuración de tipo "Admin" sólo se pueden fijar desde
los archivos principales de configuración del Apache, y no
desde los .htaccess. - php_admin_flag
nombre
on|off
Fija una opción de configuración de tipo Boolean.
Puede ver los ajustes de los valores de configuración en
la salida de phpinfo(). También puede
acceder a los valores individuales de los ajustes de
configuración utilizando get_cfg_var(). Directivas Generales de Configuración
- asp_tags
boolean
Permite el uso de las etiquetas estilo ASP <% %> además
de las habituales etiquetas <?php ?>. También se incluye
el atajo para imprimir variables <%= $valor %>. Para más
información, vea Escapando del HTML.
Nota: El soporte para etiquetas estilo ASP se añadió en la 3.0.4.
- auto_append_file
string
Especifica el nombre de un archivo que es troceado automáticamente
después del archivo principal. El archivo se incluye como si fuese
llamado mediante la función include(), así que
se utiliza include_path.
El valor especial none desconecta la
adición automática de archivos.
Nota:
Si el script es terminado con exit(),
no tendrá lugar la adición automática.
- auto_prepend_file
string
Especifica el nombre de un archivo que es troceado automáticamente
antes del archivo principal.
Specifies the name of a file that is automatically parsed
before the main file. El archivo se incluye como si fuese
llamado mediante la función include(), así que
se utiliza include_path.
El valor especial none
desconecta la adición automática de archivos.
- cgi_ext
string
- display_errors
boolean
Determina si los errores se visualizan en pantalla como parte
de la salida en HTML o no.
- doc_root
string
"Directorio raiz" del PHP en el servidor. Sólo se usa
si no está vacío. Si el PHP se configura con safe mode,
no se sirven archivos fuera de este directorio.
- engine
boolean
Esta directiva sólo es realmente útil en la versión de PHP
como módulo Apache. Se utiliza por sitios que desean habilitar
la ejecución del PHP directorio por directorio o en base a cada
servidor virtual. Poniendo php3_engine
off en los sitios apropiados del archivo
httpd.conf, se puede habilitar o deshabilitar
el PHP.
- error_log
string
Nombre del fichero para registrar los errores de un script. Si se
utiliza el valor especial syslog, los errores
se envían al registro de errores del sistema. En UNIX se refiere a
syslog(3) y en Windows NT al registro de eventos. El registro de
errores del sistema no es soportado bajo Windows 95. - error_reporting
integer
Fija el nivel de informe de errores. El parámetro es un entero
que representa un campo de bits. Sume los valores de los niveles
de informe de error que desea.
Tabla 4-1. Niveles de Informe de Errores | valor de bit | informe habilitado |
|---|
| 1 | errores normales | | 2 | avisos normales | | 4 | errores del troceador (parser) | | 8 | avisos de estilo no críticos |
El valor por defecto para esta directiva es 7 (se muestran
los errores normales, avisos normales y errores de parser).
- open_basedir
string
Limita los archivos que se pueden abrir por el PHP al árbol
de directorios especificado.
Cuando un script intenta abrir un archivo con, por ejemplo,
fopen o gzopen, se comprueba su localización. Si el fichero
está fuera del árbol de directorios especificado, PHP se negará
a abrirlo. Todos los enlaces simbólicos son resueltos, de modo
que no es posible evitar esta limitación usando uno de ellos.
El valor especial .
indica que el directorio base será aquel en el que reside el script.
Bajo Windows, separe los directorios mediante punto y coma. En el resto
de sistemas, sepárelos con dos puntos ":". Como módulo de Apache,
los senderos para open_basedir de los directorios padre se heredan
ahora automáticamente.
Nota: El soporte para directorios múltiples se añadió en la 3.0.7.
El valor por defecto es permitir abrir todos los archivos.
- gpc_order
string
Fija el order de troceo de variables GET/POST/COOKIE. El valor
por defecto de esta directiva es "GPC". Fijándola, por ejemplo,
a "GP", hará que el PHP ignore por completo las cookies y que
sobreescriba las variables recibidas por GET con las que tengan
el mismo nombre y vengan por POST.
- ignore_user_abort
string
Por defecto está a on. Si se cambia a off, los script terminarán
tan pronto como intenten enviar algo después de que un cliente
ha roto la conexión.
ignore_user_abort().
- include_path
string
Especifica una lista de directorios en los que las funciones
require(), include()
y fopen_with_path() buscan los archivos.
El formato es similar a la variable de entorno de sistema
PATH: una lista de directorios separados por
dos puntos en UNIX o por punto y coma en Windows.
Ejemplo 4-1. include_path en UNIX include_path=.:/home/httpd/php-lib |
|
Ejemplo 4-2. include_path en Windows include_path=".;c:\www\phplib" |
|
El valor por defecto para esta directiva es .
(sólo el directorio actual).- isapi_ext
string
- log_errors
boolean
Dice si los mensajes de error de los script deben ser registrados
o no en el registro del servidor. Esta opción, por tanto, es
específica del mismo. - magic_quotes_gpc
boolean
Fija el estado magic_quotes para operaciones GPC (Get/Post/Cookie).
Si magic_quotes vale on, todas las ' (comilla sencilla),
" (comilla doble), \ (barra invertida) y los NUL son
automáticamente marcados con una barra invertida. Si además
magic_quotes_sybase vale on, la comilla sencilla es
marcada con otra comilla sencilla en lugar de la barra
invertida.
- magic_quotes_runtime
boolean
Si se habilita magic_quotes_runtime, muchas
de las funciones que devuelven datos de algún tipo de fuente
externa incluyendo bases de datos y archivos de texto devolverán
las comillas marcadas con una barra invertida. Si también
está activo magic_quotes_sybase, la
comilla simple es marcada con una comilla simple en lugar
de la barra invertida.
- magic_quotes_sybase
boolean
Si magic_quotes_sybase está a on, la
comilla simple es marcada con una comilla simple en lugar
de la barra invertida cuando están habilitados
magic_quotes_gpc o
magic_quotes_runtime.
- max_execution_time
integer
Fija el tiempo máximo en segundos que se le permite usar
a un script antes de ser finalizado por el intérprete. Así
se evita que scripts mal escritos puedan bloquear el servidor.
- memory_limit
integer
Fija el tamaño máximo de memoria en bytes que se permite
reclamar a un script. Así se evita que script mal escritos
se coman toda la memoria dispomible de un servidor.
- nsapi_ext
string
- short_open_tag
boolean
Indica si se debe permitir el formato corto (<? ?>)
de la etiqueta de apertura del PHP. Si desea utilizar PHP en
combinación con XML, deberá desactivar esta opción. Si está
desactivada, deberá utilizar el formato largo de la etiqueta
de apertura (<?php ?>). - sql.safe_mode
boolean
- track_errors
boolean
Si está habilitada, el último mensaje de error estará siempre
presente en la variable global $php_errormsg. - track_vars
boolean
Si está activada, la información de entrada de GET, POST y
de las cookies se puede encontrar en las matrices asociativas
$HTTP_GET_VARS,$HTTP_POST_VARS y
$HTTP_COOKIE_VARS respectivamente. - upload_tmp_dir
string
El directorio temporal utilizado para almacenar archivos
cuando se envían al servidor. Debe tener permiso de escritura
para el usuario bajo el que corra el PHP. - user_dir
string
El nombre base del directorio utilizado bajo el directorio
inicial de un usuario para los archivos PHP. Por ejemplo:
paginas_html. - warn_plus_overloading
boolean
Si está activada, esta opción hace que el PHP muestre un
aviso cuando el operador suma (+) se
utiliza en cadenas. Así es más fácil encontrar scripts que
necesitan ser reescritos utilizando en su lugar el concatenador
de cadenas (.).
Directivas de Configuración de Correo- SMTP
string
Nombre DNS o dirección IP del servidor de SMTP que el PHP bajo
Windows deberá usar para enviar correo con la función
mail(). - sendmail_from
string
La dirección del remitente ("De:") para los
correos enviados desde PHP bajo Windows. - sendmail_path
string
Localización del programa sendmail.
Generalmente /usr/sbin/sendmail o
/usr/lib/sendmail.
configure intenta localizarle este
archivo lo mejor que puede y fijar un valor por defecto,
pero en caso de fallo, lo puede usted fijar aquí.
Los sistemas que no usan sendmail deberán fijar esta directiva
al nombre del programa alternativo que ofrezca su sistema de
correo, si es que existe. Por ejemplo, los usuarios del
Qmail pueden fijarlo
normalmente a /var/qmail/bin/sendmail.
Directivas de Configuración de Modo Seguro- safe_mode
boolean
Para activar el modo seguro del PHP. Lea el
Capítulo de seguridad para
más información. - safe_mode_exec_dir
string
Si el PHP se utiliza en modo seguro, la función system()
y el resto de funciones que ejecutan programas del sistema
se niegan a ejecutar programas que no estén en este directorio.
Directivas de Configuración del Debugger- debugger.host
string
Nombre DNS o dirección IP del servidor usado por el debugger. - debugger.port
string
Número de puerto usado por el debugger. - debugger.enabled
boolean
Indica si el debugger está habilitado o no.
Directivas de Carga de Extensiones- enable_dl
boolean
Esta directiva sólo es útil en la versión del PHP como
módulo del Apache. Puede habilitar o deshabilitar para
un servidor virtual o para un directorio la carga
dinámica de extensiones de PHP mediante dl().
La razón principal para deshabilitar la carga dinámica
es la seguridad. Con la carga dinámica es posible ignorar
las restricciones safe_mode y open_basedir.
El valor por defecto es permitir la carga dinámica, excepto
cuando se usa el modo seguro. En modo seguro, siempre es
imposible usar dl().
- extension_dir
string
En qué directorio debe buscar el PHP las extensiones cargables
dinámicamente. - extension
string
Qué extensiones dinámicas debe cargar el PHP cuando arranca.
Directivas de Configuración de MySQL- mysql.allow_persistent
boolean
Si permitir o no conexiones MySQL persistentes. - mysql.default_host
string
El servidor por defecto para utilizar cuando se conecte al
servidor de bases de datos si no se especifica otro distinto.
- mysql.default_user
string
El nombre de usuario por defecto para utilizar cuando se conecta
al servidor de base de datos si no se especifica otro.
- mysql.default_password
string
La clave por defecto para utilizar cuando se conecta al servidor
de base de datos si no se especifica otro.
- mysql.max_persistent
integer
El número máximo de conexiones persistentes de MySQL
por proceso.
- mysql.max_links
integer
El número máximo de conexiones de MySQL por proceso,
incluyendo las persistentes.
Directivas de Configuración de mSQL- msql.allow_persistent
boolean
Si se permiten o no conexiones persistentes de mSQL.
- msql.max_persistent
integer
El número máximo de conexiones persistentes mSQL por proceso.
- msql.max_links
integer
El número máximo de conexiones de mSQL por proceso,
incluyendo las persistentes.
Directivas de Configuración de Postgres- pgsql.allow_persistent
boolean
Si se permiten o no conexiones persistentes de Postgres.
- pgsql.max_persistent
integer
El número máximo de conexiones persistentes Postgres por proceso.
- pgsql.max_links
integer
El número máximo de conexiones de Postgres por proceso,
incluyendo las persistentes.
SESAM Configuration Directives- sesam_oml
string
Name of BS2000 PLAM library containing the loadable SESAM
driver modules. Required for using SESAM functions. The
BS2000 PLAM library must be set ACCESS=READ,SHARE=YES
because it must be readable by the apache server's user id.
- sesam_configfile
string
Name of SESAM application configuration file. Required for
using SESAM functions. The BS2000 file must be readable by
the apache server's user id.
The application configuration file will usually contain a
configuration like (see SESAM
reference manual):
- sesam_messagecatalog
string
Name of SESAM message catalog file. In most cases, this
directive is not neccessary. Only if the SESAM message file
is not installed in the system's BS2000 message file table,
it can be set with this directive.
The message catalog must be set ACCESS=READ,SHARE=YES because
it must be readable by the apache server's user id.
Directivas de Configuración de Sybase- sybase.allow_persistent
boolean
Si se permiten o no conexiones persistentes de Sybase.
- sybase.max_persistent
integer
El número máximo de conexiones persistentes Sybase por proceso.
- sybase.max_links
integer
El número máximo de conexiones de Sybase por proceso,
incluyendo las persistentes.
Directivas de Configuración de Sybase-CT- sybct.allow_persistent
boolean
Si se permiten o no conexiones persistentes de Sybase-CT.
El valor por defecto es on.
- sybct.max_persistent
integer
El número máximo de conexiones persistentes Sybase-CT por
proceso. El valor por defecto es -1, que significa ilimitadas.
- sybct.max_links
integer
El número máximo de conexiones de Sybase-CT por proceso,
incluyendo las persistentes. El valor por defecto es -1,
que significa ilimitadas.
- sybct.min_server_severity
integer
Los mensajes de servidor con gravedad mayor o igual que
sybct.min_server_severity serán
reportados como avisos. Este valor también se puede cambiar desde
un script usando la función sybase_min_server_severity().
El valor por defecto es 10, que reporta los errores de
información con gravedad o mayores.
- sybct.min_client_severity
integer
Los mensajes de librería de cliente con gravedad mayor o
igual que sybct.min_client_severity
serán reportados como avisos. Este valor también se puede
cambiar desde un script usando la función
sybase_min_client_severity(). El valor
por defecto es 10, que desconecta los avisos.
- sybct.login_timeout
integer
El número máximo de segundos de espera por un intento de
conexión con éxito antes de indicar un fallo. Nótese que
si se ha excedido max_execution_time
cuando finaliza la espera de un intento de conexión, el
script será finalizado antes de que se pueda tomar una
acción en caso de fallo. El valor por defecto es 1 minuto.
- sybct.timeout
integer
El número máximo de segundos de espera por una operación
de consulta o select_db con éxito antes de indicar un fallo.
Nótese que si se ha excedido max_execution_time
cuando finaliza la espera de un intento de conexión, el
script será finalizado antes de que se pueda tomar una
acción en caso de fallo. El valor por defecto es sin límite.
- sybct.hostname
string
El nombre de la máquina desde la que dice estarse conectando,
para que se visualize con sp_who(). El
valor por defecto es "none".
Directivas de Configuración de Informix- ifx.allow_persistent
boolean
Si se permiten o no conexiones persistentes de Informix.
- ifx.max_persistent
integer
El número máximo de conexiones persistentes de Informix
por proceso.
- ifx.max_links
integer
El número máximo de conexiones Informix por proceso,
incluyendo las persistentes.
- ifx.default_host
string
El servidor por defecto al que conectarse si no se
especifica uno en ifx_connect() o
en ifx_pconnect().
- ifx.default_user
string
El id de usuario por defecto para utilizar si no
se especifica uno en ifx_connect() o
en ifx_pconnect().
- ifx.default_password
string
La clave por defecto para utilizar si no se especifica
uno en ifx_connect() o en
ifx_pconnect().
- ifx.blobinfile
boolean
Fíjelo a TRUE si desea recibir las columnas
blob (objetos binarios grandes) en un archivo,
y a FALSE si las desea en memoria. Puede cambiar
el ajuste en tiempo de ejecución utilizando
ifx_blobinfile_mode().
- ifx.textasvarchar
boolean
Fíjelo a TRUE si desea recibir las columnas TEXT
como cadenas normales en las instrucciones select,
y a FALSE si quiere usar parámetros de identificador
de blobs. Puede cambiar el ajuste en tiempo de
ejecución utilizando ifx_textasvarchar().
- ifx.byteasvarchar
boolean
Fíjelo a TRUE si desea devolver las columnas BYTE
como cadenas normales en las instrucciones select,
y a FALSE si quiere usar parámetros de identificador
de blobs. Puede cambiar el ajuste en tiempo de
ejecución utilizando ifx_byteasvarchar().
- ifx.charasvarchar
boolean
Fíjelo a TRUE si desea suprimir los espacios a la
derecha de las columnas CHAR cuando las solicita.
- ifx.nullformat
boolean
Fíjelo a TRUE si desea que las columnas NULL (nulas)
se devuelvan como la cadena literal "NULL", y a
FALSE si desea que se devuelvan como la cadena vacía
"". Puede cambiar el ajuste en tiempo de ejecución
utilizando ifx_nullformat().
Directivas de Configuración de Matemática BC- bcmath.scale
integer
Número de dígitos decimales para todas las funciones
de bcmath.
Directivas de Configuración de Capacidades de los NavegadoresDirectivas Unificadas de Configuración de ODBC
User Contributed Notes Configuración |
 |
| There are no user contributed notes for this page. |
| |