PHPのmd5_file()関数の使い方を徹底解説！ファイルのMD5ハッシュ値を取得する方法

md5_file()関数とは

PHPのmd5_file()関数は、指定されたファイルのMD5ハッシュ値を計算するために使用されます。ファイルの内容全体を対象にハッシュ値を生成するため、ファイルの改ざん検知やデータの整合性確認などに活用できます。

MD5アルゴリズムとは

MD5メッセージダイジェストアルゴリズムは、任意の長さのメッセージを入力として受け取り、128ビットの「フィンガープリント（指紋）」または「メッセージダイジェスト」と呼ばれる出力を生成します。MD5はデジタル署名アプリケーション向けに設計されたアルゴリズムで、RSAなどの公開鍵暗号方式において、大きなファイルを秘密鍵で暗号化する前に安全に「圧縮」する必要がある場面で利用されてきました。

※参考：RFC 1321 - The MD5 Message-Digest Algorithmより

なお、MD5は現在では暗号学的な安全性に問題が指摘されており、セキュリティが重要な用途にはSHA-256などより強力なハッシュ関数の使用が推奨されています。ファイルの整合性チェックなど、セキュリティ要件が低い場面でmd5_file()関数を活用するとよいでしょう。

構文

md5_file(file_name, raw)

パラメータ

• file_name − MD5ハッシュを計算する対象のファイルを指定します。

• raw − 真偽値（Boolean）を指定します。

  TRUE − 16文字の生バイナリ形式で出力されます。
  FALSE − デフォルト値。32文字の16進数形式で出力されます。

戻り値

md5_file()関数は、処理が成功した場合にはハッシュ値の文字列を返し、失敗した場合にはFALSEを返します。

使用例

以下にmd5_file()関数の使用例を示します。

<?php
   $file = "Md5.txt";
   $md5file = md5_file($file);
   echo $md5file;
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

1e5gbjhwbdk3enkjnd9bkjbw82kjbs

まとめ

md5_file()関数を使うことで、ファイルの内容から簡単にMD5ハッシュ値を取得できます。ファイルのダウンロード検証や重複ファイルの検出など、さまざまな場面で役立つ関数です。ただし、セキュリティ用途には適さない点に注意し、目的に応じて適切なハッシュ関数を選択しましょう。