From 61785f2a83166db7713695e7a937db2c10e00d99 Mon Sep 17 00:00:00 2001 From: Philippe Delente Date: Thu, 8 May 2025 22:52:11 +0200 Subject: [PATCH] add translate page info mcrypt igbinary filestystem --- reference/filesystem/functions/fdatasync.xml | 96 +++ reference/filesystem/functions/fsync.xml | 94 +++ reference/filesystem/functions/fwrite.xml | 236 +++++++ reference/igbinary/book.xml | 47 ++ .../igbinary/functions/igbinary-serialize.xml | 158 +++++ .../functions/igbinary-unserialize.xml | 152 +++++ reference/igbinary/ini.xml | 105 +++ reference/igbinary/reference.xml | 29 + reference/info/constants.xml | 599 ++++++++++++++++++ .../info/functions/cli-get-process-title.xml | 96 +++ .../info/functions/cli-set-process-title.xml | 113 ++++ reference/info/functions/gc-mem-caches.xml | 131 ++++ reference/info/functions/gc-status.xml | 229 +++++++ .../info/functions/get-magic-quotes-gpc.xml | 100 +++ .../functions/get-magic-quotes-runtime.xml | 97 +++ reference/info/functions/get-resources.xml | 167 +++++ .../info/functions/ini-parse-quantity.xml | 130 ++++ .../functions/memory-reset-peak-usage.xml | 98 +++ reference/info/ini.xml | 454 +++++++++++++ reference/mcrypt/book.xml | 69 ++ reference/mcrypt/ciphers.xml | 94 +++ reference/mcrypt/configure.xml | 36 ++ reference/mcrypt/constants.xml | 164 +++++ .../mcrypt/functions/mcrypt-create-iv.xml | 136 ++++ reference/mcrypt/functions/mcrypt-decrypt.xml | 112 ++++ .../mcrypt-enc-get-algorithms-name.xml | 98 +++ .../functions/mcrypt-enc-get-block-size.xml | 66 ++ .../functions/mcrypt-enc-get-iv-size.xml | 70 ++ .../functions/mcrypt-enc-get-key-size.xml | 66 ++ .../functions/mcrypt-enc-get-modes-name.xml | 92 +++ .../mcrypt-enc-get-supported-key-sizes.xml | 106 ++++ .../mcrypt-enc-is-block-algorithm-mode.xml | 67 ++ .../mcrypt-enc-is-block-algorithm.xml | 67 ++ .../functions/mcrypt-enc-is-block-mode.xml | 68 ++ .../mcrypt/functions/mcrypt-enc-self-test.xml | 67 ++ reference/mcrypt/functions/mcrypt-encrypt.xml | 198 ++++++ .../functions/mcrypt-generic-deinit.xml | 82 +++ .../mcrypt/functions/mcrypt-generic-init.xml | 108 ++++ reference/mcrypt/functions/mcrypt-generic.xml | 122 ++++ .../functions/mcrypt-get-block-size.xml | 122 ++++ .../functions/mcrypt-get-cipher-name.xml | 102 +++ .../mcrypt/functions/mcrypt-get-iv-size.xml | 117 ++++ .../mcrypt/functions/mcrypt-get-key-size.xml | 128 ++++ .../functions/mcrypt-list-algorithms.xml | 115 ++++ .../mcrypt/functions/mcrypt-list-modes.xml | 98 +++ .../mcrypt/functions/mcrypt-module-close.xml | 74 +++ .../mcrypt-module-get-algo-block-size.xml | 76 +++ .../mcrypt-module-get-algo-key-size.xml | 76 +++ .../mcrypt-module-get-supported-key-sizes.xml | 96 +++ .../mcrypt-module-is-block-algorithm-mode.xml | 83 +++ .../mcrypt-module-is-block-algorithm.xml | 84 +++ .../functions/mcrypt-module-is-block-mode.xml | 84 +++ .../mcrypt/functions/mcrypt-module-open.xml | 190 ++++++ .../functions/mcrypt-module-self-test.xml | 101 +++ .../mcrypt/functions/mdecrypt-generic.xml | 153 +++++ reference/mcrypt/ini.xml | 94 +++ reference/mcrypt/reference.xml | 29 + reference/mcrypt/setup.xml | 75 +++ 58 files changed, 6916 insertions(+) create mode 100644 reference/filesystem/functions/fdatasync.xml create mode 100644 reference/filesystem/functions/fsync.xml create mode 100644 reference/filesystem/functions/fwrite.xml create mode 100644 reference/igbinary/book.xml create mode 100644 reference/igbinary/functions/igbinary-serialize.xml create mode 100644 reference/igbinary/functions/igbinary-unserialize.xml create mode 100644 reference/igbinary/ini.xml create mode 100644 reference/igbinary/reference.xml create mode 100644 reference/info/constants.xml create mode 100644 reference/info/functions/cli-get-process-title.xml create mode 100644 reference/info/functions/cli-set-process-title.xml create mode 100644 reference/info/functions/gc-mem-caches.xml create mode 100644 reference/info/functions/gc-status.xml create mode 100644 reference/info/functions/get-magic-quotes-gpc.xml create mode 100644 reference/info/functions/get-magic-quotes-runtime.xml create mode 100644 reference/info/functions/get-resources.xml create mode 100644 reference/info/functions/ini-parse-quantity.xml create mode 100644 reference/info/functions/memory-reset-peak-usage.xml create mode 100644 reference/info/ini.xml create mode 100644 reference/mcrypt/book.xml create mode 100644 reference/mcrypt/ciphers.xml create mode 100644 reference/mcrypt/configure.xml create mode 100644 reference/mcrypt/constants.xml create mode 100644 reference/mcrypt/functions/mcrypt-create-iv.xml create mode 100644 reference/mcrypt/functions/mcrypt-decrypt.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-block-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-key-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml create mode 100644 reference/mcrypt/functions/mcrypt-enc-self-test.xml create mode 100644 reference/mcrypt/functions/mcrypt-encrypt.xml create mode 100644 reference/mcrypt/functions/mcrypt-generic-deinit.xml create mode 100644 reference/mcrypt/functions/mcrypt-generic-init.xml create mode 100644 reference/mcrypt/functions/mcrypt-generic.xml create mode 100644 reference/mcrypt/functions/mcrypt-get-block-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-get-cipher-name.xml create mode 100644 reference/mcrypt/functions/mcrypt-get-iv-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-get-key-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-list-algorithms.xml create mode 100644 reference/mcrypt/functions/mcrypt-list-modes.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-close.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-get-algo-block-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-get-algo-key-size.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-get-supported-key-sizes.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-is-block-algorithm-mode.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-is-block-algorithm.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-is-block-mode.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-open.xml create mode 100644 reference/mcrypt/functions/mcrypt-module-self-test.xml create mode 100644 reference/mcrypt/functions/mdecrypt-generic.xml create mode 100644 reference/mcrypt/ini.xml create mode 100644 reference/mcrypt/reference.xml create mode 100644 reference/mcrypt/setup.xml 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; + + + Igbinary &ConfigureOptions; + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + igbinary.compact_strings + 1 + INI_ALL + + + + +
+ + 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; + + + &ConfigureOptions; mcrypt + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + mcrypt.algorithms_dir + &null; + INI_ALL + + + + mcrypt.modes_dir + &null; + INI_ALL + + + + +
+ &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. + +
+ + + + +