LegacyProtocol::flags() - Code Metrics - Inspection of "Legacy protocol support updated" - Webklex/php-imap - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 7b77e0...812ed7 )

by Malte
created 2020-11-03 18:06 UTC
LegacyProtocol::flags() B

↳ Parent: LegacyProtocol
Complexity

Conditions	8
Paths	6
Size

Total Lines	18
Code Lines	12
Duplication

Lines	0
Ratio	0 %
Importance

Changes	2
Bugs	0	Features	1
Metric	Value
eloc	12
c	2
b	0
f	1
dl	0
loc	18
rs	8.4444
cc	8
nc	6
nop	1
<?php
/*
* File: LegacyProtocol.php
* Category: Protocol
* Author: M.Goldenbaum
* Created: 16.09.20 18:27
* Updated: -
*
* Description:
*  -
*/

namespace Webklex\PHPIMAP\Connection\Protocols;

use Webklex\PHPIMAP\ClientManager;
use Webklex\PHPIMAP\Exceptions\AuthFailedException;
use Webklex\PHPIMAP\Exceptions\MethodNotSupportedException;
use Webklex\PHPIMAP\Exceptions\RuntimeException;
use Webklex\PHPIMAP\IMAP;

/**
 * Class LegacyProtocol
 *
 * @package Webklex\PHPIMAP\Connection\Protocols
 */
class LegacyProtocol extends Protocol implements ProtocolInterface {

    protected $protocol = "imap";
    protected $host = null;
    protected $port = null;
    protected $encryption = null;

    /**
     * Imap constructor.
     * @param bool $cert_validation set to false to skip SSL certificate validation
     */
    public function __construct($cert_validation = true) {
        $this->setCertValidation($cert_validation);
    }

    /**
     * Public destructor
     */
    public function __destruct() {
        $this->logout();
    }

    /**
     * Save the information for a nw connection
     * @param string $host
     * @param null $port

     * @param bool $encryption
     */
    public function connect($host, $port = null, $encryption = false) {
        if ($port === null) {

            $port = $encryption == "ssl" ? 995 : 110;
        }
        $this->host = $host;
        $this->port = $port;
        $this->encryption = $encryption;
    }

    /**
     * Login to a new session.
     * @param string $user username
     * @param string $password password
     *
     * @return bool
     * @throws AuthFailedException
     */
    public function login($user, $password) {
        try {
            $this->stream = \imap_open(
                $this->getAddress(),
                $user,
                $password,
                IMAP::OP_READONLY,
                $attempts = 3,
                ClientManager::get('options.open')
            );
        } catch (\ErrorException $e) {
            $errors = \imap_errors();
            $message = $e->getMessage().'. '.implode("; ", (is_array($errors) ? $errors : array()));


            throw new AuthFailedException($message);
        }

        if(!$this->stream) {
            $errors = \imap_errors();
            $message = implode("; ", (is_array($errors) ? $errors : array()));

            throw new AuthFailedException($message);
        }

        return $this->stream;

    }

    /**
     * Authenticate your current session.
     * @param string $user username
     * @param string $token access token
     *
     * @return bool
     * @throws AuthFailedException
     */
    public function authenticate($user, $token) {
        return $this->login($user, $token);
    }

    /**
     * Get full address of mailbox.
     *
     * @return string
     */
    protected function getAddress() {
        $address = "{".$this->host.":".$this->port."/".$this->protocol;
        if (!$this->cert_validation) {
            $address .= '/novalidate-cert';
        }
        if (in_array($this->encryption,['tls', 'notls', 'ssl'])) {
            $address .= '/'.$this->encryption;
        } elseif ($this->encryption === "starttls") {
            $address .= '/tls';
        }

        $address .= '}';

        return $address;
    }

    /**
     * Logout of the current session
     *
     * @return bool success
     */
    public function logout() {
        if ($this->stream) {
            return \imap_close($this->stream, IMAP::CL_EXPUNGE);
            return \imap_close(/** @scrutinizer ignore-type */ $this->stream, IMAP::CL_EXPUNGE);
        }
        return false;
    }

    /**
     * Check if the current session is connected
     *
     * @return bool
     */
    public function connected(){
        return !$this->stream;
    }

