Class: I2CE

From IHRIS Wiki
Revision as of 21:24, 16 October 2009 by Litlfred (talk | contribs)

This article desrcibes the class I2CE It is contained in the module I2CE in the package I2CE

The class is defined in the file: lib/I2CE.php

This class mainly handles throwing errors from withing I2CE

@package I2CE

Variables

$site_initialized

True if the site has been initalized. @param static protected boolean $site_initalized

  • Type: static protected $site_initialized

$storage

$stored_messages

An array of the notice/warning messages received for this session

  • Type: static protected y $stored_messages

$errorType

  • Type: static public $errorType

$noticeErrors

  • Type: static public $noticeErrors

$warningErrors

  • Type: static public $warningErrors

$ignoreErrorsFromFilesMatching

  • Type: static public $ignoreErrorsFromFilesMatching

$ignoreErrors

  • Type: static public $ignoreErrors

$supress

  • Type: protected $supress

$site_warnings

Count of the number of erros and warings received when the site is not initialized @param static protected boolean $site_warnings

  • Type: static protected $site_warnings

$error_num

  • Type: protected $error_num

$errorHandler

Optional error handler callback.

  • Type: static private $errorHandler

$fileSearch

$trace_depth

. Defaults to 1. The number of previous methods to report when an error message is developed. Set to a negative number to report all, or 0 to report none.

  • Type: static protected nteger $trace_depth

Methods

allSystemsAreGoGo()

Get the system status. http://www.ursula1000.com/

  • Signature: static public function allSystemsAreGoGo($site_module_file,$check_time)
  • Returns: string 'gogo' means we are good. 'needs_installation' means we need to initialize. 'needs_upgrade'

Parameters:

  • $site_module_file
  • $check_time
    • Default Value: false

bringUpSystem()

  • Signature: static protected function bringUpSystem($site_module_file)

Parameters:

  • $site_module_file

dbConnect()

connect to the database

  • Signature: static protected function dbConnect($dsn)
  • Returns: true on sucess

Parameters:

getAccessedBaseURL()

Returns the base url from which the site was accessed. If no .htaccess is used, ths will include the index.php. If rewrites are used (via .htacces) this will no include the index.php. Point is... this is the base url from which the site was accessed, no questions asked. This of course assumes that you are now accessing the site via the command line

  • Signature: static public function getAccessedBaseURL($include_http)
  • Returns: string

Parameters:

  • $include_http
    • Default Value: true

getConfig()

Get the configuration storage @param string $instance. Defaults to 'default'

getFileSearch()

  • Signature: static public function getFileSearch()

getPrevMethod()

Parse the debug backtrace to get the method that raised the error.

  • Signature: static protected function getPrevMethod($debug,$start_depth,$trace_depth)
  • Returns: string

Parameters:

  • array $debug
  • $start_depth
    • Default Value: 1
  • $trace_depth
    • Default Value: 1

getRuntimeVariable()

Gets a runtime variable. For the CLI is the is from the environment which may be overwridden by a ---long-option from the command line. Otherwise it is set by SetEnv in a .htaccess file (which is stored in $_SERVER)

  • Signature: static public function getRuntimeVariable($var,$val)

Parameters:

  • string $var
    the variable name
  • string $val
    the defualt value; Defaults to the zero length string
    • Default Value:

handleError()

  • Signature: public function handleError($err_no,$err_string,$err_file,$err_line,$err_context)

Parameters:

  • $err_no
  • $err_string
  • $err_file
    • Default Value: false
  • $err_line
    • Default Value: false
  • $err_context
    • Default Value: false

hasWarnings()

See if there were any warning messages set before the site was initialized

  • Signature: static public function hasWarnings()
  • Returns: boolean

initialize()

Gets the core system going. then we use $db

  • Signature: static public function initialize($db_user,$db_pass,$db_name,$user_db,$site_module_file,$bring_up_system)
  • Returns: boolean. True on sucess

Parameters:

  • string $db_user
    the database user
  • string $db_pass
    the database user's password
  • string $db_name
    the name of the database all data is stored in
  • string $user_db
    the name of the database which contains the user table. If null
  • string $site_module_file
    the configttion file for the site module
  • $bring_up_system
    • Default Value: true

longExecution()

  • Signature: static public function longExecution($limits)

Parameters:

  • $limits
    • Default Value: null

pearError()

Check to see if a object is a pear error and raise an error if it is.

  • Signature: static public function pearError($obj,$message,$type,$redirect)

Parameters:

  • mixed $obj
  • string $message
    The error message to display if it is an error.
  • integer $type
    The error type to raise.
    • Default Value: E_USER_NOTICE
  • string $redirect
    The page to redirect to if this is a critical error.
    • Default Value: ""

popErrorHandler()

Pop an error handler off of the stack.

  • Signature: static public function popErrorHandler()
  • Returns: $callback the callback popped off the stack

pushErrorHandler()

Push an error handler onto the stack. @param $callback

  • Signature: static public function pushErrorHandler($callback)

Parameters:

  • $callback

raiseError()

Raise an error and redirect the user for any critical errors.

The default redirect will go to the home page for the site. @param string/mixed $message The error message. @global array

  • Signature: static public function raiseError($message,$type,$redirect)

Parameters:

  • $message
    • Default Value: null
  • integer $type
    The error type.
    • Default Value: E_USER_NOTICE
  • string $redirect
    The page to redirect to for critical errors.
    • Default Value: ""

resetFileSearch()

  • Signature: public function resetFileSearch()

rewrittenURLs()

returns true if the url's have been written. false if not

  • Signature: static public function rewrittenURLs()

setConfig()

Sets an instance magic data object @param I2CE_MagicData $magicdata

  • Signature: static public function setConfig($magicData)

Parameters:

  • $magicData

setTraceDepth()

Set the trace depth used in reporting error messages

Set to a negative number to report all, 0 to report none.

  • Signature: static public function setTraceDepth($depth)
  • Returns: integer. The previous value of trace depth.

Parameters:

  • integer $depth

setupDatabaseReferences()

Setup the references to database names in magic data

  • Signature: static protected function setupDatabaseReferences($user_db)

Parameters:

  • string $user_db
    defaults
    • Default Value: null

setupFileSearch()

Create and populate the file search

and values a path or an array of paths to add to the file search

clear out the APC Cache.

  • Signature: static public function setupFileSearch($paths,$clear_cache)

Parameters:

  • array $paths
    An array with keys file search categories
    • Default Value: array()
  • boolean $clear_cache
    Default to false. If true, we
    • Default Value: false

setupMagicData()

Creates the magic data instance. Sets the mafic data storage mechanisms to be used.

  • Signature: static protected function setupMagicData()

setupSession()

Setup the session variables

  • Signature: static protected function setupSession()

siteInitialized()

Get/Set the site's initialization state.

@param init. Defaults to null in which case we return the site installation state. if non-null, it is the new site initialization state.

  • Signature: static public function siteInitialized($init)
  • Returns: mixed.

Parameters:

  • $init
    • Default Value: null
Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Class:_I2CE&oldid=5955"