<?xml version="1.0" encoding="utf-8"?>

<reference xml:id="class.random-engine" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

<title>La interfaz Random\Engine</title>

<titleabbrev>Random\Engine</titleabbrev>

<partintro>

<section xml:id="random-engine.intro">

&reftitle.intro;

<para>

Un <classname>Random\Engine</classname> constituye una fuente de aleatoriedad de bajo nivel al

devolver bytes aleatorios que son consumidos por las API de alto nivel para realizar sus operaciones.

La interfaz <classname>Random\Engine</classname> permite intercambiar el algoritmo

utilizado para generar aleatoriedad, ya que cada algoritmo realiza compromisos diferentes

para responder a casos de uso específicos. Algunos algoritmos son muy rápidos,

pero generan aleatoriedad de menor calidad, mientras que otros algoritmos son más lentos,

pero generan mejor aleatoriedad, hasta aleatoriedad criptográficamente segura

como la proporcionada por el motor <classname>Random\Engine\Secure</classname>.

</para>

<para>

PHP proporciona varios motores <classname>Random\Engine</classname> para responder a

diferentes casos de uso. El motor <classname>Random\Engine\Secure</classname> que está

respaldado por un <acronym>CSPRNG</acronym> es la opción por omisión recomendada, a menos que

la aplicación requiera secuencias reproducibles o un rendimiento muy elevado.

</para>

</section>

<section xml:id="random-engine.synopsis">

&reftitle.interfacesynopsis;

<packagesynopsis>

<package>Random</package>

<classsynopsis class="interface">

<oointerface>

<interfacename>Engine</interfacename>

</oointerface>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine'])">

<xi:fallback/>

</xi:include>

</classsynopsis>

</packagesynopsis>

</section>

</partintro>

&reference.random.random.engine.generate;

</reference>