Mailable::attachments() - Code Metrics - Inspection of "Merge pull request #37 from blitz-php/devs" - blitz-php/framework - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — main ( 9116b3...d79e5f )

by Dimitri

created 2024-11-26 09:59 UTC

Mailable::attachments() A

↳ Parent: Mailable

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
eloc	1
c	1
b	0
f	0
nc	1
nop	0
dl	0
loc	3
ccs	0
cts	1
cp	0
crap	2
rs	10

<?php

/**
 * This file is part of Blitz PHP framework.
 *
 * (c) 2022 Dimitri Sitchet Tomkeu <[email protected]>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

namespace BlitzPHP\Mail;

use ReflectionClass;
use ReflectionProperty;

abstract class Mailable
{
    /**
     * Définition des pièces jointes du mail
     */
    public function attachments(): array
    {
        return [];
    }

    /**
     * Définition des adresses de copie (BCC) au mail
     *
     * @return array<string, string>|list<string>
filter:
    dependency_paths: ["lib/*"]
     *
     * @example
     * ```php
     *  [
     *      '[email protected]' => 'john doe',
     *      '[email protected]',
     *  ]
     * ```
     */
    public function bcc(): array
    {
        return [];
    }

    /**
     * Définition des adresses de copie (CC) au mail
     *
     * @return array<string, string>|list<string>
     *
     * @example
     * ```php
     *  [
     *      '[email protected]' => 'john doe',
     *      '[email protected]',
     *  ]
     * ```
     */
    public function cc(): array
    {
        return [];
    }

    /**
     * Définition des éléments du contenu du mail
     */
    public function content(): array
    {
        return [
            'view' => '',
            'html' => '',
            'text' => '',
        ];
    }

    /**
     * Définition de l'adresse de l'expediteur du mail
     *
     * @return list<string>
     *
     * @example
     * ```php
     *  ['[email protected]', 'John Doe']
     *  ['[email protected]']
     * ```
     */
    public function from(): array
    {
        $from = config('mail.from');

        return [$from['address'] ?? '', $from['name'] ?? ''];

    }

    /**
     * Définition des entetes supplementaires du mail
     *
     * @return array<string, string>
     *
     * @example
     * ```php
     *  [
     *      'X-Custom-Header' => 'Custom Value',
     *  ]
     * ```
     */
    public function headers(): array
    {
        return [];
    }

    /**
     * Définition du niveau de priorité du mail
     */
    public function priority(): int
    {
        return Mail::PRIORITY_NORMAL;
    }

    /**
     * Définition des adresses de reponse (ReplyTo) du mail
     *
     * @return array<string, string>|list<string>
     *
     * @example
     * ```php
     *  [
     *      '[email protected]' => 'john doe',
     *      '[email protected]',
     *  ]
     * ```
     */
    public function replyTo(): array
    {
        return [];
    }

    /**
     * Définition du sujet du mail
     */
    public function subject(): string
    {
        return '';
    }

    /**
     * Définition des adresses de destination (to) au mail
     *
     * @return array<string, string>|list<string>
     *
     * @example
     * ```php
     *  [
     *      '[email protected]' => 'john doe',
     *      '[email protected]',
     *  ]
     * ```
     */
    public function to(): array
    {
        return [];
    }

    /**
     * Définition des données à transférer à la vue qui générera le mail
     */
    public function with(): array
    {
        return [];
    }

    /**
     * Données à transférer à la vue qui générera le mail
     *
     * @internal
     */
    public function data(): array
    {
        $reflection = new ReflectionClass(static::class);

        $data = [];

        foreach ($reflection->getProperties(ReflectionProperty::IS_PUBLIC) as $prop) {
            $data[$prop->getName()] = $prop->getValue($this);
        }

        return array_merge($data, $this->with());
    }

    /**
     * Envoi du mail
     *
     * @internal
     */
    public function send(Mail $mail): bool
    {
        foreach ($this->bcc() as $key => $value) {
            if (empty($value) || ! is_string($value)) {
                continue;
            }

            if (is_string($key)) {
                $mail->bcc($key, $value);
            } else {
                $mail->bcc($value);
            }
        }

        foreach ($this->cc() as $key => $value) {
            if (empty($value) || ! is_string($value)) {
                continue;
            }

            if (is_string($key)) {
                $mail->cc($key, $value);
            } else {
                $mail->cc($value);
            }
        }

        $content = $this->content();

        if (! empty($content['view'])) {
            $mail->view($content['view'], $this->data());
        } elseif (! empty($content['html'])) {
            $mail->html($content['html']);
        }
        if (! empty($content['text'])) {
            $mail->text($content['text']);
        }

        $mail->from(...$this->from());
        $mail->from(/** @scrutinizer ignore-type */ ...$this->from());
        $mail->header($this->headers());
        $mail->priority($this->priority());

        foreach ($this->replyTo() as $key => $value) {
            if (empty($value) || ! is_string($value)) {
                continue;
            }

            if (is_string($key)) {
                $mail->replyTo($key, $value);
            } else {
                $mail->replyTo($value);
            }
        }

        $mail->subject($this->subject());

        foreach ($this->to() as $key => $value) {
            if (empty($value) || ! is_string($value)) {
                continue;
            }

            if (is_string($key)) {
                $mail->to($key, $value);
            } else {
                $mail->to($value);
            }
        }

        return $mail->send();
    }
}


blitz-php / framework

Push — main ( 9116b3...d79e5f )

Mailable::attachments() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like