debug_print_backtrace(3) [php man page]

DEBUG_PRINT_BACKTRACE(3)						 1						  DEBUG_PRINT_BACKTRACE(3)

debug_print_backtrace - Prints a backtrace

SYNOPSIS

       void debug_print_backtrace ([int  $options], [int  $limit])

DESCRIPTION

       debug_print_backtrace(3) prints a PHP backtrace. It prints the function calls, included/required files and eval(3)ed stuff.

PARAMETERS

	      o $options
		- As of 5.3.6, this parameter is a bitmask for the following options:

	      debug_print_backtrace(3) options

	      +----------------------------+---------------------------------------------------+
	      |DEBUG_BACKTRACE_IGNORE_ARGS |						       |
	      | 			   |						       |
	      | 			   |  Whether  or  not	to  omit the "args" index, and |
	      | 			   | thus all the function/method arguments,  to  save |
	      | 			   | memory.					       |
	      | 			   |						       |
	      +----------------------------+---------------------------------------------------+
	      o $limit
		-  As of 5.4.0, this parameter can be used to limit the number of stack frames printed. By default ($limit= 0) it prints all stack
		frames.

RETURN VALUES

	No value is returned.

CHANGELOG

       +--------+-----------------------------------------+
       |Version |					  |
       |	|					  |
       |	|		Description		  |
       |	|					  |
       +--------+-----------------------------------------+
       | 5.4.0	|					  |
       |	|					  |
       |	|   Added the optional parameter $limit.  |
       |	|					  |
       | 5.3.6	|					  |
       |	|					  |
       |	|  Added the optional parameter $options. |
       |	|					  |
       +--------+-----------------------------------------+
EXAMPLES

       Example #1

	      debug_print_backtrace(3) example

	      <?php
	      // include.php file

	      function a() {
		  b();
	      }

	      function b() {
		  c();
	      }

	      function c(){
		  debug_print_backtrace();
	      }

	      a();

	      ?>

	      <?php
	      // test.php file
	      // this is the file you should run

	      include 'include.php';
	      ?>

	      The above example will output something similar to:

	      #0  c() called at [/tmp/include.php:10]
	      #1  b() called at [/tmp/include.php:6]
	      #2  a() called at [/tmp/include.php:17]
	      #3  include(/tmp/include.php) called at [/tmp/test.php:3]

SEE ALSO

       debug_backtrace(3).

PHP Documentation Group 												  DEBUG_PRINT_BACKTRACE(3)

PATHINFO(3)								 1							       PATHINFO(3)

pathinfo - Returns information about a file path

SYNOPSIS

       mixed pathinfo (string  $path, [int  $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME])

DESCRIPTION

       pathinfo(3) returns information about $path: either an associative array or a string, depending on $options.

PARAMETERS

	      o $path
		- The path to be parsed.

	      o $options
		-  If  present,  specifies  a  specific  element to be returned; one of PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION or
		PATHINFO_FILENAME. If $options is not specified, returns all available elements.

RETURN VALUES

	If the $options parameter is not passed, an associative array containing the following elements is returned: dirname, basename,  extension
       (if any), and filename.

       Note

	       If  the	$path has more than one extension, PATHINFO_EXTENSION returns only the last one and PATHINFO_FILENAME only strips the last
	      one. (see first example below).

       Note

	       If the $path does not have an extension, no extension element will be returned (see second example below).

	If $options is present, returns a string containing the requested element.

CHANGELOG

       +--------+--------------------------------------------+
       |Version |					     |
       |	|					     |
       |	|		 Description		     |
       |	|					     |
       +--------+--------------------------------------------+
       | 5.2.0	|					     |
       |	|					     |
       |	|  The PATHINFO_FILENAME constant was added. |
       |	|					     |
       +--------+--------------------------------------------+
EXAMPLES

       Example #1

	      pathinfo(3) Example

	      <?php
	      $path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');

	      echo $path_parts['dirname'], "
";
	      echo $path_parts['basename'], "
";
	      echo $path_parts['extension'], "
";
	      echo $path_parts['filename'], "
"; // since PHP 5.2.0
	      ?>

	      The above example will output:

	      /www/htdocs/inc
	      lib.inc.php
	      php
	      lib.inc

       Example #2

	      pathinfo(3) example showing difference between null and no extension

	      <?php
	      $path_parts = pathinfo('/path/emptyextension.');
	      var_dump($path_parts['extension']);

	      $path_parts = pathinfo('/path/noextension');
	      var_dump($path_parts['extension']);
	      ?>

	      The above example will output something similar to:

	      string(0) ""

	      Notice: Undefined index: extension in test.php on line 6
	      NULL

NOTES

       Note

	       For information on retrieving the current path info, read the section on  predefined reserved variables.

       Note

	      pathinfo(3) is locale aware, so for it to parse a path containing multibyte characters correctly, the matching locale  must  be  set
	      using the setlocale(3) function.

SEE ALSO

       dirname(3), basename(3), parse_url(3), realpath(3).

PHP Documentation Group 													       PATHINFO(3)