Sophie

Sophie

distrib > PLD > ac > amd64 > media > dist > by-pkgid > dd8ef74e7a184506d40e4328053fb785 > files > 1713

php-manual-ro-20051028-1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>mcrypt_encrypt</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="Manual PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Mcrypt Encryption Functions"
HREF="ref.mcrypt.html"><LINK
REL="PREVIOUS"
TITLE="mcrypt_enc_self_test"
HREF="function.mcrypt-enc-self-test.html"><LINK
REL="NEXT"
TITLE="mcrypt_generic_deinit"
HREF="function.mcrypt-generic-deinit.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=ISO-8859-2"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.mcrypt-enc-self-test.html"
ACCESSKEY="P"
>Înapoi</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.mcrypt-generic-deinit.html"
ACCESSKEY="N"
>Înainte</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.mcrypt-encrypt"
></A
>mcrypt_encrypt</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN55322"
></A
><P
>    (PHP 4 &#62;= 4.0.2, PHP 5)</P
>mcrypt_encrypt&nbsp;--&nbsp;Encrypts plaintext with given parameters</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN55325"
></A
><H2
>Description</H2
>string <B
CLASS="methodname"
>mcrypt_encrypt</B
> ( string cipher, string key, string data, string mode [, string iv])<BR
></BR
><P
>&#13;     <B
CLASS="function"
>mcrypt_encrypt()</B
> encrypts the data
     and returns the encrypted data.
    </P
><P
>&#13;     <VAR
CLASS="parameter"
>Cipher</VAR
> is one of the MCRYPT_ciphername
     constants of the name of the algorithm as string.
    </P
><P
>&#13;     <VAR
CLASS="parameter"
>Key</VAR
> is the key with which the data
     will be encrypted. If it's smaller that the required keysize, it
     is padded with '<VAR
CLASS="literal"
>\0</VAR
>'. It is better not to use ASCII strings for
     keys. It is recommended to use the mhash functions to create a key 
     from a string.
    </P
><P
>&#13;     <VAR
CLASS="parameter"
>Data</VAR
> is the data that will be encrypted
     with the given cipher and mode. If the size of the data is not
     n * blocksize, the data will be padded with '<VAR
CLASS="literal"
>\0</VAR
>'. The returned
     crypttext can be larger that the size of the data that is given
     by <VAR
CLASS="parameter"
>data</VAR
>.
    </P
><P
>&#13;     <VAR
CLASS="parameter"
>Mode</VAR
> is one of the MCRYPT_MODE_modename
     constants of one of "ecb", "cbc", "cfb", "ofb", "nofb" or 
     "stream".
    </P
><P
>&#13;     The <VAR
CLASS="parameter"
>IV</VAR
> parameter is used for the
     initialisation in CBC, CFB, OFB modes, and in some algorithms
     in STREAM mode. If you do not supply an IV, while it is needed
     for an algorithm, the function issues a warning and uses an
     IV with all bytes set to '<VAR
CLASS="literal"
>\0</VAR
>'.
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN55362"
></A
><P
><B
>Exemplu 1. <B
CLASS="function"
>mcrypt_encrypt()</B
> Example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />&nbsp;&nbsp;&nbsp;&nbsp;$iv_size </font><font color="#007700">= </font><font color="#0000BB">mcrypt_get_iv_size</font><font color="#007700">(</font><font color="#0000BB">MCRYPT_RIJNDAEL_256</font><font color="#007700">, </font><font color="#0000BB">MCRYPT_MODE_ECB</font><font color="#007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$iv </font><font color="#007700">= </font><font color="#0000BB">mcrypt_create_iv</font><font color="#007700">(</font><font color="#0000BB">$iv_size</font><font color="#007700">, </font><font color="#0000BB">MCRYPT_RAND</font><font color="#007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$key </font><font color="#007700">= </font><font color="#DD0000">"This is a very secret key"</font><font color="#007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$text </font><font color="#007700">= </font><font color="#DD0000">"Meet me at 11 o'clock behind the monument."</font><font color="#007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#0000BB">strlen</font><font color="#007700">(</font><font color="#0000BB">$text</font><font color="#007700">) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$crypttext </font><font color="#007700">= </font><font color="#0000BB">mcrypt_encrypt</font><font color="#007700">(</font><font color="#0000BB">MCRYPT_RIJNDAEL_256</font><font color="#007700">, </font><font color="#0000BB">$key</font><font color="#007700">, </font><font color="#0000BB">$text</font><font color="#007700">, </font><font color="#0000BB">MCRYPT_MODE_ECB</font><font color="#007700">, </font><font color="#0000BB">$iv</font><font color="#007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#0000BB">strlen</font><font color="#007700">(</font><font color="#0000BB">$crypttext</font><font color="#007700">) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
><P
>&#13;       The above example will print out:
       <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>42
64</PRE
></TD
></TR
></TABLE
>
      </P
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     See also <A
HREF="function.mcrypt-module-open.html"
><B
CLASS="function"
>mcrypt_module_open()</B
></A
> for a more advanced API
     and an example.
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.mcrypt-enc-self-test.html"
ACCESSKEY="P"
>Înapoi</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Acas&#227;</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.mcrypt-generic-deinit.html"
ACCESSKEY="N"
>Înainte</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mcrypt_enc_self_test</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.mcrypt.html"
ACCESSKEY="U"
>Sus</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mcrypt_generic_deinit</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>