# sha1

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

sha1 — 计算字符串的 sha1 散列值

Warning

It is not recommended to use this function to secure passwords, due to the fast nature of this hashing algorithm. See the Password Hashing FAQ for details and best practices.

### 说明

sha1 ( string `$str` [, bool `$raw_output` = false ] ) : string

利用» 美国安全散列算法 1 计算字符串的 sha1 散列值。

### 参数

`str`

  输入字符串。

`raw_output`

  如果可选的 `raw_output` 参数被设置为 `TRUE`， 那么 sha1 摘要将以 20 字符长度的原始格式返回， 否则返回值是一个 40 字符长度的十六进制数字。

### 返回值

返回 sha1 散列值字符串。

### 范例

Example #1 sha1() 范例

    <?php
    $str = 'apple';

    if (sha1($str) === 'd0be2dc421be4fcd0172e5afceea3970e2f3d940') {
        echo "Would you like a green or red apple?";
    }
    ?>

### 参见

- sha1_file() - 计算文件的 sha1 散列值
- crc32() - 计算一个字符串的 crc32 多项式
- md5() - 计算字符串的 MD5 散列值
- hash() - 生成哈希值 （消息摘要）
- crypt() - 单向字符串散列
- password_hash() - 创建密码的散列（hash）