NativeAdapter::retrievePartialPath() - 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
NativeAdapter::retrievePartialPath() B

↳ Parent: NativeAdapter
Complexity

Conditions	7
Paths	7
Size

Total Lines	18
Code Lines	14
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	7
eloc	14
c	1
b	0
f	0
nc	7
nop	1
dl	0
loc	18
rs	8.8333
<?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 RuntimeException;

/**
 * Class View
 */
class NativeAdapter extends AbstractAdapter
{
    /**
     * Fusionner les données enregistrées et les données utilisateur
     */
    protected $tempData;

    /**
     * Indique si les données doivent être enregistrées entre les rendus.
     *
     * @var bool
     */
    protected $saveData;

    /**
     * Nombre de vues chargées
     *
     * @var int
     */
    protected $viewsCount = 0;

    /**
     * Contient les sections et leurs données.
     *
     * @var array
     */
    protected $sections = [];

    /**
     * Le nom de la section actuelle en cours de rendu, le cas échéant.
     *
     * @var string[]
     */
    protected $sectionStack = [];

    /**
     * Contient les css charges a partie de la section actuelle en cours de rendu
     *
     * @var array
     */
    protected $_styles = [];

    /**
     * Contient les librairies css charges a partie de la section actuelle en cours de rendu
     *
     * @var array
     */
    protected $_lib_styles = [];

    /**
     * Contient les scripts js charges a partie de la section actuelle en cours de rendu
     *
     * @var array
     */
    protected $_scripts = [];

    /**
     * Contient les scripts js des librairies charges a partie de la section actuelle en cours de rendu
     *
     * @var array
     */
    protected $_lib_scripts = [];

    /**
     * {@inheritDoc}
     */
    public function __construct(protected array $config, $viewPathLocator = null, protected bool $debug = BLITZ_DEBUG)
    {
        parent::__construct($config, $viewPathLocator, $debug);

        $this->saveData = (bool) ($config['save_data'] ?? true);
    }

    /**
     * {@inheritDoc}
     */
    public function render(string $view, ?array $options = null, ?bool $saveData = null): string
    {
        $this->renderVars['start']   = microtime(true);
        $this->renderVars['view']    = $view;
        $this->renderVars['options'] = $options ?? [];

        // Stocke les résultats ici donc même si
        // plusieurs vues sont appelées dans une vue, ce ne sera pas le cas
        // nettoyez-le sauf si nous le voulons.
        $saveData ??= $this->saveData;

        // A-t-il été mis en cache ?
        if (isset($this->renderVars['options']['cache'])) {
            $cacheName = $this->renderVars['options']['cache_name'] ?? str_replace('.php', '', $this->renderVars['view']);
            $cacheName = str_replace(['\\', '/'], '', $cacheName);

            $this->renderVars['cacheName'] = $cacheName;

            if ($output = cache($this->renderVars['cacheName'])) {
                $this->logPerformance($this->renderVars['start'], microtime(true), $this->renderVars['view']);
                $this->logPerformance(/** @scrutinizer ignore-type */ $this->renderVars['start'], microtime(true), $this->renderVars['view']);

                return $output;

            }
        }

        $this->renderVars['file'] = $this->getRenderedFile($this->renderVars['options'], $this->renderVars['view'], 'php');

        // Rendre nos données de vue disponibles pour la vue.
        $this->prepareTemplateData($saveData);

        // Enregistrer les variables actuelles
        $renderVars = $this->renderVars;

        $output = (function (): string {
            extract($this->tempData);
            ob_start();
            include $this->renderVars['file'];

            return ob_get_clean() ?: '';
        })();

        // Lors de l'utilisation de mises en page, les données ont déjà été stockées
        // dans $this->sections, et aucune autre sortie valide
        // est autorisé dans $output donc nous allons l'écraser.
        if ($this->layout !== null && $this->sectionStack === []) {
            $layoutView   = $this->layout;
            $this->layout = null;
            // Enregistrer les variables actuelles
            $renderVars = $this->renderVars;
            $output     = $this->render($layoutView, array_merge($options ?? [], ['viewPath' => LAYOUT_PATH]), $saveData);
        }

        $this->logPerformance($this->renderVars['start'], microtime(true), $this->renderVars['view']);

        if (($this->debug && (! isset($options['debug']) || $options['debug'] === true))) {
            // Nettoyer nos noms de chemins pour les rendre un peu plus propres
            $this->renderVars['file'] = clean_path($this->renderVars['file']);
            $this->renderVars['file'] = ++$this->viewsCount . ' ' . $this->renderVars['file'];

            $output = '<!-- DEBUG-VIEW START ' . $this->renderVars['file'] . ' -->' . PHP_EOL
                . $output . PHP_EOL
                . '<!-- DEBUG-VIEW ENDED ' . $this->renderVars['file'] . ' -->' . PHP_EOL;
        }

        // Faut-il mettre en cache ?
        if (isset($this->renderVars['options']['cache'])) {
            cache()->write($this->renderVars['cacheName'], $output, (int) $this->renderVars['options']['cache']);
        }

        $this->tempData = null;

        // Récupère les variables actuelles
        $this->renderVars = $renderVars;

        return $output;
    }

