hash(3) [php man page]

HASH(3) 								 1								   HASH(3)

hash - Generate a hash value (message digest)

SYNOPSIS

       string hash (string  $algo, string  $data, [bool  $raw_output = false])

DESCRIPTION

PARAMETERS

	      o $algo
		- Name of selected hashing algorithm (e.g. "md5", "sha256", "haval160,4", etc..)

	      o $data
		- Message to be hashed.

	      o $raw_output
		- When set to TRUE, outputs raw binary data.  FALSE outputs lowercase hexits.

RETURN VALUES

	Returns  a  string  containing	the  calculated message digest as lowercase hexits unless $raw_output is set to true in which case the raw
       binary representation of the message digest is returned.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.4.0	|						    |
       |	|						    |
       |	| The tiger  algorithm	now  uses  big-endian  byte |
       |	| ordering. See also example below.		    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      A hash(3) example

	      <?php
	      echo hash('ripemd160', 'The quick brown fox jumped over the lazy dog.');
	      ?>

	      The above example will output:

	      ec457d0a974c48d5685a7efa03d137dc8bbde7e3

       Example #2

	      Calculate pre PHP-5.4 tiger hashes with PHP-5.4 and higher

	      <?php
	      function old_tiger($data = "", $width=192, $rounds = 3) {
		  return substr(
		      implode(
			  array_map(
			      function ($h) {
				  return str_pad(bin2hex(strrev($h)), 16, "0");
			      },
			      str_split(hash("tiger192,$rounds", $data, true), 8)
			  )
		      ),
		      0, 48-(192-$width)/4
		  );
	      }
	      echo hash('tiger192,3', 'a-string'), PHP_EOL;
	      echo old_tiger('a-string'), PHP_EOL;
	      ?>

	      Output of the above example in PHP 5.3:

	      146a7492719b3564094efe7abbd40a7416fd900179d02773
	      64359b7192746a14740ad4bb7afe4e097327d0790190fd16

	      Output of the above example in PHP 5.4:

	      64359b7192746a14740ad4bb7afe4e097327d0790190fd16
	      146a7492719b3564094efe7abbd40a7416fd900179d02773

SEE ALSO

       hash_file(3), hash_hmac(3), hash_init(3), md5(3), sha1(3).

PHP Documentation Group 														   HASH(3)

Check Out this Related Man Page

DIRNAME(3)								 1								DIRNAME(3)

dirname - Returns parent directory's path

SYNOPSIS

       string dirname (string  $path)

DESCRIPTION

	Given a string containing the path of a file or directory, this function will return the parent directory's path.

PARAMETERS

	      o $path
		-  A path.  On Windows, both slash ( /) and backslash ( ) are used as directory separator character. In other environments, it is
		the forward slash ( /).

RETURN VALUES

	Returns the path of the parent directory. If there are no slashes in $path, a dot (' .') is returned, indicating  the  current	directory.
       Otherwise, the returned string is $path with any trailing /component removed.

CHANGELOG

       +--------+-------------------------------+
       |Version |				|
       |	|				|
       |	|	   Description		|
       |	|				|
       +--------+-------------------------------+
       | 5.0.0	|				|
       |	|				|
       |	| dirname(3) is now binary safe |
       |	|				|
       +--------+-------------------------------+
EXAMPLES

       Example #1

	      dirname(3) example

	      <?php
	      echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
	      echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (or  on Windows)
	      echo "3) " . dirname("."); // 3) .
	      ?>

NOTES

       Note

	      dirname(3) operates naively on the input string, and is not aware of the actual filesystem, or path components such as " ..".

       Note

	      dirname(3)  is locale aware, so for it to see the correct directory name with multibyte character paths, the matching locale must be
	      set using the setlocale(3) function.

       Note

	       Since PHP 4.3.0, you will often get a slash or a dot back from dirname(3) in situations where the older	functionality  would  have
	      given you the empty string.

	Check the following change example:

       <?php

       //before PHP 4.3.0
       dirname('c:/'); // returned '.'

       //after PHP 4.3.0
       dirname('c:/x'); // returns 'c:'
       dirname('c:/Temp/x'); // returns 'c:/Temp'
       dirname('/x'); // returns ''

       ?>

SEE ALSO

       basename(3), pathinfo(3), realpath(3).

PHP Documentation Group 														DIRNAME(3)

Linux and UNIX Man Pages

hash(3) [php man page]

Check Out this Related Man Page