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

Copy
1<?php
2
3/**
4 * 与えられた文字列のSHA-384とSHA-256ハッシュを生成し、表示します。
5 *
6 * MHASH_SHA384定数はmhash拡張に属していましたが、mhash拡張はPHP 7.0で削除されました。
7 * PHP 8では、より推奨されるhash関数を使用してSHA-384やSHA-256ハッシュを生成します。
8 * この関数は、hash関数を用いてSHA-384とSHA-256のハッシュ生成を示します。
9 *
10 * @param string $data ハッシュ化する元の文字列。
11 * @return void
12 */
13function generateShaHashes(string $data): void
14{
15    // SHA-384ハッシュを生成
16    // PHP 8では、mhash_hmacなどのmhash関数は利用できません。
17    // 代わりに、hash()関数にアルゴリズム名 'sha384' を渡して使用します。
18    $sha384Hash = hash('sha384', $data);
19    echo "元の文字列: \"{$data}\"\n";
20    echo "SHA-384ハッシュ: {$sha384Hash}\n";
21
22    // SHA-256ハッシュを生成
23    // hash()関数にアルゴリズム名 'sha256' を渡して使用します。
24    $sha256Hash = hash('sha256', $data);
25    echo "SHA-256ハッシュ: {$sha256Hash}\n";
26}
27
28// サンプルデータの定義
29$sampleData = "Hello, System Engineer Beginner!";
30
31// 関数を呼び出してハッシュを生成し表示
32generateShaHashes($sampleData);
33
34echo "\n--- 別の例 ---\n";
35$anotherData = "This is a test string for hashing.";
36generateShaHashes($anotherData);
37
38?>

このコードは、PHP 8において文字列のSHA-384およびSHA-256ハッシュを生成する方法を示しています。PHPの以前のバージョンにはMHASH_SHA384という定数が存在し、これはmhash拡張の一部でしたが、このmhash拡張はPHP 7.0で削除されました。そのため、現在のPHP 8環境ではMHASH_SHA384定数を直接利用することはできません。

代わりに、PHP 8では推奨されるhash()関数を使用して、様々なハッシュアルゴリズムを利用します。この関数は、第一引数にハッシュアルゴリズムの名前（例えば'sha384'や'sha256'）を文字列で、第二引数にハッシュ化したい元の文字列を受け取ります。

提供されたgenerateShaHashes関数は、引数$dataに指定された文字列を受け取り、それをhash()関数に渡してSHA-384とSHA-256のハッシュ値をそれぞれ計算します。計算されたハッシュ値は、元の文字列とともに画面に出力されます。

関数の引数$dataは、ハッシュ化する元の文字列（string型）を渡すために使用されます。関数の戻り値はvoidとなっており、これは関数が計算結果を直接呼び出し元に返すのではなく、処理した結果を画面に表示するだけで、何も値を返さないことを意味します。このサンプルコードは、PHP 8における暗号学的ハッシュ関数の基本的な利用方法を初心者の方にもわかりやすく示しています。

Copy
1<?php
2
3/**
4 * 指定された文字列のSHA384およびSHA512ハッシュを計算します。
5 *
6 * MHASH_SHA384のような定数はmhash拡張がPHP 7.1で削除されたため、
7 * PHP 8では直接利用できません。
8 * 代わりに、PHP 8ではhash()関数を使用してこれらのハッシュアルゴリズムを適用します。
9 *
10 * @param string $data ハッシュ化する元の文字列データ
11 * @return array 連想配列。キー 'sha384' にSHA384ハッシュ、'sha512' にSHA512ハッシュが格納されます。
12 */
13function generateShaHashes(string $data): array
14{
15    // SHA384ハッシュを計算します。
16    // 'sha384' はhash()関数がサポートするアルゴリズム名です。
17    $sha384Hash = hash('sha384', $data);
18
19    // SHA512ハッシュを計算します。
20    // 'sha512' もhash()関数がサポートするアルゴリズム名です。
21    $sha512Hash = hash('sha512', $data);
22
23    return [
24        'sha384' => $sha384Hash,
25        'sha512' => $sha512Hash,
26    ];
27}
28
29// --- 単体で動作可能なコードの例 ---
30
31// ハッシュ化するサンプルデータを定義します。
32$sampleData = 'Hello, system engineers!';
33
34// generateShaHashes関数を呼び出して、SHA384とSHA512のハッシュ値を取得します。
35$generatedHashes = generateShaHashes($sampleData);
36
37// 生成されたハッシュ値を出力します。
38echo "元のデータ: " . $sampleData . PHP_EOL;
39echo "SHA384ハッシュ: " . $generatedHashes['sha384'] . PHP_EOL;
40echo "SHA512ハッシュ: " . $generatedHashes['sha512'] . PHP_EOL;
41
42?>

PHP 8では、データのハッシュ値を計算する際に、以前使用されていたMHASH_SHA384のような定数は利用できません。これらの定数はPHP 7.1で削除されたため、PHP 8では代わりに、より汎用的なhash()関数を使用することが推奨されています。

このサンプルコードは、PHP 8でのハッシュ計算方法を示すものです。generateShaHashes関数は、引数として指定された元の文字列データ（$data）を受け取り、それに対してSHA384とSHA512という2種類のハッシュアルゴリズムを適用します。具体的には、hash('sha384', $data)とhash('sha512', $data)のように、hash()関数の第一引数にアルゴリズム名を指定することで、それぞれのハッシュ値を計算しています。

この関数は、計算されたSHA384とSHA512のハッシュ値を格納した連想配列を戻り値として返します。これにより、セキュリティ目的でのデータの一意性確認や、パスワードのような機密情報の安全な取り扱いなどに必要なハッシュ値を簡単に生成することが可能です。