freenetis-github/system/vendor/swift/Swift/Log.php @ 54b55b54
| 8baed187 | Michal Kliment | <?php
|
|
/**
|
|||
* Swift Mailer Logging Layer base class.
|
|||
* Please read the LICENSE file
|
|||
* @author Chris Corbyn <chris@w3style.co.uk>
|
|||
* @package Swift_Log
|
|||
* @license GNU Lesser General Public License
|
|||
*/
|
|||
/**
|
|||
* The Logger class/interface.
|
|||
* @package Swift_Log
|
|||
* @author Chris Corbyn <chris@w3style.co.uk>
|
|||
*/
|
|||
abstract class Swift_Log
|
|||
{
|
|||
/**
|
|||
* A command type entry
|
|||
*/
|
|||
const COMMAND = ">>";
|
|||
/**
|
|||
* A response type entry
|
|||
*/
|
|||
const RESPONSE = "<<";
|
|||
/**
|
|||
* An error type entry
|
|||
*/
|
|||
const ERROR = "!!";
|
|||
/**
|
|||
* A standard entry
|
|||
*/
|
|||
const NORMAL = "++";
|
|||
/**
|
|||
* Logging is off.
|
|||
*/
|
|||
const LOG_NOTHING = 0;
|
|||
/**
|
|||
* Only errors are logged.
|
|||
*/
|
|||
const LOG_ERRORS = 1;
|
|||
/**
|
|||
* Errors + sending failures.
|
|||
*/
|
|||
const LOG_FAILURES = 2;
|
|||
/**
|
|||
* All SMTP instructions + failures + errors.
|
|||
*/
|
|||
const LOG_NETWORK = 3;
|
|||
/**
|
|||
* Runtime info + SMTP instructions + failures + errors.
|
|||
*/
|
|||
const LOG_EVERYTHING = 4;
|
|||
/**
|
|||
* Failed recipients
|
|||
* @var array
|
|||
*/
|
|||
protected $failedRecipients = array();
|
|||
/**
|
|||
* The maximum number of log entries
|
|||
* @var int
|
|||
*/
|
|||
protected $maxSize = 50;
|
|||
/**
|
|||
* The level of logging currently set.
|
|||
* @var int
|
|||
*/
|
|||
protected $logLevel = self::LOG_NOTHING;
|
|||
/**
|
|||
* Add a new entry to the log
|
|||
* @param string The information to log
|
|||
* @param string The type of entry (see the constants: COMMAND, RESPONSE, ERROR, NORMAL)
|
|||
*/
|
|||
abstract public function add($text, $type = self::NORMAL);
|
|||
/**
|
|||
* Dump the contents of the log to the browser.
|
|||
* @param boolean True if the string should be returned rather than output.
|
|||
*/
|
|||
abstract public function dump($return_only=false);
|
|||
/**
|
|||
* Empty the log contents
|
|||
*/
|
|||
abstract public function clear();
|
|||
/**
|
|||
* Check if logging is enabled.
|
|||
*/
|
|||
public function isEnabled()
|
|||
{
|
|||
return ($this->logLevel > self::LOG_NOTHING);
|
|||
}
|
|||
/**
|
|||
* Add a failed recipient to the list
|
|||
* @param string The address of the recipient
|
|||
*/
|
|||
public function addFailedRecipient($address)
|
|||
{
|
|||
$this->failedRecipients[$address] = null;
|
|||
$this->add("Recipient '" . $address . "' rejected by connection.", self::ERROR);
|
|||
}
|
|||
/**
|
|||
* Get the list of failed recipients
|
|||
* @return array
|
|||
*/
|
|||
public function getFailedRecipients()
|
|||
{
|
|||
return array_keys($this->failedRecipients);
|
|||
}
|
|||
/**
|
|||
* Set the maximum size of this log (zero is no limit)
|
|||
* @param int The maximum entries
|
|||
*/
|
|||
public function setMaxSize($size)
|
|||
{
|
|||
$this->maxSize = (int) $size;
|
|||
}
|
|||
/**
|
|||
* Get the current maximum allowed log size
|
|||
* @return int
|
|||
*/
|
|||
public function getMaxSize()
|
|||
{
|
|||
return $this->maxSize;
|
|||
}
|
|||
/**
|
|||
* Set the log level to one of the constants provided.
|
|||
* @param int Level
|
|||
*/
|
|||
public function setLogLevel($level)
|
|||
{
|
|||
$level = (int)$level;
|
|||
$this->add("Log level changed to " . $level, self::NORMAL);
|
|||
$this->logLevel = $level;
|
|||
}
|
|||
/**
|
|||
* Get the current log level.
|
|||
* @return int
|
|||
*/
|
|||
public function getLogLevel()
|
|||
{
|
|||
return $this->logLevel;
|
|||
}
|
|||
/**
|
|||
* Check if the log level includes the one given.
|
|||
* @param int Level
|
|||
* @return boolean
|
|||
*/
|
|||
public function hasLevel($level)
|
|||
{
|
|||
return ($this->logLevel >= ((int)$level));
|
|||
}
|
|||
}
|