|
mcrypt_generic_init
This function initializes all buffers needed for encryption
(PHP 4 >= 4.0.2, PHP 5)
The maximum length of the key should be the one obtained by calling mcrypt_enc_get_key_size() and every value smaller than this is legal. The IV should normally have the size of the algorithms block size, but you must obtain the size by calling mcrypt_enc_get_iv_size(). IV is ignored in ECB. IV MUST exist in CFB, CBC, STREAM, nOFB and OFB modes. It needs to be random and unique (but not secret). The same IV must be used for encryption/decryption. If you do not want to use it you should set it to zeros, but this is not recommended.
The function returns a negative value on error, -3 when the key length
was incorrect, -4 when there was a memory allocation problem and any
other return value is an unknown error. If an error occurs a warning will
be displayed accordingly. You need to call this function before every call to mcrypt_generic() or mdecrypt_generic(). See for an example mcrypt_module_open(). Code Examples / Notes » mcrypt_generic_initcnww
If you write error-checking into your code, be warned that this function returns FALSE on some errors, and 0 on success, hence mcrypt_generic_init( $a, $b, $c ) or die( "Oops"); ALWAYS exits with the error message "Oops", and (mcrypt_generic_init( $a, $b, $c ) >= 0 ) or die( "Oops"); Sometimes continues when mcrypt_generic_init() actually failed. To check for successful init use something like: $s = mcrypt_generic_init( $a, $b, $c ); if( ($s < 0) || ($s === false)) die( "Really an error" ); |
Change Languagemcrypt_cbc mcrypt_cfb mcrypt_create_iv mcrypt_decrypt mcrypt_ecb mcrypt_enc_get_algorithms_name mcrypt_enc_get_block_size mcrypt_enc_get_iv_size mcrypt_enc_get_key_size mcrypt_enc_get_modes_name mcrypt_enc_get_supported_key_sizes mcrypt_enc_is_block_algorithm_mode mcrypt_enc_is_block_algorithm mcrypt_enc_is_block_mode mcrypt_enc_self_test mcrypt_encrypt mcrypt_generic_deinit mcrypt_generic_end mcrypt_generic_init mcrypt_generic mcrypt_get_block_size mcrypt_get_cipher_name mcrypt_get_iv_size mcrypt_get_key_size mcrypt_list_algorithms mcrypt_list_modes mcrypt_module_close mcrypt_module_get_algo_block_size mcrypt_module_get_algo_key_size mcrypt_module_get_supported_key_sizes mcrypt_module_is_block_algorithm_mode mcrypt_module_is_block_algorithm mcrypt_module_is_block_mode mcrypt_module_open mcrypt_module_self_test mcrypt_ofb mdecrypt_generic |