    /**
     * Get an array of available capabilities
     *
     * @throws MethodNotSupportedException
     */
    public function getCapabilities() {
        throw new MethodNotSupportedException();
    }

    /**
     * Change the current folder
     * @param string $folder change to this folder
     *
     * @return bool|array see examineOrselect()
     * @throws RuntimeException
     */
    public function selectFolder($folder = 'INBOX') {
        \imap_reopen($this->stream, $folder, IMAP::OP_READONLY, 3);
        \imap_reopen(/** @scrutinizer ignore-type */ $this->stream, $folder, IMAP::OP_READONLY, 3);
        return $this->examineFolder($folder);
    }

    /**
     * Examine a given folder
     * @param string $folder examine this folder
     *
     * @return bool|array see examineOrselect()
     * @throws RuntimeException
     */
    public function examineFolder($folder = 'INBOX') {
        if (strpos($folder, ".") === 0) {
            throw new RuntimeException("Segmentation fault prevented. Folders starts with an illegal char '.'.");
        }
        $folder = $this->getAddress().$folder;
        $status = \imap_status($this->stream, $folder, IMAP::SA_ALL);
        $status = \imap_status(/** @scrutinizer ignore-type */ $this->stream, $folder, IMAP::SA_ALL);
        return [
            "flags" => [],
            "exists" => $status->messages,
            "recent" => $status->recent,
            "unseen" => $status->unseen,
            "uidnext" => $status->uidnext,
        ];
    }

    /**
     * Fetch message content
     * @param array|int $uids
     * @param string $rfc
     *
     * @return array
     */
    public function content($uids, $rfc = "RFC822") {
        $result = [];
        $uids = is_array($uids) ? $uids : [$uids];
        foreach ($uids as $uid) {
            $result[$uid] = \imap_fetchbody($this->stream, $uid, "", IMAP::NIL);
            $result[$uid] = \imap_fetchbody(/** @scrutinizer ignore-type */ $this->stream, $uid, "", IMAP::NIL);
        }
        return $result;
    }

    /**
     * Fetch message headers
     * @param array|int $uids
     * @param string $rfc
     *
     * @return array
     */
    public function headers($uids, $rfc = "RFC822"){
        $result = [];
        $uids = is_array($uids) ? $uids : [$uids];
        foreach ($uids as $uid) {
            $result[$uid] = \imap_fetchheader($this->stream, $uid, IMAP::NIL);
            $result[$uid] = \imap_fetchheader(/** @scrutinizer ignore-type */ $this->stream, $uid, IMAP::NIL);
        }
        return $result;
    }

    /**
     * Fetch message flags
     * @param array|int $uids
     *
     * @return array
     */
    public function flags($uids){
        $result = [];
        $uids = is_array($uids) ? $uids : [$uids];
        foreach ($uids as $uid) {
            $raw_flags = \imap_fetch_overview($this->stream, $uid, IMAP::NIL);
            $raw_flags = \imap_fetch_overview(/** @scrutinizer ignore-type */ $this->stream, $uid, IMAP::NIL);
            $flags = [];
            if (is_array($raw_flags) && isset($raw_flags[0])) {
                $raw_flags = (array) $raw_flags[0];
                foreach($raw_flags as $flag => $value) {
                    if ($value === 1 && in_array($flag, ["size", "uid", "msgno", "update"]) === false){
                        $flags[] = "\\".ucfirst($flag);
                    }
                }
            }
            $result[$uid] = $flags;
        }

        return $result;
    }

    /**
     * Get uid for a given id
     * @param int|null $id message number
     *
     * @return array|string message number for given message or all messages as array
     */
    public function getUid($id = null) {
        if ($id === null) {
            $overview = $this->overview("1:*");
            $uids = [];
            foreach($overview as $set){
                $uids[$set->msgno] = $set->uid;
            }
            return $uids;
        }
        return \imap_uid($this->stream, $id);
        return \imap_uid(/** @scrutinizer ignore-type */ $this->stream, $id);
    }

    /**
     * Get a message number for a uid
     * @param string $id uid
     *
     * @return int message number
     */
    public function getMessageNumber($id) {
        return \imap_msgno($this->stream, $id);
        return \imap_msgno($this->stream, /** @scrutinizer ignore-type */ $id);
    }

