mirror of
https://github.com/php/doc-es.git
synced 2026-03-26 00:12:06 +01:00
48db252cf2
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@334831 c90b9560-bf6c-de11-be94-00142212c4b1
343 lines
11 KiB
XML
343 lines
11 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 565e478d69a9d0c217eda773c77ca823423adf21 Maintainer: seros Status: ready -->
|
|
<!-- Reviewed: yes Maintainer: seros -->
|
|
<section xml:id="mongo.configuration" xmlns="http://docbook.org/ns/docbook">
|
|
&reftitle.runtime;
|
|
&extension.runtime;
|
|
<para>
|
|
<table>
|
|
<title>&ConfigureOptions; de Mongo</title>
|
|
<tgroup cols="3">
|
|
<thead>
|
|
<row>
|
|
<entry>&Name;</entry>
|
|
<entry>&Default;</entry>
|
|
<entry>&Changeable;</entry>
|
|
<entry>&Changelog;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody xml:id="mongo.configuration.list">
|
|
<row>
|
|
<entry><link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link></entry>
|
|
<entry>0</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.allow-persistent">mongo.allow_persistent</link></entry>
|
|
<entry>1</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Eliminado en 1.2.0</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.chunk-size">mongo.chunk_size</link></entry>
|
|
<entry>262144</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.cmd">mongo.cmd</link></entry>
|
|
<entry>"$"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.default-host">mongo.default_host</link></entry>
|
|
<entry>"localhost"</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.default-port">mongo.default_port</link></entry>
|
|
<entry>27017</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.is-master-interval">mongo.is_master_interval</link></entry>
|
|
<entry>15</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Añadido en 1.2.10, antes de 1.3.0 el valor predeterminado era 60.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.long-as-object">mongo.long_as_object</link></entry>
|
|
<entry>o</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.native-long">mongo.native_long</link></entry>
|
|
<entry>1</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Antes de la versión 1.5.0, el valor predeterminado era 0.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.ping-interval">mongo.ping_interval</link></entry>
|
|
<entry>5</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry>Añadido en 1.2.10</entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.mongo.utf8">mongo.utf8</link></entry>
|
|
<entry>1</entry>
|
|
<entry>PHP_INI_ALL</entry>
|
|
<entry></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
&ini.php.constants;
|
|
</para>
|
|
|
|
&ini.descriptions.title;
|
|
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry xml:id="ini.mongo.allow-empty-keys">
|
|
<term>
|
|
<parameter>mongo.allow_empty_keys</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Añadido en la versión 1.0.11.
|
|
</para>
|
|
<para>
|
|
Si deberían permitirse las cadenas vacías ("") como nombres de claves. Por omisión,
|
|
el controlador lanzará una excepción si se intenta pasar la cadena vacía como
|
|
una clave a la base de datos. Es extremadamente fácil hacer esto inadvertidamente
|
|
usando comillas dobles con operadores $, por lo que se recomienda que se deje
|
|
este ajuste predeterminado. Sin embargo, si se necesita guardar claves que son cadenas
|
|
vacías, se puede establecer esta opción a true para que el controlador permita
|
|
pasar cadenas vacías a la base de datos.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.allow-persistent">
|
|
<term>
|
|
<parameter>mongo.allow_persistent</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Indica si se permiten o no conexiones persistentes. (Eliminado en 1.2.0 - ahora
|
|
todas las conexiones son persistentes).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.chunk-size">
|
|
<term>
|
|
<parameter>mongo.chunk_size</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
El número de bytes por bloque. Se usa al fragmentar ficheros GridFS. Este valor
|
|
debe ser al menos 100 veces menor que 4 megabytes (máx: 4194204) y se recomienda
|
|
que sea incluso menor.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.cmd">
|
|
<term>
|
|
<parameter>mongo.cmd</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Un carácter que se utiliza en lugar de $ en los modificadores y comparaciones.
|
|
</para>
|
|
<para>
|
|
En vista de que es fácil olvidar escapar el carácter "$", puede elegirse
|
|
cualquier otro en su lugar. Escoja un carácter que no aparezca en sus
|
|
nombres de clave, como por ejemplo ":":
|
|
</para>
|
|
<programlisting role="ini">
|
|
<![CDATA[
|
|
mongo.cmd = ":"
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Ahora, para hacer una comparación, sería:
|
|
</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
|
|
$query = array( "i" => array( ":gt" => 20, ":lte" => 30 ) );
|
|
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Puede cambiarse también en tiempo de ejecución usando
|
|
<literal>ini_set("mongo.cmd", ":")</literal>. Por supuesto, también
|
|
pueden usarse comillas simples o la barra \ para escapar el carácter $.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.default-host">
|
|
<term>
|
|
<parameter>mongo.default_host</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Nombre de host predeterminaodo en caso de que no se especifique en el constructor.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.default-port">
|
|
<term>
|
|
<parameter>mongo.default_port</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Puerto TCP predeterminado al conectar al servidor de bases de datos en caso
|
|
de que no se especifique ningún puerto. El predeterminado para la base de datos es
|
|
<literal>27017</literal>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.is-master-interval">
|
|
<term>
|
|
<parameter>mongo.is_master_interval</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Añadido en la versión 1.2.10.
|
|
</para>
|
|
<para>
|
|
Para conexiones de conjuntos réplica: El intervalo mínimo con el que el controlador
|
|
enviará peticiones "isMaster" al servidor MongoDB. Si el valor es bajo,
|
|
existirán más peticiones, pero el controlador será más rápido si la
|
|
topología del conjunto réplica ha sido cambiada.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.long-as-object">
|
|
<term>
|
|
<parameter>mongo.long_as_object</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Devuelve un BSON_LONG como una instancia de <classname>MongoInt64</classname>
|
|
(en lugar de usar el tipo primitivo).
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.native-long">
|
|
<term>
|
|
<parameter>mongo.native_long</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
<emphasis>
|
|
Este valor predeterminado ha cambiado a &true; en 1.5.0, deberá
|
|
asegurarse de establecer el valor deseado (probablemente &true;) de
|
|
manera que el comportamiento del controlador no se vea afectado al actualizarlo.
|
|
</emphasis>
|
|
</para>
|
|
<para>
|
|
En plataformas de 64 bits, el ajuste <literal>mongo.native_long</literal>
|
|
permite almacenar enteros de 64 bits en MongoDB. Si no se habilita, sólo se
|
|
podrán almacenar enteros de 32 bits. El tipo de dato MongoDB usado en
|
|
este caso es el BSON LONG, en lugar del BSON INT, que es el que funciona
|
|
cuando se deshabilita este ajuste.
|
|
</para>
|
|
<para>
|
|
Este ajuste también cambia el modo en que los tipos BSON LONG se comportan cuando se
|
|
consultan en MongoDB. Cuando <literal>mongo.native_long</literal> no está habilitado,
|
|
el driver convierte todos los BSON LONG al tipo double de PHP, por lo que podría
|
|
provocar una pérdida de precisión.
|
|
</para>
|
|
<para>
|
|
En plataformas de 32 bits, el ajuste <literal>mongo.native_log</literal> no
|
|
tiene efecto al almacenar enteros en MongoDB: los enteros se almacenan
|
|
como BSON INT. Sin embargo, cuando este ajuste está habilitado y se consulta
|
|
un tipo BSON LONG en MongDB, se emitirá una excepción
|
|
<classname>MongoCursorException</classname> alertando de que los datos
|
|
podrían no leerse sin pérdida de precisión.
|
|
</para>
|
|
<para>
|
|
Se recomienda que, en sistemas de 32 bits especialmente, se combine esto con
|
|
la habilitación de <literal>mongo.long_as_object</literal>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.ping-interval">
|
|
<term>
|
|
<parameter>mongo.ping_interval</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Añadido en la versión 1.2.10.
|
|
</para>
|
|
<para>
|
|
Para conexiones de conjuntos réplica: El intervalo mínimo con el que el controlador
|
|
enviará peticiones "ping" al servidor MongoDB. Si el valor es bajo,
|
|
existirán más pings, pero el controlador será más rápido si un nodo ya
|
|
no sepuede recuperar del conjunto réplica.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.mongo.utf8">
|
|
<term>
|
|
<parameter>mongo.utf8</parameter>
|
|
<type>int</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Indica si se debe lanzar una excepción con cadenas que no sean UTF8. Hasta la versión
|
|
1.0.4, el controlador de PHP ignoraba las cadenas que no eran UTF8, incluso cuando no
|
|
se esperaba que se fueran a insertar. Desde 1.0.4, el controlador emite una
|
|
<classname>MongoException</classname>. Para facilitar la transición en las
|
|
aplicaciones que insertan cadenas que no son UTF8, puede deshabiltiarse esta opción
|
|
para emular el comportamiento anterior en el que no se emitían excepciones. Sin embargo, esta opción
|
|
será eliminada en la versión 1.1.0, de manera que siempre se emitirán excepciones en
|
|
textos que no son UTF8.
|
|
</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
|
|
-->
|