<?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>Интерфейс Random\Engine</title>

<titleabbrev>Random\Engine</titleabbrev>

<partintro>

<!-- {{{ Random\Engine intro -->

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

&reftitle.intro;

<para>

Интерфейс <classname>Random\Engine</classname> определяет низкоуровневый источник

случайных последовательностей. Реализации интерфейса возвращают случайные байты,

которые требуются для выполнения операций высокоуровневыми API.

Интерфейс <classname>Random\Engine</classname> поддерживает переключение алгоритмов

генерации случайной последовательности для адаптации источника случайных последовательностей

под конкретные задачи: от сверхбыстрых алгоритмов с посредственной статистикой до криптографически стойких механизмов

наподобие движка <classname>Random\Engine\Secure</classname>.

</para>

<para>

В PHP предусмотрели ряд готовых генераторов на базе интерфейса <classname>Random\Engine</classname>,

каждый под конкретный сценарий. Движок <classname>Random\Engine\Secure</classname>

на базе <acronym>CSPRNG</acronym> — безопасный выбор по умолчанию, если только приложению

не требуются воспроизводимые последовательности или повышенная производительность.

</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>