    /**
     * Get a message number for a uid
     * @param string $sequence uid sequence
     *
     * @return array
     */
    public function overview($sequence) {
        return \imap_fetch_overview($this->stream, $sequence);
        return \imap_fetch_overview(/** @scrutinizer ignore-type */ $this->stream, $sequence);
    }

    /**
     * Get a list of available folders
     * @param string $reference mailbox reference for list
     * @param string $folder mailbox name match with wildcards
     *
     * @return array folders that matched $folder as array(name => array('delimiter' => .., 'flags' => ..))
     * @throws RuntimeException
     */
    public function folders($reference = '', $folder = '*') {
        $result = [];

        $items = \imap_getmailboxes($this->stream, $this->getAddress(), $reference.$folder);
        $items = \imap_getmailboxes(/** @scrutinizer ignore-type */ $this->stream, $this->getAddress(), $reference.$folder);
        if(is_array($items)){

            foreach ($items as $item) {
                $name = $this->decodeFolderName($item->name);
                $result[$name] = ['delimiter' => $item->delimiter, 'flags' => []];
            }
        }else{
            throw new RuntimeException(\imap_last_error());
        }

        return $result;
    }

    /**
     * Manage flags
     * @param array $flags flags to set, add or remove - see $mode
     * @param int $from message for items or start message if $to !== null
     * @param int|null $to if null only one message ($from) is fetched, else it's the
     *                             last message, INF means last message available
     * @param string|null $mode '+' to add flags, '-' to remove flags, everything else sets the flags as given
     * @param bool $silent if false the return values are the new flags for the wanted messages
     *
     * @return bool|array new flags if $silent is false, else true or false depending on success
     */
    public function store(array $flags, $from, $to = null, $mode = null, $silent = true) {
        $flag = trim(is_array($flags) ? implode(" ", $flags) : $flags);


        if ($mode == "+"){
            $status = \imap_setflag_full($this->stream, $from, $flag, IMAP::NIL);
            $status = \imap_setflag_full(/** @scrutinizer ignore-type */ $this->stream, $from, $flag, IMAP::NIL);
        }else{
            $status = \imap_clearflag_full($this->stream, $from, $flag, IMAP::NIL);
            $status = \imap_clearflag_full(/** @scrutinizer ignore-type */ $this->stream, $from, $flag, IMAP::NIL);
        }

        if ($silent === true) {
            return $status;
        }

        return $this->flags($from);
    }

    /**
     * Append a new message to given folder
     * @param string $folder name of target folder
     * @param string $message full message content
     * @param array $flags flags for new message
     * @param string $date date for new message
     *
     * @return bool success
     */
    public function appendMessage($folder, $message, $flags = null, $date = null) {
        if ($date != null) {

            if ($date instanceof \Carbon\Carbon){

                $date = $date->format('d-M-Y H:i:s O');
            }
            return \imap_append($this->stream, $folder, $message, $flags, $date);
            return \imap_append(/** @scrutinizer ignore-type */ $this->stream, $folder, $message, $flags, $date);
        }

        return \imap_append($this->stream, $folder, $message, $flags);
    }

    /**
     * Copy message set from current folder to other folder
     * @param string $folder destination folder
     * @param $from
     * @param int|null $to if null only one message ($from) is fetched, else it's the
     *                         last message, INF means last message available
     *
     * @return bool success
     */
    public function copyMessage($folder, $from, $to = null) {
        return \imap_mail_copy($this->stream, $from, $folder, IMAP::CP_UID);
        return \imap_mail_copy(/** @scrutinizer ignore-type */ $this->stream, $from, $folder, IMAP::CP_UID);
    }

    /**
     * Move a message set from current folder to an other folder
     * @param string $folder destination folder
     * @param $from
     * @param int|null $to if null only one message ($from) is fetched, else it's the
     *                         last message, INF means last message available
     *
     * @return bool success
     */
    public function moveMessage($folder, $from, $to = null) {
        return \imap_mail_move($this->stream, $from, $folder, IMAP::CP_UID);
        return \imap_mail_move(/** @scrutinizer ignore-type */ $this->stream, $from, $folder, IMAP::CP_UID);
    }

