highlight_file(3) [php man page]

HIGHLIGHT_FILE(3)							 1							 HIGHLIGHT_FILE(3)

highlight_file - Syntax highlighting of a file

SYNOPSIS

       mixed highlight_file (string  $filename, [bool  $return = false])

DESCRIPTION

	Prints	out  or  returns  a  syntax highlighted version of the code contained in $filename using the colors defined in the built-in syntax
       highlighter for PHP.

	Many servers are configured to automatically highlight files with a phps extension. For example, example.phps when viewed  will  show  the
       syntax highlighted source of the file. To enable this, add this line to the httpd.conf:

       AddType application/x-httpd-php-source .phps

PARAMETERS

	      o $filename
		- Path to the PHP file to be highlighted.

	      o $return
		- Set this parameter to TRUE to make this function return the highlighted code.

RETURN VALUES

	If $return is set to TRUE, returns the highlighted code as a string instead of printing it out. Otherwise, it will return TRUE on success,
       FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 4.2.1	|						    |
       |	|						    |
       |	|  This function is now also affected by  safe_mode |
       |	| and open_basedir.				    |
       |	|						    |
       +--------+---------------------------------------------------+
NOTES

       Caution

	       Care should be taken when using the highlight_file(3) function to make sure that you do not inadvertently reveal sensitive informa-
	      tion such as passwords or any other type of information that might create a potential security risk.

       Note

	      When the $return parameter is used, this function uses internal output buffering so it cannot be used inside an ob_start(3) callback
	      function.

SEE ALSO

       highlight_string(3), Highlighting INI directives.

PHP Documentation Group 													 HIGHLIGHT_FILE(3)

ARRAY_SEARCH(3) 							 1							   ARRAY_SEARCH(3)

array_search - Searches the array for a given value and returns the corresponding key if successful

SYNOPSIS

       mixed array_search (mixed  $needle, array  $haystack, [bool  $strict = false])

DESCRIPTION

	Searches $haystack for $needle.

PARAMETERS

	      o $needle
		- The searched value.

	      Note

		      If $needle is a string, the comparison is done in a case-sensitive manner.

	      o $haystack
		- The array.

	      o $strict
		-  If  the  third  parameter  $strict  is  set to TRUE then the array_search(3) function will search for identical elements in the
		$haystack. This means it will also check the types of the $needle in the $haystack, and objects must be the same instance.

RETURN VALUES

	Returns the key for $needle if it is found in the array, FALSE otherwise.

	If $needle is found in $haystack more than once, the first matching key is returned. To return the  keys  for  all  matching  values,  use
       array_keys(3) with the optional $search_value parameter instead.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  As with all internal PHP functions as of  5.3.0, |
       |	| array_search(3)  returns  NULL if invalid parame- |
       |	| ters are passed to it.			    |
       |	|						    |
       | 4.2.0	|						    |
       |	|						    |
       |	|  Prior to PHP 4.2.0, array_search(3) returns NULL |
       |	| on failure instead of FALSE.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      array_search(3) example

	      <?php
	      $array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');

	      $key = array_search('green', $array); // $key = 2;
	      $key = array_search('red', $array);   // $key = 1;
	      ?>

SEE ALSO

       array_keys(3), array_values(3), array_key_exists(3), in_array(3).

PHP Documentation Group 													   ARRAY_SEARCH(3)