【PHP8.x】openssl_cipher_iv_length関数の使い方

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 指定された暗号化アルゴリズムに必要なIV（初期化ベクトル）の長さを取得し、表示します。
7 *
8 * この関数は、暗号化処理を行う前に、適切な長さのIVを生成するために使用されます。
9 *
10 * @param string $cipherAlgo 確認したい暗号化アルゴリズム名。
11 * @return void
12 */
13function showCipherIvLength(string $cipherAlgo): void
14{
15    // openssl_cipher_iv_length() を使用して、指定された暗号アルゴリズムのIV長を取得します。
16    // サポートされていないアルゴリズムの場合、この関数は false を返します。
17    $ivLength = openssl_cipher_iv_length($cipherAlgo);
18
19    // 結果を整形して出力します。
20    echo "アルゴリズム: '{$cipherAlgo}'" . PHP_EOL;
21
22    if ($ivLength === false) {
23        // IV長が取得できなかった場合（例: アルゴリズム名が不正）
24        echo "-> 結果: サポートされていないか、無効なアルゴリズムです。" . PHP_EOL;
25    } elseif ($ivLength === 0) {
26        // IV長が0の場合（例: ECBモードなど、IVを必要としないアルゴリズム）
27        echo "-> 結果: このアルゴリズムはIVを必要としません。" . PHP_EOL;
28    } else {
29        // IV長が取得できた場合
30        echo "-> 結果: 必要なIVの長さは {$ivLength} バイトです。" . PHP_EOL;
31    }
32    echo "------------------------" . PHP_EOL;
33}
34
35// --- 関数の実行例 ---
36
37// 一般的によく使われる暗号化アルゴリズム (成功例)
38showCipherIvLength('aes-256-cbc');
39
40// 別の暗号化アルゴリズム (成功例)
41showCipherIvLength('aes-128-gcm');
42
43// IVを必要としないアルゴリズムの例
44showCipherIvLength('aes-256-ecb');
45
46// 存在しない、または無効なアルゴリズム名 (失敗例)
47showCipherIvLength('invalid-cipher-name');
48
49?>

PHPの openssl_cipher_iv_length 関数は、指定した暗号化アルゴリズムで必要となるIV（初期化ベクトル）の長さをバイト単位で取得するための関数です。IVとは、同じデータを暗号化しても毎回異なる結果になるようにするための、使い捨てのランダムな値で、暗号化の安全性を高める重要な役割を担います。

この関数の引数 $cipher_algo には、長さを調べたい暗号化アルゴリズムの名前を 'aes-256-cbc' のような文字列で指定します。

戻り値は、成功した場合は必要なIVの長さを整数で返します。アルゴリズムがIVを必要としない場合は0を返します。引数に指定されたアルゴリズム名が無効な場合や、システムでサポートされていない場合は false を返します。

サンプルコードでは、いくつかの異なるアルゴリズム名をこの関数に渡し、その結果を表示しています。例えば、一般的に使われる 'aes-256-cbc' ではIVの長さ（16バイト）が、IVを必要としない 'aes-256-ecb' では0が表示されます。また、存在しないアルゴリズム名を渡すと false が返され、エラーメッセージが表示されることがわかります。このように、暗号化処理を行う前にこの関数でIVの長さを確認し、適切な長さのIVを生成することが重要です。