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

Copy
1<?php
2
3/**
4 * MHASH_RIPEMD320 定数を使用してデータをRIPEMD320アルゴリズムでハッシュ化する例を示します。
5 *
6 * このコードは、PHPのmhash拡張機能における定数の基本的な使い方を
7 * システムエンジニアを目指す初心者向けに示します。
8 */
9function hashWithRipemd320(): void
10{
11    // MHASH_RIPEMD320 定数が利用可能か確認します。
12    // この定数はmhash拡張機能が提供します。
13    if (!defined('MHASH_RIPEMD320')) {
14        echo "エラー: MHASH_RIPEMD320 定数が定義されていません。\n";
15        echo "mhash 拡張機能が有効になっていることを確認してください。\n";
16        return;
17    }
18
19    $originalData = "Hello, PHP beginners! This is a test string for RIPEMD320 hashing.";
20
21    // MHASH_RIPEMD320 定数でRIPEMD320アルゴリズムを指定し、データをハッシュ化します。
22    // mhash() 関数はバイナリ形式のハッシュ値を返します。
23    $ripemd320Hash = mhash(MHASH_RIPEMD320, $originalData);
24
25    // ハッシュ値はバイナリなので、通常は16進数形式に変換して表示します。
26    if ($ripemd320Hash !== false) {
27        echo "元のデータ: " . $originalData . "\n";
28        echo "RIPEMD320 ハッシュ (16進数): " . bin2hex($ripemd320Hash) . "\n";
29    } else {
30        echo "RIPEMD320 ハッシュの生成に失敗しました。\n";
31    }
32}
33
34// 関数を実行します。
35hashWithRipemd320();

MHASH_RIPEMD320は、PHPのmhash拡張機能が提供する特別な定数です。この定数は、データを暗号学的なハッシュアルゴリズムの一つであるRIPEMD320でハッシュ化する際に、そのアルゴリズムを指定するために使用されます。mhash拡張機能は、さまざまなハッシュアルゴリズムをPHPで利用できるようにする機能です。

サンプルコードでは、まずdefined()関数を使ってMHASH_RIPEMD320定数が利用可能かを確認しています。これは、mhash拡張機能がPHPに正しくインストールされ、有効になっているかをチェックする基本的な手順です。もし拡張機能が有効でない場合、この定数は未定義となりエラーメッセージが表示されます。

定数が定義されていることを確認した後、mhash()関数にMHASH_RIPEMD320定数とハッシュ化したい文字列データ（$originalData）を渡しています。ここでMHASH_RIPEMD320が第一引数として渡されることで、mhash()関数はRIPEMD320アルゴリズムを用いてデータのハッシュ値を計算します。mhash()関数は処理結果としてバイナリ形式のハッシュ値を返します。

得られたバイナリ形式のハッシュ値は、そのままでは読みにくいため、bin2hex()関数を使用して人間が読みやすい16進数形式の文字列に変換してから表示しています。MHASH_RIPEMD320定数自体に引数や戻り値はありませんが、mhash()関数に渡すことでハッシュ処理のアルゴリズムを指定する重要な役割を担っています。