    /**
     * Create a new folder (and parent folders if needed)
     * @param string $folder folder name
     *
     * @return bool success
     */
    public function createFolder($folder) {
        return \imap_createmailbox($this->stream, $folder);
        return \imap_createmailbox(/** @scrutinizer ignore-type */ $this->stream, $folder);
    }

    /**
     * Rename an existing folder
     * @param string $old old name
     * @param string $new new name
     *
     * @return bool success
     */
    public function renameFolder($old, $new) {
        return \imap_renamemailbox($this->stream, $old, $new);
        return \imap_renamemailbox(/** @scrutinizer ignore-type */ $this->stream, $old, $new);
    }

    /**
     * Delete a folder
     * @param string $folder folder name
     *
     * @return bool success
     */
    public function deleteFolder($folder) {
        return \imap_deletemailbox($this->stream, $folder);
        return \imap_deletemailbox(/** @scrutinizer ignore-type */ $this->stream, $folder);
    }

    /**
     * Subscribe to a folder
     * @param string $folder folder name
     *
     * @throws MethodNotSupportedException
     */
    public function subscribeFolder($folder) {
        throw new MethodNotSupportedException();
    }

    /**
     * Unsubscribe from a folder
     * @param string $folder folder name
     *
     * @throws MethodNotSupportedException
     */
    public function unsubscribeFolder($folder) {
    public function unsubscribeFolder(/** @scrutinizer ignore-unused */ $folder) {
        throw new MethodNotSupportedException();
    }

    /**
     * Apply session saved changes to the server
     *
     * @return bool success
     */
    public function expunge() {
        return \imap_expunge($this->stream);
        return \imap_expunge(/** @scrutinizer ignore-type */ $this->stream);
    }

    /**
     * Send noop command
     *
     * @throws MethodNotSupportedException
     */
    public function noop() {
        throw new MethodNotSupportedException();
    }

    /**
     * Send idle command
     *
     * @throws MethodNotSupportedException
     */
    public function idle() {
        throw new MethodNotSupportedException();
    }

    /**
     * Send done command
     *
     * @throws MethodNotSupportedException
     */
    public function done() {
        throw new MethodNotSupportedException();
    }

    /**
     * Search for matching messages
     *
     * @param array $params
     * @return array message ids
     */
    public function search(array $params) {
        return \imap_search($this->stream, $params[0], IMAP::NIL);
        return \imap_search(/** @scrutinizer ignore-type */ $this->stream, $params[0], IMAP::NIL);
    }

    /**
     * Enable the debug mode
     */
    public function enableDebug(){
        $this->debug = true;
    }

    /**
     * Disable the debug mode
     */
    public function disableDebug(){
        $this->debug = false;
    }

    /**
     * Decode name.
     * It converts UTF7-IMAP encoding to UTF-8.
     *
     * @param $name
     *
     * @return mixed|string
     */
    protected function decodeFolderName($name) {
        preg_match('#\{(.*)\}(.*)#', $name, $preg);
        return mb_convert_encoding($preg[2], "UTF-8", "UTF7-IMAP");
    }

    /**
     * @return string
     */
    public function getProtocol() {
        return $this->protocol;
    }

    /**
     * Retrieve the quota level settings, and usage statics per mailbox
     * @param $username
     *
     * @return array
     */
    public function getQuota($username) {
        return \imap_get_quota($this->stream, 'user.'.$username);
        return \imap_get_quota(/** @scrutinizer ignore-type */ $this->stream, 'user.'.$username);
    }

    /**
     * Retrieve the quota settings per user
     * @param string $quota_root
     *
     * @return array
     */
    public function getQuotaRoot($quota_root = 'INBOX') {
        return \imap_get_quotaroot($this->stream, $quota_root);
        return \imap_get_quotaroot(/** @scrutinizer ignore-type */ $this->stream, $quota_root);
    }

    /**
     * @param string $protocol
     * @return LegacyProtocol
     */
    public function setProtocol($protocol) {
        $this->protocol = $protocol;
        return $this;
    }
}
Webklex / php-imap

Push — master ( 7b77e0...812ed7 )

LegacyProtocol::flags() B

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
