Generator::getJsLibUri() - Code Metrics - Inspection of "Merge pull request #59 from jaxon-php/feature/pack..." - jaxon-php/jaxon-core - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( f54e31...ad3cee )

by Thierry

created 2019-12-07 10:51 UTC

Generator::getJsLibUri() A

↳ Parent: Generator

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	1
nc	1
nop	0
dl	0
loc	4
rs	10
c	0
b	0
f	0

<?php

/**
 * Generator.php - Jaxon code generator
 *
 * Generate HTML, CSS and Javascript code for Jaxon.
 *
 * @package jaxon-core

 * @author Thierry Feuzeu <[email protected]>
 * @copyright 2016 Thierry Feuzeu <[email protected]>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-core
 */


namespace Jaxon\Plugin\Code;

use Jaxon\Utils\Template\Engine as TemplateEngine;
use Jaxon\Utils\Http\URI;

use Jaxon\Plugin\Code\Contracts\Generator as GeneratorContract;

class Generator

{
    use \Jaxon\Features\Config;
    use \Jaxon\Features\Minifier;

    /**
     * The response type.
     *
     * @var string
     */
    const RESPONSE_TYPE = 'JSON';

    /**
     * The objects that generate code
     *
     * @var array<GeneratorContract>
     */
    protected $aGenerators = [];

    /**
     * The Jaxon template engine
     *
     * @var TemplateEngine
     */
    protected $xTemplateEngine;

    /**
     * HTML tags to include CSS code and files into the page
     *
     * @var string
     */
    protected $sCssCode = '';

    /**
     * HTML tags to include javascript code and files into the page
     *
     * @var string
     */
    protected $sJsCode = '';

    /**
     * Javascript code to include into the page
     *
     * @var string
     */
    protected $sJsScript = '';

    /**
     * Javascript code to execute after page load
     *
     * @var string
     */
    protected $sJsReadyScript = '';

    /**
     * Code already generated
     *
     * @var boolean
     */
    protected $sCodeGenerated = false;

    /**
     * Default library URL
     *
     * @var string
     */
    protected $sJsLibraryUrl = 'https://cdn.jsdelivr.net/gh/jaxon-php/[email protected]/dist';

    /**
     * The constructor
     *
     * @param TemplateEngine        $xTemplateEngine      The template engine

     */
    public function __construct(TemplateEngine $xTemplateEngine)

    {
        $this->xTemplateEngine = $xTemplateEngine;
    }


    /**
     * Add a new generator to the list
     *
     * @param GeneratorContract     $xGenerator     The code generator

     * @param integer               $nPriority      The desired priority, used to order the plugins

     *
     * @return void
     */
    public function addGenerator(GeneratorContract $xGenerator, $nPriority)
    {
        while(isset($this->aGenerators[$nPriority]))
        {
            $nPriority++;
        }
        $this->aGenerators[$nPriority] = $xGenerator;
        // Sort the array by ascending keys
        ksort($this->aGenerators);
    }


    /**
     * Generate a hash for all the javascript code generated by the library
     *
     * @return string
     */
    private function getHash()
    {
        $sHash = jaxon()->getVersion();
        foreach($this->aGenerators as $xGenerator)
        {
            $sHash .= $xGenerator->getHash();
        }
        return md5($sHash);
    }


    /**
     * Get the HTML tags to include Jaxon javascript files into the page
     *
     * @return void
     */
    private function generateCode()
    {
        if($this->sCodeGenerated)
        {
            return;
        }
        $this->sCodeGenerated = true;

        foreach($this->aGenerators as $xGenerator)
        {
            if(($sCssCode = $xGenerator->getCss()))

            {
                $this->sCssCode .= rtrim($sCssCode, " \n") . "\n";
            }
            if(($sJsCode = $xGenerator->getJs()))

            {
                $this->sJsCode .= rtrim($sJsCode, " \n") . "\n";
            }
            if(($sJsScript = $xGenerator->getScript()))

            {
                $this->sJsScript .= rtrim($sJsScript, " \n") . "\n";
            }
            if(($sJsReadyScript = $xGenerator->getReadyScript()))

            {
                $this->sJsReadyScript .= rtrim($sJsReadyScript, " \n") . "\n";
            }
        }
    }


    /**
     * Get the base URI of the Jaxon library javascript files
     *
     * @return string
     */
    private function getJsLibUri()
    {
        return rtrim($this->getOption('js.lib.uri', $this->sJsLibraryUrl), '/') . '/';
    }


    /**
     * Get the extension of the Jaxon library javascript files
     *
     * The returned string is '.min.js' if the files are minified.
     *
     * @return string
     */
    private function getJsLibExt()
    {
        if(($this->getOption('js.app.minify')))
        {
            return '.min.js';
        }
        return '.js';
    }


