php/archived-doc-zh
1
0
Fork 0
mirror of https://github.com/php/doc-zh.git synced 2026-03-23 22:52:08 +01:00
Code Issues Packages Projects Releases Wiki Activity

mcrypt: fix XML to remove useless wrapping para tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-19 03:24:40 +00:00
parent 1979f8f94d
commit 5776cb682e
33 changed files with 858 additions and 1017 deletions
Download Patch File Download Diff File Expand all files Collapse all files

101
reference/mcrypt/functions/mcrypt-create-iv.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d 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">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mcrypt-create-iv">
<refnamediv>
<refname>mcrypt_create_iv</refname>
<refpurpose>从随机源创建初始向量</refpurpose>
@@ -36,42 +36,40 @@
<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>
<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>
</refsect1>
<refsect1 role="returnvalues">
@@ -83,34 +81,29 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_create_iv</function> 示例</title>
<programlisting role="php">
<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>
</programlisting>
</example>
</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>
<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>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

95
reference/mcrypt/functions/mcrypt-decrypt.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-decrypt" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-decrypt">
<refnamediv>
<refname>mcrypt_decrypt</refname>
<refpurpose>使用给定参数解密密文</refpurpose>
@@ -26,48 +26,46 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
数据加密密钥。
如果密钥长度不是加解密算法能够支持的有效长度，
那么会产生警告并且返回 &false;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
要使用给定的 <parameter>cipher</parameter> 和
<parameter>mode</parameter> 解密的数据。
如果数据大小不是 n * 分组大小，则在其后追加 '<literal>\0</literal>' 来补齐。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
&mcrypt.parameter.iv.strict;
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
数据加密密钥。
如果密钥长度不是加解密算法能够支持的有效长度，
那么会产生警告并且返回 &false;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
要使用给定的 <parameter>cipher</parameter> 和
<parameter>mode</parameter> 解密的数据。
如果数据大小不是 n * 分组大小，则在其后追加 '<literal>\0</literal>' 来补齐。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
&mcrypt.parameter.iv.strict;
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -78,14 +76,11 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

50
reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml
View File

@@ -1,18 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d7d7191c7dcd0384209ade638d6ecdd2ce203016 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mcrypt-enc-get-algorithms-name" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-algorithms-name">
<refnamediv>
<refname>mcrypt_enc_get_algorithms_name</refname>
<refpurpose>返回打开的算法名称</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-7-1-0.removed-7-2-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -26,18 +25,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -49,10 +46,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_enc_get_algorithms_name</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_enc_get_algorithms_name</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$td = mcrypt_module_open(MCRYPT_CAST_256, '', MCRYPT_MODE_CFB, '');
@@ -62,19 +58,17 @@ $td = mcrypt_module_open('cast-256', '', MCRYPT_MODE_CFB, '');
echo mcrypt_enc_get_algorithms_name($td). "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
CAST-256
CAST-256
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

28
reference/mcrypt/functions/mcrypt-enc-get-block-size.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d7d7191c7dcd0384209ade638d6ecdd2ce203016 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mcrypt-enc-get-block-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-block-size">
<refnamediv>
<refname>mcrypt_enc_get_block_size</refname>
<refpurpose>返回打开的算法的分组大小</refpurpose>
@@ -23,18 +22,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -43,7 +40,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-get-iv-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-iv-size">
<refnamediv>
<refname>mcrypt_enc_get_iv_size</refname>
<refpurpose>返回打开的算法的初始向量大小</refpurpose>
@@ -24,18 +24,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -44,7 +42,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-get-key-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-get-key-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-key-size">
<refnamediv>
<refname>mcrypt_enc_get_key_size</refname>
<refpurpose>返回打开的模式所能支持的最长密钥</refpurpose>
@@ -22,18 +22,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -42,7 +40,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-get-modes-name" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-modes-name">
<refnamediv>
<refname>mcrypt_enc_get_modes_name</refname>
<refpurpose>返回打开的模式的名称</refpurpose>
@@ -22,18 +22,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -43,10 +41,9 @@
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_enc_get_modes_name</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_enc_get_modes_name</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$td = mcrypt_module_open (MCRYPT_CAST_256, '', MCRYPT_MODE_CFB, '');
@@ -56,19 +53,17 @@ $td = mcrypt_module_open ('cast-256', '', 'ecb', '');
echo mcrypt_enc_get_modes_name($td). "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
CFB
ECB
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

