mirror of
https://github.com/php/doc-es.git
synced 2026-03-25 16:02:13 +01:00
231f6de4b7
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@334801 c90b9560-bf6c-de11-be94-00142212c4b1
399 lines
12 KiB
XML
399 lines
12 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: ba08db8805ddb14cbab613c893dd47eacbda22f2 Maintainer: jpberdejo Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<section xml:id="ifx.configuration" xmlns="http://docbook.org/ns/docbook">
|
|
&reftitle.runtime;
|
|
&extension.runtime;
|
|
<note>
|
|
<para>
|
|
Asegúrese de que las variables de entorno INFORMIXDIR e
|
|
INFORMIXSERVER estén disponibles para el driver ifx de PHP, y que el
|
|
directorio bin de INFORMIX esté en el <envar>PATH</envar>. Revise esto ejecutando un
|
|
script que contenga una llamada a <function>phpinfo</function>
|
|
antes de comenzar a probar. La salida de <function>phpinfo</function>
|
|
debería listar estas variables de entorno. Esto es verdadero para
|
|
ambos CGI php y Apache mod_php. Es posible que se deban fijar estas
|
|
variables de entorno en el script de arranque de Apache.
|
|
</para>
|
|
<para>
|
|
Las librerías compartidas de Informix también deben de estar disponibles para el
|
|
cargador (revise LD_LIBRARY_PATH o ld.so.conf/ldconfig).
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<title>
|
|
Algunas notas en el uso de BLOBs (columnas TEXT y BYTE)
|
|
</title>
|
|
<para>
|
|
Los BLOBs son referenciados por identificadores BLOB. Peticiones Select
|
|
regresan un "blob id" por cada columna BYTE y TEXT. Se puede llegar
|
|
al contenido con "string_var = ifx_get_blob($blob_id);" si
|
|
se elige colocar los BLOBs en memoria (con:
|
|
"ifx_blobinfile(0);"). Si se prefiere recibir el contenido de
|
|
las columnas BLOB en un fichero, utilice "ifx_blobinfile(1);", y
|
|
"ifx_get_blob($blob_id);" devolverá el nombre del fichero. Utilice E/S de ficheros
|
|
para acceder al contenido del blob.
|
|
</para>
|
|
<para>
|
|
Para peticiones de insert/update se deben crear estos "blob id"
|
|
por cuenta propia con "<function>ifx_create_blob</function>;". Entonces se insertan
|
|
los blob id dentro de una matriz, y se remplazan las columnas blob
|
|
con un signo de interrogación (?) en la cadena de petición. Para
|
|
updates/inserts, se tiene la responsabilidad de fijar el contenido
|
|
del blob con <function>ifx_update_blob</function>.
|
|
</para>
|
|
<para>
|
|
El comportamiento de las columnas BLOB puede ser alterado por variables
|
|
de configuración que también pueden ser fijadas en tiempo de ejecución:
|
|
</para>
|
|
<para>
|
|
variable de configuración: ifx.textasvarchar
|
|
</para>
|
|
<para>
|
|
variable de configuración: ifx.byteasvarchar
|
|
</para>
|
|
<para>
|
|
funciones de tiempo de ejecución:
|
|
</para>
|
|
<para>
|
|
ifx_textasvarchar(0): utilice blob ids para peticiones select con columnas
|
|
TEXT
|
|
</para>
|
|
<para>
|
|
ifx_byteasvarchar(0): utilice blob ids para peticiones select con columnas
|
|
BYTE
|
|
</para>
|
|
<para>
|
|
ifx_textasvarchar(1): devolver columnas TEXT como si fueran
|
|
columnas VARCHAR, de tal manera que no sea necesario utilizar blob ids para
|
|
peticiones select.
|
|
</para>
|
|
<para>
|
|
ifx_byteasvarchar(1): devolver columnas BYTE como si fueran
|
|
columnas VARCHAR, de tal manera que no sea necesario utilizar blob ids para
|
|
peticiones select.
|
|
</para>
|
|
<para>
|
|
variable de configuración: ifx.blobinfile
|
|
</para>
|
|
<para>
|
|
función de tiempo de ejecución:
|
|
</para>
|
|
<para>
|
|
ifx_blobinfile_mode(0): devolver columnas BYTE en memoria, el blob
|
|
id permite acceder al contenido.
|
|
</para>
|
|
<para>
|
|
ifx_blobinfile_mode(1): devolver columnas BYTE en un fichero, el blob
|
|
id permite obtener el nombre del fichero.
|
|
</para>
|
|
<para>
|
|
Si se fija ifx_text/byteasvarchar a 1, se pueden utilizar columnas TEXT y BYTE
|
|
en peticiones select tal como en campos VARCHAR normales (aunque largos).
|
|
Dado que todas las cadenas en PHP son "contadas", esto
|
|
sigue siendo "seguro al tratar con datos binarios". Es su responsabilidad manejar esto
|
|
correctamente. Los datos devueltos pueden no contener nada, Usted es
|
|
responsable del contenido.
|
|
</para>
|
|
<para>
|
|
Si se fija ifx_blobinfile a 1, utilice el nombre de fichero devuelto por
|
|
ifx_get_blob(..) para acceder al contenido del blob. Note que en este caso
|
|
USTED ES EL RESPONSABLE DE BORRAR LOS FICHEROS TEMPORALES CREADOS
|
|
POR INFORMIX al obtener el registro. Cada nuevo registro obtenido
|
|
creará nuevos ficheros temporales para cada columna BYTE.
|
|
</para>
|
|
<para>
|
|
La ubicación de los ficheros temporales puede ser influenciada por la
|
|
variable de entorno "blobdir", por defecto es "." (el directorio
|
|
actual). Algo así como: "putenv(blobdir=tmpblob"); facilitará
|
|
la limpieza de ficheros temporales dejados atrás accidentalmente (todos sus
|
|
nombres inician con "blb").
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<title>Recortado (trimming) automático de datos tipo "char" (SQLCHAR y SQLNCHAR)</title>
|
|
<para>
|
|
Esto puede ser fijado con la variable de configuración
|
|
</para>
|
|
<para>
|
|
ifx.charasvarchar: si se fija en 1 los espacios finales serán
|
|
automáticamente eliminados, para ahorrar un poco de "rebanado".
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<title>Valores &null;</title>
|
|
<para>
|
|
La variable de configuración ifx.nullformat (y la función de tiempo de
|
|
ejecución <function>ifx_nullformat</function>) cuando es fijada a &true;
|
|
devolverá las columnas &null; como la cadena "&null;", cuando es fijada a &false;
|
|
devuelven la cadena vacía. Esto permite discriminar entre
|
|
columnas &null; y columnas vacías.
|
|
</para>
|
|
</note>
|
|
|
|
<para>
|
|
<table>
|
|
<title>Opciones de configuración de Informix</title>
|
|
<tgroup cols="4">
|
|
<thead>
|
|
<row>
|
|
<entry>&Name;</entry>
|
|
<entry>&Default;</entry>
|
|
<entry>&Changeable;</entry>
|
|
<entry>&Changelog;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.allow-persistent">ifx.allow_persistent</link></entry>
|
|
<entry>"1"</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.max-persistent">ifx.max_persistent</link></entry>
|
|
<entry>"-1"</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.max-links">ifx.max_links</link></entry>
|
|
<entry>"-1"</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.default-host">ifx.default_host</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.default-user">ifx.default_user</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.default-password">ifx.default_password</link></entry>
|
|
<entry>NULL</entry>
|
|
<entry>PHP_INI_SYSTEM</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.blobinfile">ifx.blobinfile</link></entry>
|
|
<entry>"1"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.textasvarchar">ifx.textasvarchar</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.byteasvarchar">ifx.byteasvarchar</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.charasvarchar">ifx.charasvarchar</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.ifx.nullformat">ifx.nullformat</link></entry>
|
|
<entry>"0"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminada en PHP 5.2.1.</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
&ini.php.constants;
|
|
</para>
|
|
|
|
&ini.descriptions.title;
|
|
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry xml:id="ini.ifx.allow-persistent">
|
|
<term>
|
|
<parameter>ifx.allow_persistent</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Permitir o no conexiones persistentes a Informix.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.ifx.max-persistent">
|
|
<term>
|
|
<parameter>ifx.max_persistent</parameter>
|
|
<type>integer</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
El número máximo de conexiones persistentes a Informix por
|
|
proceso.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.ifx.max-links">
|
|
<term>
|
|
<parameter>ifx.max_links</parameter>
|
|
<type>integer</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
El número máximo de conexiones a Informix por proceso, incluyendo
|
|
conexiones persistentes.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.default-host">
|
|
<term>
|
|
<parameter>ifx.default_host</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
El host por defecto al cual conectarse cuando no se ha especificado un host
|
|
en <function>ifx_connect</function> o
|
|
<function>ifx_pconnect</function>. No es efectiva en
|
|
&safemode;.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.default-user">
|
|
<term>
|
|
<parameter>ifx.default_user</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
El user id por defecto a utilizarse cuando no se especifica ninguno
|
|
en <function>ifx_connect</function> o
|
|
<function>ifx_pconnect</function>. No es efectiva en
|
|
&safemode;.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.default-password">
|
|
<term>
|
|
<parameter>ifx.default_password</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
La contraseña por omisión a utilizarse cuando no se ha especificado ninguna
|
|
en <function>ifx_connect</function> o
|
|
<function>ifx_pconnect</function>. No es efectiva en
|
|
&safemode;.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.blobinfile">
|
|
<term>
|
|
<parameter>ifx.blobinfile</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Fíjese a &true; si se desea devolver las columnas blob
|
|
en un fichero, &false; si se les desea en memoria. Se puede
|
|
invalidar la opción en tiempo de ejecución
|
|
con <function>ifx_blobinfile_mode</function>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.textasvarchar">
|
|
<term>
|
|
<parameter>ifx.textasvarchar</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Fíjese a &true; si se desea devolver las columnas TEXT
|
|
como cadenas normales en enunciados select,
|
|
&false; si se desea utilizar parámetros blob id. Se puede
|
|
invalidar la opción en tiempo de ejecución
|
|
con <function>ifx_textasvarchar</function>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.byteasvarchar">
|
|
<term>
|
|
<parameter>ifx.byteasvarchar</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Fíjese a &true; si se desea devolver las columnas BYTE
|
|
como cadenas normales en peticiones select,
|
|
&false; si se desea utilizar parámetros blob id. Se puede
|
|
invalidar la opción en tiempo de ejecución con
|
|
<function>ifx_textasvarchar</function>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.charasvarchar">
|
|
<term>
|
|
<parameter>ifx.charasvarchar</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Fíjese a &true; si se desea eliminar los espacios sobrantes
|
|
de las columnas CHAR al traerlas.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="ini.ifx.nullformat">
|
|
<term>
|
|
<parameter>ifx.nullformat</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Fíjese a &true; si se desea devolver columnas &null;
|
|
como la cadena literal "&null;", &false; si se desea
|
|
que sean devueltas como la cadena vacía "". Se puede
|
|
invalidar esta opción en tiempo de ejecución con
|
|
<function>ifx_nullformat</function>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</section>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|
|
|