Overview

Namespaces

  • MvcCore
    • Ext
      • Auth
        • Virtual
      • Debug
        • Tracy
      • Form
        • Core
        • Validators
      • Request
      • Router
        • Lang
      • View
        • Helpers
  • None

Classes

  • MvcCore
  • MvcCore\Config
  • MvcCore\Controller
  • MvcCore\Debug
  • MvcCore\Ext\Auth
  • MvcCore\Ext\Auth\Controller
  • MvcCore\Ext\Auth\SignInForm
  • MvcCore\Ext\Auth\SignOutForm
  • MvcCore\Ext\Auth\User
  • MvcCore\Ext\Auth\Virtual\Controller
  • MvcCore\Ext\Auth\Virtual\Form
  • MvcCore\Ext\Auth\Virtual\User
  • MvcCore\Ext\Debug\Tracy
  • MvcCore\Ext\Debug\Tracy\AuthPanel
  • MvcCore\Ext\Debug\Tracy\IncludePanel
  • MvcCore\Ext\Debug\Tracy\MvcCorePanel
  • MvcCore\Ext\Debug\Tracy\RoutingPanel
  • MvcCore\Ext\Debug\Tracy\SessionPanel
  • MvcCore\Ext\Form
  • MvcCore\Ext\Form\Button
  • MvcCore\Ext\Form\Checkbox
  • MvcCore\Ext\Form\CheckboxGroup
  • MvcCore\Ext\Form\Core\Base
  • MvcCore\Ext\Form\Core\Configuration
  • MvcCore\Ext\Form\Core\Field
  • MvcCore\Ext\Form\Core\FieldGroup
  • MvcCore\Ext\Form\Core\Helpers
  • MvcCore\Ext\Form\Core\Validator
  • MvcCore\Ext\Form\Core\View
  • MvcCore\Ext\Form\CountrySelect
  • MvcCore\Ext\Form\Date
  • MvcCore\Ext\Form\DateTime
  • MvcCore\Ext\Form\Email
  • MvcCore\Ext\Form\Hidden
  • MvcCore\Ext\Form\NoType
  • MvcCore\Ext\Form\Number
  • MvcCore\Ext\Form\Password
  • MvcCore\Ext\Form\RadioGroup
  • MvcCore\Ext\Form\Range
  • MvcCore\Ext\Form\ResetButton
  • MvcCore\Ext\Form\ResetInput
  • MvcCore\Ext\Form\Select
  • MvcCore\Ext\Form\SubmitButton
  • MvcCore\Ext\Form\SubmitInput
  • MvcCore\Ext\Form\Text
  • MvcCore\Ext\Form\Textarea
  • MvcCore\Ext\Form\Time
  • MvcCore\Ext\Form\Validators\CompanyId
  • MvcCore\Ext\Form\Validators\CompanyVatId
  • MvcCore\Ext\Form\Validators\Date
  • MvcCore\Ext\Form\Validators\Email
  • MvcCore\Ext\Form\Validators\FloatVal
  • MvcCore\Ext\Form\Validators\Integer
  • MvcCore\Ext\Form\Validators\Maxlength
  • MvcCore\Ext\Form\Validators\MaxSelectedOptions
  • MvcCore\Ext\Form\Validators\MinSelectedOptions
  • MvcCore\Ext\Form\Validators\NumberField
  • MvcCore\Ext\Form\Validators\Pattern
  • MvcCore\Ext\Form\Validators\Phone
  • MvcCore\Ext\Form\Validators\RangeField
  • MvcCore\Ext\Form\Validators\SafeString
  • MvcCore\Ext\Form\Validators\Time
  • MvcCore\Ext\Form\Validators\Url
  • MvcCore\Ext\Form\Validators\ValueInOptions
  • MvcCore\Ext\Form\Validators\ZipCode
  • MvcCore\Ext\Request\ApacheDpi
  • MvcCore\Ext\Request\Cli
  • MvcCore\Ext\Router\Lang
  • MvcCore\Ext\Router\Lang\Route
  • MvcCore\Ext\Router\Media
  • MvcCore\Ext\Router\MediaSiteKey
  • MvcCore\Ext\View\Helpers\Assets
  • MvcCore\Ext\View\Helpers\Css
  • MvcCore\Ext\View\Helpers\Js
  • MvcCore\Ext\View\Helpers\LineBreaks
  • MvcCore\Model
  • MvcCore\Request
  • MvcCore\Response
  • MvcCore\Route
  • MvcCore\Router
  • MvcCore\Session
  • MvcCore\Tool
  • MvcCore\View