    /**
     * Check if the javascript code generated by Jaxon can be exported to an external file
     *
     * @return boolean
     */
    public function canExportJavascript()
    {
        // Check config options
        // - The js.app.export option must be set to true
        // - The js.app.uri and js.app.dir options must be set to non null values
        if(!$this->getOption('js.app.export') ||
            !$this->getOption('js.app.uri') ||
            !$this->getOption('js.app.dir'))
        {
            return false;
        }
        // Check dir access
        // - The js.app.dir must be writable
        $sJsAppDir = $this->getOption('js.app.dir');
        if(!is_dir($sJsAppDir) || !is_writable($sJsAppDir))
        {
            return false;
        }
        return true;
    }


    /**
     * Get the HTML tags to include Jaxon javascript files into the page
     *
     * @return string
     */
    public function getJs()
    {
        $sJsLibUri = $this->getJsLibUri();
$a = "a";
$ab = "ab";
$abc = "abc";
        $sJsLibExt = $this->getJsLibExt();
$a = "a";
$ab = "ab";
$abc = "abc";
        $sJsCoreUrl = $sJsLibUri . 'jaxon.core' . $sJsLibExt;
$a = "a";
$ab = "ab";
$abc = "abc";
        $sJsDebugUrl = $sJsLibUri . 'jaxon.debug' . $sJsLibExt;
        // $sJsVerboseUrl = $sJsLibUri . 'jaxon.verbose' . $sJsLibExt;
        $sJsLanguageUrl = $sJsLibUri . 'lang/jaxon.' . $this->getOption('core.language') . $sJsLibExt;

        // Add component files to the javascript file array;
        $aJsFiles = [$sJsCoreUrl];
        if($this->getOption('core.debug.on'))
        {
            $aJsFiles[] = $sJsDebugUrl;
            $aJsFiles[] = $sJsLanguageUrl;
            /*if($this->getOption('core.debug.verbose'))

            {
                $aJsFiles[] = $sJsVerboseUrl;
            }*/
        }

        // Set the template engine cache dir
        $this->generateCode();

        return $this->xTemplateEngine->render('jaxon::plugins/includes.js', [
            'sJsOptions' => $this->getOption('js.app.options', ''),
            'aUrls' => $aJsFiles,
        ]) . $this->sJsCode;
    }


    /**
     * Get the HTML tags to include Jaxon CSS code and files into the page
     *
     * @return string
     */
    public function getCss()
    {
        // Set the template engine cache dir
        $this->generateCode();

        return $this->sCssCode;
    }


    /**
     * Get the correspondances between previous and current config options
     *
     * They are used to keep the deprecated config options working.
     * They will be removed when the deprecated options will lot be supported anymore.
     *
     * @return array
     */
    private function getOptionVars()
    {
        return [
            'sResponseType'             => self::RESPONSE_TYPE,
            'sVersion'                  => $this->getOption('core.version'),
            'sLanguage'                 => $this->getOption('core.language'),
            'bLanguage'                 => $this->hasOption('core.language') ? true : false,
            'sRequestURI'               => $this->getOption('core.request.uri'),
            'sDefaultMode'              => $this->getOption('core.request.mode'),
            'sDefaultMethod'            => $this->getOption('core.request.method'),
            'sCsrfMetaName'             => $this->getOption('core.request.csrf_meta'),
            'bDebug'                    => $this->getOption('core.debug.on'),
            'bVerboseDebug'             => $this->getOption('core.debug.verbose'),
            'sDebugOutputID'            => $this->getOption('core.debug.output_id'),
            'nResponseQueueSize'        => $this->getOption('js.lib.queue_size'),
            'sStatusMessages'           => $this->getOption('js.lib.show_status') ? 'true' : 'false',
            'sWaitCursor'               => $this->getOption('js.lib.show_cursor') ? 'true' : 'false',
            'sDefer'                    => $this->getOption('js.app.options', ''),
        ];
    }


    /**
     * Get the javascript code to be sent to the browser
     *
     * @return string
     */
    private function _getScript()
    {
        $aVars = $this->getOptionVars();
$a = "a";
$ab = "ab";
$abc = "abc";
        $sYesScript = 'jaxon.ajax.response.process(command.response)';
$a = "a";
$ab = "ab";
$abc = "abc";
        $sNoScript = 'jaxon.confirm.skip(command);jaxon.ajax.response.process(command.response)';
$a = "a";
$ab = "ab";
$abc = "abc";
        $sQuestionScript = jaxon()->dialog()->confirm('msg', $sYesScript, $sNoScript);
$a = "a";
$ab = "ab";
$abc = "abc";
        $aVars['sQuestionScript'] = $this->xTemplateEngine->render('jaxon::plugins/confirm.js', [
            'sQuestionScript' => $sQuestionScript,
        ]);

        return $this->xTemplateEngine->render('jaxon::plugins/config.js', $aVars) . '
' . $this->sJsScript . '
jaxon.dom.ready(function() {
    jaxon.command.handler.register("cc", jaxon.confirm.commands);

' . $this->sJsReadyScript . '
});
';
    }