Copy
1<?php
2
3/**
4 * PHP 8 で AES-128-CBC 暗号化と復号化を行うためのユーティリティクラス。
5 *
6 * 参照されたキーワード `mcrypt_rijndael_128` は AES-128 暗号化を指しますが、
7 * `mcrypt` 拡張機能は PHP 8 では削除されています。代わりに OpenSSL 拡張機能を使用します。
8 * また、`MHASH_RIPEMD320` 定数を含む `mhash` 拡張機能も PHP 8 では利用できません。
9 */
10class Aes128Cipher
11{
12    private const METHOD = 'aes-128-cbc'; // 使用する暗号化方式 (AES-128 の CBC モード)
13    private const KEY_LENGTH_BYTES = 16;   // AES-128 のキー長は 16 バイト (128 ビット)
14    private const IV_LENGTH_BYTES  = 16;    // CBC モードの IV 長はブロックサイズと同じ (16 バイト)
15
16    /**
17     * 指定されたプレーンテキストを AES-128-CBC で暗号化します。
18     *
19     * @param string $plaintext 暗号化する平文。
20     * @param string $key 暗号化に使用するキー (厳密に16バイト)。
21     * @return string 暗号化されたデータ (Base64 エンコード済み)。
22     * @throws Exception キーまたはIVの生成に問題がある場合、あるいは暗号化に失敗した場合。
23     */
24    public static function encrypt(string $plaintext, string $key): string
25    {
26        // キーの長さを確認
27        if (strlen($key) !== self::KEY_LENGTH_BYTES) {
28            throw new Exception('キーは ' . self::KEY_LENGTH_BYTES . ' バイト長である必要があります。');
29        }
30
31        // IV (Initialization Vector) を安全なランダムバイトで生成
32        $iv = openssl_random_pseudo_bytes(self::IV_LENGTH_BYTES);
33        if ($iv === false || strlen($iv) !== self::IV_LENGTH_BYTES) {
34            throw new Exception('IV の生成に失敗しました。');
35        }
36
37        // データを暗号化
38        // OPENSSL_RAW_DATA フラグは、生データを返却することを指定
39        $ciphertext = openssl_encrypt($plaintext, self::METHOD, $key, OPENSSL_RAW_DATA, $iv);
40
41        if ($ciphertext === false) {
42            throw new Exception('暗号化に失敗しました。');
43        }
44
45        // IVと暗号文を結合し、Base64エンコードして返す
46        // IVを暗号文と結合することで、復号時に同じIVを使用できるようにする
47        return base64_encode($iv . $ciphertext);
48    }
49
50    /**
51     * AES-128-CBC で暗号化されたデータを復号化します。
52     *
53     * @param string $encryptedData 暗号化されたデータ (Base64 エンコード済み)。
54     * @param string $key 復号化に使用するキー (厳密に16バイト)。
55     * @return string 復号化された平文。
56     * @throws Exception データが不正な形式の場合、または復号化に失敗した場合。
57     */
58    public static function decrypt(string $encryptedData, string $key): string
59    {
60        // キーの長さを確認
61        if (strlen($key) !== self::KEY_LENGTH_BYTES) {
62            throw new Exception('キーは ' . self::KEY_LENGTH_BYTES . ' バイト長である必要があります。');
63        }
64
65        // Base64デコード
66        $decodedData = base64_decode($encryptedData, true);
67        if ($decodedData === false) {
68            throw new Exception('不正な Base64 エンコードデータです。');
69        }
70
71        // 結合されたデータからIVと暗号文を分離
72        if (strlen($decodedData) < self::IV_LENGTH_BYTES) {
73            throw new Exception('暗号化データがIVを含むには短すぎます。');
74        }
75        $iv = substr($decodedData, 0, self::IV_LENGTH_BYTES);
76        $ciphertext = substr($decodedData, self::IV_LENGTH_BYTES);
77
78        // データを復号化
79        $plaintext = openssl_decrypt($ciphertext, self::METHOD, $key, OPENSSL_RAW_DATA, $iv);
80
81        if ($plaintext === false) {
82            throw new Exception('復号化に失敗しました。');
83        }
84
85        return $plaintext;
86    }
87}
88
89// --- 単体で動作可能なサンプル利用例 ---
90try {
91    // 16バイトの暗号化キーを安全な方法で生成
92    // 本番環境では、このキーは安全に生成・管理される必要があります。
93    $encryptionKey = openssl_random_pseudo_bytes(Aes128Cipher::KEY_LENGTH_BYTES);
94    if ($encryptionKey === false) {
95        throw new Exception('ランダムキーの生成に失敗しました。OpenSSL拡張機能が有効か確認してください。');
96    }
97
98    $originalText = "システムエンジニアを目指す皆さん、PHPの暗号化の基本を学びましょう！";
99
100    echo "元のテキスト: " . $originalText . PHP_EOL;
101
102    // テキストを暗号化
103    $encrypted = Aes128Cipher::encrypt($originalText, $encryptionKey);
104    echo "暗号化されたデータ (Base64): " . $encrypted . PHP_EOL;
105
106    // 暗号化されたデータを復号化
107    $decrypted = Aes128Cipher::decrypt($encrypted, $encryptionKey);
108    echo "復号化されたテキスト: " . $decrypted . PHP_EOL;
109
110    // 元のテキストと復号化されたテキストが一致するか確認
111    if ($originalText === $decrypted) {
112        echo "結果: 暗号化と復号化は成功しました。データは完全に一致します。" . PHP_EOL;
113    } else {
114        echo "結果: エラー - 暗号化と復号化でデータが一致しません。" . PHP_EOL;
115    }
116
117} catch (Exception $e) {
118    echo "エラーが発生しました: " . $e->getMessage() . PHP_EOL;
119}

このサンプルコードは、PHP 8で安全なデータの暗号化と復号化を行うための Aes128Cipher クラスです。PHP 8では、mcrypt 拡張機能や mhash 拡張機能（MHASH_RIPEMD320 などを含む）が利用できなくなりましたので、代わりに標準で利用可能なOpenSSL拡張機能を用いています。

Aes128Cipher クラスは、AES-128-CBC という暗号化方式でデータを扱います。この方式では、16バイト（128ビット）の共通鍵を使用し、暗号化のたびにユニークな「初期化ベクトル（IV）」を生成して暗号の安全性を高めています。

encrypt メソッドは、与えられた平文を暗号化します。引数として暗号化したい文字列 $plaintext と、厳密に16バイト長の暗号化キー $key を渡します。このメソッドは、安全に生成されたIVと暗号化されたデータを結合し、それをBase64エンコードした文字列を戻り値として返します。

decrypt メソッドは、encrypt メソッドで暗号化されたデータを復号化します。引数として、Base64エンコードされた暗号化済みデータ $encryptedData と、暗号化時と同じ厳密に16バイト長の暗号化キー $key を渡します。このメソッドは、復号化に成功すると元の平文の文字列を戻り値として返します。

これらのメソッドは、openssl_random_pseudo_bytes や openssl_encrypt、openssl_decrypt といったOpenSSLの関数を活用し、データの機密性を保護する堅牢な暗号化処理を実現しています。