    /**
     * {@inheritDoc}
     */
    public function renderString(string $view, ?array $options = null, ?bool $saveData = null): string
    {
        $start = microtime(true);
        $saveData ??= $this->saveData;
        $this->prepareTemplateData($saveData);

        $output = (function (string $view): string {
            extract($this->tempData);
            ob_start();
            eval('?>' . $view);


            return ob_get_clean() ?: '';
        })($view);

        $this->logPerformance($start, microtime(true), $this->excerpt($view));
        $this->logPerformance(/** @scrutinizer ignore-type */ $start, microtime(true), $this->excerpt($view));
        $this->tempData = null;

        return $output;
    }

    /**
     * Extraire le premier bit d'une longue chaîne et ajouter des points de suspension
     */
    public function excerpt(string $string, int $length = 20): string
    {
        return (strlen($string) > $length) ? substr($string, 0, $length - 3) . '...' : $string;
    }

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

        $this->tempData = $data;

        return $this;
    }

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

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

        return $this;
    }

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

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

        return $this;
    }

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

    /**
     * Spécifie que la vue actuelle doit étendre une mise en page existante.
     */
    public function extend(string $layout)
    {
        $this->layout = $layout;
    }

    /**
     * Commence contient le contenu d'une section dans la mise en page.
     */
    public function start(string $name, ?string $content = null)
    {
        if (null === $content) {
            $this->sectionStack[] = $name;

            ob_start();
        } else {
            $this->sections[$name] = [$content];
        }
    }

    /**
     * Commence contient le contenu d'une section dans la mise en page.
     *
     * @alias self::start()
     */
    public function section(string $name, ?string $content = null): void
    {
        $this->start($name, $content);
    }

    /**
     * Commence contient le contenu d'une section dans la mise en page.
     *
     * @alias self::start()
     */
    public function begin(string $name, ?string $content = null): void
    {
        $this->start($name, $content);
    }

    /**
     * Capture la dernière section
     *
     * @throws RuntimeException
     */
    public function stop()
    {
        $contents = ob_get_clean();

        if ($this->sectionStack === []) {
            throw new RuntimeException('View themes, no current section.');
        }

        $section = array_pop($this->sectionStack);

        // Assurez-vous qu'un tableau existe afin que nous puissions stocker plusieurs entrées pour cela.
        if (! array_key_exists($section, $this->sections)) {
            $this->sections[$section] = [];
        }

        $this->sections[$section][] = $contents;
    }

    /**
     * Capture la dernière section
     *
     * @throws RuntimeException
     *
     * @alias self::stop()
     */
    public function endSection(): void
    {
        $this->stop();
    }

    /**
     * Capture la dernière section
     *
     * @throws RuntimeException
     *
     * @alias self::stop()
     */
    public function end(): void
    {
        $this->stop();
    }

    /**
     * Restitue le contenu d'une section.
     */
    public function show(string $sectionName, bool $preserve = false)
    {
        if (! isset($this->sections[$sectionName])) {
            echo '';

            return;
        }

        $start = $end = '';
        if ($sectionName === 'css') {
            $start = "<style type=\"text/css\">\n";
            $end   = "</style>\n";
        }
        if ($sectionName === 'js') {
            $start = "<script type=\"text/javascript\">\n";
            $end   = "</script>\n";
        }

        echo $start;

        foreach ($this->sections[$sectionName] as $key => $contents) {
            echo $contents;

            if (false === $preserve) {
                unset($this->sections[$sectionName][$key]);
            }
        }

        echo $end;
    }

    /**
     * Affichage rapide du contenu principal
     */
    public function renderView(): void
    {
        $this->show('content');
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires.
     *
     * @param mixed $saveData
     */
    public function insert(string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        $view = preg_replace('#\.php$#i', '', $view) . '.php';
        $view = str_replace(' ', '', $view);

        if ($view[0] !== '/') {
            $view = $this->retrievePartialPath($view);
        }

        return $this->addData($data)->render($view, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires.
     *
     * @alias self::insert()
     *
     * @param mixed $saveData
     */
    public function include(string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        return $this->insert($view, $data, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires lorsqu'une condition est remplie.
     *
     * @param mixed $saveData
     */
    public function insertWhen(bool|callable $condition, string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        if (is_callable($condition)) {
            $condition = call_user_func($condition);
            $condition = call_user_func(/** @scrutinizer ignore-type */ $condition);
        }

        if (true === $condition) {
            return $this->insert($view, $data, $options, $saveData);
        }

        return '';
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires lorsqu'une condition est remplie.
     *
     * @alias self::insertWhen()
     *
     * @param mixed $saveData
     */
    public function includeWhen(bool|callable $condition, string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        return $this->insertWhen($condition, $view, $data, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires lorsqu'une condition n'est pas remplie.
     * 
     * @param mixed $saveData
     */
    public function insertUnless(bool|callable $condition, string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        if (is_callable($condition)) {
            $condition = call_user_func($condition);
            $condition = call_user_func(/** @scrutinizer ignore-type */ $condition);
        }

        return $this->insertWhen(false === $condition, $view, $data, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires lorsqu'une condition n'est pas remplie.
     *
     * @alias self::insertUnless()
     *
     * @param mixed $saveData
     */
    public function includeUnless(bool|callable $condition, string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        return $this->insertUnless($condition, $view, $data, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires si elle existe.
     *
     * @alias self::insertIf()
     *
     * @param mixed $saveData
     */
    public function includeIf(string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        return $this->insertIf($view, $data, $options, $saveData);
    }

    /**
     * Utilisé dans les vues de mise en page pour inclure des vues supplémentaires si elle existe.
     *
     * @param mixed $saveData
     */
    public function insertIf(string $view, ?array $data = [], ?array $options = null, $saveData = true): string
    {
        $view = preg_replace('#\.php$#i', '', $view) . '.php';
        $view = str_replace(' ', '', $view);

        if ($view[0] !== '/') {
            $view = $this->retrievePartialPath($view);
        }

        if (is_file($view)) {
            return $this->addData($data)->render($view, $options, $saveData);
        }
        
        return '';
    }


    /**
     * Ajoute un fichier css de librairie a la vue
     */
    public function addLibCss(string ...$src): self
    {
        foreach ($src as $var) {
            if (! in_array($var, $this->_lib_styles, true)) {
                $this->_lib_styles[] = $var;
            }
        }

        return $this;
    }

    /**
     * Ajoute un fichier css a la vue
     */
    public function addCss(string ...$src): self
    {
        foreach ($src as $var) {
            if (! in_array($var, $this->_styles, true)) {
                $this->_styles[] = $var;
            }
        }

        return $this;
    }

    /**
     * Compile les fichiers de style de l'instance et genere les link:href vers ceux-ci
     */
    public function stylesBundle(string ...$groups): void
    {
        $groups     = (array) (empty($groups) ? $this->layout ?? 'default' : $groups);
        $lib_styles = $styles = [];

        foreach ($groups as $group) {
            $lib_styles = array_merge(
                $lib_styles,
                // (array) config('layout.'.$group.'.lib_styles'),
                $this->_lib_styles ?? []
            );
            $styles = array_merge(
                $styles,
                // (array) config('layout.'.$group.'.styles'),
                $this->_styles ?? []
            );
        }

        if (! empty($lib_styles)) {
            lib_styles(array_unique($lib_styles));
        }
        if (! empty($styles)) {
            styles(array_unique($styles));
        }

        $this->show('css');
    }

    /**
     * Ajoute un fichier js de librairie a la vue
     */
    public function addLibJs(string ...$src): self
    {
        foreach ($src as $var) {
            if (! in_array($var, $this->_lib_scripts, true)) {
                $this->_lib_scripts[] = $var;
            }
        }

        return $this;
    }

    /**
     * Ajoute un fichier js a la vue
     */
    public function addJs(string ...$src): self
    {
        foreach ($src as $var) {
            if (! in_array($var, $this->_scripts, true)) {
                $this->_scripts[] = $var;
            }
        }

        return $this;
    }

    /**
     * Compile les fichiers de script de l'instance et genere les link:href vers ceux-ci
     */
    public function scriptsBundle(string ...$groups): void
    {
        $groups      = (array) (empty($groups) ? $this->layout ?? 'default' : $groups);
        $lib_scripts = $scripts = [];

        foreach ($groups as $group) {
            $lib_scripts = array_merge(
                $lib_scripts,
                // (array) config('layout.'.$group.'.lib_scripts'),
                $this->_lib_scripts ?? []
            );
            $scripts = array_merge(
                $scripts,
                // (array) config('layout.'.$group.'.scripts'),
                $this->_scripts ?? []
            );
        }

        if (! empty($lib_scripts)) {
            lib_scripts(array_unique($lib_scripts));
        }
        if (! empty($scripts)) {
            scripts(array_unique($scripts));
        }

        $this->show('js');
    }

    protected function prepareTemplateData(bool $saveData): void
    {
        $this->tempData ??= $this->data;

        if ($saveData) {
            $this->data = $this->tempData;
        }
    }

    private function retrievePartialPath(string $view): string
    {
        $current_dir = pathinfo($this->renderVars['file'] ?? '', PATHINFO_DIRNAME);
        if (file_exists(rtrim($current_dir, DS) . DS . $view)) {
        if (file_exists(rtrim(/** @scrutinizer ignore-type */ $current_dir, DS) . DS . $view)) {
            $view = rtrim($current_dir, DS) . DS . $view;
        } elseif (file_exists(rtrim($current_dir, DS) . DS . 'partials' . DS . $view)) {
            $view = rtrim($current_dir, DS) . DS . 'partials' . DS . $view;
        } elseif (file_exists($this->viewPath . 'partials' . DS . $view)) {
            $view = $this->viewPath . 'partials' . DS . $view;
        } elseif (file_exists($this->viewPath . trim(dirname($current_dir), '/\\') . DS . $view)) {
        } elseif (file_exists($this->viewPath . trim(dirname(/** @scrutinizer ignore-type */ $current_dir), '/\\') . DS . $view)) {
            $view = $this->viewPath . trim(dirname($current_dir), '/\\') . DS . $view;
        } elseif (file_exists(VIEW_PATH . 'partials' . DS . $view)) {
            $view = VIEW_PATH . 'partials' . DS . $view;
        } elseif (file_exists(VIEW_PATH . trim(dirname($current_dir), '/\\') . DS . $view)) {
            $view = VIEW_PATH . trim(dirname($current_dir), '/\\') . DS . $view;
        }

        return $view;
    }
}

blitz-php / framework

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

NativeAdapter::retrievePartialPath() B

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
