mcrypt_get_iv_size

指定した暗号/モードの組み合わせに属する IV の大きさを返す

警告

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

説明

int mcrypt_get_iv_size(string $cipher, string $mode)

指定した cipher/mode の組み合わせにおける IV の大きさを取得します。

mcrypt_enc_get_iv_size 関数を使用するほうが より有用です。これは mcrypt_module_open が返すリソースを使用します。

パラメータ

cipher

MCRYPT_暗号名 定数のいずれか、 あるいはアルゴリズム名をあらわす文字列。

mode

定数 MCRYPT_MODE_モード名、あるいは文字列 "ecb", "cbc", "cfb", "ofb", "nofb" ,"stream" のいずれか。

ECB モードでは IV は要求されないため、IV は無視されます。 暗号化と復号の際には、同じ IV(開始位置)が必要です。さもないと 暗号化処理は失敗します。

戻り値

初期化ベクトル(IV)の大きさをバイト数で返します。 エラーの際には false を返します。IV が指定した暗号/モードで無視される場合には、ゼロを返します。

例1 mcrypt_get_iv_size の例

<?php
    echo mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB) . "\n";

    echo mcrypt_get_iv_size('des', 'ecb') . "\n";
?>

参考

  • mcrypt_get_block_size
  • mcrypt_enc_get_iv_size
  • mcrypt_create_iv