mcrypt_generic_init

(PHP 4 >= 4.0.2, PHP 5, PHP 7 < 7.2.0, PECL mcrypt >= 1.0.0)

mcrypt_generic_init — 暗号化に必要な全てのバッファを初期化する

警告

この関数は PHP 7.1.0 で 非推奨となり、PHP 7.2.0 で削除されました。この関数に頼らないことを強く推奨します。

mcrypt_generic_init(resource $td, string $key, string $iv): int

mcrypt_generic() または mdecrypt_generic() をコールする前に、常にこの関数をコールする必要があります。

td: 暗号化記述子。
key: キーの最大長は、mcrypt_enc_get_key_size() をコールした際に得られるキー長であり、この値より小さな値は全て有効です。
iv: IV は通常そのアルゴリズムのブロック長と同じ大きさですが、 mcrypt_enc_get_iv_size() をコールすることにより、その大きさを得る必要があります。IV は ECB では無視されます。IV は CFB、CBC、STREAM、nOFB では必須です。 IV はランダムで一意である必要があります(しかし、秘密ではある必要はありません)。暗号化と復号で同じ IV を使用する必要があります。 IV を使用したくない場合にはゼロに設定しますが、これは推奨されません。

この関数は、エラー時に負の値を返します。キー長が不正な場合に -3、メモリの確保に問題があった場合に -4、そしてそれ以外の戻り値はその他のエラーとなります。エラーが警告を発生させた場合、それが表示されます。間違ったパラメータが渡された場合には false が返されます。