【PHP8.x】hash_init()関数の使い方

Copy
1<?php
2
3/**
4 * hash_init() を使用して入力データをハッシュ化し、そのハッシュ値の検証を行うサンプル。
5 * この関数は、hash_init()、hash_update()、hash_final() の基本的な使い方を示します。
6 */
7function hashDataAndVerify(string $inputData): void
8{
9    // 使用するハッシュアルゴリズムを定義（例: SHA-256）
10    $algo = 'sha256';
11
12    // 1. ハッシュコンテキストを初期化する
13    // hash_init() は HashContext オブジェクトを返す
14    $context = hash_init($algo);
15
16    // 2. ハッシュコンテキストに入力データを追加する
17    hash_update($context, $inputData);
18
19    // 3. 最終的なハッシュ値を取得する（16進数文字列形式）
20    // false を指定すると、ハッシュ値が16進数文字列として返される
21    $hashedData = hash_final($context, false);
22
23    echo "元のデータ: \"" . $inputData . "\"" . PHP_EOL;
24    echo "ハッシュアルゴリズム: " . $algo . PHP_EOL;
25    echo "計算されたハッシュ値: " . $hashedData . PHP_EOL . PHP_EOL;
26
27    // --- ハッシュ値の検証プロセス ---
28    echo "--- 検証 ---" . PHP_EOL;
29
30    // 新しいハッシュコンテキストを初期化し、同じデータでハッシュを再計算する
31    $verificationContext = hash_init($algo);
32    hash_update($verificationContext, $inputData);
33    $recalculatedHash = hash_final($verificationContext, false);
34
35    echo "再計算されたハッシュ値: " . $recalculatedHash . PHP_EOL;
36
37    // 元のハッシュ値と再計算されたハッシュ値を比較して、データの一貫性を検証する
38    $isMatch = ($hashedData === $recalculatedHash);
39    echo "元のハッシュ値と一致するか？: " . ($isMatch ? "はい" : "いいえ") . PHP_EOL . PHP_EOL;
40
41    // --- 異なるデータでの検証例 ---
42    echo "--- 異なるデータでの検証 ---" . PHP_EOL;
43    $differentData = $inputData . "changed"; // 元のデータとは異なるデータを用意
44    $differentContext = hash_init($algo);
45    hash_update($differentContext, $differentData);
46    $differentDataHash = hash_final($differentContext, false);
47
48    echo "異なるデータ: \"" . $differentData . "\"" . PHP_EOL;
49    echo "異なるデータのハッシュ値: " . $differentDataHash . PHP_EOL;
50
51    // 元のハッシュ値と異なるデータのハッシュ値を比較する
52    $isDifferentMatch = ($hashedData === $differentDataHash);
53    echo "元のハッシュ値と一致するか？: " . ($isDifferentMatch ? "はい" : "いいえ") . PHP_EOL;
54}
55
56// サンプルコードの実行
57// キーワード「php hash_password」を意識し、パスワードに見立てた文字列を使用
58hashDataAndVerify("MySuperSecurePassword123!");
59

hash_init 関数は、PHPでデータをハッシュ化する処理を開始するための重要な関数です。ハッシュ化とは、任意の長さのデータを、元の内容が少しでも変わると大きく異なる固定長の短い値（ハッシュ値）に変換することです。この技術は、パスワードなどの機密情報を安全に保存したり、データの改ざんを検出したりする目的で広く使われます。

この関数は、使用するハッシュアルゴリズム（例えば 'sha256' など）を最初の$algo引数で指定します。そして、ハッシュ処理の状態を管理するためのHashContextという特別なオブジェクトを戻り値として返します。$flags引数や$key引数は、特定のハッシュ化モードで使用されますが、基本的にはデフォルト値のままで問題ありません。

サンプルコードでは、まずhash_initを使って'sha256'アルゴリズムのハッシュコンテキストを初期化しています。次に、hash_update関数で入力データ "MySuperSecurePassword123!" をこのコンテキストに追加し、最後にhash_final関数を呼び出すことで、追加されたデータから最終的なハッシュ値が計算されます。

この一連の流れにより、パスワードなどの元のデータを見せずにハッシュ値だけを保存し、セキュリティを確保できます。また、後で同じデータからハッシュ値を再計算し、保存されている値と比較することで、データが改ざんされていないかを検証することが可能です。サンプルでは、同じデータからは常に同じハッシュ値が生成されること、そして少しでもデータが異なると全く異なるハッシュ値が生成されることが示されており、データの整合性確認の仕組みを理解できます。