49
reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml
View File

@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-get-supported-key-sizes" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-supported-key-sizes">
<refnamediv>
<refname>mcrypt_enc_get_supported_key_sizes</refname>
<refpurpose>以数组方式返回打开的算法所支持的密钥长度</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-7-1-0.removed-7-2-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -25,18 +25,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -51,19 +49,18 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_enc_get_supported_key_sizes</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_enc_get_supported_key_sizes</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$td = mcrypt_module_open('rijndael-256', '', 'ecb', '');
var_dump(mcrypt_enc_get_supported_key_sizes($td));
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(3) {
[0]=>
@@ -74,12 +71,10 @@ array(3) {
int(32)
}
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-is-block-algorithm-mode" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-algorithm-mode">
<refnamediv>
<refname>mcrypt_enc_is_block_algorithm_mode</refname>
<refpurpose>检测打开的模式是否支持分组加密</refpurpose>
@@ -23,18 +23,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -44,7 +42,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-is-block-algorithm" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-algorithm">
<refnamediv>
<refname>mcrypt_enc_is_block_algorithm</refname>
<refpurpose>检测打开模式的算法是否为分组算法</refpurpose>
@@ -22,18 +22,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -43,7 +41,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-is-block-mode" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-mode">
<refnamediv>
<refname>mcrypt_enc_is_block_mode</refname>
<refpurpose>检测打开的模式是否以分组方式输出</refpurpose>
@@ -23,18 +23,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -44,7 +42,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

27
reference/mcrypt/functions/mcrypt-enc-self-test.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-enc-self-test" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-self-test">
<refnamediv>
<refname>mcrypt_enc_self_test</refname>
<refpurpose>在打开的模块上进行自检</refpurpose>
@@ -23,18 +23,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -43,7 +41,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

143
reference/mcrypt/functions/mcrypt-encrypt.xml
View File

@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-encrypt" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-encrypt">
<refnamediv>
<refname>mcrypt_encrypt</refname>
<refpurpose>使用给定参数加密明文</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-7-1-0.removed-7-2-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -29,51 +29,49 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
加密密钥。
如果密钥长度不是该算法所能够支持的有效长度，则函数将会发出警告并返回 &false;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
使用给定的 <parameter>cipher</parameter> 和 <parameter>mode</parameter>
加密的数据。
如果数据长度不是 n*分组大小，则在其后使用 '<literal>\0</literal>' 补齐。
</para>
<para>
返回的密文长度可能比 <parameter>data</parameter>
更大。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
&mcrypt.parameter.iv.strict;
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
加密密钥。
如果密钥长度不是该算法所能够支持的有效长度，则函数将会发出警告并返回 &false;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
使用给定的 <parameter>cipher</parameter> 和 <parameter>mode</parameter>
加密的数据。
如果数据长度不是 n*分组大小，则在其后使用 '<literal>\0</literal>' 补齐。
</para>
<para>
返回的密文长度可能比 <parameter>data</parameter>
更大。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
&mcrypt.parameter.iv.strict;
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -85,10 +83,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_encrypt</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_encrypt</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
# --- 加密 ---
@@ -97,18 +94,18 @@
# 开始使用 scrypt, bcrypt 或 PBKDF2 将一个字符串转换成一个密钥
# 密钥是 16 进制字符串格式
$key = pack('H*', "bcb04b7e103a0cd8b54763051cef08bc55abe029fdebae5e1d417e2ffb2a00a3");
# 显示 AES-128, 192, 256 对应的密钥长度：
#16，24，32 字节。
$key_size = strlen($key);
echo "Key size: " . $key_size . "\n";
$plaintext = "This string was AES-256 / CBC / ZeroBytePadding encrypted.";
# 为 CBC 模式创建随机的初始向量
$iv_size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
$iv = mcrypt_create_iv($iv_size, MCRYPT_RAND);
# 创建和 AES 兼容的密文（Rijndael 分组大小 = 128）
# 仅适用于编码后的输入不是以 00h 结尾的
@@ -118,7 +115,7 @@
# 将初始向量附加在密文之后，以供解密时使用
$ciphertext = $iv . $ciphertext;
# 对密文进行 base64 编码
$ciphertext_base64 = base64_encode($ciphertext);
@@ -128,47 +125,43 @@
# 密文并未进行完整性和可信度保护，
# 所以可能遭受 Padding Oracle 攻击。
# --- 解密 ---
$ciphertext_dec = base64_decode($ciphertext_base64);
# 初始向量大小，可以通过 mcrypt_get_iv_size() 来获得
$iv_dec = substr($ciphertext_dec, 0, $iv_size);
# 获取除初始向量外的密文
$ciphertext_dec = substr($ciphertext_dec, $iv_size);
# 可能需要从明文末尾移除 0
$plaintext_dec = mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $key,
$ciphertext_dec, MCRYPT_MODE_CBC, $iv_dec);
echo $plaintext_dec . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Key size: 32
ENJW8mS2KaJoNB5E5CoSAAu0xARgsR1bdzFWpEn+poYw45q+73az5kYi4j+0haevext1dGrcW8Qi59txfCBV8BBj3bzRP3dFCp3CPQSJ8eU=
This string was AES-256 / CBC / ZeroBytePadding encrypted.
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_decrypt</function></member>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_decrypt</function></member>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