    /**
     * Write javascript files and return the corresponding URI
     *
     * @return string
     */
    private function _writeFiles()
    {
        $sJsAppURI = rtrim($this->getOption('js.app.uri'), '/') . '/';
$a = "a";
$ab = "ab";
$abc = "abc";
        $sJsAppDir = rtrim($this->getOption('js.app.dir'), '/') . '/';
$a = "a";
$ab = "ab";
$abc = "abc";
        $sFinalFile = $this->getOption('js.app.file');
        $sExtension = $this->getJsLibExt();

        // Check if the final file already exists
        if(($sFinalFile) && is_file($sJsAppDir . $sFinalFile . $sExtension))
        {
            return $sJsAppURI . $sFinalFile . $sExtension;
        }

        // The plugins scripts are written into the javascript app dir
        $sHash = $this->getHash();
$a = "a";
$ab = "ab";
$abc = "abc";
        $sOutFile = $sHash . '.js';
        $sMinFile = $sHash . '.min.js';
        if(!is_file($sJsAppDir . $sOutFile))
        {
            file_put_contents($sJsAppDir . $sOutFile, $this->_getScript());
        }
        if(($this->getOption('js.app.minify')))
        {
            if(is_file($sJsAppDir . $sMinFile))
            {
                $sOutFile = $sMinFile; // The file was already minified
            }
            elseif(($this->minify($sJsAppDir . $sOutFile, $sJsAppDir . $sMinFile)))
            {
                $sOutFile = $sMinFile;
            }
        }
        // Copy the file to its final location
        if(($sFinalFile))
        {
            if(copy($sJsAppDir . $sOutFile, $sJsAppDir . $sFinalFile . $sExtension))
            {
                $sOutFile = $sFinalFile . $sExtension;
            }
        }

        return $sJsAppURI . $sOutFile;
    }


    /**
     * Get the javascript code to be sent to the browser
     *
     * Also call each of the request plugins giving them the opportunity
     * to output some javascript to the page being generated.
     * This is called only when the page is being loaded initially.
     * This is not called when processing a request.
     *
     * @param boolean        $bIncludeJs            Also get the JS files

     * @param boolean        $bIncludeCss        Also get the CSS files

     *
     * @return string
     */
    public function getScript($bIncludeJs, $bIncludeCss)
    {
        if(!$this->getOption('core.request.uri'))
        {
            $this->setOption('core.request.uri', jaxon()->di()->get(URI::class)->detect());
        }

        // Set the template engine cache dir
        $this->generateCode();

        $sScript = '';
        if(($bIncludeCss))
        {
            $sScript .= $this->getCss() . "\n";
        }
        if(($bIncludeJs))
        {
            $sScript .= $this->getJs() . "\n";
        }

        if($this->canExportJavascript())
        {
            // The returned code loads the generated javascript file
            return $sScript . $this->xTemplateEngine->render('jaxon::plugins/include.js', [
                'sJsOptions' => $this->getOption('js.app.options', ''),
                'sUrl' => $this->_writeFiles(),
            ]);
        }

        // The plugins scripts are wrapped with javascript tags
        return $sScript . $this->xTemplateEngine->render('jaxon::plugins/wrapper.js', [
            'sJsOptions' => $this->getOption('js.app.options', ''),
            'sScript' => $this->_getScript(),
        ]);
    }

}


1			<?php
2
3			/**
4			* Generator.php - Jaxon code generator
5			*
6			* Generate HTML, CSS and Javascript code for Jaxon.
7			*
8			* @package jaxon-core
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Package name "jaxon-core" is not valid; consider "Jaxoncore" instead Loading history...
9			* @author Thierry Feuzeu <[email protected]>
10			* @copyright 2016 Thierry Feuzeu <[email protected]>
11			* @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
12			* @link https://github.com/jaxon-php/jaxon-core
13			*/
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report PHP version not specified Loading history... Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Missing @category tag in file comment Loading history...
14
15			namespace Jaxon\Plugin\Code;
16
17			use Jaxon\Utils\Template\Engine as TemplateEngine;
18			use Jaxon\Utils\Http\URI;
19
20			use Jaxon\Plugin\Code\Contracts\Generator as GeneratorContract;
21
22			class Generator
			0 ignored issues – show Coding Style introduced 2019-12-07 05:11 UTC by Report Bug Copy Issue Report Missing doc comment for class Generator Loading history...
23			{
24			use \Jaxon\Features\Config;
25			use \Jaxon\Features\Minifier;
26
27			/**
28			* The response type.
29			*
30			* @var string
31			*/
32			const RESPONSE_TYPE = 'JSON';
33
34			/**
35			* The objects that generate code
36			*
37			* @var array<GeneratorContract>

jaxon-php / jaxon-core

Push — master ( f54e31...ad3cee )

Generator::getJsLibUri() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like