【PHP8.x】MHASH_SHA224定数の使い方

Copy
1<?php
2
3/**
4 * 指定された文字列のSHA256ハッシュを生成します。
5 *
6 * SHA256は、データの完全性を確認するためによく使用される暗号学的ハッシュ関数です。
7 * 同じ入力からは常に同じハッシュ値が生成され、わずかな変更でもハッシュ値は大きく変わります。
8 * これは、パスワードの保存（直接保存せずハッシュを保存）、ファイルの改ざん検知などに利用されます。
9 *
10 * MHASH_SHA224 のような定数は、PHP 7.0 で削除された mhash 拡張のものであり、
11 * PHP 8では使用できません。代わりに、hash() 関数を使用するのが現代のPHPにおける標準的な方法です。
12 *
13 * @param string $data ハッシュ化する入力文字列
14 * @return string 生成されたSHA256ハッシュ文字列
15 */
16function generateSha256Hash(string $data): string
17{
18    // 'sha256' アルゴリズムを使用してデータをハッシュ化します。
19    // PHP 8では、hash() 関数が推奨されるハッシュ生成方法です。
20    return hash('sha256', $data);
21}
22
23// --- サンプルコードの実行例 ---
24
25// ハッシュ化する元のデータを定義
26$originalData1 = "Hello, PHP!";
27$originalData2 = "Hello, php!"; // わずかに異なるデータ
28$originalData3 = "Hello, PHP!"; // originalData1 と同じデータ
29
30// SHA256ハッシュを生成し、結果を出力
31echo "元のデータ1: \"" . $originalData1 . "\"\n";
32echo "SHA256ハッシュ1: " . generateSha256Hash($originalData1) . "\n\n";
33
34echo "元のデータ2: \"" . $originalData2 . "\"\n";
35echo "SHA256ハッシュ2: " . generateSha256Hash($originalData2) . "\n\n";
36
37echo "元のデータ3: \"" . $originalData3 . "\"\n";
38echo "SHA256ハッシュ3: " . generateSha256Hash($originalData3) . "\n";
39
40?>

このサンプルコードは、PHP 8で文字列のSHA256ハッシュを生成する方法を示しています。SHA256は、データの完全性を確認するためや、ファイルの改ざんを検知するためによく使用される暗号学的ハッシュ関数です。同じ入力データからは常に同じハッシュ値が生成されますが、元のデータがわずかに変更されるだけでも、全く異なるハッシュ値が出力されるのが大きな特徴です。これは、パスワードを直接保存せずハッシュ値として保存する際などにも活用されます。

提供されたリファレンス情報のMHASH_SHA224という定数は、PHP 7.0で削除されたmhash拡張に属するため、PHP 8では利用できません。現代のPHPでハッシュを生成する際には、サンプルコードで使用されているhash()関数が標準的かつ推奨される方法です。

generateSha256Hash関数は、ハッシュ化したい文字列を引数$dataとして受け取ります。関数内部では、hash('sha256', $data)という形式でsha256アルゴリズムを指定し、入力文字列のハッシュを計算しています。そして、計算されたSHA256ハッシュ値の文字列を戻り値として返します。この関数を利用することで、簡単にデータのハッシュ値を生成し、その特性を理解できます。

Copy
1<?php
2
3/**
4 * システムエンジニアを目指す初心者向けに、PHPでハッシュを生成する方法を示す関数です。
5 *
6 * この関数では、キーワードにあるSHA-1アルゴリズムと、
7 * リファレンス情報にあるMHASH_SHA224定数が示すSHA-224アルゴリズムを例に、
8 * PHP 8で推奨されるhash()関数を使用して文字列のハッシュ値を生成し、表示します。
9 *
10 * MHASH_SHA224定数自体はPHP 7.1以降で削除されたmhash拡張に属しており、
11 * PHP 8では直接使用できません。しかし、hash()関数に 'sha224' という文字列を
12 * アルゴリズム名として渡すことで、同等のSHA-224ハッシュを生成できます。
13 */
14function demonstrateHashGenerationForBeginner(): void
15{
16    // ハッシュ化する元の文字列を定義します。
17    $originalString = "Welcome to PHP Hashing!";
18
19    echo "--- PHP Hash Generation Examples ---\n\n";
20    echo "Original String: \"{$originalString}\"\n\n";
21
22    // SHA-1ハッシュを生成します。
23    // これはキーワード「sha1」に直接関連します。
24    $sha1Hash = hash('sha1', $originalString);
25    echo "SHA-1 Hash:      {$sha1Hash}\n";
26
27    // SHA-224ハッシュを生成します。
28    // これはリファレンス情報「MHASH_SHA224」が示すアルゴリズムです。
29    $sha224Hash = hash('sha224', $originalString);
30    echo "SHA-224 Hash:    {$sha224Hash}\n";
31
32    echo "\n------------------------------------\n";
33}
34
35// 上記のハッシュ生成デモ関数を実行します。
36demonstrateHashGenerationForBeginner();

このサンプルコードは、システムエンジニアを目指す初心者の皆様に向けて、PHP 8で文字列のハッシュ値を生成する方法を簡潔に示しています。ハッシュとは、元のデータから固定長の短い値を生成する技術で、データの同一性検証やパスワードの保存など、セキュリティ分野で広く利用されます。

コードでは、PHP 8で推奨されるhash()関数を使用しています。この関数は、第一引数にハッシュ化に使用するアルゴリズム名（例えば'sha1'や'sha224'のような文字列）、第二引数にハッシュ化したい元の文字列を受け取ります。そして、戻り値として指定されたアルゴリズムで計算されたハッシュ値の文字列を返します。

リファレンス情報にあるMHASH_SHA224は、かつてPHPのmhash拡張で使用されたSHA-224アルゴリズムを指す定数でしたが、このmhash拡張はPHP 7.1以降で削除されたため、PHP 8では直接使用できません。しかし、サンプルコードが示すように、hash()関数にアルゴリズム名を文字列として'sha224'と渡すことで、MHASH_SHA224が示していたのと同じSHA-224形式のハッシュを問題なく生成できます。

具体的には、"Welcome to PHP Hashing!"という文字列を元のデータとして、まずキーワードにあるSHA-1アルゴリズムでハッシュを生成し、次にSHA-224アルゴリズムでハッシュを生成して、それぞれの結果を表示しています。これにより、PHP 8で多様なアルゴリズムを用いたハッシュ生成の基本的な手順を学ぶことができます。