-tipos
-
-
- =El tipo es recuperado desde el MIB
- iINTEGER
- uINTEGER
- sSTRING
- xHEX STRING
- dDECIMAL STRING
- nNULLOBJ
- oOBJID
- tTIMETICKS
- aIPADDRESS
- bBITS
-
-
+ tipos
+
+
+ =El tipo es recuperado desde el MIB
+ iINTEGER
+ uINTEGER
+ sSTRING
+ xHEX STRING
+ dDECIMAL STRING
+ nNULLOBJ
+ oOBJID
+ tTIMETICKS
+ aIPADDRESS
+ bBITS
+
+
-Si la constante OPAQUE_SPECIAL_TYPES ha sido definida durante
-la compilación de la biblioteca SNMP, los caracteres siguientes
-también estarán disponibles:
+ Si la constante OPAQUE_SPECIAL_TYPES ha sido definida durante la compilación de la biblioteca SNMP, los caracteres siguientes también estarán disponibles:
-tipos
-
-
- Uint64 sin signo
- Iint64 con signo
- Ffloat
- Ddouble
-
-
+ tipos
+
+
+ Uint64 sin signo
+ Iint64 con signo
+ Ffloat
+ Ddouble
+
+
'>
-
-La mayoría de estos valores utilizan el tipo ASN.1 correspondiente. 's', 'x', 'd' y 'b'
-son todas formas diferentes de especificar el valor OCTET STRING y el tipo sin signo
-'u' también es utilizado para manejar los valores Gauge32.
+
+ La mayoría de estos valores utilizan el tipo ASN.1 correspondiente. 's', 'x', 'd' y 'b' son todas formas diferentes de especificar el valor OCTET STRING y el
+ tipo sin signo 'u' también es utilizado para manejar los valores Gauge32.
'>
-
-Si los archivos MIB son cargados en el árbol MIB con "snmp_read_mib" o especificándolos
-en la configuración de libsnmp, '=' podrá ser utilizado como parámetro
-de tipo para todos los identificadores de objetos, ya que el tipo puede ser leído automáticamente desde el MIB.
+
+ Si los ficheros MIB se cargan en el árbol MIB con "snmp_read_mib" o especificándolos en la configuración de libsnmp, se puede usar '=' como el
+ parámetro type para todos los identificadores de objeto, ya que entonces el tipo se puede leer automáticamente desde el MIB.
'>
-
-Nota que hay 2 formas de definir una variable de tipo BITS como i.e.
-"SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
+
+ Nota que hay 2 formas de definir una variable de tipo BITS como i.e. "SYNTAX
+ BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
-
-
- Utilizando el tipo "b" y una lista de octetos. Este método no es
- recomendado ya que la petición GET para un mismo OID retornará i.e. 0xF8.
-
-
-
-
- Utilizando el tipo "x" y un número hexadecimal pero sin(!) el prefijo usual
- "0x".
-
-
+
+
+ Utilizando el tipo "b" y una lista de octetos. Este método no es recomendado ya que la petición GET para un mismo OID retornará i.e. 0xF8.
+
+
+
+
+ Utilizando el tipo "x" y un número hexadecimal pero sin(!) el prefijo usual "0x".
+
+
-Consúltese la sección sobre ejemplos para más detalles.
+ Consúltese la sección sobre ejemplos para más detalles.
'>
-
+
&reftitle.errors;
- Este método no lanza excepciones por omisión.
- Para activar el lanzamiento de excepciones SNMPException cuando
- ocurren errores de la biblioteca,
- el parámetro de la clase SNMP exceptions_enabled
- debe ser definido al valor correspondiente. Ver las
- explicaciones sobre SNMP::$exceptions_enabled
- para más detalles.
+ Este método no lanza excepciones por defecto. Para activar
+ el lanzamiento de excepciones SNMPException cuando ocurren errores de la biblioteca, el parámetro
+ de la clase SNMP exceptions_enabled
+ ebe ser definido al valor correspondiente. Ver las explicaciones
+ sobre SNMP::$exceptions_enabled para más detalles.
'>
-
-
-La función de retrollamada callback
-es llamada cuando la petición está terminada.
+
+ La función
+de retrollamada callback es llamada cuando la petición está terminada.
Debe corresponder al siguiente prototipo:
-
- data
- representa los datos personalizados pasados a la petición.
-
-
- result
- representa el valor resultante específico de la petición; básicamente,
- el valor retornado por la llamada al sistema correspondiente.
-
-
- req
- es el recurso opcional de la petición que puede ser
- utilizado con funciones como eio_get_last_error.
-
+
+data
+representa los datos personalizados pasados a la petición.
+
+
+result
+representa el valor resultante específico de la petición; básicamente, el valor retornado por la llamada
+al sistema correspondiente.
+
+
+req
+es el recurso opcional de la petición que puede ser utilizado con funciones como eio_get_last_error.
+
'>
- La prioridad de la petición: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, o &null;.
-Si &null; es pasado, el parámetro pri, internamente, es definido a
+xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, o &null;. Si
+&null; es pasado, el parámetro pri, internamente, es definido a
EIO_PRI_DEFAULT.
'>
- Evitar los
- caminos relativos.
+Evite las rutas
+relativas.
'>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
- TRADER_MA_TYPE_* debe ser utilizada.'>
-
- TRADER_REAL_MIN a TRADER_REAL_MAX.'>
- TRADER_REAL_MIN a TRADER_REAL_MAX.'>
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_MA_TYPE_* debe ser utilizada.'>
+TRADER_REAL_MIN a TRADER_REAL_MAX.'>
+TRADER_REAL_MIN a TRADER_REAL_MAX.'>
+
+
+
+
+
PECL mongodb 2.0.0
- Esta clase ha sido eliminada.
+ Esta clase ha sido eliminada.
-
+
'>
-
+
PECL mongodb 2.0.0
- Esta función ha sido eliminada.
+ Esta función ha sido eliminada.
-
+
'>
-
+
PECL mongodb 2.0.0
- Este método ha sido eliminado.
+ Este método ha sido eliminado.
-
+
'>
-
+
PECL mongodb 2.0.0
-
- Esta clase ya no implementa la interfaz
- Serializable.
-
+
+ Esta clase ya no implementa la interfaz
+ Serializable.
+
-
+
'>
-
- PECL mongodb 1.15.0
-
- Los tipos de retorno de los métodos son declarados como provisionales en PHP 8.0 y posteriores,
- lo que desencadena avisos de depreciación en el código que implementa esta interfaz sin declarar
- los tipos de retorno apropiados.
- El atributo #[ReturnTypeWillChange] puede ser añadido
- para ignorar la notificación de depreciación.
-
-
+
+ PECL mongodb 1.15.0
+
+ Los tipos de retorno de los métodos son declarados como provisionales en PHP 8.0 y posteriores, lo
+ que desencadena avisos de depreciación en el código que implementa esta interfaz
+ sin declarar los tipos de retorno apropiados. El atributo #[ReturnTypeWillChange]
+ puede ser añadido para ignorar la notificación de depreciación.
+
+
'>
-
+
PECL mongodb 2.0.0
- Los tipos de retorno previamente declarados como provisionales ahora son aplicados.
+ Los tipos de retorno previamente declarados como provisionales ahora son aplicados.
-
+
'>
-
+
PECL mongodb 2.0.0
-
- Este método ahora lanza una excepción cuando es llamado
- para una escritura no reconocida, en lugar de retornar &null;.
-
+
+ Este método ahora lanza una excepción cuando es llamado para una escritura no reconocida, en lugar de retornar &null;.
+
-
+
'>
-
-collation
-arrayobject
-
-
- Collation permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el documento Collation.
-
-
- Si la collation no es especificada pero la colección tiene una collation por omisión, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas.
-
-
- Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior.
-
-
-
+
+ collation
+ arrayobject
+
+
+ Collation permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el documento Collation.
+
+
+ Si la collation no es especificada pero la colección tiene una collation predeterminada, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas.
+
+
+ Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior.
+
+
+
'>
-
-
- let
- arrayobject
-
-
- Diccionario de nombres y valores de parámetros. Los valores deben ser constantes o expresiones cerradas que no hagan referencia a campos del documento. Los parámetros pueden ser accedidos luego como variables en un contexto de expresión agregada (por ejemplo $$var).
-
-
- Esta opción está disponible en MongoDB 5.0+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión anterior del servidor.
-
-
-
+
+ let
+ arrayobject
+
+
+ Diccionario de nombres y valores de parámetros. Los valores deben ser constantes o expresiones cerradas que no hagan referencia a campos del documento. Los parámetros pueden ser accedidos luego como variables en un contexto de expresión agregada (por ejemplo $$var).
+
+
+ Esta opción está disponible en MongoDB 5.0+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión anterior del servidor.
+
+
+
'>
-
-
keyVaultClientMongoDB\Driver\Manager
- El Manager utilizado para enrutar las peticiones de claves de datos a un cluster MongoDB diferente. Por omisión, el Manager y cluster actual es utilizado.
+ El Manager utilizado para enrutar las peticiones de claves de datos a un cluster MongoDB diferente. Por defecto, el Manager y cluster actual es utilizado.
'>
-
keyVaultNamespace
- &string;
+ stringUn nombre de espacio completamente calificado (por ejemplo "databaseName.collectionName") denotando la colección que contiene todas las claves de datos utilizadas para el cifrado y descifrado. Esta opción es requerida.
-
-'>
+'>
+
kmsProviders
- &array;
+ array
- Un documento que contiene la configuración de uno o varios
- proveedores KMS, que se utilizan para cifrar las claves de datos.
- Los proveedores soportados son "aws",
- "azure", "gcp" y
- "local", y al menos uno debe ser especificado.
+ Un documento que contiene la configuración de uno o más proveedores KMS, que se utilizan para cifrar claves de datos. Los proveedores admitidos incluyen "aws", "azure", "gcp", "kmip" y "local", y se debe especificar al menos uno.
Si se especifica un documento vacío para "aws",
- "azure", o "gcp", el controlador
- intentará configurar el proveedor utilizando
+ "azure" o "gcp", el
+ controlador intentará configurar el proveedor utilizando
Automatic Credentials.
@@ -3278,7 +3190,6 @@ azure: {
clientId: ,
clientSecret: ,
identityPlatformEndpoint: // Defaults to "login.microsoftonline.com"
-
}
]]>
@@ -3291,7 +3202,6 @@ gcp: {
email: ,
privateKey: |,
endpoint: // Defaults to "oauth2.googleapis.com"
-
}
]]>
@@ -3319,8 +3229,7 @@ local: {
'>
-
-
Opciones del proveedor "aws"
@@ -3377,7 +3286,7 @@ local: {
keyVersionstring
- Opcional. Una versión específica de la clave nombrada. Por omisión, se utiliza la versión primaria de la clave.
+ Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave.
@@ -3418,12 +3327,12 @@ local: {
keyVersionstring
- Opcional. Una versión específica de la clave nombrada. Por omisión, se utiliza la versión primaria de la clave.
+ Opcional. Una versión específica de la clave nombrada. De forma predeterminada, se utiliza la versión primaria de la clave.endpointstring
- Opcional. Host con puerto opcional. El valor por omisión es "cloudkms.googleapis.com".
+ Opcional. Host con puerto opcional. El valor predeterminado es "cloudkms.googleapis.com".
@@ -3454,28 +3363,22 @@ local: {
delegatedbool
- Opcional. Si es verdadero, esta clave debe ser descifrada por el servidor KMIP.
+ Opcional. Si es true, esta clave debe ser descifrada por el servidor KMIP.
'>
-
-
- tlsOptions
- array
-
-
- Un documento que contiene la configuración TLS de uno o varios
- proveedores KMS.
- Los proveedores soportados son "aws",
- "azure", "gcp" y
- "kmip".
- Todos los proveedores soportan las siguientes opciones:
-
-
+
+ tlsOptions
+ array
+
+
+ Un documento que contiene la configuración TLS de uno o varios proveedores KMS. Los proveedores soportados son "aws", "azure", "gcp" y "kmip". Todos los proveedores soportan las siguientes opciones:
+
+
: {
tlsCaFile: ,
@@ -3484,467 +3387,436 @@ local: {
tlsDisableOCSPEndpointCheck:
}
]]>
-
-
-
-'>
-
-
- maxCommitTimeMS
- integer
-
-
- El tiempo máximo en milisegundos para permitir que una sola
- comando commitTransaction se ejecute.
-
-
- Si se especifica, maxCommitTimeMS debe ser un entero
- 32 bits con signo superior o igual a cero.
-
-
-
-'>
-
-readConcern
-MongoDB\Driver\ReadConcern
-
-
- Una preocupación de lectura a aplicar a la operación.
-
-
- Esta opción está disponible en MongoDB 3.2+ y se traducirá en
- una excepción en el momento de la ejecución si se especifica para
- una versión más antigua del servidor.
-
-
-
-'>
-
-readPreference
-MongoDB\Driver\ReadPreference
-
-
- Una preferencia de lectura a utilizar para seleccionar un servidor
- para la operación.
-
-
-
+
+
+
'>
-
-session
-MongoDB\Driver\Session
-
-
- Una sesión a asociar a la operación.
-
-
-
+
+ maxCommitTimeMS
+ integer
+
+
+ El tiempo máximo en milisegundos para permitir que una sola comando
+ commitTransaction se ejecute.
+
+
+ Si se especifica, maxCommitTimeMS debe ser un entero
+ 32 bits con signo superior o igual a cero.
+
+
+
'>
-
-
- Si se utiliza una "session" que tiene una transacción
- en curso, no se puede especificar la opción "readConcern"
- o "writeConcern". Intentar hacer esto lanzará una excepción
- MongoDB\Driver\Exception\InvalidArgumentException.
- En su lugar, debe definir estas opciones cuando se crea la transacción con
- MongoDB\Driver\Session::startTransaction.
-
-
+
+ readConcern
+ MongoDB\Driver\ReadConcern
+
+
+ Una preocupación de lectura a aplicar a la operación.
+
+
+ Esta opción está disponible en MongoDB 3.2+ y se traducirá en una excepción en el
+ momento de la ejecución si se especifica para una versión más antigua del
+ servidor.
+
+
+
'>
-
-writeConcern
-MongoDB\Driver\WriteConcern
-
-
- Una preocupación de escritura a aplicar a la operación.
-
-
-
+
+ readPreference
+ MongoDB\Driver\ReadPreference
+
+
+ Una preferencia de lectura a utilizar para seleccionar un servidor para la operación.
+
+
+
'>
-
-namespace (string)
-
-
- Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")
-
-
-
+
+ session
+ MongoDB\Driver\Session
+
+
+ Una sesión a asociar a la operación.
+
+
+
'>
-
-db (string)
-
-
- El nombre de la base de datos sobre la cual se ejecutará el comando.
-
-
-
+
+
+ Si se utiliza una "session" que tiene una transacción en
+ curso, no se puede especificar la opción "readConcern" o
+ "writeConcern". Intentar hacer esto lanzará una excepción
+ MongoDB\Driver\Exception\InvalidArgumentException
+ . En su lugar, debe definir estas opciones cuando se crea
+ la transacción con
+ MongoDB\Driver\Session::startTransaction.
+
+
'>
-
-bulk (MongoDB\Driver\BulkWrite)
-
-
- Escritura(s) a ejecutar.
-
-
-
+
+ writeConcern
+ MongoDB\Driver\WriteConcern
+
+
+ Una preocupación de escritura a aplicar a la operación.
+
+
+
'>
-
- bulk (MongoDB\Driver\BulkWriteCommand)
+ namespace (string)
- Escritura(s) a ejecutar.
+ Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")
'>
-
-command (MongoDB\Driver\Command)
-
-
- El comando a ejecutar.
-
-
-
+
+ db (string)
+
+
+ El nombre de la base de datos sobre la cual se ejecutará el comando.
+
+
+
'>
-
-
- options
-
-
-
+
+ bulk (MongoDB\Driver\BulkWrite)
+
+
+ Escritura(s) a ejecutar.
+
+
+
+'>
+
+ bulk (MongoDB\Driver\BulkWriteCommand)
+
+
+ Escritura(s) a ejecutar.
+
+
+
+'>
+
+ command (MongoDB\Driver\Command)
+
+
+ El comando a ejecutar.
+
+
+
+'>
+
+ options
+
+
- Opciones de cifrado
-
-
-
- Opción
- Tipo
- Descripción
-
-
-
-
- algorithm
-
- string
-
-
-
- El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique una de las siguientes constantes de
- ClientEncryption:
-
-
-
- MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC
-
-
- MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM
-
-
- MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
-
-
- MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED
-
-
- MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE
-
-
-
-
-
- contentionFactor
-
- int
-
-
-
- El factor de contención para evaluar las consultas con cargas útiles cifradas indexadas.
-
-
- Esta opción se aplica únicamente y solo puede ser especificada cuando
- algorithm es
- MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o
- MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
-
-
-
-
- keyAltName
-
- string
-
-
-
- Identifica un documento de colección de cofre de claves por keyAltName. Esta opción es mutuamente exclusiva
- con keyId y una de las dos es requerida.
-
-
-
-
- keyId
-
- MongoDB\BSON\Binary
-
-
-
- Identifica una clave de datos por _id. El valor es un UUID (subtipo binario 4). Esta opción es mutuamente
- exclusiva con keyAltName y una de las dos es requerida.
-
-
-
-
- queryType
-
- string
-
-
-
- El tipo de consulta para evaluar las consultas con cargas útiles cifradas indexadas. Especifique una de las siguientes constantes de
- ClientEncryption:
-
-
-
- MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY
-
-
- MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE
-
-
-
- Esta opción se aplica únicamente y solo puede ser especificada cuando
- algorithm es
- MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o
- MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
-
-
-
-
- rangeOpts
-
- array
-
-
-
- Opciones de índice para un campo de cifrado interrogeable que soporta consultas "range". Las opciones a continuación deben coincidir
- con los valores definidos en encryptedFields de la colección objetivo. Para los tipos de campo BSON double y decimal128,
- min, max y precision deben ser todos definidos o todos no definidos.
-
-
-
- Opciones de índice de rango
-
-
-
- Opción
- Tipo
- Descripción
-
-
-
-
- min
-
- mixed
-
- Requisito si precision está definido. El valor BSON mínimo del rango.
-
-
- max
-
- mixed
-
- Requisito si precision está definido. El valor BSON máximo del rango.
-
-
- sparsity
-
- int
-
- Opcional. Entero positivo de 64 bits.
-
-
- precision
-
- int
-
-
- Opcional. Entero positivo de 32 bits que especifica la precisión a utilizar
- para el cifrado explícito. Solo puede ser definido para los tipos
- de campo BSON double o decimal128.
-
-
-
- trimFactor
- int
- Opcional. Entero positivo de 32 bits.
-
-
-
-
-
-
-
-
-
+ Opciones de cifrado
+
+
+
+ Opción
+ Tipo
+ Descripción
+
+
+
+
+ algorithm
+ string
+
+
+ El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique
+ una de las siguientes constantes de
+ ClientEncryption:
+
+
+ MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC
+ MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM
+ MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
+ MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED
+ MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE
+
+
+
+
+ contentionFactor
+ int
+
+
+ El factor de contención para evaluar las consultas con cargas útiles cifradas
+ indexadas.
+
+
+ Esta opción se aplica únicamente y solo puede ser especificada cuando
+ algorithm es
+ MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
+ o
+ MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
+
+
+
+
+ keyAltName
+ string
+
+
+ Identifica un documento de colección de cofre de claves por
+ keyAltName. Esta opción es mutuamente exclusiva
+ con keyId y una de las dos es requerida.
+
+
+
+
+ keyId
+ MongoDB\BSON\Binary
+
+
+ Identifica una clave de datos por _id. El valor es un UUID
+ (subtipo binario 4). Esta opción es mutuamente exclusiva con
+ keyAltName y una de las dos es requerida.
+
+
+
+
+ queryType
+ string
+
+
+ El tipo de consulta para evaluar las consultas con cargas útiles cifradas
+ indexadas. Especifique una de las siguientes constantes de
+ ClientEncryption:
+
+
+ MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY
+ MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE
+
+
+ Esta opción se aplica únicamente y solo puede ser especificada cuando
+ algorithm es
+ MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
+ o MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
+
+
+
+
+ rangeOpts
+ array
+
+
+ Opciones de índice para un campo de cifrado interrogeable que soporta
+ consultas "range". Las opciones a continuación deben coincidir con los valores definidos en
+ encryptedFields de la colección objetivo. Para los
+ tipos de campo BSON double y decimal128, min,
+ max y precision deben ser todos
+ definidos o todos no definidos.
+
+
+
+ Opciones de índice de rango
+
+
+
+ Opción
+ Tipo
+ Descripción
+
+
+
+
+ min
+ mixed
+
+ Requisito si precision está definido. El valor
+ BSON mínimo del rango.
+
+
+
+ max
+ mixed
+
+ Requisito si precision está definido. El valor
+ BSON máximo del rango.
+
+
+
+ sparsity
+ int
+ Opcional. Entero positivo de 64 bits.
+
+
+ precision
+ int
+
+ Opcional. Entero positivo de 32 bits que especifica la precisión a
+ utilizar para el cifrado explícito. Solo puede ser definido para los tipos de
+ campo BSON double o decimal128.
+
+
+
+ trimFactor
+ int
+ Opcional. Entero positivo de 32 bits.
+
+
+
+
+
+
+
+
+
-
-
-
-'>
-
-query (MongoDB\Driver\Query)
-
-
- La consulta a ejecutar.
-
-
-
+
+
+
'>
-
-typeMap (array)
-
-
- Configuración del mapa de tipos.
-
-
-
+
+ query (MongoDB\Driver\Query)
+
+
+ La consulta a ejecutar.
+
+
+
'>
-
-filter (arrayobject)
-
-
- El atributo de la consulta.
- Un atributo vacío hará coincidir todos los documentos de la colección.
-
-
-
- Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un ObjectId).
-
-
-
-
+
+ typeMap (array)
+
+
+ Configuración del mapa de tipos.
+
+
+
'>
- Retorna un MongoDB\Driver\Cursor en caso de éxito.'>
- Retorna un MongoDB\Driver\WriteResult en caso de éxito.'>
- Retorna un MongoDB\Driver\BulkWriteCommandResult en caso de éxito.'>
-
- Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza con una transacción asociada en combinación con una opción "readConcern" o "writeConcern".'>
- Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.'>
- Lanza una excepción MongoDB\Driver\Exception\BulkWriteCommandException en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)'>
- Lanza una excepción MongoDB\Driver\BulkWriteException en caso de error de una operación de escritura (un error WriteError y WriteConcern)'>
- Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.'>
- Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla'>
- Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación'>
- Lanza una excepción MongoDB\Driver\Exception\UnexpectedValueException si la entrada no contiene exactamente un documento BSON. Las razones posibles incluyen, pero no se limitan a, BSON inválido, datos adicionales (después de leer un documento BSON), o un error inesperado de libbson.'>
-
- Levanta una excepción MongoDB\Driver\Exception\LogicException
- si la escritura no ha sido reconocida.
-
+
+ filter (arrayobject)
+
+
+ El atributo de la consulta.
+ Un atributo vacío hará coincidir todos los documentos de la colección.
+
+
+
+ Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un ObjectId).
+
+
+
+
'>
+Retorna un MongoDB\Driver\Cursor en caso de éxito.'>
+Retorna un MongoDB\Driver\WriteResult en caso de éxito.'>
+Retorna un MongoDB\Driver\BulkWriteCommandResult en caso de éxito.'>
+
+Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza con una transacción asociada en combinación con una opción "readConcern" o "writeConcern".'>
+Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.'>
+Lanza una excepción MongoDB\Driver\Exception\BulkWriteCommandException en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)'>
+Lanza una excepción MongoDB\Driver\Exception\BulkWriteException en caso de error de una operación de escritura (un error WriteError y WriteConcern)'>
+Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException en caso de error durante el análisis de un argumento.'>
+Lanza una excepción MongoDB\Driver\Exception\AuthenticationException si se requiere una identificación pero falla'>
+Lanza una excepción MongoDB\Driver\Exception\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación'>
+Lanza una excepción MongoDB\Driver\Exception\UnexpectedValueException si la entrada no contiene exactamente un documento BSON. Las razones posibles incluyen, pero no se limitan a, BSON inválido, datos adicionales (después de leer un documento BSON), o un error inesperado de libbson.'>
+Levanta una excepción MongoDB\Driver\Exception\LogicExceptionsi la escritura no ha sido reconocida.'>
-
-
- MongoDB\BSON\Decimal128 solo es compatible con
- MongoDB 3.4+. Si se intenta utilizar el tipo BSON con una versión antigua
- de MongoDB, se emitirá un error.
-
-
+
+
+ MongoDB\BSON\Decimal128 solo es compatible con
+ MongoDB 3.4+. Si se intenta utilizar el tipo BSON con una versión antigua
+ de MongoDB, se emitirá un error.
+
+
'>
-
-
- La salida es coherente con la función MongoDB\BSON\toJSON,
- que utiliza el formato JSON extendido específico del controlador. Esto no corresponde
- necesariamente a las representaciones JSON extendidas
- relajadas
- o canónicas
- utilizadas por MongoDB\BSON\toRelaxedExtendedJSON y
- MongoDB\BSON\toCanonicalExtendedJSON, respectivamente.
-
-
- '>
+
+ La salida es coherente con la función MongoDB\BSON\toJSON
+ , que utiliza el formato JSON extendido específico del controlador. Esto no corresponde
+ necesariamente a las representaciones JSON extendidas
+ relajadas
+ o canónicas
+ utilizadas por
+ MongoDB\BSON\toRelaxedExtendedJSON y
+ MongoDB\BSON\toCanonicalExtendedJSON, respectivamente.
+
+
+'>
-
- En las plataformas Unix, la extensión MongoDB es sensible a los scripts que utilizan
- la llamada al sistema fork() sin llamar a exec(). No se deben reutilizar
- instancias MongoDB\Driver\Manager en un proceso
- hijo derivado de un fork.
-
-
- '>
+
+
+ En las plataformas Unix, la extensión MongoDB es sensible a los scripts que
+ utilizan la llamada al sistema fork() sin llamar a exec(). No se deben reutilizar
+ instancias MongoDB\Driver\Manager en un proceso hijo derivado
+ de un fork.
+
+
+'>
-
- Dado que el tipo entero de PHP es firmado, algunos valores
- devueltos por este método pueden aparecer como enteros negativos
- en las plataformas de 32 bits. El formateador "%u" de
- sprintf puede ser utilizado para obtener una
- representación en forma de string del valor decimal no firmado.
-
- '>
+
+
+ Dado que el tipo integer de PHP es con signo, algunos de los valores devueltos por
+ este método pueden aparecer como enteros negativos en plataformas de 32 bits. El formateador
+ "%u" de sprintf se puede
+ utilizar para obtener una representación en forma de string del valor decimal sin signo.
+
+
+'>
-
- La opción readPreference no controla el servidor hacia
- el cual el controlador emite la operación; siempre se ejecutará en este objeto
- servidor. En su lugar, puede ser utilizado al emitir
- la operación a un secundario (desde una conexión de conjunto de réplicas,
- no autónoma) o el nodo Mongos para asegurarse de que el controlador defina el
- protocolo de fila en consecuencia o añada la preferencia de lectura a
- la operación, respectivamente.
-
-
- '>
+
+
+ La opción "readPreference" no controla el servidor hacia el
+ cual el controlador emite la operación; siempre se ejecutará en este objeto servidor. En su
+ lugar, puede ser utilizado al emitir la operación a un secundario (desde una conexión de
+ conjunto de réplicas, no autónoma) o el nodo Mongos para asegurarse de que
+ el controlador defina el protocolo de fila en consecuencia o añada la preferencia de
+ lectura a la operación, respectivamente.
+
+
+'>
-
- Es responsabilidad del llamante asegurarse de que el
- servidor sea capaz de ejecutar la operación de escritura. Por
- ejemplo, la ejecución de una operación de escritura en un
- secundario (excluyendo su base de datos "local") fallará.
-
-
- '>
+
+
+ Es responsabilidad del llamante asegurarse de que el servidor sea capaz de ejecutar la
+ operación de escritura. Por ejemplo, la ejecución de una operación de escritura
+ en un secundario (excluyendo su base de datos "local") fallará.
+
+
+'>
-
- Los documentos BSON pueden contener técnicamente claves duplicadas ya que
- los documentos se almacenan como una lista de pares clave-valor;
- sin embargo, las aplicaciones deben abstenerse de generar
- documentos con claves duplicadas ya que el comportamiento del servidor y del
- controlador puede ser indefinido. Dado que los objetos y arrays de PHP no pueden
- tener claves duplicadas, los datos también podrían perderse al decodificar
- un documento BSON con claves duplicadas.
-
-
- '>
+
+
+ Los documentos BSON pueden contener técnicamente claves duplicadas ya que los documentos
+ se almacenan como una lista de pares clave-valor; sin embargo, las aplicaciones deben abstenerse
+ de generar documentos con claves duplicadas ya que el comportamiento del servidor y
+ del controlador puede ser indefinido. Dado que los objetos y arrays de PHP no pueden
+ tener claves duplicadas, los datos también podrían perderse al decodificar un documento BSON con claves duplicadas.
+
+
+'>
Una petición debe ser creada mediante la función radius_create_request antes de que esta función pueda ser llamada.'>
@@ -3958,590 +3830,585 @@ local: {
file_descriptor
-
- El descriptor de archivo, que debe ser ya sea una recurso
- de archivo, o un entero. Un entero se asume como un descriptor
- de archivo que puede ser pasado directamente a la llamada al sistema
- subyacente.
-
+
+ El descriptor de fichero, el cual se espera que sea un
+ resource de fichero o un int. Se asumirá que un int
+ es un descriptor de fichero que puede ser pasado directamente a la
+ llamada al sistema subyacente.
+
- '>
+'>
- Cada recurso tiene un límite soft y hard asociados. El límite
- soft corresponde al valor que el núcleo fuerza para el recurso
- correspondiente. El límite hard actúa como un techo del límite soft.
- Un proceso no privilegiado solo puede definir su límite soft en un
- valor comprendido entre 0 y el límite hard, lo que solo hará bajar
- su límite hard.
-
- '>
+
+ Cada recurso tiene un límite soft y hard asociados. El límite soft
+ corresponde al valor que el núcleo fuerza para el recurso correspondiente.
+ El límite hard actúa como un techo del límite soft. Un proceso no
+ privilegiado solo puede definir su límite soft en un valor comprendido entre
+ 0 y el límite hard, lo que solo hará bajar su límite hard.
+
+'>
-
-
- " ": carácter SP en ASCII
- 0x20, un espacio ordinario.
-
-
-
-
- "\t": carácter HT en ASCII
- 0x09, una tabulación.
-
-
-
-
- "\n": carácter LF en ASCII
- 0x0A, un salto de línea (line feed).
-
-
-
-
- "\r": carácter CR en ASCII
- 0x0D, un retorno de carro.
-
-
-
-
- "\0": carácter NUL en ASCII
- 0x00, el octeto NUL.
-
-
-
-
- "\v": carácter VT en ASCII
- 0x0B, una tabulación vertical.
-
-
-
- '>
+
+
+ " ": carácter SP en ASCII
+ 0x20, un espacio ordinario.
+
+
+
+
+ "\t": carácter HT en ASCII
+ 0x09, una tabulación.
+
+
+
+
+ "\n": carácter LF en ASCII
+ 0x0A, un salto de línea (line feed).
+
+
+
+
+ "\r": carácter CR en ASCII
+ 0x0D, un retorno de carro.
+
+
+
+
+ "\0": carácter NUL en ASCII
+ 0x00, el octeto NUL.
+
+
+
+
+ "\v": carácter VT en ASCII
+ 0x0B, una tabulación vertical.
+
+
+
+'>
-
-
- " " (Unicode U+0020), un espacio ordinario.
-
-
-
-
- "\t" (Unicode U+0009), una tabulación.
-
-
-
-
- "\n" (Unicode U+000A), un salto de línea.
-
-
-
-
- "\r" (Unicode U+000D), un retorno de carro.
-
-
-
-
- "\0" (Unicode U+0000), el octeto NUL.
-
-
-
-
- "\v" (Unicode U+000B), una tabulación vertical.
-
-
-
-
- "\f" (Unicode U+000C), un avance de página.
-
-
-
-
- "\u00A0" (Unicode U+00A0), un ESPACIO INSÉCABLE.
-
-
-
-
- "\u1680" (Unicode U+1680), una MARCA DE ESPACIO OGHAM.
-
-
-
-
- "\u2000" (Unicode U+2000), un CUADRADO MEDIO.
-
-
-
-
- "\u2001" (Unicode U+2001), un CUADRADO.
-
-
-
-
- "\u2002" (Unicode U+2002), un ESPACIO MEDIO.
-
-
-
-
- "\u2003" (Unicode U+2003), un ESPACIO CUADRADO.
-
-
-
-
- "\u2004" (Unicode U+2004), un ESPACIO DE UN-TERCIO-DE-CUADRADO.
-
-
-
-
- "\u2005" (Unicode U+2005), un ESPACIO DE UN-CUARTO-DE-CUADRADO.
-
-
-
-
- "\u2006" (Unicode U+2006), un ESPACIO DE UN-SEXTO-DE-CUADRADO.
-
-
-
-
- "\u2007" (Unicode U+2007), un ESPACIO PARA DÍGITOS.
-
-
-
-
- "\u2008" (Unicode U+2008), un ESPACIO DE PUNTUACIÓN.
-
-
-
-
- "\u2009" (Unicode U+2009), un ESPACIO FINO.
-
-
-
-
- "\u200A" (Unicode U+200A), un ESPACIO PELUDO.
-
-
-
-
- "\u2028" (Unicode U+2028), un SEPARADOR DE LÍNEA.
-
-
-
-
- "\u2029" (Unicode U+2029), un SEPARADOR DE PÁRRAFO.
-
-
-
-
- "\u202F" (Unicode U+202F), un ESPACIO INSÉCABLE ESTRECHO.
-
-
-
-
- "\u205F" (Unicode U+205F), un ESPACIO MATEMÁTICO MEDIO.
-
-
-
-
- "\u3000" (Unicode U+3000), un ESPACIO IDEOGRÁFICO.
-
-
-
-
- "\u0085" (Unicode U+0085), una LÍNEA SIGUIENTE (NEL).
-
-
-
-
- "\u180E" (Unicode U+180E), un SEPARADOR DE VOCALES MONGOL.
-
-
-
- '>
+
+
+ " " (Unicode U+0020), un espacio ordinario.
+
+
+
+
+ "\t" (Unicode U+0009), una tabulación.
+
+
+
+
+ "\n" (Unicode U+000A), un salto de línea.
+
+
+
+
+ "\r" (Unicode U+000D), un retorno de carro.
+
+
+
+
+ "\0" (Unicode U+0000), el octeto NUL.
+
+
+
+
+ "\v" (Unicode U+000B), una tabulación vertical.
+
+
+
+
+ "\f" (Unicode U+000C), un avance de página.
+
+
+
+
+ "\u00A0" (Unicode U+00A0), un ESPACIO INSÉCABLE.
+
+
+
+
+ "\u1680" (Unicode U+1680), una MARCA DE ESPACIO OGHAM.
+
+
+
+
+ "\u2000" (Unicode U+2000), un CUADRADO MEDIO.
+
+
+
+
+ "\u2001" (Unicode U+2001), un CUADRADO.
+
+
+
+
+ "\u2002" (Unicode U+2002), un ESPACIO MEDIO.
+
+
+
+
+ "\u2003" (Unicode U+2003), un ESPACIO CUADRADO.
+
+
+
+
+ "\u2004" (Unicode U+2004), un ESPACIO DE UN-TERCIO-DE-CUADRADO.
+
+
+
+
+ "\u2005" (Unicode U+2005), un ESPACIO DE UN-CUARTO-DE-CUADRADO.
+
+
+
+
+ "\u2006" (Unicode U+2006), un ESPACIO DE UN-SEXTO-DE-CUADRADO.
+
+
+
+
+ "\u2007" (Unicode U+2007), un ESPACIO PARA DÍGITOS.
+
+
+
+
+ "\u2008" (Unicode U+2008), un ESPACIO DE PUNTUACIÓN.
+
+
+
+
+ "\u2009" (Unicode U+2009), un ESPACIO FINO.
+
+
+
+
+ "\u200A" (Unicode U+200A), un ESPACIO PELUDO.
+
+
+
+
+ "\u2028" (Unicode U+2028), un SEPARADOR DE LÍNEA.
+
+
+
+
+ "\u2029" (Unicode U+2029), un SEPARADOR DE PÁRRAFO.
+
+
+
+
+ "\u202F" (Unicode U+202F), un ESPACIO INSÉCABLE ESTRECHO.
+
+
+
+
+ "\u205F" (Unicode U+205F), un ESPACIO MATEMÁTICO MEDIO.
+
+
+
+
+ "\u3000" (Unicode U+3000), un ESPACIO IDEOGRÁFICO.
+
+
+
+
+ "\u0085" (Unicode U+0085), una LÍNEA SIGUIENTE (NEL).
+
+
+
+
+ "\u180E" (Unicode U+180E), un SEPARADOR DE VOCALES MONGOL.
+
+
+
+'>
- Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando
- el parámetro characters.
- Basta con listar todos los caracteres que deben ser eliminados.
- Con .., es posible especificar un rango creciente de caracteres.
+ Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el
+ parámetro characters.
+ Basta con listar todos los caracteres que deben ser eliminados.
+ Con .., es posible especificar un rango creciente de caracteres.
- '>
+'>
- Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando
- el parámetro characters.
- Basta con listar todos los caracteres a eliminar.
+ Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el
+ parámetro characters.
+ Basta con listar todos los caracteres a eliminar.
- '>
+'>
- Un argumento opcional que define el codificado utilizado durante
- la conversión de caracteres.
+ Un argumento opcional que define el codificado utilizado durante la conversión de caracteres.
- Si se omite, el valor por omisión del parámetro encoding
- es el valor de la opción de configuración
- default_charset.
+ Si se omite, el valor predeterminado del parámetro encoding es el valor de la opción de configuración
+ default_charset
+ .
- Aunque este argumento es técnicamente opcional, se recomienda encarecidamente
- especificar el valor correcto para su código si la opción de configuración
- default_charset
- ha sido definida incorrectamente para la entrada proporcionada.
-
- '>
-
-
- format
-
-
- La cadena de formato está compuesta por cero o más directivas:
- caracteres ordinarios (excepto %)
- que se copian directamente al resultado y
- especificaciones de conversión,
- cada una con su propio parámetro.
-
-
-
- Una especificación de conversión que sigue este prototipo:
- %[argnum$][flags][width][.precision]specifier.
+ Aunque este argumento es técnicamente opcional, se recomienda encarecidamente especificar el valor
+ correcto para su código si la opción
+ de configuración default_charset
+ ha sido definida incorrectamente para la entrada proporcionada.
+'>
-
- Argnum
-
- Un &integer; seguido de un signo dólar $,
- para especificar qué número de argumento tratar en la conversión.
-
-
-
-
- Banderas
-
-
-
-
-
- Bandera
- &Description;
-
-
-
-
- -
-
- Justifica el texto a la izquierda dado el ancho del campo;
- la justificación a la derecha es el comportamiento por omisión.
-
-
-
- +
-
- Prefija los números positivos con un signo más
- +; por omisión solo los números
- negativos son prefijados con un signo negativo.
-
-
-
- (espacio)
-
- Rellena el resultado con espacios.
- Esto es por omisión.
-
-
-
- 0
-
- Rellena solo los números a la izquierda con ceros.
- Con el especificador s esto también puede
- rellenar a la derecha con ceros.
-
-
-
- '(char)
-
- Rellena el resultado con el carácter (char).
-
-
-
-
-
-
-
+
+ format
+
+
+ La cadena de formato está compuesta por cero o más directivas:
+ caracteres ordinarios (excepto %) que se
+ copian directamente al resultado y especificaciones de
+ conversión, cada una con su propio
+ parámetro.
+
-
- Ancho
-
- Sea un entero indicando el número de caracteres (mínimo)
- que esta conversión debe producir, o *.
- Si * es utilizado, entonces el ancho es proporcionado
- como un valor entero adicional precediendo al que se formatea
- por el especificador.
-
-
+
+ Una especificación de conversión que sigue este prototipo:
+ %[argnum$][flags][width][.precision]specifier.
+
-
- Precisión
-
- Un punto . seguido opcionalmente
- sea de un entero, o de *,
- cuya significación depende del especificador:
-
-
-
- Para los especificadores e, E,
- f y F:
- esto es el número de dígitos a mostrar después
- de la coma (por omisión, esto es 6).
-
-
-
-
- Para los especificadores g, G,
- h y H:
- esto es el número máximo de dígitos significativos a mostrar.
-
-
-
-
- Para el especificador s: actúa como un punto de corte,
- definiendo un límite máximo de caracteres de la cadena.
-
-
-
-
-
- Si el punto es especificado sin un valor explícito para la precisión,
- 0 es asumido. Si * es utilizado, la precisión es
- proporcionada como un valor entero adicional precediendo al que se formatea
+
+ Argnum
+
+ Un &integer; seguido de un signo dólar $,
+ para especificar qué número de argumento tratar en la conversión.
+
+
+
+
+ Banderas
+
+
+
+
+
+ Bandera
+ &Description;
+
+
+
+
+ -
+
+ Justifica el texto a la izquierda dado el ancho del campo;
+ la justificación a la derecha es el comportamiento predeterminado.
+
+
+
+ +
+
+ Prefija los números positivos con un signo más
+ +; por defecto solo los
+ números negativos son prefijados con un signo negativo.
+
+
+
+ (espacio)
+
+ Rellena el resultado con espacios.
+ Esto es por defecto.
+
+
+
+ 0
+
+ Rellena solo los números a la izquierda con ceros. Con
+ el especificador s esto también puede rellenar
+ a la derecha con ceros.
+
+
+
+ '(char)
+
+ Rellena el resultado con el carácter (char).
+
+
+
+
+
+
+
+
+
+ Ancho
+
+ Sea un entero indicando el número de caracteres (mínimo)
+ que esta conversión debe producir, o *.
+ Si * es utilizado, entonces el ancho es proporcionado
+ como un valor entero adicional precediendo al que se formatea
por el especificador.
-
-
-
-
-
-
-
- Especificadores
-
-
-
- Especificador
- &Description;
-
-
-
-
- %
-
- Un carácter de porcentaje literal. No se necesita ningún argumento.
-
-
-
- b
-
- El argumento es tratado como un entero y presentado
- como un número binario.
-
-
-
- c
-
- El argumento es tratado como un entero y presentado
- como el carácter de código ASCII correspondiente.
-
-
-
- d
-
- El argumento es tratado como un entero y presentado
- como un número entero decimal (firmado).
-
-
-
- e
-
- El argumento es tratado como una notación científica
- (ej. 1.2e+2).
-
-
-
- E
-
- Como el especificador e pero utiliza
- una letra mayúscula (por ejemplo 1.2E+2).
-
-
-
- f
-
- El argumento es tratado como un número de coma flotante
- (tipo &float;) y presentado como un número de coma
- flotante (teniendo en cuenta la configuración local).
-
-
-
- F
-
- El argumento es tratado como un número de coma flotante
- (tipo &float;) y presentado como un número de coma
- flotante (sin tener en cuenta la configuración local).
-
-
-
- g
-
+
+
+
+
+ Precisión
+
+ Un punto . seguido opcionalmente sea
+ de un entero, o de *,
+ cuya significación depende del especificador:
+
+
- Formato general.
+ Para los especificadores e, E,
+ f y F
+ : esto es el número de dígitos a mostrar
+ después de la coma (por defecto, esto es 6).
+
+
- Sea P igual a la precisión si diferente de 0, 6 si la precisión
- es omitida o 1 si la precisión es cero.
- Entonces, si la conversión con el estilo E tuviera como exponente X:
+ Para los especificadores g, G,
+ h y H
+ : esto es el número máximo de
+ dígitos significativos a mostrar.
+
+
- Si P > X ≥ −4, la conversión es con estilo f y precisión P − (X + 1).
- De lo contrario, la conversión es con el estilo e y precisión P - 1.
+ Para el especificador s: actúa como un punto de corte,
+ definiendo un límite máximo de caracteres de la cadena.
-
-
-
- G
-
- Como el especificador g pero utiliza
- E y f.
-
-
-
- h
-
- Como el especificador g pero utiliza F.
- Disponible a partir de PHP 8.0.0.
-
-
-
- H
-
- Como el especificador g pero utiliza
- E y F. Disponible a partir de PHP 8.0.0.
-
-
-
- o
-
- El argumento es tratado como un entero y presentado
- como un número octal.
-
-
-
- s
-
- El argumento es tratado y presentado como una cadena de caracteres.
-
-
-
- u
-
- El argumento es tratado como un entero y presentado
- como un número decimal no firmado.
-
-
-
- x
-
- El argumento es tratado como un entero y presentado
- como un número hexadecimal (las letras en minúsculas).
-
-
-
- X
-
- El argumento es tratado como un entero y presentado
- como un número hexadecimal (las letras en mayúsculas).
-
-
-
-
-
-
+
+
+
+
+ Si el punto es especificado sin un valor explícito para la precisión,
+ 0 es asumido. Si * es utilizado, la precisión es
+ proporcionada como un valor entero adicional precediendo al que se formatea
+ por el especificador.
+
+
+
+
-
-
- El especificador de tipo c ignora el alineamiento y el tamaño.
-
-
+
+
+ Especificadores
+
+
+
+ Especificador
+ &Description;
+
+
+
+
+ %
+
+ Un carácter de porcentaje literal. No se necesita ningún argumento.
+
+
+
+ b
+
+ El argumento es tratado como un entero y presentado
+ como un número binario.
+
+
+
+ c
+
+ El argumento es tratado como un entero y presentado como
+ el carácter de código ASCII correspondiente.
+
+
+
+ d
+
+ El argumento es tratado como un entero y presentado como
+ un número entero decimal (firmado).
+
+
+
+ e
+
+ El argumento es tratado como una notación científica (ej. 1.2e+2).
+
+
+
+ E
+
+ Como el especificador e pero utiliza una
+ letra mayúscula (por ejemplo 1.2E+2).
+
+
+
+ f
+
+ El argumento es tratado como un número de coma flotante (tipo &float;) y presentado como un
+ número de coma flotante (teniendo en cuenta la configuración local).
+
+
+
+ F
+
+ El argumento es tratado como un número de coma flotante (tipo &float;) y presentado como un
+ número de coma flotante (sin tener en cuenta la configuración local).
+
+
+
+ g
+
+
+ Formato general.
+
+
+ Sea P igual a la precisión si diferente de 0, 6 si la precisión
+ es omitida o 1 si la precisión
+ es cero. Entonces, si la conversión con el estilo E tuviera como exponente X:
+
+
+ Si P > X ≥ −4, la conversión es con estilo f y precisión P − (X + 1). De lo
+ contrario, la conversión es con el estilo e y precisión P - 1.
+
+
+
+
+ G
+
+ Como el especificador g pero utiliza
+ E y f.
+
+
+
+ h
+
+ Como el especificador g pero utiliza F.
+ Disponible a partir de PHP 8.0.0.
+
+
+
+ H
+
+ Como el especificador g pero utiliza
+ E y F. Disponible a partir de PHP 8.0.0.
+
+
+
+ o
+
+ El argumento es tratado como un entero y presentado
+ como un número octal.
+
+
+
+ s
+
+ El argumento es tratado y presentado como una cadena de caracteres.
+
+
+
+ u
+
+ El argumento es tratado como un entero y presentado como
+ un número decimal no firmado.
+
+
+
+ x
+
+ El argumento es tratado como un entero y presentado como
+ un número hexadecimal (las letras en minúsculas).
+
+
+
+ X
+
+ El argumento es tratado como un entero y presentado como
+ un número hexadecimal (las letras en mayúsculas).
+
+
+
+
+
+
-
-
- Intentar utilizar una combinación de una cadena
- y especificadores con juegos de caracteres que necesitan
- más de un octeto por carácter dará un resultado inesperado.
-
-
+
+
+ El especificador de tipo c ignora el alineamiento y el tamaño.
+
+
-
- Las variables serán forzadas a un tipo apropiado para el especificador:
-
- Manejo de tipos
-
-
-
- Tipo
- Especificadores
-
-
-
-
- string
- s
-
-
- int
-
- d,
- u,
- c,
- o,
- x,
- X,
- b
-
-
-
- float
-
- e,
- E,
- f,
- F,
- g,
- G,
- h,
- H
-
-
-
-
-
-
+
+
+ Intentar utilizar una combinación de una cadena y especificadores con juegos de caracteres que necesitan más de un octeto por carácter dará un resultado inesperado.
+
+
+
+
+ Las variables serán forzadas a un tipo apropiado para el especificador:
+
+ Manejo de tipos
+
+
+
+ Tipo
+ Especificadores
+
+
+
+
+ string
+ s
+
+
+ int
+
+ d,
+ u,
+ c,
+ o,
+ x,
+ X,
+ b
+
+
+
+ float
+
+ e,
+ E,
+ f,
+ F,
+ g,
+ G,
+ h,
+ H
+
+
+
+
+
+
-
- '>
+
+'>
-
format
- El formato interpretado para string se describe
- en la documentación de la sprintf con las siguientes diferencias:
+ El formato interpretado para string se describe en
+ la documentación de la sprintf con
+ las siguientes diferencias:
La función no tiene en cuenta el contexto local.
@@ -4572,34 +4439,37 @@ local: {
'>
-
- Anterior a PHP 8.0.0, si needle no es una cadena de caracteres,
- se convierte en un entero y se aplica como valor ordinal de un carácter.
- Este comportamiento está obsoleto a partir de PHP 7.3.0, y confiar en él
+ Anterior a PHP 8.0.0, si needle no es una cadena de caracteres, se
+ convierte en un entero y se aplica como valor ordinal de un
+ carácter. Este comportamiento está obsoleto a partir de PHP 7.3.0, y confiar en él
está fuertemente desaconsejado. Dependiendo del comportamiento esperado,
needle debe ser explícitamente convertido a una cadena de caracteres,
o debe realizarse una llamada explícita a chr.
-'>
+'>
+
+
8.0.0needle acepta ahora una cadena vacía.
'>
-
-5.6.0
-
- El valor por omisión para el parámetro encoding
- ha sido modificado para ser el valor de la opción de configuración
- default_charset.
-
-
+
+ 5.6.0
+
+ El valor predeterminado para el parámetro encoding ha sido modificado
+ para ser el valor de la opción de configuración
+ default_charset
+ .
+
+
'>
-
8.2.0
@@ -4609,7 +4479,7 @@ local: {
'>
-
8.2.0
@@ -4620,7 +4490,7 @@ local: {
'>
-
@@ -4668,7 +4538,8 @@ local: {
'>
-
@@ -4708,7 +4579,7 @@ local: {
8.0.0
- Lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos;
+ Lanza una ValueError cuando se proporcionan menos argumentos de los requeridos;
anteriormente, esta función emitía un E_WARNING.
@@ -4716,29 +4587,30 @@ local: {
'>
-
-A partir de PHP 8.0.0, se lanza una ValueError si el número de argumentos es nulo.
-Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
-
-
-A partir de PHP 8.0.0, se lanza una ValueError si [width] es inferior a cero o superior a PHP_INT_MAX.
-Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
-
-
-A partir de PHP 8.0.0, se lanza una ValueError si [precision] es inferior a cero o superior a PHP_INT_MAX.
-Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
-
-
-A partir de PHP 8.0.0, se lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos.
-Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar.
-
+ A partir de PHP 8.0.0, se lanza una ValueError si el número de argumentos es nulo. Anterior a
+ PHP 8.0.0, se emitía un E_WARNING en su lugar.
+
+
+ A partir de PHP 8.0.0, se lanza una ValueError si [width] es inferior a cero o superior a PHP_INT_MAX.
+ Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
+
+
+ A partir de PHP 8.0.0, se lanza una ValueError si [precision] es inferior a cero o superior a PHP_INT_MAX.
+ Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
+
+
+ A partir de PHP 8.0.0, se lanza una ArgumentCountError cuando se proporcionan menos argumentos de los requeridos. Anterior a
+ PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar.
+
'>
- A partir de PHP 8.0.0, se lanza un ValueError si el número de argumentos es cero.
- Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
+ A partir de PHP 8.0.0, se lanza un ValueError si el número de argumentos es cero. Anterior a
+ PHP 8.0.0, se emitía un E_WARNING en su lugar.
A partir de PHP 8.0.0, se lanza un ValueError si [width] es menor que cero o mayor que PHP_INT_MAX.
@@ -4749,58 +4621,60 @@ Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING
Anterior a PHP 8.0.0, se emitía un E_WARNING en su lugar.
- A partir de PHP 8.0.0, se lanza un ValueError cuando se proporcionan menos argumentos de los requeridos.
- Anterior a PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar.
+ A partir de PHP 8.0.0, se lanza un ValueError cuando se proporcionan menos argumentos de los requeridos. Anterior a
+ PHP 8.0.0, se devolvía &false; y se emitía un E_WARNING en su lugar.
'>
-
Devuelve un valor inferior a 0 si string1
es inferior a string2; un valor superior
a 0 si string1 es superior a
string2, y 0 si son
- iguales.
- No se puede deducir ningún significado particular de este valor,
+ iguales. No
+ se puede deducir ningún significado particular de este valor,
excepto su signo.
'>
-
-
-
-filter
-
-
- El filtro a aplicar.
- Puede ser un filtro de validación utilizando una de las constantes
- FILTER_VALIDATE_*, un filtro de
- limpieza utilizando una de las constantes
- FILTER_SANITIZE_* o FILTER_UNSAFE_RAW,
- o un filtro personalizado utilizando FILTER_CALLBACK.
-
-
- El valor por omisión es FILTER_DEFAULT,
- que es un alias de FILTER_UNSAFE_RAW.
-
-
-
+
+
+
+ filter
+
+
+ El filtro a aplicar.
+ Puede ser un filtro de validación utilizando una de las constantes
+ FILTER_VALIDATE_*
+ , un filtro de limpieza utilizando una de las constantes
+ FILTER_SANITIZE_*
+ o FILTER_UNSAFE_RAW, o un filtro personalizado utilizando
+ FILTER_CALLBACK.
+
+
+ El valor predeterminado es FILTER_DEFAULT,
+ que es un alias de FILTER_UNSAFE_RAW
+ .
+
+
+
'>
-
-
+
-Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
+ Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
-
+
Linux: getrandom(), /dev/urandom
-
-
-
+
+
+
FreeBSD >= 12 (PHP >= 7.3): getrandom(), /dev/urandom
@@ -4839,41 +4713,41 @@ Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
Solaris (PHP >= 8.1): getrandom(), /dev/urandom
-
-
-
- Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente:
- /dev/urandom.
-
-
-
-
- Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar
- aleatoriedad, se lanzará una excepción de tipo Random\RandomException.
-
-
+
+
+
+ Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente: /dev/urandom.
+
+
+
+
+ Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar aleatoriedad, se lanzará
+ una excepción de tipo Random\RandomException
+ .
+
+
'>
-
-
- Si no se encuentra ninguna fuente de datos aleatorios, se lanzará una
- Random\RandomException.
-
-
+
+
+ Si no se encuentra ninguna fuente de datos aleatorios, se lanzará
+ una Random\RandomException.
+
+
'>
-
-
- Aunque esta función fue añadida en PHP 7.0, una
- implementación en espacio de usuario
- está disponible para PHP 5.2 hasta 5.6, inclusive.
-
-
+
+
+ Aunque esta función fue añadida en PHP 7.0, una
+ implementación en espacio de usuario
+ está disponible para PHP 5.2 hasta 5.6, inclusive.
+
+
'>
-
-
+
Cualquier Throwable lanzado por el método Random\Engine::generate
@@ -4882,27 +4756,27 @@ Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
'>
-
-
+
Si la URI resultante es inválida, se lanza una excepción Uri\InvalidUriException.
- '>
+'>
-
Si la URL resultante es inválida, se lanza una excepción Uri\WhatWg\InvalidUrlException.
- '>
+'>
-
+
- Esta función ha sido
- ELIMINADA en PECL uopz 5.0.0.'>
+ELIMINADA en PECL uopz 5.0.0.'>
-
-
+
+
parser
@@ -4911,12 +4785,12 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido
'>
-
- Si &null; se pasa, el controlador se reinicia a su estado por omisión.
+
+ Si &null; se pasa, el controlador se reinicia a su estado predeterminado.
- Una cadena vacía también reiniciará el controlador,
- sin embargo esta funcionalidad está deprecada a partir de PHP 8.4.0.
+ Una cadena vacía también reiniciará el controlador, sin embargo
+ esta funcionalidad está deprecada a partir de PHP 8.4.0.
@@ -4932,21 +4806,21 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido
Esta funcionalidad está deprecada a partir de PHP 8.4.0.
-
+
- A partir de PHP 8.4.0, se verifica la validez del callable durante la configuración del controlador,
- y no en el momento de su llamada.
- Esto significa que xml_set_object debe ser llamado antes
- de definir un método como cadena como devolución de llamada.
+ A partir de PHP 8.4.0, se verifica la validez del callable durante la configuración del controlador, y no
+ en el momento de su
+ llamada. Esto significa que xml_set_object debe ser llamado antes de definir
+ un método como cadena como devolución de llamada.
Sin embargo, como este comportamiento también está deprecado a partir de PHP 8.4.0,
se recomienda utilizar un callable adecuado para el método.
'>
-
+
parser
@@ -4958,7 +4832,7 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido
8.4.0
- Pasar un string no callable a
+ Pasar un valor no callable de tipo string a
handler ahora está obsoleto;
utilice un callable apropiado para los métodos, o &null; para reinicializar el gestor.
@@ -4971,41 +4845,41 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido
'>
-
+
8.0.0parser ahora espera una instancia de XMLParser
- en lugar de un resourcexml.
+ ; anteriormente, se esperaba un recurso xml de tipo resource válido.
'>
-
-
- Todos los flujos clientes cifrados activan ahora la verificación por pares por omisión.
- Por omisión, esto utilizará el CA OpenSSL por omisión para verificar el par
- de certificados. En la mayoría de los casos, no se necesita realizar ninguna modificación
- para comunicarse con servidores y certificados SSL válidos, sabiendo que los distribuidores
- configuran generalmente OpenSSL para utilizar los CA conocidos.
-
+
+
+ Todos los flujos clientes cifrados activan ahora la verificación por pares por defecto.
+ Por defecto, esto utilizará el paquete de CA predeterminado de OpenSSL para verificar el
+ par de certificados. En la mayoría de los casos, no se necesita realizar ninguna modificación
+ para comunicarse con servidores y certificados SSL válidos, sabiendo que los
+ distribuidores configuran generalmente OpenSSL para utilizar los CA conocidos.
+
-
- El CA por omisión puede ser sobrescrito a nivel global utilizando las
+
+ El paquete de CA predeterminado puede ser sobrescrito a nivel global utilizando las
opciones de configuración openssl.cafile o openssl.capath, o mediante una solicitud
básica utilizando las opciones de contexto
cafile o
- capath.
-
+ capath
+ .
+
-
- Aunque no se recomienda en general, es posible desactivar la
- verificación de certificados por pares para una solicitud definiendo la
- opción de contexto verify_peer
- a &false;, y para desactivar la validación del nombre de los pares, configurando
- la opción de contexto
- verify_peer_name
+
+ Aunque no se recomienda en general, es posible desactivar la verificación de certificados
+ por pares para una solicitud definiendo la opción de contexto
+ verify_peer
+ a &false;, y para desactivar la validación del nombre de los pares, configurando la opción de
+ contexto verify_peer_name
a &false;.
-
+
'>
-
-
+
+
@@ -11,37 +10,37 @@
PHP, que significa PHP: Preprocesador de
Hipertexto, es un lenguaje de programación de propósito general,
- de código abierto y ampliamente utilizado, especialmente adecuado para el desarrollo web y
- que se puede incrustar en HTML. Su sintaxis se basa en C, Java y Perl, y es fácil de aprender.
- El objetivo principal del lenguaje es permitir a los desarrolladores web escribir páginas web
- dinámicas rápidamente, pero se puede hacer mucho más con PHP.
+ de código abierto y ampliamente utilizado, especialmente adecuado para el
+ desarrollo web y que se puede incrustar en HTML. Su sintaxis se basa en C,
+ Java y Perl, y es fácil de aprender. El objetivo principal del lenguaje es
+ permitir a los desarrolladores web escribir páginas web dinámicas
+ rápidamente, pero se puede hacer mucho más con PHP.
-
- Este manual consiste principalmente en una
+ Este manual consta principalmente de una
referencia de funciones, aunque también contiene una
referencia del lenguaje, explicaciones
- de algunas de las características
- importantes de PHP, y otra información
- suplementaria.
+ de algunas de las principales características
+ de PHP, y otra información suplementaria.
-
- Este manual incluye información sobre las dos versiones principales más recientes de PHP (versiones 7 y 8).
- No se incluye información sobre extensiones que ya no forman parte de estas versiones de PHP ni sobre cambios
- en funciones de versiones anteriores. Los archivos de versiones antiguas del manual, que documentan lanzamientos
+ Este manual incluye información que cubre las dos versiones principales más
+ recientes de PHP (versiones 7 y 8). No se incluye información sobre
+ extensiones que ya no están incluidas en esas versiones de PHP ni sobre
+ cambios en funciones de versiones anteriores del manual. Los archivos
+ históricos de versiones anteriores del manual, que documentan lanzamientos
previos de PHP, están disponibles en la sección "Más documentación" en la
- página de "Documentación" del sitio web de PHP.
+ página de "Documentación" del sitio web
+ de PHP.
-
- Este manual se puede descargar en diferentes formatos en &url.php.doc.downloads;.
Puede encontrarse más información sobre cómo se desarrolla este manual en el
- apéndice "Acerca de este manual". Si está
- interesado en la Historia de PHP,
+ apéndice 'Acerca del manual'. Si está
+ interesado en la historia de PHP,
visite el apéndice correspondiente.