# sha1_file

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

sha1_file — 计算文件的 sha1 散列值

### 说明

sha1_file ( string `$filename` [, bool `$raw_output` = `FALSE` ] ) : string

利用» 美国安全散列算法 1，计算并返回由 `filename` 指定的文件的 sha1 散列值。该散列值是一个 40 字符长度的十六进制数字。

### 参数

`filename`

  要散列的文件的文件名。

`raw_output`

  如果被设置为 `TRUE`，sha1 摘要将以 20 字符长度的原始格式返回。

### 返回值

成功返回一个字符串，否则返回 `FALSE`。

### 范例

Example #1 sha1_file() 范例

    <?php
    foreach(glob('/home/Kalle/myproject/*.php') as $ent)
    {
        if(is_dir($ent))
        {
            continue;
        }

        echo $ent . ' (SHA1: ' . sha1_file($ent) . ')', PHP_EOL;
    }
    ?>

### 更新日志

版本 | 说明
--- | ---
5.1.0 | 改变函数以使用流 API。这意味着可以使用包装器，比如 sha1_file('http://example.com/..')。

### 参见

- sha1() - 计算字符串的 sha1 散列值
- md5_file() - 计算指定文件的 MD5 散列值
- crc32() - 计算一个字符串的 crc32 多项式