Exceptions

  • MvcCore\Ext\Form\Core\Exception
  • Overview
  • Namespace
  • Class
  • Tree
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 
<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom FlĂ­dr (https://github.com/mvccore/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/4.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Request;

/**
 * MvcCore Cli Request extension:
 * - linear request url parsing from $_SERVER into local properties describing app root and params
 * - params reading from $_SERVER['argv'] in double dash, single dash or no dash form with or without equal char
 * - params cleaning by developer rules
 */
class Cli extends \MvcCore\Request
{
    /**
     * MvcCore Extension - Request CLI - version:
     * Comparation by PHP function version_compare();
     * @see http://php.net/manual/en/function.version-compare.php
     */
    const VERSION = '4.2.0';
    
    /**
     * Application console mode. TRUE if application is running in console mode (php_sapi_name() == 'cli').
     * @var bool
     */
    public $Console     = FALSE;

    /**
     * Get everytime new instance of http request,
     * global variables should be changed and injected here
     * to get different request object from currently called real request.
     *
     * @param array $server
     * @param array $get
     * @param array $post
     */
    public function __construct (array & $server, array & $get, array & $post) {
        $this->serverGlobals = $server;
        $this->getGlobals = $get;
        $this->postGlobals = $post;
        
        $this->Console = php_sapi_name() == 'cli';

        $this->initScriptName();
        $this->initAppRoot();
        if ($this->Console) {
            $this->initCliParams();
        } else {
            $this->initMethod();
            $this->initBasePath();
            $this->initProtocol();
            $this->initParsedUrlSegments();
            $this->initHttpParams();
            $this->initPath();
            $this->initReferer();
            $this->initUrlCompositions();
        }

        unset($this->serverGlobals, $this->getGlobals, $this->postGlobals);
    }

    /**
     * Initialize index.php script name.
     * @return void
     */
    protected function initScriptName () {
        $this->indexScriptName = str_replace('\\', '/', $this->serverGlobals['SCRIPT_NAME']);
        if (!$this->Console)
            $this->ScriptName = '/' . substr($this->indexScriptName, strrpos($this->indexScriptName, '/') + 1);
    }

    /**
     * Initialize application root directory.
     * @return void
     */
    protected function initAppRoot () {
        // $appRootRelativePath = mb_substr($this->indexScriptName, 0, strrpos($this->indexScriptName, '/') + 1);
        // ucfirst - cause IIS has lower case drive name here - different from __DIR__ value
        $indexFilePath = $this->Console
            ? str_replace('\\', '/', getcwd()) . '/' . $_SERVER['SCRIPT_FILENAME']
            : ucfirst(str_replace('\\', '/', $this->serverGlobals['SCRIPT_FILENAME']));
        if (strpos(__FILE__, 'phar://') === 0) {
            $appRootFullPath = 'phar://' . $indexFilePath;
        } else {
            $appRootFullPath = substr($indexFilePath, 0, mb_strrpos($indexFilePath, '/'));
        }
        $this->AppRoot = str_replace(array('\\', '//'), '/', $appRootFullPath);
    }

    /**
     * Initialize params from cli.
     * @example
     *      php index.php -c index -a index --id 10 --switch -sw
     *      php index.php --controller index --action index --id 10 --switch --s --w
     *      php index.php --controller=index --action=index -id 10 --switch -sw
     * @return void
     */
    protected function initCliParams () {
        $rawArgs = $this->serverGlobals['argv'];
        if (isset($rawArgs[0]) && $rawArgs[0] == $this->indexScriptName) array_shift($rawArgs);
        $params = array();
        $dash = '-';
        for ($i = 0, $l = count($rawArgs); $i < $l; $i += 1) {
            $rawArg = $rawArgs[$i];
            $nextRawArg = isset($rawArgs[$i + 1]) ? $rawArgs[$i + 1] : NULL;
            $nextRawArgIsValue = !is_null($nextRawArg) && substr($nextRawArg, 0, 1) != $dash;
            $rawArgLength = strlen($rawArg);
            if ($rawArgLength > 1) {
                $firstChar = substr($rawArg, 0, 1);
                $secondChar = substr($rawArg, 1, 1);
                if ($firstChar == $dash && $secondChar != $dash) {
                    $i = $this->initCliParamSingleDash($i, $params, $rawArg, $nextRawArg, $nextRawArgIsValue);
                } else if ($firstChar == $dash && $secondChar == $dash) {
                    $i = $this->initCliParamDoubleDash($i, $params, $rawArg, $nextRawArg, $nextRawArgIsValue);
                } else {
                    $this->initCliParamNoDash($params, $rawArg);
                }
            }
        }
        $this->initCliParamsCleanQuotes($params);
        $this->Params = $params;
    }

    /**
     * Initialize params from cli, starting with single dash, with value assigned by equal char or after space as another query part if any, else boolean true.
     * @return void
     */
    protected function initCliParamSingleDash ($i, & $params, & $rawArg, & $nextRawArg, & $nextRawArgIsValue) {
        // single dash param: -c | -a | -o | -opq
        $param = substr($rawArg, 1);
        $equalPos = strpos($param, '=');
        if ($equalPos !== FALSE) {
            // equal character:
            $params[substr($param, 0, $equalPos)] = substr($param, $equalPos + 1);
        } else {
            // no equal character:
            if (strlen($param) > 1 && !$nextRawArgIsValue) {
                for ($j = 0, $k = strlen($param); $j < $k; $j += 1) $params[$param[$j]] = TRUE;
            } else {
                if ($param == 'c' && $nextRawArgIsValue) {
                    $params['controller'] = $nextRawArg;
                } else if ($param == 'a' && $nextRawArgIsValue) {
                    $params['action'] = $nextRawArg;
                } else {
                    $params[$param] = $nextRawArg;
                }
                $i += 1;
            }
        }
        return $i;
    }

    /**
     * Initialize params from cli, starting with double dash, with value assigned by equal char or after space as another query part if any, else boolean true.
     * @return void
     */
    protected function initCliParamDoubleDash ($i, & $params, & $rawArg, & $nextRawArg, & $nextRawArgIsValue) {
        // double dash param: --controller controllerValue | --action actionValue | -other anyOtherValue
        $param = substr($rawArg, 2);
        $equalPos = strpos($param, '=');
        if ($equalPos !== FALSE) {
            // equal character:
            $params[substr($param, 0, $equalPos)] = substr($param, $equalPos + 1);
        } else if ($nextRawArgIsValue) {
            // no equal character:
            $params[$param] = $nextRawArg;
            $i += 1;
        } else {
            $params[$param] = TRUE;
        }
        return $i;
    }

    /**
     * Initialize params from cli, starting without dash, with value assigned by equal char or after space as another query part if any, else boolean true.
     * @return void
     */
    protected function initCliParamNoDash (& $params, & $rawArg) {
        $equalPos = strpos($rawArg, '=');
        if ($equalPos !== FALSE) {
            // equal character:
            $params[substr($rawArg, 0, $equalPos)] = substr($rawArg, $equalPos + 1);
        } else {
            // no equal character:
            array_push($params, $rawArg);
        }
    }

    /**
     * Initialize params from cli, clean trailing quotes: " ' `
     * @return void
     */
    protected function initCliParamsCleanQuotes (& $params) {
        $quotChars = array('"', "'", '`');
        foreach ($params as & $value) {
            foreach ($quotChars as $quotChar) {
                if (mb_strpos($value, $quotChar) !== 0) continue;
                if (mb_strrpos($value, $quotChar) !== mb_strlen($value) - 1) continue;
                $value = trim($value, $quotChar);
            }
        }
    }
}
MvcCore API documentation generated by ApiGen