37
reference/mcrypt/functions/mcrypt-generic-deinit.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id='function.mcrypt-generic-deinit' xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic-deinit">
<refnamediv>
<refname>mcrypt_generic_deinit</refname>
<refpurpose>对加密模块进行清理工作</refpurpose>
@@ -27,18 +27,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -50,16 +48,13 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
<member><function>mcrypt_generic_init</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
<member><function>mcrypt_generic_init</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

83
reference/mcrypt/functions/mcrypt-generic-init.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-generic-init" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic-init">
<refnamediv>
<refname>mcrypt_generic_init</refname>
<refpurpose>初始化加密所需的缓冲区</refpurpose>
@@ -26,42 +26,40 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
调用 <function>mcrypt_enc_get_key_size</function>
函数获得的密钥最大长度。
小于最大长度的数值都被视为非法参数。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
<para>
通常情况下，向量大小等于算法的分组大小，
但是你应该通过 <function>mcrypt_enc_get_iv_size</function> 函数
来获得这个值。在 ECB 模式下，初始向量会被忽略，
在 CFB，CBC，STREAM，nOFB 和 OFB 模式下，必须提供初始向量。
初始向量要求是随机的，并且是唯一的（不需要是安全的）。
加密和解密必须使用相同的初始向量。
如果你不想使用初始向量，请将其设置为全 0 值，但是不建议你这么做。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
调用 <function>mcrypt_enc_get_key_size</function>
函数获得的密钥最大长度。
小于最大长度的数值都被视为非法参数。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
<para>
通常情况下，向量大小等于算法的分组大小，
但是你应该通过 <function>mcrypt_enc_get_iv_size</function> 函数
来获得这个值。在 ECB 模式下，初始向量会被忽略，
在 CFB，CBC，STREAM，nOFB 和 OFB 模式下，必须提供初始向量。
初始向量要求是随机的，并且是唯一的（不需要是安全的）。
加密和解密必须使用相同的初始向量。
如果你不想使用初始向量，请将其设置为全 0 值，但是不建议你这么做。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -75,14 +73,11 @@
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

