402 lines
9.0 KiB
PHP
Executable File
402 lines
9.0 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* Phergie
|
|
*
|
|
* PHP version 5
|
|
*
|
|
* LICENSE
|
|
*
|
|
* This source file is subject to the new BSD license that is bundled
|
|
* with this package in the file LICENSE.
|
|
* It is also available through the world-wide-web at this URL:
|
|
* http://phergie.org/license
|
|
*
|
|
* @category Phergie
|
|
* @package Phergie
|
|
* @author Phergie Development Team <team@phergie.org>
|
|
* @copyright 2008-2010 Phergie Development Team (http://phergie.org)
|
|
* @license http://phergie.org/license New BSD License
|
|
* @link http://pear.phergie.org/package/Phergie
|
|
*/
|
|
|
|
/**
|
|
* Data structure for connection metadata.
|
|
*
|
|
* @category Phergie
|
|
* @package Phergie
|
|
* @author Phergie Development Team <team@phergie.org>
|
|
* @license http://phergie.org/license New BSD License
|
|
* @link http://pear.phergie.org/package/Phergie
|
|
*/
|
|
class Phergie_Connection
|
|
{
|
|
/**
|
|
* Host to which the client will connect
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $host;
|
|
|
|
/**
|
|
* Port on which the client will connect, defaults to the standard IRC
|
|
* port
|
|
*
|
|
* @var int
|
|
*/
|
|
protected $port;
|
|
|
|
/**
|
|
* Transport for the connection, defaults to tcp but can be set to ssl
|
|
* or variations thereof to connect over SSL
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $transport;
|
|
|
|
/**
|
|
* Encoding method for the connection, defaults to ISO-8859-1 but can
|
|
* be set to UTF8 if necessary
|
|
*
|
|
* @var strng
|
|
*/
|
|
protected $encoding;
|
|
|
|
/**
|
|
* Nick that the client will use
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $nick;
|
|
|
|
/**
|
|
* Username that the client will use
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $username;
|
|
|
|
/**
|
|
* Realname that the client will use
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $realname;
|
|
|
|
/**
|
|
* Password that the client will use
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $password;
|
|
|
|
/**
|
|
* Hostmask for the connection
|
|
*
|
|
* @var Phergie_Hostmask
|
|
*/
|
|
protected $hostmask;
|
|
|
|
/**
|
|
* Constructor to initialize instance properties.
|
|
*
|
|
* @param array $options Optional associative array of property values
|
|
* to initialize
|
|
*
|
|
* @return void
|
|
*/
|
|
public function __construct(array $options = array())
|
|
{
|
|
$this->transport = 'tcp';
|
|
$this->encoding = 'ISO-8859-1';
|
|
// @note this may need changed to something different, for broader support.
|
|
// @note also may need to make use of http://us.php.net/manual/en/function.stream-encoding.php
|
|
|
|
$this->setOptions($options);
|
|
}
|
|
|
|
/**
|
|
* Emits an error related to a required connection setting does not have
|
|
* value set for it.
|
|
*
|
|
* @param string $setting Name of the setting
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function checkSetting($setting)
|
|
{
|
|
if (empty($this->$setting)) {
|
|
throw new Phergie_Connection_Exception(
|
|
'Required connection setting "' . $setting . '" missing',
|
|
Phergie_Connection_Exception::ERR_REQUIRED_SETTING_MISSING
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns a hostmask that uniquely identifies the connection.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getHostmask()
|
|
{
|
|
if (empty($this->hostmask)) {
|
|
$this->hostmask = new Phergie_Hostmask(
|
|
$this->getNick(),
|
|
$this->getUsername(),
|
|
$this->getHost()
|
|
);
|
|
}
|
|
|
|
return $this->hostmask;
|
|
}
|
|
|
|
/**
|
|
* Sets the host to which the client will connect.
|
|
*
|
|
* @param string $host Hostname
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setHost($host)
|
|
{
|
|
if (empty($this->host)) {
|
|
$this->host = (string) $host;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the host to which the client will connect if it is set or
|
|
* emits an error if it is not set.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getHost()
|
|
{
|
|
$this->checkSetting('host');
|
|
|
|
return $this->host;
|
|
}
|
|
|
|
/**
|
|
* Sets the port on which the client will connect.
|
|
*
|
|
* @param int $port Port
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setPort($port)
|
|
{
|
|
if (empty($this->port)) {
|
|
$this->port = (int) $port;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the port on which the client will connect.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getPort()
|
|
{
|
|
if (empty($this->port)) {
|
|
$this->port = 6667;
|
|
}
|
|
|
|
return $this->port;
|
|
}
|
|
|
|
/**
|
|
* Sets the transport for the connection to use.
|
|
*
|
|
* @param string $transport Transport (ex: tcp, ssl, etc.)
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setTransport($transport)
|
|
{
|
|
$this->transport = (string) $transport;
|
|
|
|
if (!in_array($this->transport, stream_get_transports())) {
|
|
throw new Phergie_Connection_Exception(
|
|
'Transport ' . $this->transport . ' is not supported',
|
|
Phergie_Connection_Exception::ERR_TRANSPORT_NOT_SUPPORTED
|
|
);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the transport in use by the connection.
|
|
*
|
|
* @return string Transport (ex: tcp, ssl, etc.)
|
|
*/
|
|
public function getTransport()
|
|
{
|
|
return $this->transport;
|
|
}
|
|
|
|
/**
|
|
* Sets the encoding for the connection to use.
|
|
*
|
|
* @param string $encoding Encoding to use (ex: ASCII, ISO-8859-1, UTF8, etc.)
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setEncoding($encoding)
|
|
{
|
|
$this->encoding = (string) $encoding;
|
|
|
|
if (!in_array($this->encoding, mb_list_encodings())) {
|
|
throw new Phergie_Connection_Exception(
|
|
'Encoding ' . $this->encoding . ' is not supported',
|
|
Phergie_Connection_Exception::ERR_ENCODING_NOT_SUPPORTED
|
|
);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the encoding in use by the connection.
|
|
*
|
|
* @return string Encoding (ex: ASCII, ISO-8859-1, UTF8, etc.)
|
|
*/
|
|
public function getEncoding()
|
|
{
|
|
return $this->encoding;
|
|
}
|
|
|
|
/**
|
|
* Sets the nick that the client will use.
|
|
*
|
|
* @param string $nick Nickname
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setNick($nick)
|
|
{
|
|
if (empty($this->nick)) {
|
|
$this->nick = (string) $nick;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the nick that the client will use.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getNick()
|
|
{
|
|
$this->checkSetting('nick');
|
|
|
|
return $this->nick;
|
|
}
|
|
|
|
/**
|
|
* Sets the username that the client will use.
|
|
*
|
|
* @param string $username Username
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setUsername($username)
|
|
{
|
|
if (empty($this->username)) {
|
|
$this->username = (string) $username;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the username that the client will use.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getUsername()
|
|
{
|
|
$this->checkSetting('username');
|
|
|
|
return $this->username;
|
|
}
|
|
|
|
/**
|
|
* Sets the realname that the client will use.
|
|
*
|
|
* @param string $realname Real name
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setRealname($realname)
|
|
{
|
|
if (empty($this->realname)) {
|
|
$this->realname = (string) $realname;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the realname that the client will use.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getRealname()
|
|
{
|
|
$this->checkSetting('realname');
|
|
|
|
return $this->realname;
|
|
}
|
|
|
|
/**
|
|
* Sets the password that the client will use.
|
|
*
|
|
* @param string $password Password
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setPassword($password)
|
|
{
|
|
if (empty($this->password)) {
|
|
$this->password = (string) $password;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the password that the client will use.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getPassword()
|
|
{
|
|
return $this->password;
|
|
}
|
|
|
|
/**
|
|
* Sets multiple connection settings using an array.
|
|
*
|
|
* @param array $options Associative array of setting names mapped to
|
|
* corresponding values
|
|
*
|
|
* @return Phergie_Connection Provides a fluent interface
|
|
*/
|
|
public function setOptions(array $options)
|
|
{
|
|
foreach ($options as $option => $value) {
|
|
$method = 'set' . ucfirst($option);
|
|
if (method_exists($this, $method)) {
|
|
$this->$method($value);
|
|
}
|
|
}
|
|
}
|
|
}
|