C:/usr/local/lib/php/blueshoes-4.2/core/lang/Bs_Exception.class.phpAndrej Arn <andrej at blueshoes dot org>no dependencies here. please try to avoid dependencies.Emulate a Java exception, sort of...4.0.$id$blueshoes.organ error messagethe file name (full path), use __FILE__the line number, use __LINE__a unique error code with text info: db:26:not connectedthe weight of the exception (fatal?)example:return new Bs_Exception('not a valid usDatetime specified', __FILE__, __LINE__);Constructorcan be one of 'functionArgs', 'vars', 'objects'true on success, false if $key is not a known param. 'functionArgs' => array of vars that were passed to the function, get them with func_get_args(), see the example. 'vars' => associative array of some vars you want to pass along. 'objects' => array of some objects you want to pass along. note: if you want to pass the functionArgs, you cannot do it all in one line. it's not possible to use the function func_get_args() as function parameter :( see example. example for 'functionArgs': $funcArgs = func_get_args(); $success = $Obj->setStackParam('functionArgs', $funcArgs); example for 'vars': $success = $Obj->setStackParam('vars', array('myVar' => &$myVar)); example for 'objects': $success = $Obj->setStackParam('objects', array(&$this));Bs_Exception()stackTrace()an error messagean associative arraygets called from the constructor and from stackTrace(). returns a useful aArray that will be added to $this->stack.Bs_Exception()an error messagethe file name (full path), use __FILE__the line number, use __LINE__the weight of the exception (fatal?)what you want to do. see text.param $what options:'' => Default. trigger a warning.'log' => Log the exception.'alert' => Email this alert to the ppl in the alert list and log the exception.'echo' => Echo the exception to the screen. Use this only for debugging. please.'die' => Echo the exception to the screen and die. Use this only for debugging. please.'return' => Return the toHtml string of this exception.Dumps the stack to where you specify.this includes:HTTP_POST_VARS, HTTP_GET_VARS, HTTP_COOKIE_VARS, HTTP_SERVER_VARS,HTTP_ENV_VARS, HTTP_POST_FILES, a string of all declared classes,a varDump of our own settings array $APP, our own flat vars that are visible global,a varDump of our own flat arrays that are visible global (without $APP),theDon't use this for fun! It's expensive!If it has already been done for this instance, we don't do it again but just ignore the request.Grabs all information we can about the current state of the php file.Prepares the stack to spit it out.toString()Puts <pre></pre> around the string we grab from toString().@privateI wanted to make this class completly independant. but toString() and seedGlobals() need $Bs_String->varDump().String indicating the exception weight.The error code if one is set.The error text if one is set.Type of the error (if set). can be one of db, ...Holds the elements: ($stack[x]['element'])$stack[0] is when the error gets thrown, [1] for the first addToStack, ...timestamp => a us-style datetime that is created in this classmessage => a string error messagefile => the full file name with pathline => the line number in the filefunctionArgs => an array holding the arguements which were passes to the function where the error occured.vars => an associative array holding vars that were passed by param.objects => an array holding copies of objects that were passed by param.Array holding assotiative arrays of the params we get when an exception gets thrown or a stackTrace is done.Holds the elements: ($globals['element'])postVars => an assotiative array holding the vars we got from an http post.getVars => an assotiative array holding the vars we got from an http get.cookieVars => an assotiative array holding the cookie vars.serverVars => an assotiative array holding the server vars.envVars => an assotiative array holding the environment vars.postFiles => something holding the post files. dunno.appVars => string of the dumped array $APP. THIS MIGHT BE A SECURITY HOLE IF PASSWORDS GET WRITTEN OR SENT TO SOMEWHERE!!!globalVars => assotiative array of all not-system-vars.globalArrays => assotiative array of all not-system-arrays. the values are dumped.globalObjects => assotiative array (key is the object name) holding strings of the dumped objects. THIS MIGHT BE A SECURITY HOLE IF PASSWORDS ARE IN AN OBJECT AND GET WRITTEN OR SENT TO SOMEWHERE!!!declaredClasses => an array holding the class names of all defined classes. only set if weight='fatal'.if ($this->_weight == 'fatal') {$ret['declaredClasses'] = get_declared_classes();}@privateAssotiative array with things we got from $GLOBALS.4.0.$x$isexisexceptiontohtmlpersistunpersistbs_objectbbsetoutputbbawakebbisawakebbxmsgbbxfunctionstartbbxfunctionendbbxechobbxvarbbxvardumpbbforcetracebbbufferstartbbbuffergetbbbufferendflushbbbufferendcleanbs_object_versionBs_ObjectBs_Object