AbstractAdapter::with() - Code Metrics - Inspection of "feat: renvoi une vue comme reponse" - blitz-php/framework - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — main ( 79ccdf...097cc9 )

by Dimitri
created 2023-09-01 15:10 UTC
AbstractAdapter::with() A

↳ Parent: AbstractAdapter
Complexity

Conditions	2
Paths	2
Size

Total Lines	9
Code Lines	5
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	2
eloc	5
c	0
b	0
f	0
nc	2
nop	3
dl	0
loc	9
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\View\Adapters;

use BlitzPHP\Autoloader\Locator;
use BlitzPHP\Container\Services;
use BlitzPHP\Exceptions\ViewException;
use BlitzPHP\Utilities\Helpers;
use BlitzPHP\View\RendererInterface;

abstract class AbstractAdapter implements RendererInterface
{
    /**
     * Données mises à la disposition des vues.
     *
     * @var array
     */
    protected $data = [];

    /**
     * Les variables de rendu
     *
     * @var array
     */
    protected $renderVars = [];

    /**
     * Le répertoire de base dans lequel rechercher nos vues.
     *
     * @var string
     */
    protected $viewPath = '';

    /**
     * Instance de Locator lorsque nous devons tenter de trouver une vue qui n'est pas à l'emplacement standard.
     */
    protected ?Locator $locator = null;

    /**
     * Le nom de la mise en page utilisée, le cas échéant.
     * Défini par la méthode "extend" utilisée dans les vues.
     *
     * @var string|null
     */
    protected $layout;

    /**
     * Les statistiques sur nos performances ici
     *
     * @var array
     */
    protected $performanceData = [];

    /**
     * {@inheritDoc}
     *
     * @param array $config Configuration actuelle de l'adapter
     * @param bool  $debug  Devrions-nous stocker des informations sur les performances ?
     */
    public function __construct(protected array $config, $viewPathLocator = null, protected bool $debug = BLITZ_DEBUG)
    {
        helper('assets');

        if (! empty($viewPathLocator)) {
            if (is_string($viewPathLocator)) {
                $this->viewPath = rtrim($viewPathLocator, '\\/ ') . DS;
            } elseif ($viewPathLocator instanceof Locator) {
                $this->locator = $viewPathLocator;
            }
        } else {
            $this->locator = Services::locator();
        }
    }

    /**
     * {@inheritDoc}
     */
    public function setData(array $data = [], ?string $context = null): self
    {
        if ($context) {
            $data = esc($data, $context);
        }

        $this->data = $data;

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function getData(): array
    {
        return $this->data;
    }

    /**
     * {@inheritDoc}
     */
    public function addData(array $data = [], ?string $context = null): self
    {
        if ($context) {
            $data = esc($data, $context);
        }

        $this->data = array_merge($this->data, $data);

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function setVar(string $name, $value = null, ?string $context = null): self
    {
        if ($context) {
            $value = esc($value, $context);
        }

        $this->data[$name] = $value;

        return $this;
    }

    /**
     * Définit plusieurs éléments de données de vue à la fois.
     */
    public function with(array|string $key, mixed $value = null, ?string $context = null): self
    {
        if (is_array($key)) {

            $context = $value;
        } else {
            $key = [$key => $value];
        }

        return $this->addData($key, $context);
    }

    /**
     * {@inheritDoc}
     */
    public function resetData(): self
    {
        $this->data = [];

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function setLayout(?string $layout): self
    {
        $this->layout = $layout;

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function renderString(string $view, ?array $options = null, bool $saveData = false): string
    {
        return $this->render($view, $options, $saveData);
    }

    /**
     * {@inheritDoc}
     */
    public function getPerformanceData(): array
    {
        return $this->performanceData;
    }

    /**
     * Consigne les données de performances pour le rendu d'une vue.
     */
    protected function logPerformance(float $start, float $end, string $view)
    {
        if ($this->debug) {
            $this->performanceData[] = [
                'start' => $start,
                'end'   => $end,
                'view'  => $view,
            ];
        }
    }

    /**
     * Recupère ou modifie le titre de la page
     *
     * @return self|string
     */
    public function title(?string $title = null)
    {
        if (empty($title)) {
            return $this->getData()['title'] ?? '';
        }

        return $this->setVar('title', $title);
    }

    /**
     * Recupère ou modifie les elements de balises "meta"
     *
     * @return self|string
     */
    public function meta(string $key, ?string $value = null)
    {
        $meta = $this->getData()['meta'] ?? [];

        if (empty($value)) {
            return $meta[$key] ?? '';
        }

        $meta[$key] = esc($value);

        return $this->setVar('meta', $meta);
    }

    /**
     * Recupere le chemin absolue du fichier de vue a rendre
     */
    protected function getRenderedFile(?array $options, string $view, string $ext = 'php'): string
    {
        $options = (array) $options;

        $viewPath = $options['viewPath'] ?? $this->viewPath;
        if (! empty($viewPath)) {
            $file = str_replace('/', DS, rtrim($viewPath, '/\\') . DS . ltrim($view, '/\\'));
        } else {
            $file = $view;
        }

        $file = Helpers::ensureExt($file, $ext);

        if (! is_file($file) && $this->locator instanceof Locator) {
            $file = $this->locator->locateFile($view, 'Views', empty($ext) ? 'php' : $ext);
        }
		
		$file = realpath($file);
		$file = realpath(/** @scrutinizer ignore-type */ $file);
		
        // locateFile renverra une chaîne vide si le fichier est introuvable.
        if (! is_file($file)) {
            throw ViewException::invalidFile($view);
        }

        return $file;
    }

    /**
     * Construit la sortie en fonction d'un nom de fichier et de tout données déjà définies.
     *
     * Options valides :
     * - cache Nombre de secondes à mettre en cache pour
     * - cache_name Nom à utiliser pour le cache
     *
     * @param string     $view     Nom de fichier de la source de la vue
     * @param array|null $options  Réservé à des utilisations tierces car
     *                             il peut être nécessaire de transmettre des
     *                             informations supplémentaires à d'autres moteurs de modèles.
     * @param bool|null  $saveData Si vrai, enregistre les données pour les appels suivants,
     *                             si faux, nettoie les données après affichage,
     *                             si null, utilise le paramètre de configuration.
     */
    abstract public function render(string $view, ?array $options = null, ?bool $saveData = null): string;
}

blitz-php / framework

Push — main ( 79ccdf...097cc9 )

AbstractAdapter::with() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