71
reference/mcrypt/functions/mcrypt-generic.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-generic" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic">
<refnamediv>
<refname>mcrypt_generic</refname>
<refpurpose>加密数据</refpurpose>
@@ -28,7 +28,7 @@
如果你需要把加密后的数据保存到数据库，
请确保保存 mcrypt_generic 返回的完整的字符串，
否则将无法正确解密。
如果原始数据有 10 个字符，分组大小为 8
如果原始数据有 10 个字符，分组大小为 8
（使用 <function>mcrypt_enc_get_block_size</function> 获取分组大小），
则数据库中至少需要 16 个字符来保存数据。
请注意 <function>mdecrypt_generic</function> 函数返回的数据也会是 16 个字符。
@@ -45,33 +45,31 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
<para>
在调用本函数之前，
请使用 <function>mcrypt_generic_init</function> 函数初始化加密句柄。
在加密完成之后，
需要调用 <function>mcrypt_generic_deinit</function> 函数进行必要的清理工作。
请参见 <function>mcrypt_module_open</function> 。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
要加密的数据。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
<para>
在调用本函数之前，
请使用 <function>mcrypt_generic_init</function> 函数初始化加密句柄。
在加密完成之后，
需要调用 <function>mcrypt_generic_deinit</function> 函数进行必要的清理工作。
请参见 <function>mcrypt_module_open</function> 。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
要加密的数据。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -83,17 +81,14 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mdecrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mdecrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