Copy
1<?php
2
3/**
4 * 複数のデータを段階的にハッシュ化し、最終的なハッシュ値を計算するデモンストレーション。
5 * hash_init, hash_update, hash_final の一連の処理を示します。
6 *
7 * @param string $dataPart1 ハッシュ化するデータの一部1
8 * @param string $dataPart2 ハッシュ化するデータの一部2
9 * @return string 計算されたハッシュ値。エラー時は空文字列。
10 */
11function demonstrate_incremental_hashing(string $dataPart1, string $dataPart2): string
12{
13    // 使用するハッシュアルゴリズムを定義します。ここでは一般的なSHA256を使用。
14    $algo = 'sha256';
15
16    // 1. ハッシュコンテキストを初期化します。
17    // hash_init は、段階的なハッシュ計算を開始するために必要な HashContext オブジェクトを返します。
18    // これが「初期化」のフェーズです。
19    // 第二引数 $flags と第三引数 $key はオプションで、
20    // ここでは単純なハッシュ計算のためデフォルト値 (0 と空文字列) を使用します。
21    $context = hash_init($algo);
22
23    // 初期化に失敗した場合はエラーを出力して終了
24    if ($context === false) {
25        echo "エラー: ハッシュコンテキストの初期化に失敗しました。\n";
26        return '';
27    }
28
29    // 2. 最初のデータの一部をハッシュコンテキストに追加（更新）します。
30    // hash_update を複数回呼び出すことで、大きなデータや、
31    // 異なるタイミングで得られるデータを段階的にハッシュ化できます。
32    hash_update($context, $dataPart1);
33
34    // 3. 別のデータの一部をハッシュコンテキストに追加（更新）します。
35    // これにより、以前追加されたデータに続いてハッシュが計算されます。
36    hash_update($context, $dataPart2);
37
38    // 4. ハッシュ計算を完了し、最終的なハッシュ値を取得します。
39    // 第二引数に true を指定すると、ハッシュ値は16進数形式の文字列として返されます。
40    $finalHash = hash_final($context, true);
41
42    return $finalHash;
43}
44
45// --- サンプルデータの定義と実行例 ---
46
47// ハッシュ化したいデータの一部を定義
48$firstData = "PHPは素晴らしいプログラミング言語です。";
49$secondData = "特にウェブ開発で強力な力を発揮します。";
50
51// hash_init, hash_update, hash_final を使用して段階的にハッシュを計算
52$incrementalHash = demonstrate_incremental_hashing($firstData, $secondData);
53
54if (!empty($incrementalHash)) {
55    echo "段階的なハッシュ計算の結果 (SHA256): " . $incrementalHash . "\n";
56}
57
58// --- 参考：hash() 関数で同じデータを一度にハッシュ化した場合の比較 ---
59// hash_init/update/final で段階的に計算されたハッシュ値は、
60// データを連結して hash() 関数で一度に計算した場合と同じになります。
61$combinedData = $firstData . $secondData;
62$directHash = hash('sha256', $combinedData);
63
64echo "直接ハッシュ計算の結果   (SHA256): " . $directHash . "\n";
65
66// 両方の計算結果が一致することを確認
67if ($incrementalHash === $directHash) {
68    echo "確認: 段階的なハッシュと直接ハッシュは同じです。\n";
69} else {
70    echo "エラー: ハッシュ値が一致しません。\n";
71}

PHPのhash_init関数は、データを一度にまとめてハッシュ化するのではなく、複数の部分に分けて段階的にハッシュ計算を行う際に、その計算プロセスを初期化するために使用される関数です。この関数は、指定されたハッシュアルゴリズム（例えばsha256）で計算を開始するための準備を行い、その計算の状態を管理する特別なオブジェクトであるHashContextを戻り値として返します。

引数$algoには、使用したいハッシュアルゴリズムの名前を文字列で指定します。オプションの引数$flagsと$keyは、特定のハッシュモード（HMACなど）で使用されますが、通常の段階的ハッシュ計算ではデフォルト値（0と空文字列）で問題ありません。

サンプルコードでは、まずhash_init('sha256')でSHA256アルゴリズムによるハッシュ計算を初期化し、HashContextオブジェクトを取得しています。このHashContextは、その後の処理でhash_update関数に渡されます。hash_update関数を複数回呼び出すことで、$dataPart1や$dataPart2のような異なるデータを逐次的にハッシュコンテキストに追加（更新）できます。最後にhash_final関数を呼び出すことで、これまでにhash_updateで追加された全てのデータから最終的なハッシュ値が計算されます。この一連の処理は、大きなファイルを一度にメモリに読み込まずにハッシュ化する際や、データがストリームとして段階的に供給される場合に非常に有効です。