# sha1

(PHP 4 >= 4.3.0, PHP 5, PECL hash:1.1-1.3)

sha1 — Calculate the sha1 hash of a string

### Description

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

Calculates the sha1 hash of `str` using the » US Secure Hash Algorithm 1,

### Parameters

`str`

  The input string.

`raw_output`

  If the optional `raw_output` is set to `TRUE`, then the sha1 digest is instead returned in raw binary format with a length of 20, otherwise the returned value is a 40-character hexadecimal number. Defaults to `FALSE`.

### Return Values

Returns the sha1 hash as a string.

### ChangeLog

Version | Description
--- | ---
5.0.0 | The `raw_output` parameter was added.

### Examples

Example#1 A sha1() example

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

### See Also

- sha1_file()
- crc32()
- md5()