67
reference/mcrypt/functions/mcrypt-get-block-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-get-block-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-block-size">
<refnamediv>
<refname>mcrypt_get_block_size</refname>
<refpurpose>获得加密算法的分组大小</refpurpose>
@@ -39,22 +39,20 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -66,14 +64,13 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_get_block_size</function> 示例</title>
<para>
在 libmcrypt 2.4.x 和 2.5.x 下
如何使用本函数。
</para>
<programlisting role="php">
<example>
<title><function>mcrypt_get_block_size</function> 示例</title>
<para>
在 libmcrypt 2.4.x 和 2.5.x 下
如何使用本函数。
</para>
<programlisting role="php">
<![CDATA[
<?php
@@ -81,24 +78,20 @@ echo mcrypt_get_block_size('tripledes', 'ecb'); // 8
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_get_key_size</function></member>
<member><function>mcrypt_enc_get_block_size</function></member>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_get_key_size</function></member>
<member><function>mcrypt_enc_get_block_size</function></member>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

43
reference/mcrypt/functions/mcrypt-get-cipher-name.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-get-cipher-name" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-cipher-name">
<refnamediv>
<refname>mcrypt_get_cipher_name</refname>
<refpurpose>获取加密算法名称</refpurpose>
@@ -21,7 +21,7 @@
<methodparam><type>string</type><parameter>cipher</parameter></methodparam>
</methodsynopsis>
<para>
<function>mcrypt_get_cipher_name</function>
<function>mcrypt_get_cipher_name</function>
用来获取加密算法名称。
</para>
<para>
@@ -33,16 +33,14 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -55,10 +53,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_get_cipher_name</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_get_cipher_name</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$cipher = MCRYPT_TripleDES;
@@ -66,18 +63,16 @@
echo mcrypt_get_cipher_name($cipher);
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
3DES
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

73
reference/mcrypt/functions/mcrypt-get-iv-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-get-iv-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-iv-size">
<refnamediv>
<refname>mcrypt_get_iv_size</refname>
<refpurpose>返回指定算法/模式组合的初始向量大小</refpurpose>
@@ -23,34 +23,32 @@
</para>
<para>
<function>mcrypt_enc_get_iv_size</function> 更加有用，
因为它使用由 <function>mcrypt_module_open</function>
因为它使用由 <function>mcrypt_module_open</function>
返回的资源作为参数。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
<para>
由于 ECB 模式不使用初始向量，所以会忽略它。
在加密和解密的过程中，
你需要使用相同的初始向量（想象成：开始点）。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
<para>
由于 ECB 模式不使用初始向量，所以会忽略它。
在加密和解密的过程中，
你需要使用相同的初始向量（想象成：开始点）。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -64,10 +62,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_get_iv_size</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_get_iv_size</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
echo mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB) . "\n";
@@ -75,24 +72,20 @@
echo mcrypt_get_iv_size('des', 'ecb') . "\n";
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_get_block_size</function></member>
<member><function>mcrypt_enc_get_iv_size</function></member>
<member><function>mcrypt_create_iv</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_get_block_size</function></member>
<member><function>mcrypt_enc_get_iv_size</function></member>
<member><function>mcrypt_create_iv</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

75
reference/mcrypt/functions/mcrypt-get-key-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-get-key-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-key-size">
<refnamediv>
<refname>mcrypt_get_key_size</refname>
<refpurpose>获取指定加密算法的密钥大小</refpurpose>
@@ -27,7 +27,7 @@
</para>
<para>
<function>mcrypt_get_key_size</function> 用来获取
由 <parameter>cipher</parameter>
由 <parameter>cipher</parameter>
所指定的算法和模式所需的密钥长度。
</para>
<para>
@@ -38,22 +38,20 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>cipher</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -66,42 +64,37 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_get_key_size</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_get_key_size</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
echo mcrypt_get_key_size('tripledes', 'ecb');
?>
]]>
</programlisting>
<para>
在 libmcrypt 2.4.x 或 2.5.x 版本中，
如果使用本函数。
</para>
&example.outputs;
<screen>
</programlisting>
<para>
在 libmcrypt 2.4.x 或 2.5.x 版本中，
如果使用本函数。
</para>
&example.outputs;
<screen>
<![CDATA[
24
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_get_block_size</function></member>
<member><function>mcrypt_enc_get_key_size</function></member>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_get_block_size</function></member>
<member><function>mcrypt_enc_get_key_size</function></member>
<member><function>mcrypt_encrypt</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

49
reference/mcrypt/functions/mcrypt-list-algorithms.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-list-algorithms" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-list-algorithms">
<refnamediv>
<refname>mcrypt_list_algorithms</refname>
<refpurpose>获取支持的加密算法</refpurpose>
@@ -24,20 +24,18 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
指定算法所在的位置。
如果未指定，将使用 &php.ini;
中的 <literal>mcrypt.algorithms_dir</literal> 指示所指定的位置。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
指定算法所在的位置。
如果未指定，将使用 &php.ini;
中的 <literal>mcrypt.algorithms_dir</literal> 指示所指定的位置。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -49,19 +47,18 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_list_algorithms</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_list_algorithms</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$algorithms = mcrypt_list_algorithms();
print_r($algorithms);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
@@ -86,12 +83,10 @@ Array
[18] => tripledes
)
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/mcrypt/functions/mcrypt-list-modes.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-list-modes" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-list-modes">
<refnamediv>
<refname>mcrypt_list_modes</refname>
<refpurpose>获取所支持的模式</refpurpose>
@@ -24,20 +24,18 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
指定模式所在的位置。
如果未指定，将使用 &php.ini;
中的 <literal>mcrypt.modes_dir</literal> 指示所指定的位置。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
指定模式所在的位置。
如果未指定，将使用 &php.ini;
中的 <literal>mcrypt.modes_dir</literal> 指示所指定的位置。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -49,10 +47,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_list_modes</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_list_modes</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$modes = mcrypt_list_modes();
@@ -62,19 +59,17 @@
}
?>
]]>
</programlisting>
<para>
本示例列出在默认目录中
所有受支持的模式。
如果在 &php.ini; 中未指定 <literal>mcrypt.modes_dir</literal>，
则使用默认的 mcrypt 库
安装目录（<filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</example>
</para>
</programlisting>
<para>
本示例列出在默认目录中
所有受支持的模式。
如果在 &php.ini; 中未指定 <literal>mcrypt.modes_dir</literal>，
则使用默认的 mcrypt 库
安装目录（<filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

