Helix\Socket\SocketError

Complexity

Total Complexity

9

Size/Duplication

Total Lines	77
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	getExtra()	0	2	1
A	getLast()	0	15	4
A	setExtra()	0	3	1
A	__construct()	0	15	3

<?php

namespace Helix\Socket;

use RuntimeException;

/**
 * A socket error.
 *
 * @link https://php.net/sockets.constants
 */
class SocketError extends RuntimeException {

    /**
     * Extra data, if any. The specific contents are documented where the error is thrown.
     *
     * @var mixed
     */
    protected $extra;

    /**
     * Retrieves and clears the socket error.
     * For resources, this favors `SO_ERROR`, then falls back to the error number set by PHP.
     * Both error codes are cleared.
     *
     * @link https://php.net/socket_last_error
     * @link https://php.net/socket_clear_error
     *
     * @param resource $resource PHP socket resource, or `null` for the global error.
     * @return int If the resource is closed or not a socket, `SOCKET_EBADF` is returned.
     */
    public static function getLast ($resource = null) {
        if (isset($resource)) {
            if (@get_resource_type($resource) !== 'Socket') {
                return SOCKET_EBADF;
            }
            // fetching SO_ERROR also clears it
            elseif (!$errno = socket_get_option($resource, SOL_SOCKET, SO_ERROR)) {
                $errno = socket_last_error($resource);
            }
            socket_clear_error($resource);
            return $errno;
        }
        $errno = socket_last_error();
        socket_clear_error();
        return $errno;
    }

    /**
     * Initializes the error based on a mixed subject.
     *
     * @param int|resource|null $subject Error constant, or resource, or `NULL` to use the most recent global error.
     * @param int $fallback Code to assume if one can't be found via the subject. This is because PHP likes to return
     *     `false` without setting the error number in some places, all of which are accounted for in this library.
     *     PHP's last suppressed warning is used for the message.
     *
     */
    public function __construct ($subject = null, $fallback = 0) {
        if (is_int($subject)) {
            $errno = $subject;
        }
        else {
            $errno = static::getLast($subject);
        }
        if ($errno) {
            $message = socket_strerror($errno);
        }
        else {
            $errno = $fallback;
            $message = error_get_last()['message'];
        }
        parent::__construct($message, $errno);
    }

    /**
     * @return mixed
     */
    public function getExtra () {
        return $this->extra;
    }

    /**
     * @param mixed $extra
     * @return $this
     */
    public function setExtra ($extra) {
        $this->extra = $extra;
        return $this;
    }

}