PHPのsha1_file()関数とは？使い方と構文をわかりやすく解説

sha1_file()関数とは

PHPのsha1_file()関数は、指定したファイルの内容からSHA-1ハッシュ値を計算するための関数です。ファイルの中身をすべて読み込んでハッシュ化するため、ダウンロードファイルの整合性チェックや、ファイルが改ざんされていないかの確認などに活用できます。

構文

sha1_file(file_name, raw)

パラメータ

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

• raw − 出力形式（16進数またはバイナリ）を指定するブール値です。

  • TRUE − 20文字の生バイナリ形式で出力します。

  • FALSE − 40文字の16進数形式で出力します（デフォルト）。

戻り値

sha1_file()関数は、処理が成功した場合はSHA-1ハッシュ値を文字列として返し、失敗した場合はFALSEを返します。

使用例

以下は、テキストファイル「sample.txt」のSHA-1ハッシュ値を取得して表示する例です。

<?php
   $s = "sample.txt";
   $sha1file = sha1_file($s);
   echo $sha1file;
?>

出力結果

上記のコードを実行すると、次のような40桁の16進数ハッシュ値が出力されます。

aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

補足：SHA-1の利用に関する注意点

SHA-1はかつて広く使われていたハッシュアルゴリズムですが、現在では衝突耐性の脆弱性が指摘されており、セキュリティ目的（署名や認証など）での新規採用は推奨されていません。単純なファイル比較や重複チェックには引き続き利用できますが、より高い安全性が必要な場面ではhash_file()関数を使ってSHA-256などの強度の高いアルゴリズムを選択することをおすすめします。