mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-12-11 09:11:05 +01:00
214 lines
5.3 KiB
PHP
214 lines
5.3 KiB
PHP
<?php
|
|
/**
|
|
* eGroupWare API - Exceptions
|
|
*
|
|
* This file defines as set of Exceptions used in eGroupWare.
|
|
*
|
|
* Applications having the need for further exceptions should extends the from one defined in this file.
|
|
*
|
|
* @link http://www.egroupware.org
|
|
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
|
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
|
|
* @package api
|
|
* @subpackage accounts
|
|
* @access public
|
|
* @version $Id$
|
|
*/
|
|
|
|
/**
|
|
* eGroupWare API - Exceptions
|
|
*
|
|
* All eGroupWare exceptions should extended this class, so we are able to eg. add some logging later.
|
|
*
|
|
* The messages for most exceptions should be translated and ready to be displayed to the user.
|
|
* Only exception to this are exceptions like egw_exception_assertion_fails, egw_exception_wrong_parameter
|
|
* or egw_exception_db, which are suppost to happen only during program development.
|
|
*/
|
|
class egw_exception extends Exception
|
|
{
|
|
// nothing fancy yet
|
|
function __construct($msg=null,$code=100,Exception $previous=null)
|
|
{
|
|
return parent::__construct($msg, $code, $previous);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Base class for all exceptions about missing permissions
|
|
*
|
|
*/
|
|
class egw_exception_no_permission extends egw_exception
|
|
{
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param string $msg =null message, default "Permission denied!"
|
|
* @param int $code =100 numerical code, default 100
|
|
*/
|
|
function __construct($msg=null,$code=100)
|
|
{
|
|
if (is_null($msg)) $msg = lang('Permisson denied!');
|
|
|
|
parent::__construct($msg,$code);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* User lacks the right to run an application
|
|
*
|
|
*/
|
|
class egw_exception_no_permission_app extends egw_exception_no_permission
|
|
{
|
|
function __construct($msg=null,$code=101)
|
|
{
|
|
if (isset($GLOBALS['egw_info']['apps'][$msg]))
|
|
{
|
|
if ($msg == 'admin')
|
|
{
|
|
$msg = lang('You need to be an eGroupWare administrator to access this functionality!');
|
|
}
|
|
else
|
|
{
|
|
$currentapp = $GLOBALS['egw_info']['flags']['currentapp'];
|
|
$app = isset($GLOBALS['egw_info']['apps'][$currentapp]['title']) ?
|
|
$GLOBALS['egw_info']['apps'][$currentapp]['title'] : $msg;
|
|
|
|
$msg = lang('You\'ve tried to open the eGroupWare application: %1, but you have no permission to access this application.',
|
|
'"'.$app.'"');
|
|
}
|
|
}
|
|
parent::__construct($msg,$code);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* User is no eGroupWare admin (no right to run the admin application)
|
|
*
|
|
*/
|
|
class egw_exception_no_permission_admin extends egw_exception_no_permission_app
|
|
{
|
|
function __construct($msg=null,$code=102)
|
|
{
|
|
if (is_null($msg)) $msg = 'admin';
|
|
|
|
parent::__construct($msg,$code);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* User lacks a record level permission, eg. he's not the owner and has no grant from the owner
|
|
*
|
|
*/
|
|
class egw_exception_no_permission_record extends egw_exception_no_permission { }
|
|
|
|
/**
|
|
* A record or application entry was not found for the given id
|
|
*
|
|
*/
|
|
class egw_exception_not_found extends egw_exception
|
|
{
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param string $msg =null message, default "Entry not found!"
|
|
* @param int $code =99 numerical code, default 2
|
|
*/
|
|
function __construct($msg=null,$code=2)
|
|
{
|
|
if (is_null($msg)) $msg = lang('Entry not found!');
|
|
|
|
parent::__construct($msg,$code);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* An necessary assumption the developer made failed, regular execution can not continue
|
|
*
|
|
* As you get this only by an error in the code or during development, the message does not need to be translated
|
|
*/
|
|
class egw_exception_assertion_failed extends egw_exception { }
|
|
|
|
/**
|
|
* A method or function was called with a wrong or missing parameter
|
|
*
|
|
* As you get this only by an error in the code or during development, the message does not need to be translated
|
|
*/
|
|
class egw_exception_wrong_parameter extends egw_exception_assertion_failed { }
|
|
|
|
/**
|
|
* Wrong or missing required user input: message should be translated so it can be shown directly to the user
|
|
*
|
|
*/
|
|
class egw_exception_wrong_userinput extends egw_exception_assertion_failed { }
|
|
|
|
/**
|
|
* Exception thrown by the egw_db class for everything not covered by extended classed below
|
|
*/
|
|
class egw_exception_db extends egw_exception
|
|
{
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param string $msg =null message, default "Database error!"
|
|
* @param int $code =100
|
|
*/
|
|
function __construct($msg=null,$code=100)
|
|
{
|
|
if (is_null($msg)) $msg = lang('Database error!');
|
|
|
|
parent::__construct($msg,$code);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Storing the row violates a unique key constrain
|
|
*/
|
|
class egw_exception_db_not_unique extends egw_exception_db { }
|
|
|
|
/**
|
|
* Can not connect to database: eg. database down, wrong host, name or credentials
|
|
*/
|
|
class egw_exception_db_connection extends egw_exception_db { }
|
|
|
|
/**
|
|
* PHP lackst support for configured database type
|
|
*/
|
|
class egw_exception_db_support extends egw_exception_db { }
|
|
|
|
/**
|
|
* Classic invalid SQL error
|
|
*/
|
|
class egw_exception_db_invalid_sql extends egw_exception_db { }
|
|
|
|
/**
|
|
* EGroupware not (fully) installed, visit setup
|
|
*/
|
|
class egw_exception_db_setup extends egw_exception_db { }
|
|
|
|
/**
|
|
* Allow callbacks to request a redirect
|
|
*
|
|
* Can be caught be applications and is otherwise handled by global exception handler.
|
|
*/
|
|
class egw_exception_redirect extends egw_exception
|
|
{
|
|
public $url;
|
|
public $app;
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param string $url
|
|
* @param string $app
|
|
* @param string $msg
|
|
* @param int $code
|
|
*/
|
|
function __construct($url,$app=null,$msg=null,$code=301)
|
|
{
|
|
$this->url = $url;
|
|
$this->app = $app;
|
|
|
|
parent::__construct($msg, $code);
|
|
}
|
|
}
|