-
Notifications
You must be signed in to change notification settings - Fork 102
/
mcrypt-create-iv.xml
133 lines (126 loc) · 3.92 KB
/
mcrypt-create-iv.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-create-iv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mcrypt_create_iv</refname>
<refpurpose>从随机源创建初始向量</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&warn.deprecated.function.7-1-0.removed.7-2-0.alternatives;
<simplelist role="alternatives">
<member><function>random_bytes</function></member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>mcrypt_create_iv</methodname>
<methodparam><type>int</type><parameter>size</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>source</parameter><initializer>MCRYPT_DEV_URANDOM</initializer></methodparam>
</methodsynopsis>
<para>
从随机源创建初始向量。
</para>
<para>
初始向量只是为了给加密算法提供一个可用的种子,
所以它不需要安全保护,
你甚至可以随同密文一起发布初始向量也不会对安全性带来影响。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>size</parameter></term>
<listitem>
<para>
初始向量大小。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>source</parameter></term>
<listitem>
<para>
初始向量数据来源。可选值有:
<constant>MCRYPT_RAND</constant> (系统随机数生成器),
<constant>MCRYPT_DEV_RANDOM</constant> (从
<filename>/dev/random</filename> 文件读取数据) 和
<constant>MCRYPT_DEV_URANDOM</constant> (从
<filename>/dev/urandom</filename> 文件读取数据)。
在 Windows 平台,PHP 5.3.0 之前的版本中,仅支持 <constant>MCRYPT_RAND</constant>。
</para>
<para>
请注意,在 PHP 5.6.0 之前的版本中,
此参数的默认值为 <constant>MCRYPT_DEV_RANDOM</constant>。
</para>
<note>
<simpara>
需要注意的是,如果没有更多可用的用来产生随机数据的信息,那么
<constant>MCRYPT_DEV_RANDOM</constant> 可能进入阻塞状态。
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
返回初始向量。如果发生错误,则返回 &false;。
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_create_iv</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$size = mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB);
$iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="&url.mcrypt.iv;">&url.mcrypt.iv;</link></member>
<member><link xlink:href="&url.mcrypt.bcm;">&url.mcrypt.bcm;</link></member>
<member>&book.applied.cryptography; 9.3 节。</member>
<member><function>random_bytes</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->