35
reference/mcrypt/functions/mcrypt-module-close.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id='function.mcrypt-module-close' xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-close">
<refnamediv>
<refname>mcrypt_module_close</refname>
<refpurpose>关闭加密模块</refpurpose>
@@ -22,18 +22,16 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
加密描述符。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -43,14 +41,11 @@
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_module_open</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/mcrypt/functions/mcrypt-module-get-algo-block-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-get-algo-block-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-algo-block-size">
<refnamediv>
<refname>mcrypt_module_get_algo_block_size</refname>
<refpurpose>返回指定算法的分组大小</refpurpose>
@@ -23,27 +23,25 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter> ，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter> ，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -52,7 +50,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/mcrypt/functions/mcrypt-module-get-algo-key-size.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-get-algo-key-size" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-algo-key-size">
<refnamediv>
<refname>mcrypt_module_get_algo_key_size</refname>
<refpurpose>获取打开模式所支持的最大密钥大小</refpurpose>
@@ -23,27 +23,25 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -53,7 +51,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/mcrypt/functions/mcrypt-module-get-supported-key-sizes.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-get-supported-key-sizes" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-supported-key-sizes">
<refnamediv>
<refname>mcrypt_module_get_supported_key_sizes</refname>
<refpurpose>以数组形式返回打开的算法所支持的密钥大小</refpurpose>
@@ -19,54 +19,49 @@
</methodsynopsis>
<para>
以数组形式返回指定算法所支持的密钥大小。
如果从 1 到 <function>mcrypt_module_get_algo_key_size</function>
如果从 1 到 <function>mcrypt_module_get_algo_key_size</function>
的密钥大小都支持，则返回空数组。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
算法名称。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
以数组形式返回指定算法所支持的密钥大小。
如果从 1 到 <function>mcrypt_module_get_algo_key_size</function>
如果从 1 到 <function>mcrypt_module_get_algo_key_size</function>
的密钥大小都支持，则返回空数组。
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_enc_get_supported_key_sizes</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_enc_get_supported_key_sizes</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/mcrypt/functions/mcrypt-module-is-block-algorithm-mode.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-is-block-algorithm-mode" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-algorithm-mode">
<refnamediv>
<refname>mcrypt_module_is_block_algorithm_mode</refname>
<refpurpose>返回指定模块是否是分组加密模式</refpurpose>
@@ -25,27 +25,25 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
模式。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
模式。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -57,7 +55,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/mcrypt/functions/mcrypt-module-is-block-algorithm.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-is-block-algorithm" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-algorithm">
<refnamediv>
<refname>mcrypt_module_is_block_algorithm</refname>
<refpurpose>检测指定算法是否为分组加密算法</refpurpose>
@@ -25,27 +25,25 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
要检测的算法。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter>，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
要检测的算法。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter>，
表示在操作系统上包含算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -56,7 +54,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

41
reference/mcrypt/functions/mcrypt-module-is-block-mode.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-is-block-mode" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-mode">
<refnamediv>
<refname>mcrypt_module_is_block_mode</refname>
<refpurpose>检测指定模式是否以分组方式输出</refpurpose>
@@ -26,25 +26,23 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter> ，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter> ，
表示在操作系统上包含模式模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -56,7 +54,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

