diff --git a/reference/filesystem/functions/fdatasync.xml b/reference/filesystem/functions/fdatasync.xml
new file mode 100644
index 000000000..33305b86a
--- /dev/null
+++ b/reference/filesystem/functions/fdatasync.xml
@@ -0,0 +1,96 @@
+
+
+
+
+ fdatasync
+ Sincroniza los datos (pero no los metadatos) con el fichero
+
+
+
+ &reftitle.description;
+
+ boolfdatasync
+ resourcestream
+
+
+ Esta función sincroniza el contenido del stream en el soporte de almacenamiento, al igual que fsync,
+ pero no sincroniza los metadatos de los ficheros.
+ Cabe señalar que esta función es diferente solo en sistemas POSIX.
+ En Windows, esta función es un alias de fsync.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ stream
+
+ &fs.validfp.all;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ &return.success;
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo de <function>fdatasync</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ fflush
+ fsync
+
+
+
+
+
+
diff --git a/reference/filesystem/functions/fsync.xml b/reference/filesystem/functions/fsync.xml
new file mode 100644
index 000000000..3bb5793bb
--- /dev/null
+++ b/reference/filesystem/functions/fsync.xml
@@ -0,0 +1,94 @@
+
+
+
+
+ fsync
+ Sincroniza los cambios realizados en el fichero (incluyendo los metadatos)
+
+
+
+ &reftitle.description;
+
+ boolfsync
+ resourcestream
+
+
+ Esta función sincroniza los cambios realizados en el fichero, incluyendo sus metadatos. Es similar a fflush,
+ pero además solicita al sistema operativo que escriba en el soporte de almacenamiento.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ stream
+
+ &fs.validfp.all;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ &return.success;
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo de <function>fsync</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ fdatasync
+ fflush
+
+
+
+
+
+
diff --git a/reference/filesystem/functions/fwrite.xml b/reference/filesystem/functions/fwrite.xml
new file mode 100644
index 000000000..a1ed5b82e
--- /dev/null
+++ b/reference/filesystem/functions/fwrite.xml
@@ -0,0 +1,236 @@
+
+
+
+
+
+
+ fwrite
+ Escribe en un fichero en modo binario
+
+
+
+ &reftitle.description;
+
+ intfalsefwrite
+ resourcestream
+ stringdata
+ intnulllength&null;
+
+
+ fwrite escribe el contenido de la cadena
+ data en el fichero apuntado por
+ stream.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ stream
+
+ &fs.file.pointer;
+
+
+
+ data
+
+
+ La cadena a escribir.
+
+
+
+
+ length
+
+
+ Si se proporciona la longitud length,
+ la escritura se detendrá después de
+ length bytes, o al final de la
+ cadena (lo que ocurra primero).
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ fwrite devuelve el número de bytes escritos&return.falseforfailure;.
+
+
+
+
+ &reftitle.errors;
+
+ La función fwrite emite una E_WARNING si ocurre un error.
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 8.0.0
+
+ length ahora es nullable.
+
+
+
+
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>fwrite</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.notes;
+
+
+ La escritura en un flujo puede terminar antes de que la cadena completa sea
+ escrita. El valor devuelto por la función
+ fwrite puede ser verificado de la siguiente manera:
+
+
+]]>
+
+
+
+
+
+ En los sistemas que hacen la distinción entre ficheros binarios
+ y ficheros de texto (por ejemplo, Windows), el fichero debe ser abierto
+ con la opción 'b' incluida en el parámetro de modo de
+ fopen.
+
+
+
+
+ Si stream está abierto en modo añadir (append),
+ fwrite será atómico (excepto si el tamaño de
+ data excede el tamaño del bloque del sistema de ficheros,
+ en algunas plataformas, y siempre que el fichero se encuentre en el sistema de ficheros
+ local). Por lo tanto, no es necesario utilizar la función flock
+ en un recurso antes de llamar a la función fwrite;
+ todos los datos serán escritos sin interrupción.
+
+
+
+
+ Si se escribe dos veces en el fichero, los datos serán añadidos al final
+ del fichero; esto significa que el siguiente ejemplo no dará el resultado
+ esperado:
+
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ fread
+ fopen
+ fsockopen
+ popen
+ file_get_contents
+ pack
+
+
+
+
+
+
diff --git a/reference/igbinary/book.xml b/reference/igbinary/book.xml
new file mode 100644
index 000000000..6adfa0722
--- /dev/null
+++ b/reference/igbinary/book.xml
@@ -0,0 +1,47 @@
+
+
+
+
+
+ Igbinary
+ Igbinary
+
+
+ &reftitle.intro;
+
+ Igbinary es una mejora del proceso estándar de serialización de datos de PHP que no requiere
+ ningún cambio de configuración.
+ En lugar de la representación textual, consumidora de tiempo y espacio, utilizada por la función
+ serialize de PHP, igbinary almacena las estructuras de datos de PHP en un formato binario
+ compacto.
+ Los ahorros de memoria son significativos cuando memcached, APCu u otras herramientas de almacenamiento similares
+ basadas en memoria son utilizadas para los datos serializados.
+ Las reducciones características de los requisitos de almacenamiento son de aproximadamente 50%.
+ El porcentaje exacto depende de los datos.
+
+
+
+ &reference.igbinary.setup;
+ &reference.igbinary.reference;
+
+
+
diff --git a/reference/igbinary/functions/igbinary-serialize.xml b/reference/igbinary/functions/igbinary-serialize.xml
new file mode 100644
index 000000000..ab4b5b1de
--- /dev/null
+++ b/reference/igbinary/functions/igbinary-serialize.xml
@@ -0,0 +1,158 @@
+
+
+
+
+
+ igbinary_serialize
+ Genera una representación binaria almacenable y compacta de un valor
+
+
+
+ &reftitle.description;
+
+ stringfalseigbinary_serialize
+ mixedvalue
+
+
+ Genera una representación almacenable de un valor.
+
+
+ Es una técnica práctica para almacenar o pasar valores PHP entre scripts, sin perder su estructura ni su tipo.
+
+
+ Para reconvertir la cadena sérializada en un valor PHP,
+ la función igbinary_unserialize puede ser utilizada.
+
+
+
+
+ &reftitle.parameters;
+
+
+ value
+
+
+ El valor a serializar. igbinary_serialize
+ gestiona todos los tipos excepto los recursos y ciertos objetos (confiere la nota a continuación).
+ Incluso los &array;x que contienen referencias a sí mismos pueden ser serializados con igbinary_serialize.
+ Las referencias circulares dentro de un &array; o de un &object; a serializar serán igualmente almacenadas.
+ Cualquier otra referencia será perdida.
+
+
+ Al serializar objetos, igbinary intentará llamar a los métodos mágicos
+ __serialize() o
+ __sleep() antes de la serialización.
+ Esto permitirá al objeto realizar una limpieza de último momento, etc., antes de ser serializado.
+ De igual manera, cuando el objeto es restaurado utilizando la función
+ igbinary_unserialize, uno de los métodos mágicos __unserialize()
+ o __wakeup() es llamado.
+
+
+
+ Los atributos privados de un objeto tendrán el nombre de la clase prefijado al nombre del atributo;
+ los atributos protegidos serán prefijados con un asterisco '*'.
+ Estos valores prefijados tienen caracteres nulos en ambos lados.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Retorna una cadena de caracteres que contiene una representación del parámetro value
+ en forma de flujo de bytes que puede ser almacenado en cualquier lugar.
+
+
+ Es de notar que es una cadena binaria que puede incluir caracteres nulos, y debe por lo tanto ser almacenada y gestionada como tal.
+ Por ejemplo, en una base de datos, la salida de la función igbinary_serialize
+ debe, en general, ser almacenada en un campo de tipo BLOB
+ en lugar de en un campo de tipo CHAR o TEXT.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>igbinary_serialize</function>
+
+
+]]>
+
+ &example.outputs;
+
+ 'test',
+ 1 => 'test',
+)
+]]>
+
+
+
+
+
+
+ &reftitle.notes;
+
+
+ Es de notar que muchos objetos internos de PHP no pueden ser serializados. Sin embargo, aquellos que pueden
+ implementan ya sea la interfaz Serializable o los métodos mágicos
+ __serialize()/__unserialize()
+ o __sleep()/__wakeup().
+ Si una clase interna no cumple ninguna de estas condiciones, no puede ser serializada de manera fiable.
+
+
+ Existen excepciones históricas a esta regla, donde objetos internos pueden ser serializados
+ sin implementar ni la interfaz ni los métodos mágicos.
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ serialize
+ igbinary_unserialize
+ var_export
+ json_encode
+ Serialización de objetos
+ __sleep()
+ __wakeup()
+ __serialize()
+ __unserialize()
+
+
+
+
+
+
diff --git a/reference/igbinary/functions/igbinary-unserialize.xml b/reference/igbinary/functions/igbinary-unserialize.xml
new file mode 100644
index 000000000..588f74d68
--- /dev/null
+++ b/reference/igbinary/functions/igbinary-unserialize.xml
@@ -0,0 +1,152 @@
+
+
+
+
+
+ igbinary_unserialize
+
+ Crea una variable PHP a partir de un valor serializado por igbinary_serialize
+
+
+
+
+ &reftitle.description;
+
+ mixedigbinary_unserialize
+ stringstr
+
+
+ igbinary_unserialize toma una variable serializada por
+ igbinary_serialize y la convierte en una variable PHP.
+
+
+
+ Las entradas de usuario no confiables no deben pasarse a la función
+ igbinary_unserialize.
+ La deserialización puede resultar en la ejecución de código cargado y ejecutado durante la instanciación
+ y el autochargado de objetos, y así, un usuario malintencionado puede ser capaz de explotar
+ este comportamiento.
+ En su lugar, un estándar de intercambio seguro como JSON (a través de json_decode y
+ json_encode) debe usarse para pasar datos serializados al usuario.
+
+
+ Si es indispensable deserializar datos serializados provenientes del exterior, la función
+ hash_hmac puede usarse para validar los datos.
+ Es importante verificar que nadie haya alterado los datos.
+
+
+
+
+ El protocolo de serialización por igbinary no permite distinguir entre los diferentes grupos de
+ referencias. Todas las referencias PHP a un valor dado son vistas como miembros de un mismo
+ grupo durante la deserialización, incluso si pertenecían a grupos diferentes antes de la
+ serialización.
+
+
+
+
+
+ &reftitle.parameters;
+
+
+ str
+
+
+ La cadena serializada, generada por igbinary_serialize.
+
+
+ Si la variable deserializada es un &object;, después de reconstruirla con éxito,
+ PHP intentará automáticamente llamar a los métodos mágicos
+ __unserialize() o
+ __wakeup() (si alguno de ellos existe).
+
+
+
+
+ La directiva <link linkend="ini.unserialize-callback-func">unserialize_callback_func</link>
+
+
+ La función de retrollamada especificada en la directiva
+ unserialize_callback_func
+ es llamada cuando una clase no definida es deserializada.
+ Si ninguna función de retrollamada es especificada, el objeto será instanciado
+ como __PHP_Incomplete_Class.
+
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ El valor convertido es retornado por la función, y puede ser de tipo &boolean;,
+ &integer;, &float;, &string;,
+ &array;, &object;, o de tipo null.
+
+
+ Si la cadena pasada no puede ser deserializada, esta función retorna &false; y
+ un diagnóstico E_NOTICE o E_WARNING es emitido.
+
+
+
+
+ &reftitle.errors;
+
+ Los objetos pueden lanzar un Throwable en su gestor de deserialización.
+
+
+
+
+ &reftitle.notes;
+
+
+ &null; o &false; es retornado ya sea en caso de error o después de deserializar
+ el resultado de la serialización de &null; o &false;. Es posible discriminar entre estos dos casos
+ especiales comparando el valor del parámetro str con el resultado de la ejecución
+ de igbinary_serialize(null) o de igbinary_serialize(false)
+ o bien atrapando un diagnóstico E_NOTICE.
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ unserialize
+ json_encode
+ json_decode
+ hash_hmac
+ igbinary_serialize
+ Autocargado de clases
+ unserialize_callback_func
+ __wakeup()
+ __serialize()
+ __unserialize()
+
+
+
+
+
diff --git a/reference/igbinary/ini.xml b/reference/igbinary/ini.xml
new file mode 100644
index 000000000..d47a25a23
--- /dev/null
+++ b/reference/igbinary/ini.xml
@@ -0,0 +1,105 @@
+
+
+
+
+
+ &reftitle.runtime;
+ &extension.runtime;
+
+
+ Opciones de configuración de sesión que afectan al comportamiento de igbinary
+
+
+
+ &Name;
+ &Default;
+ &Changeable;
+ &Changelog;
+
+
+
+
+ session.save_handler
+ "files"
+ INI_ALL
+
+
+
+
+
+ &ini.php.constants;
+
+
+ &ini.descriptions.title;
+
+
+
+
+
+ igbinary.compact_strings
+ bool
+
+
+
+ Activa o no el compactado de strings duplicados.
+ El valor por omisión es On.
+
+
+
+
+
+
+ session.save_handler
+ string
+
+
+
+ Igbinary es utilizado como gestor de sesión al establecer el valor de esta opción a igbinary.
+
+
+
+
+
+
+
+
diff --git a/reference/igbinary/reference.xml b/reference/igbinary/reference.xml
new file mode 100644
index 000000000..b01aa7f5b
--- /dev/null
+++ b/reference/igbinary/reference.xml
@@ -0,0 +1,29 @@
+
+
+
+
+ &Functions; de Igbinary
+
+ &reference.igbinary.entities.functions;
+
+
+
diff --git a/reference/info/constants.xml b/reference/info/constants.xml
new file mode 100644
index 000000000..5661d232e
--- /dev/null
+++ b/reference/info/constants.xml
@@ -0,0 +1,599 @@
+
+
+
+
+
+ &reftitle.constants;
+ &extension.constants.core;
+
+
+ Constantes predefinidas de <function xmlns="http://docbook.org/ns/docbook">phpcredits</function>
+
+
+ CREDITS_GROUP
+ (int)
+
+
+
+ Una lista de los desarrolladores principales
+
+
+
+
+
+ CREDITS_GENERAL
+ (int)
+
+
+
+ Créditos generales. Diseño del lenguaje, conceptos,
+ autores de PHP y módulo SAPI.
+
+
+
+
+
+ CREDITS_SAPI
+ (int)
+
+
+
+ Una lista de las API de servidores, y sus autores.
+
+
+
+
+
+ CREDITS_MODULES
+ (int)
+
+
+
+ Una lista de las extensiones de PHP, y sus autores
+
+
+
+
+
+ CREDITS_DOCS
+ (int)
+
+
+
+ Los créditos del equipo de documentación
+
+
+
+
+
+ CREDITS_FULLPAGE
+ (int)
+
+
+
+ Generalmente utilizado combinado con otras opciones. Esta
+ opción indica que debe generarse una página HTML completa.
+
+
+
+
+
+ CREDITS_QA
+ (int)
+
+
+
+ Los créditos para el grupo de aseguramiento de calidad.
+
+
+
+
+
+ CREDITS_ALL
+ (int)
+
+
+
+ Todos los créditos. Es el equivalente a: CREDITS_DOCS
+ | CREDITS_GENERAL | CREDITS_GROUP | CREDITS_MODULES | CREDITS_QA
+ | CREDITS_FULLPAGE. Genera una página HTML completa
+ y autónoma. Es el valor por omisión.
+
+
+
+
+
+
+ Constantes de <function xmlns="http://docbook.org/ns/docbook">phpinfo</function>
+
+
+ INFO_GENERAL
+ (int)
+
+
+
+ La línea de configuración, la ruta del &php.ini;, la fecha de
+ compilación, el sistema y más.
+
+
+
+
+
+ INFO_CREDITS
+ (int)
+
+
+
+ Créditos de PHP. Véase también phpcredits.
+
+
+
+
+
+ INFO_CONFIGURATION
+ (int)
+
+
+
+ Valores locales y de servidor de las directivas PHP. Véase también
+ ini_get.
+
+
+
+
+
+ INFO_MODULES
+ (int)
+
+
+
+ Los módulos cargados y sus configuraciones respectivas.
+
+
+
+
+
+ INFO_ENVIRONMENT
+ (int)
+
+
+
+ Las variables de entorno, que también están disponibles
+ en $_ENV.
+
+
+
+
+
+ INFO_VARIABLES
+ (int)
+
+
+
+ Todas las
+ variables predefinidas : EGPCS
+ (Entorno, GET, POST, Cookie, Servidor).
+
+
+
+
+
+ INFO_LICENSE
+ (int)
+
+
+
+ La licencia de PHP. Véase también la
+ FAQ de la licencia.
+
+
+
+
+
+ INFO_ALL
+ (int)
+
+
+
+ Muestra todos los valores citados anteriormente. Es el valor
+ por omisión.
+
+
+
+
+
+
+ Constantes modo INI
+
+
+ INI_USER
+ (int)
+
+
+
+ Esta entrada puede ser definida en los scripts de usuario (como con ini_set)
+ o en el registro de Windows.
+ La entrada puede ser definida en el fichero &user-ini;.
+
+
+
+
+
+ INI_PERDIR
+ (int)
+
+
+
+ Esta entrada puede ser definida en el fichero &php.ini;, &htaccess;, &httpd.conf; o &user-ini;.
+
+
+
+
+
+ INI_SYSTEM
+ (int)
+
+
+
+ Esta entrada puede ser definida en el fichero &php.ini; o &httpd.conf;.
+
+
+
+
+
+ INI_ALL
+ (int)
+
+
+
+ Esta entrada puede ser definida en cualquier lugar.
+
+
+
+
+
+
+ Las constantes de aserciones sirven con la función
+ assert_options.
+
+
+ Constantes de <function xmlns="http://docbook.org/ns/docbook">assert</function>
+
+
+ ASSERT_ACTIVE
+ (int)
+
+
+
+ Activa la evaluación assert.
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ ASSERT_CALLBACK
+ (int)
+
+
+
+ Función de retrollamada de aserciones fallidas.
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ ASSERT_BAIL
+ (int)
+
+
+
+ Termina la ejecución de aserciones fallidas.
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ ASSERT_EXCEPTION
+ (int)
+
+
+
+ Lanza una AssertionError para cada aserción fallida.
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ ASSERT_WARNING
+ (int)
+
+
+
+ Emite una alerta PHP para cada aserción fallida.
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ ASSERT_QUIET_EVAL
+ (int)
+
+
+
+ Desactiva el error_reporting durante la evaluación
+ de las expresiones de aserción.
+ &warn.feature.removed-8-0-0;
+
+
+
+
+
+
+ Las constantes siguientes solo están disponibles si el sistema de
+ alojamiento es Windows, y pueden proporcionar información
+ sobre las versiones, lo que permite detectar la presencia
+ de funcionalidades. Están disponibles desde PHP 5.3.0.
+
+
+ Constantes particulares a Windows
+
+
+ PHP_WINDOWS_VERSION_MAJOR
+ (int)
+
+
+
+ La versión mayor de Windows, que puede ser 4
+ (NT4/Me/98/95), 5 (XP/2003 R2/2003/2000) o 6 (Vista/2008/7/8/8.1).
+
+
+
+
+
+ PHP_WINDOWS_VERSION_MINOR
+ (int)
+
+
+
+ La versión menor de Windows, que puede ser 0
+ (Vista/2008/2000/NT4/95), 1 (XP), 2
+ (2003 R2/2003/XP x64), 10 (98) o 90 (ME).
+
+
+
+
+
+ PHP_WINDOWS_VERSION_BUILD
+ (int)
+
+
+
+ El número de compilación de Windows (por ejemplo,
+ Windows Vista con SP1 tiene el número 6001)
+
+
+
+
+
+ PHP_WINDOWS_VERSION_PLATFORM
+ (int)
+
+
+
+ La plataforma que PHP utiliza actualmente: este valor puede ser
+ 2 en Windows Vista/XP/2000/NT4, Server 2008/2003 y
+ en Windows ME/98/95 este valor es 1.
+
+
+
+
+
+ PHP_WINDOWS_VERSION_SP_MAJOR
+ (int)
+
+
+
+ La versión mayor del paquete de servicio instalado: este valor es
+ 0 si ningún paquete de servicio está disponible. Por
+ ejemplo, Windows XP con el paquete de servicio 3 da el valor
+ 3 a esta constante.
+
+
+
+
+
+ PHP_WINDOWS_VERSION_SP_MINOR
+ (int)
+
+
+
+ La versión menor del paquete de servicio instalado. Este valor es
+ 0 si ningún paquete de servicio está instalado.
+
+
+
+
+
+ PHP_WINDOWS_VERSION_SUITEMASK
+ (int)
+
+
+
+ La máscara es un campo de bits que permite conocer la presencia
+ de diferentes funcionalidades de Windows. Vea la tabla a continuación
+ para conocer los diferentes campos.
+
+
+
+
+
+ PHP_WINDOWS_VERSION_PRODUCTTYPE
+ (int)
+
+
+
+ Esta constante contiene el valor utilizado para determinar
+ el valor de las constantes
+ PHP_WINDOWS_NT_*.
+ Este valor puede ser una de las constantes
+ PHP_WINDOWS_NT_*,
+ indicando el tipo de plataforma.
+
+
+
+
+
+ PHP_WINDOWS_NT_DOMAIN_CONTROLLER
+ (int)
+
+
+
+ El controlador de dominio.
+
+
+
+
+
+ PHP_WINDOWS_NT_SERVER
+ (int)
+
+
+
+ Un servidor de sistema (ej. Server 2008/2003/2000). Tenga en cuenta que
+ si es un controlador de dominio, se indica en
+ PHP_WINDOWS_NT_DOMAIN_CONTROLLER.
+
+
+
+
+
+ PHP_WINDOWS_NT_WORKSTATION
+ (int)
+
+
+
+ Un puesto de trabajo (ej. Vista/XP/2000/NT4)
+
+
+
+
+
+ La tabla a continuación presenta las funcionalidades que pueden ser
+ verificadas en el campo de bits de la constante
+ PHP_WINDOWS_VERSION_SUITEMASK.
+
+
+ Campos de la máscara Windows
+
+
+
+ Bits
+ Descripción
+
+
+
+
+ 0x00000004
+ Los componentes Microsoft BackOffice están instalados.
+
+
+ 0x00000400
+ Windows Server 2003, Web Edition está instalado.
+
+
+ 0x00004000
+ Windows Server 2003, Compute Cluster Edition está instalado.
+
+
+ 0x00000080
+
+ Windows Server 2008 Datacenter, Windows Server 2003, Datacenter Edition o
+ Windows 2000 Datacenter Server está instalado.
+
+
+
+ 0x00000002
+
+ Windows Server 2008 Enterprise, Windows Server 2003, Enterprise Edition,
+ Windows 2000 Advanced Server, o Windows NT Server 4.0 Enterprise Edition
+ está instalado.
+
+
+
+ 0x00000040
+ Windows XP Embedded está instalado.
+
+
+ 0x00000200
+
+ Windows Vista Home Premium, Windows Vista Home Basic, o Windows XP Home
+ Edition está instalado.
+
+
+
+ 0x00000100
+
+ Remote Desktop es soportado, pero solo una sesión interactiva es
+ soportada. Este valor está presente, a menos que el sistema no funcione
+ en modo servidor de aplicación.
+
+
+
+ 0x00000001
+
+ Microsoft Small Business Server fue instalado en el sistema, pero
+ fue actualizado a una nueva versión de Windows.
+
+
+
+ 0x00000020
+
+ Microsoft Small Business Server está instalado con la licencia cliente
+ restringida.
+
+
+
+ 0x00002000
+ Windows Storage Server 2003 R2 o Windows Storage Server 2003 está instalado.
+
+
+ 0x00000010
+
+ Terminal Services está instalado. Este valor siempre está activado. Si este
+ valor está activado, pero 0x00000100 no lo está, entonces
+ el sistema funciona en modo de servidor de aplicación.
+
+
+
+ 0x00008000
+ Windows Home Server está instalado.
+
+
+
+
+
+
diff --git a/reference/info/functions/cli-get-process-title.xml b/reference/info/functions/cli-get-process-title.xml
new file mode 100644
index 000000000..cfa2cb040
--- /dev/null
+++ b/reference/info/functions/cli-get-process-title.xml
@@ -0,0 +1,96 @@
+
+
+
+
+
+
+ cli_get_process_title
+ Devuelve el título del proceso actual
+
+
+
+ &reftitle.description;
+
+ stringnullcli_get_process_title
+
+
+
+ Devuelve el título del proceso actual, tal como se definió mediante la función
+ cli_set_process_title. Tenga en cuenta que este título puede
+ ser ligeramente diferente al que se muestra mediante los comandos
+ ps y top, según el sistema subyacente.
+
+
+
+ Esta función solo está disponible en modo
+ CLI.
+
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el título del proceso actual, en forma de
+ una cadena de caracteres, o &null; si ocurre un error.
+
+
+
+
+ &reftitle.errors;
+
+ Se generará una advertencia de nivel E_WARNING si el sistema
+ subyacente no es compatible.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>cli_get_process_title</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ cli_set_process_title
+
+
+
+
+
diff --git a/reference/info/functions/cli-set-process-title.xml b/reference/info/functions/cli-set-process-title.xml
new file mode 100644
index 000000000..3ec9d2c18
--- /dev/null
+++ b/reference/info/functions/cli-set-process-title.xml
@@ -0,0 +1,113 @@
+
+
+
+
+
+
+
+ cli_set_process_title
+ Define el título del proceso
+
+
+
+ &reftitle.description;
+
+ boolcli_set_process_title
+ stringtitle
+
+
+
+ Define el título del proceso visible con herramientas como
+ top y ps. Esta función
+ solo está disponible en modo
+ CLI.
+
+
+
+
+
+ &reftitle.parameters;
+
+
+ title
+
+
+ El nuevo título
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ &return.success;
+
+
+
+
+ &reftitle.errors;
+
+
+ Se generará una alerta de nivel E_WARNING si el sistema
+ subyacente no es compatible.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>cli_set_process_title</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ cli_get_process_title
+
+
+
+
+
+
+
diff --git a/reference/info/functions/gc-mem-caches.xml b/reference/info/functions/gc-mem-caches.xml
new file mode 100644
index 000000000..758e88739
--- /dev/null
+++ b/reference/info/functions/gc-mem-caches.xml
@@ -0,0 +1,131 @@
+
+
+
+
+
+
+
+ gc_mem_caches
+
+ Libera memoria utilizada por el gestor de memoria de Zend Engine
+
+
+
+
+ &reftitle.description;
+
+ intgc_mem_caches
+
+
+
+ Libera memoria utilizada por el gestor de memoria de Zend Engine.
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el número de bytes liberados.
+
+
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ Recolección de basura (Garbage Collection)
+
+
+
+
+
+
+
diff --git a/reference/info/functions/gc-status.xml b/reference/info/functions/gc-status.xml
new file mode 100644
index 000000000..0538a4105
--- /dev/null
+++ b/reference/info/functions/gc-status.xml
@@ -0,0 +1,229 @@
+
+
+
+
+
+
+
+ gc_status
+ Obtiene información sobre el recolector de basura
+
+
+
+ &reftitle.description;
+
+ arraygc_status
+
+
+
+ Obtiene información sobre el estado actual del recolector de basura.
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un &array; asociativo con los siguientes elementos:
+
+
+
+ "runs"
+
+
+
+
+ "collected"
+
+
+
+
+ "threshold"
+
+
+
+
+ "roots"
+
+
+
+
+ "running"
+
+
+
+
+ "protected"
+
+
+
+
+ "full"
+
+
+
+
+ "buffer_size"
+
+
+
+
+ "application_time"
+
+
+
+
+ "collector_time"
+
+
+
+
+ "destructor_time"
+
+
+
+
+ "free_time"
+
+
+
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 8.3.0
+
+ gc_status devuelve ahora los campos adicionales siguientes:
+ "running", "protected",
+ "full", "buffer_size",
+ "application_time", "collector_time",
+ "destructor_time", y "free_time".
+
+
+
+
+
+
+
+
+
+ &reftitle.examples;
+
+
+ Uso de <function>gc_status</function>
+
+b = [];
+for ($i = 0; $i < 100000; $i++) {
+ $b = new stdClass();
+ $b->a = $a;
+ $a->b[] = $b;
+}
+unset($a);
+unset($b);
+gc_collect_cycles();
+
+var_dump(gc_status());
+]]>
+
+ &example.outputs.similar;
+
+
+ int(5)
+ ["collected"]=>
+ int(100002)
+ ["threshold"]=>
+ int(50001)
+ ["roots"]=>
+ int(0)
+}
+]]>
+
+ &example.outputs.83.similar;
+
+
+ bool(false)
+ ["protected"]=>
+ bool(false)
+ ["full"]=>
+ bool(false)
+ ["runs"]=>
+ int(5)
+ ["collected"]=>
+ int(100002)
+ ["threshold"]=>
+ int(50001)
+ ["buffer_size"]=>
+ int(131072)
+ ["roots"]=>
+ int(0)
+ ["application_time"]=>
+ float(0.031182458)
+ ["collector_time"]=>
+ float(0.020106291)
+ ["destructor_time"]=>
+ float(0)
+ ["free_time"]=>
+ float(0.003707167)
+}
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ Recolector de basura (Garbage Collection)
+
+
+
+
+
+
+
diff --git a/reference/info/functions/get-magic-quotes-gpc.xml b/reference/info/functions/get-magic-quotes-gpc.xml
new file mode 100644
index 000000000..cba00e847
--- /dev/null
+++ b/reference/info/functions/get-magic-quotes-gpc.xml
@@ -0,0 +1,100 @@
+
+
+
+
+
+ get_magic_quotes_gpc
+ Devuelve la configuración actual de la opción magic_quotes_gpc
+
+
+
+ &warn.deprecated.function-7-4-0.removed-8-0-0;
+
+
+
+ &reftitle.description;
+
+ falseget_magic_quotes_gpc
+
+
+
+ Siempre devuelve &false;.
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Siempre devuelve &false;.
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 8.0.0
+
+ &removed.function;
+
+
+
+ 7.4.0
+
+ &deprecated.function;
+
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ addslashes
+ stripslashes
+ get_magic_quotes_runtime
+ ini_get
+
+
+
+
+
+
+
diff --git a/reference/info/functions/get-magic-quotes-runtime.xml b/reference/info/functions/get-magic-quotes-runtime.xml
new file mode 100644
index 000000000..08b1150f8
--- /dev/null
+++ b/reference/info/functions/get-magic-quotes-runtime.xml
@@ -0,0 +1,97 @@
+
+
+
+
+
+ get_magic_quotes_runtime
+ Devuelve la configuración actual de la opción magic_quotes_runtime
+
+
+
+ &warn.deprecated.function-7-4-0.removed-8-0-0;
+
+
+
+ &reftitle.description;
+
+ falseget_magic_quotes_runtime
+
+
+
+ Siempre devuelve &false;.
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ Siempre devuelve &false;.
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 8.0.0
+
+ &removed.function;
+
+
+
+ 7.4.0
+
+ &deprecated.function;
+
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ get_magic_quotes_gpc
+
+
+
+
+
+
+
diff --git a/reference/info/functions/get-resources.xml b/reference/info/functions/get-resources.xml
new file mode 100644
index 000000000..6080cd31f
--- /dev/null
+++ b/reference/info/functions/get-resources.xml
@@ -0,0 +1,167 @@
+
+
+
+
+
+
+ get_resources
+ Devuelve los recursos activos
+
+
+
+ &reftitle.description;
+
+ arrayget_resources
+ stringnulltype&null;
+
+
+ Devuelve un array de todos los recursos resource actualmente activos,
+ opcionalmente filtrados por el tipo de recurso.
+
+
+
+ Esta función está destinada a fines de depuración y prueba. No está pensada
+ para ser utilizada en entornos de producción, y mucho menos para acceder o incluso manipular
+ recursos que normalmente no son accesibles (por ejemplo, el recurso
+ de flujo subyacente de las instancias de SplFileObject).
+
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ type
+
+
+ Si se define, esto hará que get_resources
+ devuelva solo los recursos del tipo dado.
+ Una lista de tipos de recursos está disponible.
+
+
+ Si se proporciona &string; Unknown para el tipo,
+ en ese caso solo se devolverán los recursos cuyo tipo es desconocido.
+
+
+ Si se omite, se devolverán todos los recursos.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un &array; de los recursos actualmente activos, indexados por el
+ número del recurso.
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 8.0.0
+
+ type ahora es nullable.
+
+
+
+
+
+
+
+
+ &reftitle.examples;
+
+
+ <function>get_resources</function> sin filtrar
+
+
+]]>
+
+ &example.outputs.similar;
+
+
+ resource(1) of type (stream)
+}
+]]>
+
+
+
+ <function>get_resources</function> filtrado
+
+
+]]>
+
+ &example.outputs.similar;
+
+
+ resource(1) of type (stream)
+}
+array(0) {
+}
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ get_loaded_extensions
+ get_defined_constants
+ get_defined_functions
+ get_defined_vars
+
+
+
+
+
+
diff --git a/reference/info/functions/ini-parse-quantity.xml b/reference/info/functions/ini-parse-quantity.xml
new file mode 100644
index 000000000..626d9a0cd
--- /dev/null
+++ b/reference/info/functions/ini-parse-quantity.xml
@@ -0,0 +1,130 @@
+
+
+
+
+
+ ini_parse_quantity
+ Devuelve el tamaño interpretado a partir de la sintaxis abreviada ini
+
+
+
+ &reftitle.description;
+
+ intini_parse_quantity
+ stringshorthand
+
+
+ Devuelve el tamaño interpretado en bytes en caso de éxito a partir de una sintaxis abreviada ini.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ shorthand
+
+
+ La sintaxis abreviada ini a interpretar, debe ser un número seguido de un multiplicador opcional.
+
+ Los multiplicadores siguientes son soportados: k/K (1024),
+ m/M (1048576),
+ g/G (1073741824).
+
+ El número puede ser un decimal, hexadecimal (prefijado por 0x o 0X),
+ octal (prefijado por 0o, 0O o 0) o binario (prefijado por
+ 0b o 0B)
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño interpretado en bytes en tanto que &integer;.
+
+
+
+
+ &reftitle.errors;
+
+ Si el valor no puede ser interpretado, o si un multiplicador inválido es utilizado, un E_WARNING es emitido.
+
+
+
+
+ &reftitle.examples;
+
+
+ Algunos ejemplos de <function>ini_parse_quantity</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+ ini_get
+
+
+
+
diff --git a/reference/info/functions/memory-reset-peak-usage.xml b/reference/info/functions/memory-reset-peak-usage.xml
new file mode 100644
index 000000000..08bf6d9b3
--- /dev/null
+++ b/reference/info/functions/memory-reset-peak-usage.xml
@@ -0,0 +1,98 @@
+
+
+
+
+
+ memory_reset_peak_usage
+ Reinicia el uso máximo de memoria
+
+
+
+ &reftitle.description;
+
+ voidmemory_reset_peak_usage
+
+
+
+ Reinicia el uso máximo de memoria devuelto por la
+ función memory_get_peak_usage.
+
+
+
+
+ &reftitle.parameters;
+ &no.function.parameters;
+
+
+
+ &reftitle.returnvalues;
+
+ &return.void;
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo de <function>memory_reset_peak_usage</function>
+
+
+]]>
+
+ &example.outputs.similar;
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ memory_get_peak_usage
+
+
+
+
+
+
diff --git a/reference/info/ini.xml b/reference/info/ini.xml
new file mode 100644
index 000000000..eb9108175
--- /dev/null
+++ b/reference/info/ini.xml
@@ -0,0 +1,454 @@
+
+
+
+
+
+ &reftitle.runtime;
+ &extension.runtime;
+
+
+ &ConfigureOptions;
+
+
+
+ &Name;
+ &Default;
+ &Changeable;
+ &Changelog;
+
+
+
+
+ assert.active
+ "1"
+ INI_ALL
+
+ Obsoleto a partir de PHP 8.3.0
+
+
+
+ assert.bail
+ "0"
+ INI_ALL
+
+ Obsoleto a partir de PHP 8.3.0
+
+
+
+ assert.warning
+ "1"
+ INI_ALL
+
+ Obsoleto a partir de PHP 8.3.0
+
+
+
+ assert.callback
+ NULL
+ INI_ALL
+
+ Obsoleto a partir de PHP 8.3.0
+
+
+
+ assert.quiet_eval
+ "0"
+ INI_ALL
+ Eliminado a partir de PHP 8.0.0
+
+
+ assert.exception
+ "1"
+ INI_ALL
+
+ Anterior a PHP 8.0.0, el valor por defecto es "0"
+ Obsoleto a partir de PHP 8.3.0
+
+
+
+ enable_dl
+ "1"
+ INI_SYSTEM
+ &removed.php.future;
+
+
+ max_execution_time
+ "30"
+ INI_ALL
+
+
+
+ max_input_time
+ "-1"
+ INI_PERDIR
+
+
+
+ max_input_nesting_level
+ "64"
+ INI_PERDIR
+
+
+
+ max_input_vars
+ 1000
+ INI_PERDIR
+
+
+
+ zend.enable_gc
+ "1"
+ INI_ALL
+
+
+
+ zend.max_allowed_stack_size
+ "0"
+ INI_SYSTEM
+ Disponible a partir de PHP 8.3.0.
+
+
+ zend.reserved_stack_size
+ "0"
+ INI_SYSTEM
+ Disponible a partir de PHP 8.3.0.
+
+
+ fiber.stack_size
+
+ INI_ALL
+ Disponible a partir de PHP 8.1.0.
+
+
+
+
+ &ini.php.constants;
+
+ &ini.descriptions.title;
+
+
+
+
+ assert.active
+ bool
+
+
+
+ Activa las evaluaciones de tipo assert.
+ zend.assertions debería ser
+ utilizado en su lugar para controlar el comportamiento de assert.
+
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ assert.bail
+ bool
+
+
+
+ Termina el script si una aserción falla.
+
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ assert.warning
+ bool
+
+
+
+ Emite una alerta PHP para cada aserción que falle.
+
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ assert.callback
+ string
+
+
+
+ Función definida por el programador, a llamar para cada
+ aserción fallida.
+
+ &warn.deprecated.feature-8-3-0;
+
+
+
+
+
+ assert.quiet_eval
+ bool
+
+
+ &warn.feature.removed-8-0-0;
+
+ Utiliza la configuración actual de error_reporting
+ durante las evaluaciones de aserciones. Si está activada, ningún error es
+ mostrado (error_reporting(0) implícito) durante la evaluación. Si está desactivada,
+ los errores son mostrados según la configuración de
+ error_reporting
+
+
+
+
+
+
+ assert.exception
+ bool
+
+
+
+ Lanza una excepción AssertionError cuando una
+ aserción falla.
+
+
+
+
+
+
+ enable_dl
+ bool
+
+
+
+ Esta directiva permite activar o desactivar
+ la carga dinámica de extensiones PHP con la función PHP dl.
+
+
+ La razón principal para desactivar este sistema es la seguridad.
+ Con la carga dinámica, es posible eludir
+ las restricciones impuestas por
+ open_basedir.
+
+
+
+
+
+
+ max_execution_time
+ int
+
+
+
+ Establece el tiempo máximo de ejecución de un script,
+ en segundos. Esto evita que los scripts en
+ bucles infinitos saturen el servidor. La configuración por
+ defecto es de 30 segundos. Cuando PHP
+ funciona desde la línea
+ de comando, el valor por defecto es 0.
+
+
+ En sistemas no-Windows, el tiempo máximo de ejecución no se ve afectado por
+ llamadas al sistema como sleep.
+ Consulte la función set_time_limit
+ para más detalles.
+
+
+ El servidor web puede tener otras configuraciones de tiempo límite
+ de ejecución que también pueden interrumpir PHP. Apache tiene una directiva
+ Timeout e IIS tiene una función CGI para ello.
+ Por defecto, ambas valen 300 segundos. Consulte
+ la documentación del servidor web para más detalles.
+
+
+
+
+
+
+ max_input_time
+ int
+
+
+
+ Esta opción especifica la duración máxima para analizar
+ los datos de entrada, como POST y GET.
+ Esta duración se mide desde el momento en que PHP es invocado en el
+ servidor hasta el inicio de la ejecución del script.
+ El valor por defecto es -1, lo que significa que
+ max_execution_time
+ es utilizado en su lugar. Establecer el valor a 0 para permitir una ejecución ilimitada.
+
+
+
+
+
+
+ max_input_nesting_level
+ int
+
+
+
+ Define la profundidad máxima de las
+ variables de entrada (es decir,
+ $_GET, $_POST..)
+
+
+
+
+
+
+ max_input_vars
+ int
+
+
+
+ El número de variables de entrada
+ que pueden ser aceptadas (este límite se aplica a las variables
+ superglobales $_GET, $_POST y $_COOKIE, por separado). El uso de esta directiva
+ permite limitar las posibilidades de ataque por denegación de servicio
+ utilizando colisiones de hash. Si hay más variables de entrada que el número especificado por esta directiva, una
+ alerta de tipo E_WARNING será emitida, y las
+ variables adicionales serán eliminadas de la solicitud.
+
+
+
+
+
+
+ zend.enable_gc
+ bool
+
+
+
+ Activa o desactiva la recolección de referencias circulares.
+
+
+
+
+
+ zend.max_allowed_stack_size
+ int
+
+
+
+ La cantidad máxima de memoria de pila nativa (stack) permitida por el
+ sistema operativo para el programa.
+ Intentar consumir más de lo que el sistema permite generalmente resulta
+ en un fallo brusco, sin información de depuración
+ fácilmente disponible.
+ Para facilitar la depuración, el motor lanza una
+ Error
+ antes de que esto ocurra (cuando el programa utiliza más de
+ zend.max_allowed_stack_size-zend.reserved_stack_size
+ bytes de pila).
+
+
+ La recursión en el código definido por el usuario no consume
+ pila nativa. Sin embargo, las funciones internas y los métodos mágicos, sí
+ consumen pila nativa.
+ Una recursión muy profunda que involucre estas funciones puede hacer que el programa
+ agote toda la memoria de pila disponible.
+
+
+ Los valores posibles para este parámetro son:
+
+
+ 0 :
+ Detectar automáticamente la memoria de pila nativa máxima que el sistema
+ operativo permite para el programa.
+ Este es el valor por defecto.
+ Cuando la detección es imposible, se utiliza un valor por defecto del sistema.
+
+
+ -1 : Desactiva la verificación del tamaño de la pila en el motor.
+
+
+ Entero positivo : Un tamaño fijo, en bytes.
+ Establecer este valor demasiado alto equivale a desactivar la verificación de la
+ tamaño de la pila.
+
+
+
+
+ Como el tamaño de pila
+ de las fibers
+ está determinado por
+ fiber.stack_size,
+ el valor de este parámetro es utilizado en lugar de
+ zend.max_allowed_stack_size
+ durante la verificación del uso de la pila durante la ejecución de una Fiber.
+
+
+
+ Esto no tiene ninguna relación con los desbordamientos de búfer de pila
+ (stack buffer overflows), y no es una funcionalidad de seguridad.
+
+
+
+
+
+
+
+ zend.reserved_stack_size
+ int
+
+
+
+ El tamaño reservado de la pila, en bytes.
+ Este se resta de la
+ tamaño máximo de pila permitido,
+ como un margen de seguridad, durante la verificación del tamaño de la pila.
+
+
+ Los valores posibles para este parámetro son:
+
+
+ 0 : Detectar automáticamente un tamaño razonable.
+
+
+ Entero positivo : Un tamaño fijo, en bytes.
+
+
+
+
+
+
+
+
+ fiber.stack_size
+ int
+
+
+
+ El tamaño de la pila nativa, en bytes, asignada a cada
+ Fiber.
+
+
+ El valor por defecto es de 1 Mio en sistemas donde el tamaño de los punteros
+ es inferior a 8 bytes, o de 2 Mio en caso contrario.
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/book.xml b/reference/mcrypt/book.xml
new file mode 100644
index 000000000..ee0d29ce3
--- /dev/null
+++ b/reference/mcrypt/book.xml
@@ -0,0 +1,69 @@
+
+
+
+
+
+
+
+ Mcrypt
+
+
+
+ &reftitle.intro;
+
+ &warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives;
+
+
+ Sodium
+ (disponible a partir de PHP 7.2.0)
+
+
+ OpenSSL
+
+
+
+
+
+
+ &pecl.moved-ver;7.2.0.
+
+
+
+ Estas funciones permiten acceder a la biblioteca
+ mcrypt, que dispone de una gran variedad de algoritmos
+ de cifrado, como DES, TripleDES, Blowfish (por omisión), 3-WAY,
+ SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 y GOST en modos CBC,
+ OFB, CFB y ECB. Asimismo, aceptan también RC6 e IDEA que son
+ considerados como "no libres".
+ CFB/OFB es de 8 bits por omisión.
+
+
+
+
+ &reference.mcrypt.setup;
+ &reference.mcrypt.constants;
+ &reference.mcrypt.ciphers;
+ &reference.mcrypt.reference;
+
+
+
+
diff --git a/reference/mcrypt/ciphers.xml b/reference/mcrypt/ciphers.xml
new file mode 100644
index 000000000..969e00d99
--- /dev/null
+++ b/reference/mcrypt/ciphers.xml
@@ -0,0 +1,94 @@
+
+
+
+
+
+
+ Modos de cifrado Mcrypt
+
+ A continuación se presenta una lista no exhaustiva de los modos de cifrado de la extensión
+ mcrypt. Para disponer de una lista completa de los cifrados soportados,
+ consulte las definiciones en el fichero mcrypt.h. La regla
+ general con la API mcrypt-2.2.x es que se puede acceder al
+ modo de cifrado desde PHP con la constante MCRYPT_ciphername. Con
+ la biblioteca libmcrypt-2.4.x y libmcrypt-2.5.x, estas constantes funcionan
+ siempre, pero es posible especificar el nombre del cifrado en una cadena,
+ al llamar a mcrypt_module_open.
+
+ MCRYPT_3DES
+ MCRYPT_ARCFOUR_IV (libmcrypt > 2.4.x únicamente)
+ MCRYPT_ARCFOUR (libmcrypt > 2.4.x únicamente)
+ MCRYPT_BLOWFISH
+ MCRYPT_CAST_128
+ MCRYPT_CAST_256
+ MCRYPT_CRYPT
+ MCRYPT_DES
+ MCRYPT_DES_COMPAT (libmcrypt 2.2.x únicamente)
+ MCRYPT_ENIGMA (libmcrypt > 2.4.x únicamente, alias de MCRYPT_CRYPT)
+ MCRYPT_GOST
+ MCRYPT_IDEA (no libre)
+ MCRYPT_LOKI97 (libmcrypt > 2.4.x únicamente)
+ MCRYPT_MARS (libmcrypt > 2.4.x únicamente, no libre)
+ MCRYPT_PANAMA (libmcrypt > 2.4.x únicamente)
+ MCRYPT_RIJNDAEL_128 (libmcrypt > 2.4.x únicamente)
+ MCRYPT_RIJNDAEL_192 (libmcrypt > 2.4.x únicamente)
+ MCRYPT_RIJNDAEL_256 (libmcrypt > 2.4.x únicamente)
+ MCRYPT_RC2
+ MCRYPT_RC4 (libmcrypt 2.2.x únicamente)
+ MCRYPT_RC6 (libmcrypt > 2.4.x únicamente)
+ MCRYPT_RC6_128 (libmcrypt 2.2.x únicamente)
+ MCRYPT_RC6_192 (libmcrypt 2.2.x únicamente)
+ MCRYPT_RC6_256 (libmcrypt 2.2.x únicamente)
+ MCRYPT_SAFER64
+ MCRYPT_SAFER128
+ MCRYPT_SAFERPLUS (libmcrypt > 2.4.x únicamente)
+ MCRYPT_SERPENT(libmcrypt > 2.4.x únicamente)
+ MCRYPT_SERPENT_128 (libmcrypt 2.2.x únicamente)
+ MCRYPT_SERPENT_192 (libmcrypt 2.2.x únicamente)
+ MCRYPT_SERPENT_256 (libmcrypt 2.2.x únicamente)
+ MCRYPT_SKIPJACK (libmcrypt > 2.4.x únicamente)
+ MCRYPT_TEAN (libmcrypt 2.2.x únicamente)
+ MCRYPT_THREEWAY
+ MCRYPT_TRIPLEDES (libmcrypt > 2.4.x únicamente)
+ MCRYPT_TWOFISH (para las versiones antiguas de mcrypt 2.x o mcrypt > 2.4.x )
+ MCRYPT_TWOFISH128 (TWOFISHxxx está disponible en las nuevas versiones 2.x,
+ pero no en las versiones 2.4.x)
+ MCRYPT_TWOFISH192
+ MCRYPT_TWOFISH256
+ MCRYPT_WAKE (libmcrypt > 2.4.x únicamente)
+ MCRYPT_XTEA (libmcrypt > 2.4.x únicamente)
+
+
+
+ Se debe (modo CFB y OFB)
+ o puede (modo CBC) proporcionar un vector de inicialización
+ (IV) para estos modos de cifrado. IV debe ser único, y tener el mismo
+ valor en el cifrado y en el descifrado. Para datos que serán
+ almacenados después del cifrado, se puede tomar el resultado de una
+ función como MD5, aplicada al nombre del fichero. De lo contrario,
+ se puede enviar IV con los datos cifrados, (consulte el capítulo
+ 9.3 de &book.applied.cryptography; de Schneier (ISBN 0-471-11709-9)
+ para más detalles sobre el tema).
+
+
+
+
diff --git a/reference/mcrypt/configure.xml b/reference/mcrypt/configure.xml
new file mode 100644
index 000000000..25c1f7434
--- /dev/null
+++ b/reference/mcrypt/configure.xml
@@ -0,0 +1,36 @@
+
+
+
+
+
+
+ &reftitle.install;
+
+ &pecl.moved-ver;7.2.0
+
+
+ &pecl.info;
+ &url.pecl.package;mcrypt.
+
+
+
+
diff --git a/reference/mcrypt/constants.xml b/reference/mcrypt/constants.xml
new file mode 100644
index 000000000..5e4f692d8
--- /dev/null
+++ b/reference/mcrypt/constants.xml
@@ -0,0 +1,164 @@
+
+
+
+
+
+
+ &reftitle.constants;
+ &extension.constants;
+
+ Mcrypt puede operar en 4 modos de cifrado (CBC,
+ OFB, CFB y ECB).
+ Si está vinculado contra libmcrypt-2.4.x o posterior, las funciones pueden
+ operar asimismo en modo nOFB y en modo STREAM.
+ A continuación se encuentra una lista con todos los modos de cifrado soportados con
+ las constantes que están definidas para el modo de cifrado. Para una referencia
+ más completa y discusiones, ver &book.applied.cryptography;.
+
+
+
+ MCRYPT_MODE_ECB (electronic codebook)
+ es un modo de cifrado por bloques que generalmente es inapropiado para la mayoría
+ de los usos. El uso de este modo está desaconsejado.
+
+
+
+
+ MCRYPT_MODE_CBC (cipher block chaining)
+ es un modo de cifrado por bloques que es considerablemente más seguro que
+ el modo ECB.
+
+
+
+
+ MCRYPT_MODE_CFB (cipher feedback,
+ en modo de 8 bits) es un modo de cifrado por flujo.
+ Se recomienda utilizar el modo NCFB en lugar
+ del modo CFB.
+
+
+
+
+ MCRYPT_MODE_OFB (output feedback, en
+ 8 bits) es un modo de cifrado por flujo comparable a
+ CFB, pero puede ser utilizado en aplicaciones donde la
+ propagación de errores no puede ser tolerada.
+ Se recomienda utilizar el modo NOFB en lugar
+ del modo OFB.
+
+
+
+
+ MCRYPT_MODE_NOFB (output feedback,
+ en modo de n bits) es comparable al modo OFB,
+ pero opera sobre el tamaño de bloque completo del algoritmo.
+
+
+
+
+ MCRYPT_MODE_STREAM es un modo adicional, para incluir
+ algoritmos de flujo tales como "WAKE" o "RC4".
+
+
+
+
+
+
+ Mcrypt soporta otros modos de operación para los cuales no hay constantes
+ predefinidas.
+ Pueden ser utilizados pasando un &string; en lugar de las constantes faltantes.
+
+
+
+ "ctr" (counter mode) es un modo de cifrado por flujo.
+
+
+
+
+ "ncfb" (cipher feedback,
+ en modo de n bits) es comparable al modo CFB,
+ pero opera sobre el tamaño de bloque completo del algoritmo.
+
+
+
+
+
+
+ A continuación se presentan algunos otros modos y métodos de compresión:
+
+
+
+ MCRYPT_ENCRYPT
+ (int)
+
+
+
+
+
+
+
+
+
+ MCRYPT_DECRYPT
+ (int)
+
+
+
+
+
+
+
+
+
+ MCRYPT_DEV_RANDOM
+ (int)
+
+
+
+
+
+
+
+
+
+ MCRYPT_DEV_URANDOM
+ (int)
+
+
+
+
+
+
+
+
+
+ MCRYPT_RAND
+ (int)
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-create-iv.xml b/reference/mcrypt/functions/mcrypt-create-iv.xml
new file mode 100644
index 000000000..d95081223
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-create-iv.xml
@@ -0,0 +1,136 @@
+
+
+
+
+
+
+
+ mcrypt_create_iv
+ Crea un vector de inicialización (IV) a partir de una fuente aleatoria
+
+
+
+
+ &warn.deprecated.function.7-1-0.removed.7-2-0.alternatives;
+
+ random_bytes
+
+
+
+
+
+ &reftitle.description;
+
+ stringmcrypt_create_iv
+ intsize
+ intsourceMCRYPT_DEV_URANDOM
+
+
+ mcrypt_create_iv crea un IV
+ (vector de inicialización) a partir de una fuente aleatoria.
+
+
+ El vector de inicialización es el único medio de proporcionar una inicialización
+ de reemplazo a los métodos de inicialización. Este vector no necesita
+ ser particularmente secreto, aunque es mejor que lo sea. Puede enviarse
+ con los documentos cifrados sin perder seguridad.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ size
+
+
+ El tamaño del vector.
+
+
+
+
+ source
+
+
+ La fuente de un IV. La fuente puede ser MCRYPT_RAND (el generador
+ de números aleatorios del sistema), MCRYPT_DEV_RANDOM
+ (lee los datos desde /dev/random) y
+ MCRYPT_DEV_URANDOM (lee los datos desde
+ /dev/urandom). Antes de la versión 5.3.0,
+ MCRYPT_RAND era la única constante
+ soportada por Windows.
+
+
+ Tenga en cuenta que el valor por defecto de este parámetro era
+ MCRYPT_DEV_RANDOM antes de PHP 5.6.0.
+
+
+
+ Tenga en cuenta que la constante MCRYPT_DEV_RANDOM
+ puede bloquearse mientras espera que haya más entropía disponible.
+
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el vector de inicialización, o bien &false; en caso de error.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_create_iv</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ &url.mcrypt.iv;
+ &url.mcrypt.bcm;
+ Capítulo 9.3 de &book.applied.cryptography;
+ random_bytes
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-decrypt.xml b/reference/mcrypt/functions/mcrypt-decrypt.xml
new file mode 100644
index 000000000..e7aeee8f7
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-decrypt.xml
@@ -0,0 +1,112 @@
+
+
+
+
+
+
+
+ mcrypt_decrypt
+ Descifra un texto con los parámetros dados
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ stringfalsemcrypt_decrypt
+ stringcipher
+ stringkey
+ stringdata
+ stringmode
+ stringiv
+
+
+ Descifra los datos data y devuelve los datos descifrados.
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+ key
+
+
+ La clave utilizada durante el cifrado de los datos. Si el tamaño de la clave
+ proporcionada no es soportado por el cipher, la función emitirá un
+ warning y devolverá &false;
+
+
+
+
+ data
+
+
+ Los datos que serán descifrados utilizando los parámetros
+ cipher y mode.
+ Si el tamaño de los datos no corresponde a n * el tamaño del bloque,
+ los datos serán completados con '\0'.
+
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+ iv
+
+ &mcrypt.parameter.iv.strict;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve los datos descifrados en forma de &string;
+ &return.falseforfailure;.
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_encrypt
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml b/reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml
new file mode 100644
index 000000000..f49cfb70c
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml
@@ -0,0 +1,98 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_algorithms_name
+ Devuelve el nombre del algoritmo de cifrado
+
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ stringmcrypt_enc_get_algorithms_name
+ resourcetd
+
+
+ mcrypt_enc_get_algorithms_name devuelve el nombre de
+ el algoritmo utilizado por td.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el nombre del algoritmo actual, en forma de &string;
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_enc_get_algorithms_name</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-block-size.xml b/reference/mcrypt/functions/mcrypt-enc-get-block-size.xml
new file mode 100644
index 000000000..ec095e30e
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-block-size.xml
@@ -0,0 +1,66 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_block_size
+ Devuelve el tamaño de bloque de un algoritmo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_enc_get_block_size
+ resourcetd
+
+
+ Obtiene el tamaño de bloque de un algoritmo.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El gestor de ficheros.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño de bloque del algoritmo, en bytes.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml b/reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml
new file mode 100644
index 000000000..94fe40d5f
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml
@@ -0,0 +1,70 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_iv_size
+ Devuelve el tamaño del VI de un algoritmo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_enc_get_iv_size
+ resourcetd
+
+
+ Esta función devuelve el tamaño del VI del algoritmo designado
+ por td, en bytes. Si el valor devuelto
+ es 0, es que el algoritmo no requiere de VI. Un VI es
+ requerido en modo "cbc", "cfb" y
+ "ofb", y a veces en modo "stream".
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El gestor de ficheros.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño del IV, o &zero; si el IV es ignorado por el algoritmo.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-key-size.xml b/reference/mcrypt/functions/mcrypt-enc-get-key-size.xml
new file mode 100644
index 000000000..742e00dac
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-key-size.xml
@@ -0,0 +1,66 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_key_size
+ Devuelve el tamaño máximo de la clave para un modo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_enc_get_key_size
+ resourcetd
+
+
+ Devuelve el tamaño máximo de la clave para un modo dado.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El gestor de fichero.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño máximo de la clave para el modo dado.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml b/reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml
new file mode 100644
index 000000000..c75e7e30b
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml
@@ -0,0 +1,92 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_modes_name
+ Devuelve el nombre del modo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ stringmcrypt_enc_get_modes_name
+ resourcetd
+
+
+ Devuelve el nombre del modo.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el nombre, en forma de &string;.
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_enc_get_modes_name</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml b/reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml
new file mode 100644
index 000000000..994a931ad
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml
@@ -0,0 +1,106 @@
+
+
+
+
+
+
+
+ mcrypt_enc_get_supported_key_sizes
+ Devuelve un array que contiene los tamaños de clave admitidos por un algoritmo
+
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ arraymcrypt_enc_get_supported_key_sizes
+ resourcetd
+
+
+ mcrypt_enc_get_supported_key_sizes lee
+ los tamaños de clave soportados por el algoritmo actual del
+ recurso de cifrado td.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un array que contiene los tamaños de clave soportados por el algoritmo
+ designado por td. Si devuelve un array
+ vacío, es que todas las claves entre 1 y
+ mcrypt_enc_get_key_size son admitidas por
+ el algoritmo.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_enc_get_supported_key_sizes</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+ int(16)
+ [1]=>
+ int(24)
+ [2]=>
+ int(32)
+}
+]]>
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml b/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml
new file mode 100644
index 000000000..8d25724c6
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml
@@ -0,0 +1,67 @@
+
+
+
+
+
+
+
+ mcrypt_enc_is_block_algorithm_mode
+ Comprueba si el modo de cifrado es por bloques
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ boolmcrypt_enc_is_block_algorithm_mode
+ resourcetd
+
+
+ Comprueba si el modo de cifrado es por bloques (por ejemplo,
+ &false; para un flujo, y &true; para "cbc", "cfb", "ofb").
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve &true; si este modo utiliza algoritmos por bloques, y &false; en caso contrario.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml b/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml
new file mode 100644
index 000000000..a004d8968
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml
@@ -0,0 +1,67 @@
+
+
+
+
+
+
+
+ mcrypt_enc_is_block_algorithm
+ Comprueba si el cifrado es por bloques en un algoritmo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ boolmcrypt_enc_is_block_algorithm
+ resourcetd
+
+
+ Comprueba si el cifrado es por bloques en un algoritmo.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve &true; si el algoritmo utilizado es un algoritmo por bloques, y &false;
+ si es un algoritmo por flujo.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml b/reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml
new file mode 100644
index 000000000..459aef867
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml
@@ -0,0 +1,68 @@
+
+
+
+
+
+
+
+ mcrypt_enc_is_block_mode
+ Comprueba si el modo devuelve los datos por bloques
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ boolmcrypt_enc_is_block_mode
+ resourcetd
+
+
+ Comprueba si el modo devuelve los datos por bloques (por ejemplo, &true; para "cbc"
+ y "ecb", y &false; para "cfb" y un flujo).
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve &true; si el modo devuelve bloques de bytes,
+ o bien &false; si solo devuelve bytes.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-enc-self-test.xml b/reference/mcrypt/functions/mcrypt-enc-self-test.xml
new file mode 100644
index 000000000..32d3ae4d5
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-enc-self-test.xml
@@ -0,0 +1,67 @@
+
+
+
+
+
+
+
+ mcrypt_enc_self_test
+ Prueba un módulo abierto
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_enc_self_test
+ resourcetd
+
+
+ Realiza una prueba del módulo abierto y designado por td.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve 0 en caso de éxito o un &integer; negativo en
+ caso de fallo.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-encrypt.xml b/reference/mcrypt/functions/mcrypt-encrypt.xml
new file mode 100644
index 000000000..b7f437870
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-encrypt.xml
@@ -0,0 +1,198 @@
+
+
+
+
+
+
+
+ mcrypt_encrypt
+ Cifra un texto
+
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ stringfalsemcrypt_encrypt
+ stringcipher
+ stringkey
+ stringdata
+ stringmode
+ stringiv
+
+
+ mcrypt_encrypt cifra los datos y devuelve
+ los datos cifrados.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+ key
+
+
+ La clave con la que se cifrarán los datos. Si el tamaño de la clave
+ proporcionada no es compatible con el cipher, la función emitirá un
+ warning y devolverá &false;
+
+
+
+
+ data
+
+
+ Los datos que se cifrarán, con el cipher y el
+ mode indicado.
+ Si el tamaño de los datos no es un múltiplo del tamaño de bloque,
+ los datos se rellenarán con caracteres '\0',
+ según sea necesario.
+
+
+ El texto cifrado devuelto puede ser más largo que el tamaño de los datos
+ pasados como argumento a través de data.
+
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+ iv
+
+ &mcrypt.parameter.iv.strict;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve los datos cifrados, como &string; &return.falseforfailure;.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_encrypt</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_decrypt
+ mcrypt_module_open
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-generic-deinit.xml b/reference/mcrypt/functions/mcrypt-generic-deinit.xml
new file mode 100644
index 000000000..b2b1dfe8d
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-generic-deinit.xml
@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
+ mcrypt_generic_deinit
+ Prepara el módulo para la descarga
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ boolmcrypt_generic_deinit
+ resourcetd
+
+
+ Prepara el módulo de cifrado td para la descarga.
+ Todos los búferes se vacían, pero el módulo no se descarga.
+ Se debe llamar a mcrypt_module_close manualmente
+ (aunque PHP lo hará por usted al final del script).
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ &return.success;
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_module_open
+ mcrypt_generic_init
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-generic-init.xml b/reference/mcrypt/functions/mcrypt-generic-init.xml
new file mode 100644
index 000000000..424bb881c
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-generic-init.xml
@@ -0,0 +1,108 @@
+
+
+
+
+
+
+
+ mcrypt_generic_init
+ Inicializa todos los buffers necesarios
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_generic_init
+ resourcetd
+ stringkey
+ stringiv
+
+
+ Se debe llamar a mcrypt_generic_init
+ antes de cada llamada a mcrypt_generic o
+ mdecrypt_generic.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+ key
+
+
+ El tamaño máximo de la clave debe ser el devuelto por
+ mcrypt_enc_get_key_size y todos los valores
+ inferiores también serán válidos.
+
+
+
+
+ iv
+
+
+ El vector de inicialización (VI) debe tener el tamaño de un bloque,
+ pero se debe leer su tamaño llamando a
+ mcrypt_enc_get_iv_size. VI es ignorado en modo
+ ECB. VI DEBE existir en modos "CFB",
+ "CBC", "STREAM", "nOFB"
+ y "OFB". Debe ser aleatorio y único (pero no secreto).
+ El mismo VI debe ser utilizado para el cifrado y el descifrado.
+ Si no se desea utilizar, se puede rellenar con ceros, pero
+ no se recomienda.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un valor negativo en caso de error: -3 si el tamaño
+ de la clave es incorrecto, -4 cuando hay un problema de asignación de
+ memoria y cualquier otro valor en caso de error desconocido. Si ocurre un
+ error, se muestra una alerta. &false; es devuelto si se pasan parámetros
+ incorrectos a la función.
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_module_open
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-generic.xml b/reference/mcrypt/functions/mcrypt-generic.xml
new file mode 100644
index 000000000..a2c710495
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-generic.xml
@@ -0,0 +1,122 @@
+
+
+
+
+
+
+
+ mcrypt_generic
+ Cifra los datos
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ stringmcrypt_generic
+ resourcetd
+ stringdata
+
+
+ mcrypt_generic cifra los datos
+ data. Los datos se completan
+ con "\0" para obtener un tamaño múltiplo del tamaño
+ de un bloque. Devuelve los datos cifrados. Tenga en cuenta que la longitud
+ del string devuelto puede ser más larga que la
+ pasada como argumento, debido al relleno.
+
+
+ Si se desea almacenar los datos cifrados en una base de datos
+ asegúrese de almacenar el string completo devuelto por esta función,
+ de lo contrario el string no se descifrará correctamente. Si el string original
+ contiene 10 caracteres y el tamaño de un bloque es de 8 (utilice
+ mcrypt_enc_get_block_size para determinar este tamaño),
+ se necesitará al menos 16 caracteres en el campo de la base de datos.
+ Tenga en cuenta que el string devuelto por mdecrypt_generic tendrá
+ 16 caracteres de longitud... utilice rtrim($str, "\0")
+ para eliminar el relleno.
+
+
+ Por ejemplo, si se almacenan los datos en una base de datos MySQL,
+ recuerde que los campos de tipo VARCHAR eliminan automáticamente los
+ espacios adicionales durante la inserción. Como los datos cifrados pueden
+ terminar con un espacio (ASCII 32), los datos se dañarán por esta
+ eliminación. Almacene los datos en un campo de tipo TINYBLOB/TINYTEXT
+ (o más grande) para que todo funcione normalmente.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+ El manejador de cifrado td debe ser
+ inicializado con la función mcrypt_generic_init,
+ con una clave y un VI, antes de llamar a esta función. Cuando el cifrado
+ se realiza, se deben liberar los buffers llamando a la función
+ mcrypt_generic_deinit.
+ Consulte mcrypt_module_open para un ejemplo.
+
+
+
+
+ data
+
+
+ Los datos a cifrar.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve los datos cifrados.
+
+
+
+
+ &reftitle.seealso;
+
+
+ mdecrypt_generic
+ mcrypt_generic_init
+ mcrypt_generic_deinit
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-get-block-size.xml b/reference/mcrypt/functions/mcrypt-get-block-size.xml
new file mode 100644
index 000000000..71e3819c5
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-get-block-size.xml
@@ -0,0 +1,122 @@
+
+
+
+
+
+
+
+ mcrypt_get_block_size
+ Devuelve el tamaño de bloques de un cifrado
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ intfalsemcrypt_get_block_size
+ intcipher
+
+
+ intfalsemcrypt_get_block_size
+ stringcipher
+ stringmode
+
+
+ El primer prototipo se utiliza cuando PHP está compilado con la biblioteca
+ libmcrypt 2.2.x, el segundo cuando está compilado con
+ libmcrypt 2.4.x o 2.5.x.
+
+
+ mcrypt_get_block_size sirve para leer el tamaño
+ de bloques del cifrado cipher (en
+ combinación con un modo de cifrado).
+
+
+ Se recomienda utilizar la función
+ mcrypt_enc_get_block_size,
+ ya que utiliza el recurso devuelto por
+ mcrypt_module_open.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Lee el tamaño de bloque, en forma de un &integer;.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_get_block_size</function>
+
+ Este ejemplo muestra cómo utilizar esta función cuando PHP
+ está compilado con libmcrypt 2.4.x y 2.5.x.
+
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_get_key_size
+ mcrypt_enc_get_block_size
+ mcrypt_encrypt
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-get-cipher-name.xml b/reference/mcrypt/functions/mcrypt-get-cipher-name.xml
new file mode 100644
index 000000000..ee78917a5
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-get-cipher-name.xml
@@ -0,0 +1,102 @@
+
+
+
+
+
+
+
+ mcrypt_get_cipher_name
+ Lee el nombre del cifrado utilizado
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ stringmcrypt_get_cipher_name
+ intcipher
+
+
+ stringmcrypt_get_cipher_name
+ stringcipher
+
+
+ mcrypt_get_cipher_name devuelve el nombre del cifrado
+ utilizado.
+
+
+ mcrypt_get_cipher_name toma el número de
+ cifrado (con libmcrypt 2.2.x) o toma el nombre del cifrado
+ (con libmcrypt 2.4.x) como argumento, y devuelve el nombre del
+ cifrado, o &false;, si no existe.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Esta función devuelve el nombre del cipher o &false; si el cipher no existe.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_get_cipher_name</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-get-iv-size.xml b/reference/mcrypt/functions/mcrypt-get-iv-size.xml
new file mode 100644
index 000000000..9ca700eaf
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-get-iv-size.xml
@@ -0,0 +1,117 @@
+
+
+
+
+
+
+
+ mcrypt_get_iv_size
+ Retorna el tamaño del VI utilizado por un par cifrado/modo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ intmcrypt_get_iv_size
+ stringcipher
+ stringmode
+
+
+ mcrypt_get_iv_size retorna el tamaño del
+ vector de inicialización (VI). Si el algoritmo no utiliza
+ un vector de inicialización, se retorna cero.
+
+
+ Es más útil utilizar la función mcrypt_enc_get_iv_size,
+ ya que utiliza el recurso retornado por mcrypt_module_open.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+ El VI es ignorado en modo ECB, ya que este modo no lo requiere.
+ Debe tener el mismo VI (punto de partida) durante el cifrado
+ y el descifrado, de lo contrario, el cifrado fallará.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Retorna el tamaño del vector de inicialización (VI), en bytes.
+ En caso de error, la función retorna &false;. Si el vector de inicialización
+ no es necesario, se retorna 0.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_get_iv_size</function>
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_get_block_size
+ mcrypt_enc_get_iv_size
+ mcrypt_create_iv
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-get-key-size.xml b/reference/mcrypt/functions/mcrypt-get-key-size.xml
new file mode 100644
index 000000000..9147c294c
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-get-key-size.xml
@@ -0,0 +1,128 @@
+
+
+
+
+
+
+
+ mcrypt_get_key_size
+ Devuelve el tamaño de la clave de cifrado
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ intfalsemcrypt_get_key_size
+ intcipher
+
+
+ intfalsemcrypt_get_key_size
+ stringcipher
+ stringmode
+
+
+ La primera sintaxis utiliza libmcrypt 2.2.x, y la segunda
+ libmcrypt 2.4.x o posterior.
+
+
+ mcrypt_get_key_size se utiliza para obtener el tamaño de
+ la clave del cifrado cipher.
+
+
+ Es más interesante utilizar la función
+ mcrypt_enc_get_key_size ya que utiliza el recurso
+ devuelto por la función mcrypt_module_open.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ cipher
+
+ &mcrypt.parameter.cipher;
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño máximo soportado para una clave del algoritmo, en bytes
+ &return.falseforfailure;.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_get_key_size</function>
+
+
+]]>
+
+
+ El ejemplo anterior muestra el uso de la función
+ cuando ha sido compilada con la biblioteca
+ 2.4.x o 2.5.x.
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_get_block_size
+ mcrypt_enc_get_key_size
+ mcrypt_encrypt
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-list-algorithms.xml b/reference/mcrypt/functions/mcrypt-list-algorithms.xml
new file mode 100644
index 000000000..d532fe029
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-list-algorithms.xml
@@ -0,0 +1,115 @@
+
+
+
+
+
+
+
+ mcrypt_list_algorithms
+ Lista todos los algoritmos de cifrado soportados
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ arraymcrypt_list_algorithms
+ stringlib_dirini_get("mcrypt.algorithms_dir")
+
+
+ Lista todos los algoritmos de cifrado de lib_dir.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ lib_dir
+
+
+ Especifica el directorio donde se encuentran los algoritmos. Si se omite,
+ se utiliza el valor de la directiva mcrypt.algorithms_dir del fichero
+ &php.ini;.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un array con los algoritmos soportados.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_list_algorithms</function>
+
+
+]]>
+
+ &example.outputs.similar;
+
+ cast-128
+ [1] => gost
+ [2] => rijndael-128
+ [3] => twofish
+ [4] => arcfour
+ [5] => cast-256
+ [6] => loki97
+ [7] => rijndael-192
+ [8] => saferplus
+ [9] => wake
+ [10] => blowfish-compat
+ [11] => des
+ [12] => rijndael-256
+ [13] => serpent
+ [14] => xtea
+ [15] => blowfish
+ [16] => enigma
+ [17] => rc2
+ [18] => tripledes
+)
+]]>
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-list-modes.xml b/reference/mcrypt/functions/mcrypt-list-modes.xml
new file mode 100644
index 000000000..fba011756
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-list-modes.xml
@@ -0,0 +1,98 @@
+
+
+
+
+
+
+
+ mcrypt_list_modes
+ Lista todos los modos de cifrado soportados
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ arraymcrypt_list_modes
+ stringlib_dirini_get("mcrypt.modes_dir")
+
+
+ Lista todos los modos de cifrado de lib_dir.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ lib_dir
+
+
+ Especifica el directorio donde se encuentran todos los modos.
+ Si se omite, se utiliza el valor de la directiva mcrypt.modes_dir
+ en el &php.ini;.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un array con todos los modos soportados.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_list_modes</function>
+
+\n";
+}
+?>
+]]>
+
+
+ El ejemplo anterior mostrará todos los modos soportados
+ en el directorio por omisión. Si el modo no está definido
+ por la directiva mcrypt.modes_dir del &php.ini;,
+ se utilizará el directorio por omisión de mcrypt (el directorio
+ /usr/local/lib/libmcrypt).
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-close.xml b/reference/mcrypt/functions/mcrypt-module-close.xml
new file mode 100644
index 000000000..3d80a3ebd
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-close.xml
@@ -0,0 +1,74 @@
+
+
+
+
+
+
+
+ mcrypt_module_close
+ Libera el módulo de cifrado
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ boolmcrypt_module_close
+ resourcetd
+
+
+ Libera el módulo td.
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ El recurso de cifrado.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ &return.success;
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_module_open
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-get-algo-block-size.xml b/reference/mcrypt/functions/mcrypt-module-get-algo-block-size.xml
new file mode 100644
index 000000000..24df1b9d1
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-get-algo-block-size.xml
@@ -0,0 +1,76 @@
+
+
+
+
+
+
+
+ mcrypt_module_get_algo_block_size
+ Devuelve el tamaño de bloques de un algoritmo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_module_get_algo_block_size
+ stringalgorithm
+ stringlib_dir
+
+
+ Devuelve el tamaño de bloques de un algoritmo.
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+
+ El nombre del algoritmo.
+
+
+
+
+ lib_dir
+
+
+ El parámetro opcional lib_dir contiene la
+ ruta de acceso hasta el módulo del algoritmo en el sistema.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño de bloques de un algoritmo, en bytes.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-get-algo-key-size.xml b/reference/mcrypt/functions/mcrypt-module-get-algo-key-size.xml
new file mode 100644
index 000000000..c2f7c6b1b
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-get-algo-key-size.xml
@@ -0,0 +1,76 @@
+
+
+
+
+
+
+ mcrypt_module_get_algo_key_size
+ Devuelve el tamaño máximo de clave
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+ &reftitle.description;
+
+ intmcrypt_module_get_algo_key_size
+ stringalgorithm
+ stringlib_dir
+
+
+ Devuelve el tamaño máximo de clave.
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+
+ El nombre del algoritmo.
+
+
+
+
+ lib_dir
+
+
+ El parámetro opcional lib_dir contiene la ruta
+ hasta el módulo del algoritmo en el sistema.
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el tamaño máximo de la clave soportada por el algoritmo
+ algorithm.
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-get-supported-key-sizes.xml b/reference/mcrypt/functions/mcrypt-module-get-supported-key-sizes.xml
new file mode 100644
index 000000000..e9236e1a2
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-get-supported-key-sizes.xml
@@ -0,0 +1,96 @@
+
+
+
+
+
+
+
+ mcrypt_module_get_supported_key_sizes
+ Devuelve un array que contiene los tamaños de claves soportados por el algoritmo abierto
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ arraymcrypt_module_get_supported_key_sizes
+ stringalgorithm
+ stringlib_dir
+
+
+ Devuelve un array que contiene los tamaños de claves soportados por
+ el algoritmo de cifrado algorithm.
+ Si devuelve un array vacío, entonces todas las claves entre
+ 1 y mcrypt_module_get_algo_key_size son
+ soportadas por el algoritmo.
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+
+ El algoritmo a utilizar.
+
+
+
+
+ lib_dir
+
+
+ El parámetro opcional
+ lib_dir puede contener la ruta de acceso
+ del directorio de instalación del módulo, en el sistema.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve un array que contiene los tamaños de claves soportados por
+ el algoritmo de cifrado algorithm.
+ Si devuelve un array vacío, entonces todas las claves entre
+ 1 y mcrypt_module_get_algo_key_size son
+ soportadas por el algoritmo.
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_enc_get_supported_key_sizes
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-is-block-algorithm-mode.xml b/reference/mcrypt/functions/mcrypt-module-is-block-algorithm-mode.xml
new file mode 100644
index 000000000..17756a729
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-is-block-algorithm-mode.xml
@@ -0,0 +1,83 @@
+
+
+
+
+
+
+
+ mcrypt_module_is_block_algorithm_mode
+ Indica si un modo funciona por bloques
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ boolmcrypt_module_is_block_algorithm_mode
+ stringmode
+ stringlib_dir
+
+
+ Esta función devuelve &true; si el modo debe ser utilizado
+ con un algoritmo por bloques, de lo contrario, devuelve &false;
+ (i.e. &false; para un flujo, y &true; para cbc, cfb, ofb).
+
+
+
+ &reftitle.parameters;
+
+
+
+ mode
+
+
+ El modo a verificar.
+
+
+
+
+ lib_dir
+
+
+ El argumento opcional lib_dir
+ puede contener el directorio donde los módulos de algoritmo
+ se encuentran en el sistema.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Esta función devuelve &true; si el modo debe ser utilizado
+ con un algoritmo por bloques, de lo contrario, devuelve &false;
+ (i.e. &false; para un flujo, y &true; para cbc, cfb, ofb).
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-is-block-algorithm.xml b/reference/mcrypt/functions/mcrypt-module-is-block-algorithm.xml
new file mode 100644
index 000000000..67424aaa5
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-is-block-algorithm.xml
@@ -0,0 +1,84 @@
+
+
+
+
+
+
+
+ mcrypt_module_is_block_algorithm
+ Indica si un algoritmo funciona por bloques
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ boolmcrypt_module_is_block_algorithm
+ stringalgorithm
+ stringlib_dir
+
+
+ mcrypt_module_is_block_algorithm devuelve &true;
+ si algorithm es un algoritmo por bloques,
+ o &false; si es un algoritmo por flujo.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+
+ El algoritmo a verificar.
+
+
+
+
+ lib_dir
+
+
+ El parámetro opcional lib_dir
+ puede contener la ruta donde se encuentran los módulos de los algoritmos
+ en el disco del sistema.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve &true; si el algoritmo especificado es un algoritmo por bloques
+ o &false; si es un algoritmo por flujo.
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-is-block-mode.xml b/reference/mcrypt/functions/mcrypt-module-is-block-mode.xml
new file mode 100644
index 000000000..05f779ac9
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-is-block-mode.xml
@@ -0,0 +1,84 @@
+
+
+
+
+
+
+
+ mcrypt_module_is_block_mode
+ Indica si un modo trabaja por bloques
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ boolmcrypt_module_is_block_mode
+ stringmode
+ stringlib_dir
+
+
+ Esta función devuelve &true; si este modo proporciona bloques de bytes o
+ &false; si solo produce bytes.
+ (i.e. &true; para "cbc" y "ecb",
+ y &false; para "cfb" y "stream").
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+ lib_dir
+
+
+ El parámetro opcional lib_dir contiene
+ la ruta de acceso hasta el módulo del algoritmo en el sistema.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Esta función devuelve &true; si este modo proporciona bloques de bytes o
+ &false; si solo produce bytes.
+ (i.e. &true; para "cbc" y "ecb",
+ y &false; para "cfb" y "stream").
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-open.xml b/reference/mcrypt/functions/mcrypt-module-open.xml
new file mode 100644
index 000000000..bd01ba7b4
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-open.xml
@@ -0,0 +1,190 @@
+
+
+
+
+
+
+
+ mcrypt_module_open
+ Abre el módulo del algoritmo y del modo a utilizar
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ resourcemcrypt_module_open
+ stringalgorithm
+ stringalgorithm_directory
+ stringmode
+ stringmode_directory
+
+
+ mcrypt_module_open abre el módulo del algoritmo
+ y del modo a utilizar. El nombre del algoritmo se especifica mediante el parámetro
+ algorithm (por ejemplo: "twofish"),
+ o bien una de las constantes MCRYPT_ciphername. La biblioteca se cierra
+ al llamar a mcrypt_module_close.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+ &mcrypt.parameter.cipher;
+
+
+
+ algorithm_directory
+
+
+ El parámetro algorithm_directory se utiliza
+ para localizar el módulo de cifrado. Cuando se especifica un
+ nombre de directorio, se utilizará. Si se especifica una cadena vacía
+ (""), se utilizará el valor definido en la directiva
+ mcrypt.algorithms_dir del fichero &php.ini;. Cuando no está definida, el directorio por omisión utilizado
+ será aquel en el que se encuentre la biblioteca libmcrypt
+ (habitualmente, /usr/local/lib/libmcrypt).
+
+
+
+
+ mode
+
+ &mcrypt.parameter.mode;
+
+
+
+ mode_directory
+
+
+ El parámetro mode_directory se utiliza para localizar
+ el módulo de cifrado. Si se especifica un nombre de directorio, se utilizará.
+ Cuando se especifica una cadena vacía (""), se utilizará el valor
+ de la directiva mcrypt.modes_dir del fichero &php.ini;.
+ Si no está definida, el directorio por omisión utilizado
+ será aquel en el que se encuentre la biblioteca libmcrypt
+ (habitualmente /usr/local/lib/libmcrypt).
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Normalmente, esta función devuelve un descriptor de cifrado, o
+ &false; si ocurre un error.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_module_open</function>
+
+
+]]>
+
+
+
+
+ La primera línea del ejemplo anterior intentará abrir el cifrado
+ DES, en el directorio por omisión, y el modo ECB en el directorio
+ /usr/lib/mcrypt-modes. El segundo ejemplo utiliza
+ las cadenas como nombre para el cifrado y el modo. Esto solo funciona
+ si la extensión está compilada con libmcrypt 2.4.x o 2.5.x.
+
+
+
+ Utilización de <function>mcrypt_module_open</function> para cifrar
+
+
+]]>
+
+
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_module_close
+ mcrypt_generic
+ mdecrypt_generic
+ mcrypt_generic_init
+ mcrypt_generic_deinit
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mcrypt-module-self-test.xml b/reference/mcrypt/functions/mcrypt-module-self-test.xml
new file mode 100644
index 000000000..ef3cfff02
--- /dev/null
+++ b/reference/mcrypt/functions/mcrypt-module-self-test.xml
@@ -0,0 +1,101 @@
+
+
+
+
+
+
+
+ mcrypt_module_self_test
+ Prueba un modo
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ boolmcrypt_module_self_test
+ stringalgorithm
+ stringlib_dir
+
+
+ Realiza una prueba sobre el algoritmo especificado.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ algorithm
+
+ &mcrypt.parameter.cipher;
+
+
+
+ lib_dir
+
+
+ El argumento opcional lib_dir contiene
+ la ruta de acceso hasta el módulo del algoritmo en el sistema.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve &true; si la prueba funciona, y &false; en caso contrario.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mcrypt_module_self_test</function>
+
+
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/functions/mdecrypt-generic.xml b/reference/mcrypt/functions/mdecrypt-generic.xml
new file mode 100644
index 000000000..60af283b5
--- /dev/null
+++ b/reference/mcrypt/functions/mdecrypt-generic.xml
@@ -0,0 +1,153 @@
+
+
+
+
+
+
+
+ mdecrypt_generic
+ Desencripta los datos
+
+
+ &warn.deprecated.function-7-1-0.removed-7-2-0;
+
+
+
+ &reftitle.description;
+
+ stringmdecrypt_generic
+ resourcetd
+ stringdata
+
+
+ Desencripta los datos data. Tenga en cuenta que la longitud
+ del string desencriptado puede ser más larga que el string original, ya que
+ puede haber sido completado con caracteres.
+
+
+
+
+ &reftitle.parameters;
+
+
+
+ td
+
+
+ Un descriptor de cifrado, devuelto por la función
+ mcrypt_module_open
+
+
+
+
+ data
+
+
+ Los datos cifrados.
+
+
+
+
+
+
+
+
+ &reftitle.returnvalues;
+
+ Devuelve el string desencriptado.
+
+
+
+
+ &reftitle.examples;
+
+
+ Ejemplo con <function>mdecrypt_generic</function>
+
+
+]]>
+
+
+
+
+ El ejemplo anterior muestra cómo verificar que los datos antes
+ del cifrado son los mismos que después del
+ cifrado/descifrado. Es muy importante reiniciar
+ el buffer de cifrado con mcrypt_generic_init
+ antes de descifrar los datos.
+
+
+ El gestor de descifrado debe ser siempre inicializado
+ por la función mcrypt_generic_init con una clave
+ y un VI antes de llamar a esta función. Cuando el cifrado está hecho,
+ es necesario liberar los datos cifrados llamando
+ a mcrypt_generic_deinit.
+ Consulte mcrypt_module_open para un ejemplo.
+
+
+
+
+ &reftitle.seealso;
+
+
+ mcrypt_generic
+ mcrypt_generic_init
+ mcrypt_generic_deinit
+
+
+
+
+
+
diff --git a/reference/mcrypt/ini.xml b/reference/mcrypt/ini.xml
new file mode 100644
index 000000000..0b3b2e2d8
--- /dev/null
+++ b/reference/mcrypt/ini.xml
@@ -0,0 +1,94 @@
+
+
+
+
+
+
+ &reftitle.runtime;
+ &extension.runtime;
+
+
+ &ini.php.constants;
+
+
+ &ini.descriptions.title;
+
+
+
+
+ mcrypt.algorithms_dir
+ string
+
+
+
+ El directorio que contiene los algoritmos. Por omisión es el directorio indicado durante la
+ compilación de libmcrypt, típicamente se trata de
+ /usr/local/lib/libmcrypt. Consulte
+ mcrypt_list_algorithms para más detalles.
+
+
+
+
+
+ mcrypt.modes_dir
+ string
+
+
+
+ El directorio que contiene los modos. Por omisión es el directorio indicado durante la
+ compilación de libmcrypt, típicamente se trata de
+ /usr/local/lib/libmcrypt. Consulte
+ mcrypt_list_modes para más detalles.
+
+
+
+
+
+
+
+
diff --git a/reference/mcrypt/reference.xml b/reference/mcrypt/reference.xml
new file mode 100644
index 000000000..16695495c
--- /dev/null
+++ b/reference/mcrypt/reference.xml
@@ -0,0 +1,29 @@
+
+
+
+
+
+
+ &Functions; Mcrypt
+
+ &reference.mcrypt.entities.functions;
+
+
+
+
diff --git a/reference/mcrypt/setup.xml b/reference/mcrypt/setup.xml
new file mode 100644
index 000000000..98e0464f0
--- /dev/null
+++ b/reference/mcrypt/setup.xml
@@ -0,0 +1,75 @@
+
+
+
+
+
+
+ &reftitle.setup;
+
+
+
+ &reftitle.required;
+
+ Estas funciones utilizan mcrypt.
+ Para utilizar esta biblioteca, descargue
+ el fichero libmcrypt-x.x.tar.gz desde
+ &url.mcrypt;
+ y siga las instrucciones de instalación proporcionadas.
+
+
+ Se requiere la versión 2.5.6 o posterior de la biblioteca libmcrypt.
+
+
+ Los usuarios de Windows encontrarán la biblioteca en la versión Windows
+ de PHP 5.3. La versión binaria de Windows de PHP 5.3 utiliza la versión estática
+ de la biblioteca MCrypt, no se necesita ninguna DLL.
+
+
+ Si se compila PHP con la biblioteca libmcrypt 2.4.x,
+ se admiten los siguientes algoritmos: "CAST", "LOKI97", "RIJNDAEL", "SAFERPLUS",
+ "SERPENT" así como los siguientes cifrados: "ENIGMA" (cifrado), "PANAMA",
+ "RC4" y "WAKE". Con libmcrypt 2.4.x otro modo de cifrado
+ está disponible: "nOFB".
+
+
+
+
+
+ &reference.mcrypt.configure;
+
+
+
+ &reference.mcrypt.ini;
+
+
+
+
+ &reftitle.resources;
+
+ mcrypt_module_open devuelve un puntero de cifrado.
+
+
+
+
+
+
+