129
reference/mcrypt/functions/mcrypt-module-open.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f27cfeeefc13717f86a53d7fefa0ce54f7bfaaaf Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.mcrypt-module-open" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-open">
<refnamediv>
<refname>mcrypt_module_open</refname>
<refpurpose>打开算法和模式对应的模块</refpurpose>
@@ -29,48 +29,46 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>algorithm_directory</parameter></term>
<listitem>
<para>
<parameter>algorithm_directory</parameter> 参数指示加密模块的位置。
如果你提供此参数，则使用你指定的值。
如果将此参数设置为空字符串（<literal>""</literal>），将使用
&php.ini; 中的 <literal>mcrypt.algorithms_dir</literal> 。
如果不指定此参数，则使用 libmcrypt 的编译路径
（通常是 <filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode_directory</parameter></term>
<listitem>
<para>
<parameter>algorithm_directory</parameter> 参数指示加密模式的位置。
如果你提供此参数，则使用你指定的值。
如果将此参数设置为空字符串（<literal>""</literal>），将使用
&php.ini; 中的 <literal>mcrypt.modes_dir</literal> 。
如果不指定此参数，则使用 libmcrypt 的编译路径
（通常是 <filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>algorithm_directory</parameter></term>
<listitem>
<para>
<parameter>algorithm_directory</parameter> 参数指示加密模块的位置。
如果你提供此参数，则使用你指定的值。
如果将此参数设置为空字符串（<literal>""</literal>），将使用
&php.ini; 中的 <literal>mcrypt.algorithms_dir</literal> 。
如果不指定此参数，则使用 libmcrypt 的编译路径
（通常是 <filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode_directory</parameter></term>
<listitem>
<para>
<parameter>algorithm_directory</parameter> 参数指示加密模式的位置。
如果你提供此参数，则使用你指定的值。
如果将此参数设置为空字符串（<literal>""</literal>），将使用
&php.ini; 中的 <literal>mcrypt.modes_dir</literal> 。
如果不指定此参数，则使用 libmcrypt 的编译路径
（通常是 <filename>/usr/local/lib/libmcrypt</filename>）。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -82,10 +80,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_module_open</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_module_open</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
$td = mcrypt_module_open(MCRYPT_DES, '',
@@ -94,9 +91,8 @@
$td = mcrypt_module_open('rijndael-256', '', 'ofb', '');
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
示例中的第一行从默认目录打开 <literal>DES</literal> 加密算法，
从 <filename>/usr/lib/mcrypt-modes</filename> 目录打开
@@ -105,16 +101,15 @@
这种形式仅适用于 libmcrypt 2.4.x 或 2.5.x 版本。
</para>
<para>
<example>
<title>在加密中使用 <function>mcrypt_module_open</function></title>
<programlisting role="php">
<example>
<title>在加密中使用 <function>mcrypt_module_open</function></title>
<programlisting role="php">
<![CDATA[
<?php
/* 打开加密算法和模式 */
$td = mcrypt_module_open('rijndael-256', '', 'ofb', '');
/* 创建初始向量，并且检测密钥长度。
/* 创建初始向量，并且检测密钥长度。
* Windows 平台请使用 MCRYPT_RAND。 */
$iv = mcrypt_create_iv(mcrypt_enc_get_iv_size($td), MCRYPT_DEV_RANDOM);
$ks = mcrypt_enc_get_key_size($td);
@@ -145,25 +140,21 @@
echo trim($decrypted) . "\n";
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_module_close</function></member>
<member><function>mcrypt_generic</function></member>
<member><function>mdecrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_module_close</function></member>
<member><function>mcrypt_generic</function></member>
<member><function>mdecrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

59
reference/mcrypt/functions/mcrypt-module-self-test.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 115560f445336d95d9fccdc1b8b2a90e210fbbd0 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mcrypt-module-self-test" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-self-test">
<refnamediv>
<refname>mcrypt_module_self_test</refname>
<refpurpose>在指定模块上执行自检</refpurpose>
@@ -24,25 +24,23 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter>，
表示包含加密算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
&mcrypt.parameter.cipher;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
可选参数 <parameter>lib_dir</parameter>，
表示包含加密算法模块的路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -55,29 +53,26 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mcrypt_module_self_test</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mcrypt_module_self_test</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(mcrypt_module_self_test(MCRYPT_RIJNDAEL_128)) . "\n";
var_dump(mcrypt_module_self_test(MCRYPT_BOGUS_CYPHER));
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(true)
bool(false)
]]>
</screen>
</example>
</para>
</screen>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

73
reference/mcrypt/functions/mdecrypt-generic.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d91e36266dddbe570789dbe218e5672fc0b85089 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.mdecrypt-generic" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mdecrypt-generic">
<refnamediv>
<refname>mdecrypt_generic</refname>
<refpurpose>解密数据</refpurpose>
@@ -26,27 +26,25 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
由
<function>mcrypt_module_open</function> 函数创建的加密描述符。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
密文。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
由
<function>mcrypt_module_open</function> 函数创建的加密描述符。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
密文。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -58,10 +56,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mdecrypt_generic</function> 示例</title>
<programlisting role="php">
<example>
<title><function>mdecrypt_generic</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
/* 数据 */
@@ -97,15 +94,14 @@
}
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
<para>
上例中演示了如何检测
解密后的数据是否和原始明文长度一致。
需要着重提醒的是，在对数据进行机密之前，
必须使用 <function>mcrypt_generic_init</function>
函数来重新初始化缓冲区。
必须使用 <function>mcrypt_generic_init</function>
函数来重新初始化缓冲区。
</para>
<para>
调用本函数之前，
@@ -118,16 +114,13 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mcrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</para>
<simplelist>
<member><function>mcrypt_generic</function></member>
<member><function>mcrypt_generic_init</function></member>
<member><function>mcrypt_generic_deinit</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

73
reference/mcrypt/ini.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6dfe0767250cdbdf509223f6bc266557b0a3fec9 Maintainer: yuanyuqiang Status: ready -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: yuanyuqiang Status: ready -->
<!-- Reviewed: no -->
<section xml:id="mcrypt.configuration" xmlns="http://docbook.org/ns/docbook">
<section xmlns="http://docbook.org/ns/docbook" xml:id="mcrypt.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
@@ -23,13 +22,13 @@
<entry><link linkend="ini.mcrypt.algorithms-dir">mcrypt.algorithms_dir</link></entry>
<entry>&null;</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
<entry/>
</row>
<row>
<entry><link linkend="ini.mcrypt.modes-dir">mcrypt.modes_dir</link></entry>
<entry>&null;</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
<entry/>
</row>
</tbody>
</tgroup>
@@ -38,41 +37,38 @@
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.mcrypt.algorithms-dir">
<term>
<parameter>mcrypt.algorithms_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
包含算法的目录。
默认情况向是 libmcrypt 的编译目录，
通常是 <emphasis>/usr/local/lib/libmcrypt</emphasis>。
更多信息请参见 <function>mcrypt_list_algorithms</function>。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mcrypt.modes-dir">
<term>
<parameter>mcrypt.modes_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
包含模式的目录。
默认情况向是 libmcrypt 的编译目录，
通常是 <emphasis>/usr/local/lib/libmcrypt</emphasis>。
更多信息请参见 <function>mcrypt_list_modes</function>。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry xml:id="ini.mcrypt.algorithms-dir">
<term>
<parameter>mcrypt.algorithms_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
包含算法的目录。
默认情况向是 libmcrypt 的编译目录，
通常是 <emphasis>/usr/local/lib/libmcrypt</emphasis>。
更多信息请参见 <function>mcrypt_list_algorithms</function>。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mcrypt.modes-dir">
<term>
<parameter>mcrypt.modes_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
包含模式的目录。
默认情况向是 libmcrypt 的编译目录，
通常是 <emphasis>/usr/local/lib/libmcrypt</emphasis>。
更多信息请参见 <function>mcrypt_list_modes</function>。
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -93,4 +89,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->