Overview

Classes

  • MvcCore\Application
  • MvcCore\Config
  • MvcCore\Controller
  • MvcCore\Controller\AutoInit
  • MvcCore\Debug
  • MvcCore\Environment
  • MvcCore\Ext\Auth
  • MvcCore\Ext\Auths\Basic
  • MvcCore\Ext\Auths\Basics\Controller
  • MvcCore\Ext\Auths\Basics\Role
  • MvcCore\Ext\Auths\Basics\SignInForm
  • MvcCore\Ext\Auths\Basics\SignOutForm
  • MvcCore\Ext\Auths\Basics\User
  • MvcCore\Ext\Auths\Basics\Users\Database
  • MvcCore\Ext\Auths\Basics\Users\SystemConfig
  • MvcCore\Ext\Auths\User
  • MvcCore\Ext\Auths\Users\Database
  • MvcCore\Ext\Auths\Users\SystemConfig
  • MvcCore\Ext\Cache
  • MvcCore\Ext\Caches\Redis
  • MvcCore\Ext\Configs\Cached
  • MvcCore\Ext\Configs\Yaml
  • MvcCore\Ext\Debugs\Tracy
  • MvcCore\Ext\Debugs\Tracys\AuthPanel
  • MvcCore\Ext\Debugs\Tracys\IncludePanel
  • MvcCore\Ext\Debugs\Tracys\MvcCorePanel
  • MvcCore\Ext\Debugs\Tracys\RoutingPanel
  • MvcCore\Ext\Debugs\Tracys\SessionPanel
  • MvcCore\Ext\Form
  • MvcCore\Ext\Forms\Field
  • MvcCore\Ext\Forms\Fields\Button
  • MvcCore\Ext\Forms\Fields\ButtonInput
  • MvcCore\Ext\Forms\Fields\Checkbox
  • MvcCore\Ext\Forms\Fields\CheckboxGroup
  • MvcCore\Ext\Forms\Fields\Color
  • MvcCore\Ext\Forms\Fields\CountrySelect
  • MvcCore\Ext\Forms\Fields\DataList
  • MvcCore\Ext\Forms\Fields\Date
  • MvcCore\Ext\Forms\Fields\DateTime
  • MvcCore\Ext\Forms\Fields\Email
  • MvcCore\Ext\Forms\Fields\File
  • MvcCore\Ext\Forms\Fields\Hidden
  • MvcCore\Ext\Forms\Fields\Image
  • MvcCore\Ext\Forms\Fields\LocalizationSelect
  • MvcCore\Ext\Forms\Fields\Month
  • MvcCore\Ext\Forms\Fields\Number
  • MvcCore\Ext\Forms\Fields\Password
  • MvcCore\Ext\Forms\Fields\RadioGroup
  • MvcCore\Ext\Forms\Fields\Range
  • MvcCore\Ext\Forms\Fields\ResetButton
  • MvcCore\Ext\Forms\Fields\ResetInput
  • MvcCore\Ext\Forms\Fields\Search
  • MvcCore\Ext\Forms\Fields\Select
  • MvcCore\Ext\Forms\Fields\SubmitButton
  • MvcCore\Ext\Forms\Fields\SubmitInput
  • MvcCore\Ext\Forms\Fields\Tel
  • MvcCore\Ext\Forms\Fields\Text
  • MvcCore\Ext\Forms\Fields\Textarea
  • MvcCore\Ext\Forms\Fields\Time
  • MvcCore\Ext\Forms\Fields\Url
  • MvcCore\Ext\Forms\Fields\Week
  • MvcCore\Ext\Forms\FieldsGroup
  • MvcCore\Ext\Forms\Validator
  • MvcCore\Ext\Forms\Validators\Color
  • MvcCore\Ext\Forms\Validators\CompanyIdEu
  • MvcCore\Ext\Forms\Validators\CompanyVatIdEu
  • MvcCore\Ext\Forms\Validators\CreditCard
  • MvcCore\Ext\Forms\Validators\Date
  • MvcCore\Ext\Forms\Validators\DateTime
  • MvcCore\Ext\Forms\Validators\Email
  • MvcCore\Ext\Forms\Validators\Files
  • MvcCore\Ext\Forms\Validators\Files\Validations\BombScanners\GzArchive
  • MvcCore\Ext\Forms\Validators\Files\Validations\BombScanners\PngImage
  • MvcCore\Ext\Forms\Validators\Files\Validations\BombScanners\RarArchive
  • MvcCore\Ext\Forms\Validators\Files\Validations\BombScanners\ZipArchive
  • MvcCore\Ext\Forms\Validators\FloatNumber
  • MvcCore\Ext\Forms\Validators\Hex
  • MvcCore\Ext\Forms\Validators\Iban
  • MvcCore\Ext\Forms\Validators\IntNumber
  • MvcCore\Ext\Forms\Validators\Ip
  • MvcCore\Ext\Forms\Validators\MinMaxLength
  • MvcCore\Ext\Forms\Validators\MinMaxOptions
  • MvcCore\Ext\Forms\Validators\Month
  • MvcCore\Ext\Forms\Validators\Number
  • MvcCore\Ext\Forms\Validators\Password
  • MvcCore\Ext\Forms\Validators\Pattern
  • MvcCore\Ext\Forms\Validators\Range
  • MvcCore\Ext\Forms\Validators\SafeString
  • MvcCore\Ext\Forms\Validators\Tel
  • MvcCore\Ext\Forms\Validators\Time
  • MvcCore\Ext\Forms\Validators\Url
  • MvcCore\Ext\Forms\Validators\ValueInOptions
  • MvcCore\Ext\Forms\Validators\Week
  • MvcCore\Ext\Forms\Validators\ZipCode
  • MvcCore\Ext\Forms\View
  • MvcCore\Ext\Models\Db\Attrs\Column
  • MvcCore\Ext\Models\Db\Attrs\Connection
  • MvcCore\Ext\Models\Db\Attrs\Format
  • MvcCore\Ext\Models\Db\Attrs\KeyPrimary
  • MvcCore\Ext\Models\Db\Attrs\KeyUnique
  • MvcCore\Ext\Models\Db\Attrs\Table
  • MvcCore\Ext\Models\Db\Connection
  • MvcCore\Ext\Models\Db\Models\MySql
  • MvcCore\Ext\Models\Db\Models\PgSql
  • MvcCore\Ext\Models\Db\Models\Resource
  • MvcCore\Ext\Models\Db\Models\SQLite
  • MvcCore\Ext\Models\Db\Models\SqlSrv
  • MvcCore\Ext\Models\Db\Providers\Connections\MySql
  • MvcCore\Ext\Models\Db\Providers\Connections\PgSql
  • MvcCore\Ext\Models\Db\Providers\Connections\SQLite
  • MvcCore\Ext\Models\Db\Providers\Connections\SqlSrv
  • MvcCore\Ext\Models\Db\Providers\Resource
  • MvcCore\Ext\Models\Db\Providers\Resources\MySql
  • MvcCore\Ext\Models\Db\Providers\Resources\PgSql
  • MvcCore\Ext\Models\Db\Providers\Resources\SQLite
  • MvcCore\Ext\Models\Db\Providers\Resources\SqlSrv
  • MvcCore\Ext\Models\Db\Reader
  • MvcCore\Ext\Models\Db\Readers\Execution
  • MvcCore\Ext\Models\Db\Readers\Multiple
  • MvcCore\Ext\Models\Db\Readers\Single
  • MvcCore\Ext\Models\Db\Readers\Stream
  • MvcCore\Ext\Models\Db\Readers\Streams\Iterator
  • MvcCore\Ext\Models\Db\Statement
  • MvcCore\Ext\Models\Model
  • MvcCore\Ext\Routers\Localization
  • MvcCore\Ext\Routers\Localizations\Route
  • MvcCore\Ext\Routers\Media
  • MvcCore\Ext\Routers\MediaAndLocalization
  • MvcCore\Ext\Routers\Module
  • MvcCore\Ext\Routers\ModuleLocalization
  • MvcCore\Ext\Routers\ModuleMedia
  • MvcCore\Ext\Routers\ModuleMediaAndLocalization
  • MvcCore\Ext\Routers\Modules\Route
  • MvcCore\Ext\Tools\Image
  • MvcCore\Ext\Tools\Images\Gd
  • MvcCore\Ext\Tools\Images\Gds\ApplyMask
  • MvcCore\Ext\Tools\Images\Gds\RoundCorners
  • MvcCore\Ext\Tools\Images\Gds\UnsharpMask
  • MvcCore\Ext\Tools\Images\Imagick
  • MvcCore\Ext\Tools\Locale
  • MvcCore\Ext\Tools\Locales\FloatParser
  • MvcCore\Ext\Tools\MimeTypesExtensions
  • MvcCore\Ext\Views\Helpers\AbstractHelper
  • MvcCore\Ext\Views\Helpers\Assets
  • MvcCore\Ext\Views\Helpers\CssHelper
  • MvcCore\Ext\Views\Helpers\DataUrlHelper
  • MvcCore\Ext\Views\Helpers\FormatDateHelper
  • MvcCore\Ext\Views\Helpers\FormatMoneyHelper
  • MvcCore\Ext\Views\Helpers\FormatNumberHelper
  • MvcCore\Ext\Views\Helpers\InternationalizedHelper
  • MvcCore\Ext\Views\Helpers\JsHelper
  • MvcCore\Ext\Views\Helpers\LineBreaksHelper
  • MvcCore\Ext\Views\Helpers\TruncateHelper
  • MvcCore\Ext\Views\Helpers\WriteByJsHelper
  • MvcCore\Model
  • MvcCore\Request
  • MvcCore\Response
  • MvcCore\Route
  • MvcCore\Router
  • MvcCore\Session
  • MvcCore\Tool
  • MvcCore\View

Interfaces

  • MvcCore\Application\IConstants
  • MvcCore\Controller\IConstants
  • MvcCore\Debug\IConstants
  • MvcCore\Environment\IConstants
  • MvcCore\Ext\Auths\Basics\IController
  • MvcCore\Ext\Auths\Basics\IDatabaseUser
  • MvcCore\Ext\Auths\Basics\IForm
  • MvcCore\Ext\Auths\Basics\IRole
  • MvcCore\Ext\Auths\Basics\IUser
  • MvcCore\Ext\Auths\IBasic
  • MvcCore\Ext\Form\IConstants
  • MvcCore\Ext\Forms\Fields\IAlwaysValidate
  • MvcCore\Ext\Forms\Fields\IChecked
  • MvcCore\Ext\Forms\Fields\IDataList
  • MvcCore\Ext\Forms\Fields\IFile
  • MvcCore\Ext\Forms\Fields\IFormat
  • MvcCore\Ext\Forms\Fields\ILabel
  • MvcCore\Ext\Forms\Fields\IMinMaxLength
  • MvcCore\Ext\Forms\Fields\IMinMaxOptions
  • MvcCore\Ext\Forms\Fields\IMinMaxStepDates
  • MvcCore\Ext\Forms\Fields\IMinMaxStepNumbers
  • MvcCore\Ext\Forms\Fields\IMultiple
  • MvcCore\Ext\Forms\Fields\IOptions
  • MvcCore\Ext\Forms\Fields\IPattern
  • MvcCore\Ext\Forms\Fields\ISubmit
  • MvcCore\Ext\Forms\Fields\IVisibleField
  • MvcCore\Ext\Forms\IError
  • MvcCore\Ext\Forms\IField
  • MvcCore\Ext\Forms\IFieldsGroup
  • MvcCore\Ext\Forms\IValidator
  • MvcCore\Ext\Forms\IView
  • MvcCore\Ext\Forms\Validators\Files\Validations\IBombScanner
  • MvcCore\Ext\Forms\Validators\IFiles
  • MvcCore\Ext\ICache
  • MvcCore\Ext\IForm
  • MvcCore\Ext\Models\Db\IConnection
  • MvcCore\Ext\Models\Db\IModel
  • MvcCore\Ext\Models\Db\IReader
  • MvcCore\Ext\Models\Db\IStatement
  • MvcCore\Ext\Models\Db\Model\IConstants
  • MvcCore\Ext\Models\Db\Models\MySqls\IConstants
  • MvcCore\Ext\Models\Db\Models\PgSqls\IConstants
  • MvcCore\Ext\Models\Db\Models\SqlSrvs\IConstants
  • MvcCore\Ext\Models\Db\Readers\IExecution
  • MvcCore\Ext\Models\Db\Readers\IMultiple
  • MvcCore\Ext\Models\Db\Readers\ISingle
  • MvcCore\Ext\Models\Db\Readers\IStream
  • MvcCore\Ext\Models\Db\Readers\Streams\IIterator
  • MvcCore\Ext\Routers\IExtended
  • MvcCore\Ext\Routers\ILocalization
  • MvcCore\Ext\Routers\IMedia
  • MvcCore\Ext\Routers\IModule
  • MvcCore\Ext\Routers\Modules\IRoute
  • MvcCore\Ext\Tools\Images\IAdapter
  • MvcCore\Ext\Tools\Images\IComposite
  • MvcCore\Ext\Tools\Images\IFormat
  • MvcCore\Ext\Tools\Images\IImage
  • MvcCore\Ext\Tools\Images\Imagicks\IComposite
  • MvcCore\Ext\Tools\Images\IOrientation
  • MvcCore\Ext\Views\Helpers\IHelper
  • MvcCore\IApplication
  • MvcCore\IConfig
  • MvcCore\IController
  • MvcCore\IDebug
  • MvcCore\IEnvironment
  • MvcCore\IModel
  • MvcCore\IRequest
  • MvcCore\IResponse
  • MvcCore\IRoute
  • MvcCore\IRouter
  • MvcCore\ISession
  • MvcCore\ITool
  • MvcCore\IView
  • MvcCore\Model\IConstants
  • MvcCore\Request\IConstants
  • MvcCore\Response\IConstants
  • MvcCore\Route\IConstants
  • MvcCore\Router\IConstants
  • MvcCore\Session\IConstants
  • MvcCore\View\IConstants

Traits

  • MvcCore\Application\Dispatching
  • MvcCore\Application\GettersSetters
  • MvcCore\Application\Helpers
  • MvcCore\Application\Props
  • MvcCore\Config\Environment
  • MvcCore\Config\IniDump
  • MvcCore\Config\IniProps
  • MvcCore\Config\IniRead
  • MvcCore\Config\MagicMethods
  • MvcCore\Config\PropsGettersSetters
  • MvcCore\Config\ReadWrite
  • MvcCore\Controller\Dispatching
  • MvcCore\Controller\GettersSetters
  • MvcCore\Controller\Props
  • MvcCore\Controller\Rendering
  • MvcCore\Debug\Handlers
  • MvcCore\Debug\Initializations
  • MvcCore\Debug\Props
  • MvcCore\Environment\Detection
  • MvcCore\Environment\Instancing
  • MvcCore\Environment\PropsGettersSetters
  • MvcCore\Ext\Auths\Basic\Handling
  • MvcCore\Ext\Auths\Basic\PropsGettersSetters
  • MvcCore\Ext\Auths\Basics\Controller\Base
  • MvcCore\Ext\Auths\Basics\Form\Base
  • MvcCore\Ext\Auths\Basics\Form\SignIn
  • MvcCore\Ext\Auths\Basics\Form\SignOut
  • MvcCore\Ext\Auths\Basics\Role\Base
  • MvcCore\Ext\Auths\Basics\Role\Features
  • MvcCore\Ext\Auths\Basics\User\Auth
  • MvcCore\Ext\Auths\Basics\User\Base
  • MvcCore\Ext\Auths\Basics\User\Features
  • MvcCore\Ext\Auths\Basics\User\Roles
  • MvcCore\Ext\Auths\Basics\UserAndRole\Base
  • MvcCore\Ext\Auths\Basics\UserAndRole\Permissions
  • MvcCore\Ext\Configs\Yamls\YamlDump
  • MvcCore\Ext\Configs\Yamls\YamlProps
  • MvcCore\Ext\Configs\Yamls\YamlRead
  • MvcCore\Ext\Form\AddMethods
  • MvcCore\Ext\Form\Assets
  • MvcCore\Ext\Form\ConfigProps
  • MvcCore\Ext\Form\Csrf
  • MvcCore\Ext\Form\FieldMethods
  • MvcCore\Ext\Form\GetMethods
  • MvcCore\Ext\Form\InternalProps
  • MvcCore\Ext\Form\Rendering
  • MvcCore\Ext\Form\Session
  • MvcCore\Ext\Form\SetMethods
  • MvcCore\Ext\Form\Submitting
  • MvcCore\Ext\Forms\Field\Getters
  • MvcCore\Ext\Forms\Field\Props
  • MvcCore\Ext\Forms\Field\Props\AccessKey
  • MvcCore\Ext\Forms\Field\Props\AutoComplete
  • MvcCore\Ext\Forms\Field\Props\AutoFocus
  • MvcCore\Ext\Forms\Field\Props\Checked
  • MvcCore\Ext\Forms\Field\Props\DataList
  • MvcCore\Ext\Forms\Field\Props\Disabled
  • MvcCore\Ext\Forms\Field\Props\Files
  • MvcCore\Ext\Forms\Field\Props\Format
  • MvcCore\Ext\Forms\Field\Props\FormAttrs
  • MvcCore\Ext\Forms\Field\Props\GroupLabelAttrs
  • MvcCore\Ext\Forms\Field\Props\GroupLabelCssClasses
  • MvcCore\Ext\Forms\Field\Props\InputMode
  • MvcCore\Ext\Forms\Field\Props\Label
  • MvcCore\Ext\Forms\Field\Props\MinMaxLength
  • MvcCore\Ext\Forms\Field\Props\MinMaxOptions
  • MvcCore\Ext\Forms\Field\Props\MinMaxStepDates
  • MvcCore\Ext\Forms\Field\Props\MinMaxStepNumbers
  • MvcCore\Ext\Forms\Field\Props\Multiple
  • MvcCore\Ext\Forms\Field\Props\NullOptionText
  • MvcCore\Ext\Forms\Field\Props\Options
  • MvcCore\Ext\Forms\Field\Props\Pattern
  • MvcCore\Ext\Forms\Field\Props\PlaceHolder
  • MvcCore\Ext\Forms\Field\Props\ReadOnly
  • MvcCore\Ext\Forms\Field\Props\Required
  • MvcCore\Ext\Forms\Field\Props\RowsColsWrap
  • MvcCore\Ext\Forms\Field\Props\Size
  • MvcCore\Ext\Forms\Field\Props\SpellCheck
  • MvcCore\Ext\Forms\Field\Props\Submit
  • MvcCore\Ext\Forms\Field\Props\TabIndex
  • MvcCore\Ext\Forms\Field\Props\VisibleField
  • MvcCore\Ext\Forms\Field\Props\WidthHeight
  • MvcCore\Ext\Forms\Field\Props\Wrapper
  • MvcCore\Ext\Forms\Field\Rendering
  • MvcCore\Ext\Forms\Field\Setters
  • MvcCore\Ext\Forms\Validators\Files\CheckRequirements
  • MvcCore\Ext\Forms\Validators\Files\CompleteFiles
  • MvcCore\Ext\Forms\Validators\Files\ReadAccept
  • MvcCore\Ext\Forms\Validators\Files\Validations\Bomb
  • MvcCore\Ext\Forms\Validators\Files\Validations\FileAndSize
  • MvcCore\Ext\Forms\Validators\Files\Validations\MimeTypeAndExtension
  • MvcCore\Ext\Forms\Validators\Files\Validations\NameAndExtension
  • MvcCore\Ext\Models\Db\Model\Connection
  • MvcCore\Ext\Models\Db\Model\DataMethods
  • MvcCore\Ext\Models\Db\Model\Features
  • MvcCore\Ext\Models\Db\Model\Manipulation
  • MvcCore\Ext\Models\Db\Model\MetaData
  • MvcCore\Ext\Models\Db\Model\Parsers
  • MvcCore\Ext\Models\Db\Model\Props
  • MvcCore\Ext\Models\Db\Model\ProviderResource
  • MvcCore\Ext\Models\Db\Models\MySqls\Features
  • MvcCore\Ext\Models\Db\Models\MySqls\ProviderResource
  • MvcCore\Ext\Models\Db\Models\PgSqls\Features
  • MvcCore\Ext\Models\Db\Models\PgSqls\ProviderResource
  • MvcCore\Ext\Models\Db\Models\Resources\Features
  • MvcCore\Ext\Models\Db\Models\SQLites\Features
  • MvcCore\Ext\Models\Db\Models\SQLites\ProviderResource
  • MvcCore\Ext\Models\Db\Models\SqlSrvs\Features
  • MvcCore\Ext\Models\Db\Models\SqlSrvs\ProviderResource
  • MvcCore\Ext\Models\Db\Providers\Resources\Manipulation
  • MvcCore\Ext\Models\Db\Providers\Resources\PgSqls\Manipulation
  • MvcCore\Ext\Routers\Extended
  • MvcCore\Ext\Routers\Extendeds\Preparing
  • MvcCore\Ext\Routers\Extendeds\PropsGettersSetters
  • MvcCore\Ext\Routers\Extendeds\Redirect
  • MvcCore\Ext\Routers\Extendeds\RedirectHelpers
  • MvcCore\Ext\Routers\Extendeds\Url
  • MvcCore\Ext\Routers\Localization\Preparing
  • MvcCore\Ext\Routers\Localization\PreRouting
  • MvcCore\Ext\Routers\Localization\PropsGettersSetters
  • MvcCore\Ext\Routers\Localization\RedirectSections
  • MvcCore\Ext\Routers\Localization\RewriteRouting
  • MvcCore\Ext\Routers\Localization\RewriteRoutingChecks
  • MvcCore\Ext\Routers\Localization\Routing
  • MvcCore\Ext\Routers\Localization\UrlByRoute
  • MvcCore\Ext\Routers\Localization\UrlByRouteSections
  • MvcCore\Ext\Routers\Localization\UrlByRouteSectionsLocalization
  • MvcCore\Ext\Routers\Localizations\Route\Instancing
  • MvcCore\Ext\Routers\Localizations\Route\InternalInits
  • MvcCore\Ext\Routers\Localizations\Route\Matching
  • MvcCore\Ext\Routers\Localizations\Route\PropsGettersSetters
  • MvcCore\Ext\Routers\Localizations\Route\UrlBuilding
  • MvcCore\Ext\Routers\Media\Preparing
  • MvcCore\Ext\Routers\Media\PreRouting
  • MvcCore\Ext\Routers\Media\PropsGettersSetters
  • MvcCore\Ext\Routers\Media\RedirectSections
  • MvcCore\Ext\Routers\Media\Routing
  • MvcCore\Ext\Routers\Media\UrlByRoute
  • MvcCore\Ext\Routers\Media\UrlByRouteSections
  • MvcCore\Ext\Routers\Media\UrlByRouteSectionsMedia
  • MvcCore\Ext\Routers\MediaAndLocalization\RedirectSections
  • MvcCore\Ext\Routers\MediaAndLocalization\Routing
  • MvcCore\Ext\Routers\MediaAndLocalization\UrlByRoute
  • MvcCore\Ext\Routers\MediaAndLocalization\UrlByRouteSections
  • MvcCore\Ext\Routers\Module\Canonical
  • MvcCore\Ext\Routers\Module\DomainRouteSetUp
  • MvcCore\Ext\Routers\Module\DomainRouting
  • MvcCore\Ext\Routers\Module\PreAndPostRouting
  • MvcCore\Ext\Routers\Module\Props
  • MvcCore\Ext\Routers\Module\Redirect
  • MvcCore\Ext\Routers\Module\RewriteRoutingChecks
  • MvcCore\Ext\Routers\Module\RouteMethods
  • MvcCore\Ext\Routers\Module\UrlByQuery
  • MvcCore\Ext\Routers\Module\UrlByRoute
  • MvcCore\Ext\Routers\Module\UrlByRouteSections
  • MvcCore\Ext\Routers\Module\UrlDomain
  • MvcCore\Ext\Routers\ModuleLocalization\DomainRouteSetUp
  • MvcCore\Ext\Routers\ModuleLocalization\Redirect
  • MvcCore\Ext\Routers\ModuleLocalization\RewriteRoutingChecks
  • MvcCore\Ext\Routers\ModuleLocalization\UrlByRoute
  • MvcCore\Ext\Routers\ModuleMedia\DomainRouteSetUp
  • MvcCore\Ext\Routers\ModuleMedia\Redirect
  • MvcCore\Ext\Routers\ModuleMediaAndLocalization\DomainRouteSetUp
  • MvcCore\Ext\Routers\ModuleMediaAndLocalization\Redirect
  • MvcCore\Ext\Routers\Modules\Route\Instancing
  • MvcCore\Ext\Routers\Modules\Route\Matching
  • MvcCore\Ext\Routers\Modules\Route\PropsGettersSetters
  • MvcCore\Ext\Routers\Modules\Route\UrlBuilding
  • MvcCore\Model\Comparers
  • MvcCore\Model\Config
  • MvcCore\Model\Connection
  • MvcCore\Model\Converters
  • MvcCore\Model\DataMethods
  • MvcCore\Model\MagicMethods
  • MvcCore\Model\MetaData
  • MvcCore\Model\Parsers
  • MvcCore\Model\Props
  • MvcCore\Model\Resource
  • MvcCore\Request\CollectionsMethods
  • MvcCore\Request\GettersSetters
  • MvcCore\Request\Instancing
  • MvcCore\Request\InternalInits
  • MvcCore\Request\Props
  • MvcCore\Response\Content
  • MvcCore\Response\Cookies
  • MvcCore\Response\Headers
  • MvcCore\Response\Instancing
  • MvcCore\Response\PropsGettersSetters
  • MvcCore\Route\GettersSetters
  • MvcCore\Route\Instancing
  • MvcCore\Route\InternalInits
  • MvcCore\Route\Matching
  • MvcCore\Route\Props
  • MvcCore\Route\UrlBuilding
  • MvcCore\Router\Canonical
  • MvcCore\Router\GettersSetters
  • MvcCore\Router\Instancing
  • MvcCore\Router\Props
  • MvcCore\Router\Redirecting
  • MvcCore\Router\RewriteRouting
  • MvcCore\Router\RouteMethods
  • MvcCore\Router\Routing
  • MvcCore\Router\UrlBuilding
  • MvcCore\Router\UrlByQuery
  • MvcCore\Router\UrlByRoutes
  • MvcCore\Session\Closing
  • MvcCore\Session\MagicMethods
  • MvcCore\Session\MetaData
  • MvcCore\Session\NamespaceMethods
  • MvcCore\Session\Props
  • MvcCore\Session\Starting
  • MvcCore\Tool\Helpers
  • MvcCore\Tool\Json
  • MvcCore\Tool\Reflection
  • MvcCore\Tool\StringConversions
  • MvcCore\View\DirectoryMethods
  • MvcCore\View\Escaping
  • MvcCore\View\GettersSetters
  • MvcCore\View\LocalMethods
  • MvcCore\View\MagicMethods
  • MvcCore\View\Props
  • MvcCore\View\Rendering
  • MvcCore\View\UrlHelpers
  • MvcCore\View\ViewHelpers

Exceptions

  • MvcCore\Ext\Models\Db\Exception
  • Throwable

Functions

  • MvcCore\Ext\Models\Db\FuncHelpers\Columns
  • MvcCore\Ext\Models\Db\FuncHelpers\Table
  • Overview
  • Class
  • Tree
  • Todo
  • Deprecated
  • Download
  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: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: 286: 287: 288: 289: 290: 291: 292: 293: 294: 295: 296: 297: 298: 299: 300: 301: 302: 303: 304: 305: 306: 307: 308: 309: 310: 311: 312: 313: 314: 315: 316: 317: 318: 319: 320: 321: 322: 323: 324: 325: 326: 327: 328: 329: 330: 331: 332: 333: 334: 335: 336: 337: 338: 339: 340: 341: 342: 343: 344: 345: 346: 347: 348: 349: 350: 351: 352: 353: 354: 355: 356: 357: 358: 359: 360: 361: 362: 363: 364: 365: 366: 367: 368: 369: 370: 371: 372: 373: 374: 375: 376: 377: 378: 379: 380: 381: 382: 383: 384: 385: 386: 387: 388: 389: 390: 391: 392: 393: 394: 395: 396: 397: 398: 399: 400: 401: 402: 403: 404: 405: 406: 407: 408: 409: 410: 411: 412: 413: 414: 415: 416: 417: 418: 419: 420: 421: 422: 423: 424: 425: 426: 427: 428: 429: 430: 431: 432: 433: 434: 435: 436: 437: 438: 439: 440: 441: 442: 443: 444: 445: 446: 447: 448: 449: 450: 451: 452: 453: 454: 455: 456: 457: 458: 459: 460: 461: 462: 463: 464: 465: 466: 467: 468: 469: 470: 471: 472: 473: 474: 475: 476: 477: 478: 479: 480: 481: 482: 483: 484: 485: 486: 487: 488: 489: 490: 491: 492: 493: 494: 495: 
<?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 Flidr (https://github.com/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Views\Helpers;

/**
 * Responsibility - format number by explicitly given arguments or by default configured arguments.
 * - Formatting processed by `Intl` extension if installed or by `\number_format()` and `\localeconv()` fallback.
 * - Possibility to define default decimal points value to not define it every time using `FormatNumber()` call.
 * - Possibility to define any argument to create `Intl` number formatter instance in every call or globally by default setters.
 * - Possibility to define any argument for `number_format()` and `\localeconv()` fallback in every call or globally by default setters.
 * - If there is used formatting fallback and no locale formatting conventions are defined, system locale settings is automatically
 *   configured by request language and request locale and by system locale settings are defined locale formatting conventions.
 * - Fallback result string always returned in response encoding, in UTF-8 by default.
 *
 * @see http://php.net/manual/en/numberformatter.create.php
 * @see http://php.net/manual/en/numberformatter.format.php
 * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatstyle
 * @see http://www.icu-project.org/apiref/icu4c/classDecimalFormat.html#details
 * @see http://www.icu-project.org/apiref/icu4c/classRuleBasedNumberFormat.html#details
 * @see http://php.net/manual/en/numberformatter.setattribute.php
 * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatattribute
 * @see http://php.net/manual/en/numberformatter.settextattribute.php
 * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformattextattribute
 * @see http://php.net/manual/en/function.number-format.php
 * @see http://php.net/manual/en/function.localeconv.php
 * @method \MvcCore\Ext\Views\Helpers\FormatNumberHelper GetInstance()
 */
class FormatNumberHelper extends \MvcCore\Ext\Views\Helpers\InternationalizedHelper {

    /**
     * MvcCore Extension - View Helper - Assets - version:
     * Comparison by PHP function version_compare();
     * @see http://php.net/manual/en/function.version-compare.php
     */
    const VERSION = '5.0.0';

    /**
     * If this static property is set - helper is possible
     * to configure as singleton before it's used for first time.
     * Example:
     *  `\MvcCore\Ext\View\Helpers\FormatNumber::GetInstance()`
     * @var \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    protected static $instance;

    /**
     * Default numerics count after decimal point.
     * @var int|NULL
     */
    protected $defaultDecimalsCount = 2;

    /**
     * Default style of the formatting, one of the format style constants in second link.
     * If `\NumberFormatter::PATTERN_DECIMAL` or `\NumberFormatter::PATTERN_RULEBASED`
     * is passed then the number format is opened using the given pattern, which must
     * conform to the syntax described in » ICU DecimalFormat documentation or
     * » ICU RuleBasedNumberFormat documentation, respectively.
     * @see http://php.net/manual/en/numberformatter.create.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatstyle
     * @see http://www.icu-project.org/apiref/icu4c/classDecimalFormat.html#details
     * @see http://www.icu-project.org/apiref/icu4c/classRuleBasedNumberFormat.html#details
     * @var int
     */
    protected $intlDefaultStyle = 1; // 1 means `\NumberFormatter::DEFAULT_STYLE`

    /**
     * Default pattern string if the chosen style requires a pattern.
     * @see http://php.net/manual/en/numberformatter.create.php
     * @var string|NULL
     */
    protected $intlDefaultPattern = NULL;

    /**
     * Default set of numeric attribute(s) associated with the formatter.
     * Array with keys describing number formatter constants and with values describing specific values.
     * @see http://php.net/manual/en/numberformatter.setattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatattribute
     * @var int[]
     */
    protected $intlDefaultAttributes = [];

    /**
     * Default set of text attribute(s) associated with the formatter.
     * Array with keys describing number formatter constants and with values describing specific values.
     * @see http://php.net/manual/en/numberformatter.settextattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformattextattribute
     * @var int[]
     */
    protected $intlDefaultTextAttributes = [];

    /**
     * System `setlocale()` category to set up system locale automatically in `parent::SetView()` method.
     * This property is used only for fallback if formatting is not by `Intl` extension.
     * @var \int[]
     */
    protected $localeCategories = [LC_NUMERIC];

    /**
     * Numeric formatting information by system locale settings.
     * There are used all keys defined in property `$this->defaultLocaleConventions;`.
     * This property is used only for fallback if formatting is not by `Intl` extension.
     * @see http://php.net/manual/en/function.localeconv.php
     * @var \stdClass|NULL
     */
    protected $localeConventions = NULL;

    /**
     * Default locale conventions used for `Intl` formatting fallback,
     * when is not possible to configure system locale value
     * and when there is necessary to define some default formatting rules.
     * @see http://php.net/manual/en/function.localeconv.php
     * @var array|\stdClass
     */
    protected $defaultLocaleConventions = [
        'decimal_point'     => '.', // numbers decimal point
        'thousands_sep'     => ',', // numbers thousands separator
        'mon_decimal_point' => '.', // money decimal point
        'mon_thousands_sep' => ',', // money thousands separator
        'int_curr_symbol'   => 'USD',// international currency symbol for `Intl` extension
        'currency_symbol'   => '$', // text currency symbol for fallback formatting
        'frac_digits'       => 2,   // decimals count
        'positive_sign'     => '',  // positive sign character
        'negative_sign'     => '-', // negative sign character
        'p_cs_precedes'     => 1,   // 1 - currency before negative value
        'n_cs_precedes'     => 1,   // 1 - currency before positive value
        'p_sep_by_space'    => 0,   // 0 - no space between currency and positive value
        'n_sep_by_space'    => 0,   // 0 - no space between currency and negative value
        'p_sign_posn'       => 3,   // 3 - sign string immediately before currency
        'n_sign_posn'       => 3,   // 3 - sign string immediately before currency
    ];

    /**
     * Set default numerics count after decimal point.
     * @param int $defaultDecimalsCount
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetDefaultDecimalsCount ($defaultDecimalsCount = 2) {
        $this->defaultDecimalsCount = $defaultDecimalsCount;
        return $this;
    }

    /**
     * Set default style of the formatting, one of the format style constants if second link.
     * If `\NumberFormatter::PATTERN_DECIMAL` or `\NumberFormatter::PATTERN_RULEBASED`
     * is passed then the number format is opened using the given pattern, which must
     * conform to the syntax described in » ICU DecimalFormat documentation or
     * » ICU RuleBasedNumberFormat documentation, respectively.
     * This setter is used for `Intl` number formatter.
     * @see http://php.net/manual/en/numberformatter.create.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatstyle
     * @see http://www.icu-project.org/apiref/icu4c/classDecimalFormat.html#details
     * @see http://www.icu-project.org/apiref/icu4c/classRuleBasedNumberFormat.html#details
     * @param int $intlDefaultStyle
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetIntlDefaultStyle ($intlDefaultStyle = 1) {// 1 means `\NumberFormatter::DEFAULT_STYLE`
        $this->intlDefaultStyle = $intlDefaultStyle;
        return $this;
    }

    /**
     * Set default pattern string if the chosen style requires a pattern.
     * This setter is used for `Intl` number formatter.
     * @see http://php.net/manual/en/numberformatter.create.php
     * @param string $intlDefaultPattern
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetIntlDefaultPattern ($intlDefaultPattern = '') {
        $this->intlDefaultPattern = $intlDefaultPattern;
        return $this;
    }

    /**
     * Set default set of numeric attribute(s) associated with `Intl` number formatter.
     * Array with keys describing number formatter constants and with values describing specific values.
     * @see http://php.net/manual/en/numberformatter.setattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatattribute
     * @param array $intlDefaultAttributes
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetIntlDefaultAttributes ($intlDefaultAttributes = []) {
        $this->intlDefaultAttributes = $intlDefaultAttributes;
        return $this;
    }

    /**
     * Set default set of text attribute(s) associated with `Intl` number formatter.
     * Array with keys describing number formatter constants and with values describing specific values.
     * @see http://php.net/manual/en/numberformatter.settextattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformattextattribute
     * @param array $intlDefaultTextAttributes
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetIntlDefaultTextAttributes ($intlDefaultTextAttributes = []) {
        $this->intlDefaultTextAttributes = $intlDefaultTextAttributes;
        return $this;
    }

    /**
     * Set custom number (and money) formatting conventions if you don't want to use
     * automatically assigned formatting conventions by system locale settings.
     * You have to define all keys defined in property `$this->defaultLocaleConventions;`.
     * Use this function only for fallback if formatting is not by `Intl` extension.
     * @see http://php.net/manual/en/function.localeconv.php
     * @param array $localeConventions Locale specific number formatting conventions.
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetLocaleConventions (array $localeConventions = []) {
        $this->localeConventions = (object) $localeConventions;
        return $this;
    }

    /**
     * Set default locale conventions used for `Intl` formatting fallback,
     * when is not possible to configure system locale value
     * and when there is necessary to define some default formatting rules.
     * @see http://php.net/manual/en/function.localeconv.php
     * @param string[] $defaultLocaleConventions
     * @return \MvcCore\Ext\Views\Helpers\FormatNumberHelper
     */
    public function SetDefaultLocaleConventions ($defaultLocaleConventions = []) {
        $this->defaultLocaleConventions = (object) $defaultLocaleConventions;
        return $this;
    }

    /**
     * Format number (first argument) by explicitly given next following arguments
     * or by default settings configured by it's setters. This function uses two
     * ways to format numbers:
     *
     *  1)  Formatting by `Intl` extension - creating `\NumberFormatter` instance
     *      and calling `format()` function. You can format first argument by
     *      explicitly given next following arguments to create formatter instance.
     *      If there are no next following arguments, there are used default arguments
     *      to create formatter instance defined by it's helper setters above.
     *
     *  2)  Formatting fallback by `number_format()` with explicitly given next
     *      following arguments to specify decimals count, decimal point and thousands separator.
     *      If there are no values for decimal point and thousands separator, there is
     *      used values from protected $this->localeConventions array, which should be defined
     *      by it's setter method. And if this array is not defined, there is used
     *      format conventions by system locale settings by request object language and locale.
     *      This method is used as fallback for `Intl` extension.
     *
     * @see http://php.net/manual/en/numberformatter.create.php
     * @see http://php.net/manual/en/numberformatter.format.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatstyle
     * @see http://www.icu-project.org/apiref/icu4c/classDecimalFormat.html#details
     * @see http://www.icu-project.org/apiref/icu4c/classRuleBasedNumberFormat.html#details
     * @see http://php.net/manual/en/numberformatter.setattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformatattribute
     * @see http://php.net/manual/en/numberformatter.settextattribute.php
     * @see http://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants.unumberformattextattribute
     * @see http://php.net/manual/en/function.number-format.php
     * @see http://php.net/manual/en/function.localeconv.php
     * @param int|float|string  $number                                 The number being formatted.
     * @param int|NULL          $decimalsCount                          Optional, numerics count after decimal point. If `NULL`,
     *                                                                  there is used configurable property `$this->defaultDecimalsCount`.
     * @param string|NULL       $formatterStyleOrDecimalPoint           1) Optional, `\NumberFormatter` constant to choose proper localized
     *                                                                     formatter (`\NumberFormatter::DECIMAL`, `\NumberFormatter::PERCENT`,
     *                                                                     `\NumberFormatter::SPELLOUT`, `\NumberFormatter::DURATION`...).
     *                                                                  2) Optional, decimal point separator for `number_format()` fallback.
     *                                                                     If `NULL`, there is used system locale settings value and if
     *                                                                     there are no locale system settings, there is used dot char - `.`.
     * @param array|string|NULL $formatterPatternOrThousandsSeparator   1) Optional, number formatter pattern for following style constants:
     *                                                                     - `\NumberFormatter::PATTERN_DECIMAL`
     *                                                                     - `\NumberFormatter::PATTERN_RULEBASED`
     *                                                                  2) Optional, thousands separator for `number_format()` fallback.
     *                                                                     If `NULL`, there is used system locale settings value and if there
     *                                                                     is no system locale settings, there is used comma char - `,`.
     * @param array|NULL        $formatterAttributes                        1) Optional number formatter attributes, for example to max./min.
     *                                                                     integer digits etc...
     * @param array|NULL        $formatterTextAttributes                1) Optional number formatter text attributes.
     * @return string
     */
    public function FormatNumber (
        $number = NULL,
        $decimalsCount = NULL,
        $formatterStyleOrDecimalPoint = NULL ,
        $formatterPatternOrThousandsSeparator = NULL,
        $formatterAttributes = NULL,
        $formatterTextAttributes = NULL
    ) {
        $numberIsNumeric = is_numeric($number);
        if (!$numberIsNumeric) return (string) $number;
        $valueToFormat = $numberIsNumeric && is_string($number)
            ? floatval($number)
            : $number;
        if ($this->intlExtensionFormatting) {
            return $this->formatByIntlNumberFormatter(
                $valueToFormat, $decimalsCount,
                $formatterStyleOrDecimalPoint, $formatterPatternOrThousandsSeparator,
                $formatterAttributes, $formatterTextAttributes
            );
        } else {
            return $this->fallbackFormatByNumberFormat(
                $valueToFormat, $decimalsCount,
                $formatterStyleOrDecimalPoint, $formatterPatternOrThousandsSeparator
            );
        }
    }

    /**
     * Format number by `numfmt_format()` (PHP `Intl` extension) with explicitly given
     * `$style`, `$pattern`, `$attributes` or `$textAttributes`. If there are no explicitly given
     * arguments, there are used default values configured by it's setter methods above.
     * @see http://php.net/manual/en/numberformatter.create.php
     * @see http://php.net/manual/en/numberformatter.format.php
     * @param int|float     $valueToFormat  Numeric value to format.
     * @param int|NULL      $decimalsCount  Optional, numerics count after decimal point. If `NULL`,
     *                                      there is used configurable property `$this->defaultDecimalsCount`.
     * @param int|NULL      $style          `\NumberFormatter` constant to choose proper localized formatter.
     * @param string|NULL   $pattern        Optional pattern for style constants
     *                                      `NumberFormatter::PATTERN_DECIMAL` or
      *                                     `\NumberFormatter::PATTERN_RULEBASED`.
     * @param array|NULL    $attributes     Optional formatter attributes.
     * @param array|NULL    $textAttributes Optional formatter text attributes.
     * @return string
     */
    protected function formatByIntlNumberFormatter (
        $valueToFormat = 0.0,
        $decimalsCount = NULL,
        $style = NULL,
        $pattern = NULL ,
        $attributes = NULL,
        $textAttributes = NULL
    ) {
        if ($decimalsCount !== NULL) $decimalsCount = $this->defaultDecimalsCount;
        $attributes = is_array($attributes) 
            ? $attributes 
            : $this->intlDefaultAttributes ;
        $attributes[\NumberFormatter::MIN_FRACTION_DIGITS] = $decimalsCount;
        $formatter = $this->getIntlNumberFormatter(
            $this->langAndLocale,
            $style !== NULL
                ? $style
                : $this->intlDefaultStyle,
            $pattern !== NULL
                ? $pattern
                : $this->intlDefaultPattern,
            $attributes,
            $textAttributes !== NULL
                ? $textAttributes
                : $this->intlDefaultTextAttributes
        );
        return \numfmt_format($formatter, $valueToFormat);
    }

    /**
     * Get stored `\NumberFormatter` instance or create new one.
     * @param string|NULL   $langAndLocale
     * @param int|NULL      $style
     * @param int|NULL      $pattern
     * @param array         $attributes
     * @param array         $textAttributes
     * @return \NumberFormatter
     */
    protected function getIntlNumberFormatter (
        $langAndLocale = NULL,
        $style = NULL,
        $pattern = NULL,
        $attributes = [],
        $textAttributes = []
    ) {
        $key = implode('_', [
            'number',
            serialize(func_get_args())
        ]);
        if (!isset($this->intlFormatters[$key])) {
            $formatter = \numfmt_create(
                $this->langAndLocale, $style, $pattern
            );
            foreach ($attributes as $key => $value)
                \numfmt_set_attribute($formatter, $key, $value);
            foreach ($textAttributes as $key => $value)
                \numfmt_set_text_attribute($formatter, $key, $value);
            $this->intlFormatters[$key] = $formatter;
        }
        return $this->intlFormatters[$key];
    }

    /**
     * Format a number with PHP `number_format()` with optionally given decimals count,
     * by optionally given decimal point and by optionally given thousands separator.
     * If there are no values for decimal point and thousands separator, there is
     * used values from protected $this->localeConventions array, which should be defined
     * by it's setter method. And if this array is not defined, there is used
     * format conventions by system locale settings by request object language and locale.
     * This method is used as fallback for `Intl` extension.
     * @see http://php.net/manual/en/function.number-format.php
     * @see http://php.net/manual/en/function.localeconv.php
     * @param int|float     $valueToFormat      The number being formatted.
     * @param int|NULL      $decimalsCount      Optional, numerics count after decimal point,
     *                                          If `NULL`, there is used configurable property
      *                                         `$this->defaultDecimalsCount`.
     * @param string|NULL   $decimalPoint       Optional, separator for the decimal point.
     *                                          If `NULL`, there is used system locale settings.
     * @param string|NULL   $thousandsSeparator Optional, thousands separator. If `NULL`,
     *                                          there is used system locale settings.
     * @return string
     */
    protected function fallbackFormatByNumberFormat (
        $valueToFormat = 0.0,
        $decimalsCount = NULL,
        $decimalPoint = NULL,
        $thousandsSeparator = NULL
    ) {
        if ($this->encodingConversion === NULL) {
            $this->setUpSystemLocaleAndEncodings();
            $this->setUpLocaleConventions();
        }
        $lc = $this->localeConventions;
        // decide number to format is positive or negative
        $negative = $valueToFormat < 0;
        // complete decimals count by given argument or by default fractal digits
        $decimalsCount = $decimalsCount !== NULL
            ? $decimalsCount
            : $this->defaultDecimalsCount;
        // complete decimals point by given argument or by locale conventions
        $decimalPoint = $decimalPoint !== NULL
            ? $decimalPoint
            : (isset($lc->decimal_point) ? $lc->decimal_point : '.');
        // complete thousands separator by given argument or by locale conventions
        $thousandsSeparator = $thousandsSeparator !== NULL
            ? $thousandsSeparator
            : (isset($lc->thousands_sep) ? $lc->thousands_sep : ',');
        // format absolute value by classic PHPs `number_format()`
        $result = \number_format(
            abs($valueToFormat), $decimalsCount,
            $decimalPoint, $thousandsSeparator
        );
        // if formatted number is under zero - formatting rules will be different
        if ($negative) {
            $currencyBeforeValue  = $lc->n_cs_precedes;
            $signPosition    = $lc->n_sign_posn;
            $signSymbol  = $lc->negative_sign;
        } else {
            $currencyBeforeValue  = $lc->p_cs_precedes;
            $signPosition    = $lc->p_sign_posn;
            $signSymbol  = $lc->positive_sign;
        }
        // add sign character
        if ($signPosition == 0) {
            // negative value by brackets
            $result = "($result)";
        } elseif ($signPosition == 1) {
            // sign symbol is before number and currency
            $result = $signSymbol . $result;
        } elseif ($signPosition == 2) {
            // sign symbol is after number and currency
            $result .= $signSymbol;
        } elseif ($signPosition > 2 && $currencyBeforeValue) {
            // sign symbol is before/after currency symbol
            // and currency symbol is always before formatted number
            $result = $signSymbol . $result;
        } elseif ($signPosition > 2 && !$currencyBeforeValue) {
            // sign symbol is before/after currency symbol
            // and currency symbol is always after formatted number
            $result .= $signSymbol;
        }
        return $this->encode($result);
    }

    /**
     * Try to set up local conventions by system locale settings
     * only if there was any success with setting up system locale.
     * If system locale is not set up properly - use default formatting conventions.
     * @see http://php.net/manual/en/function.localeconv.php
     * @return void
     */
    protected function setUpLocaleConventions () {
        $this->localeConventions = NULL;
        if ($this->systemEncoding !== NULL) {
            $this->localeConventions = (object) localeconv();
        }
        if (!$this->localeConventions || $this->localeConventions->frac_digits == 127)
            // something wrong - use default values for en_US:-(
            $this->localeConventions = (object) $this->defaultLocaleConventions;
        // remove all bracket shit rulez, from `($123,456.789)` to `-$123,456.789`
        if (!$this->localeConventions->n_sign_posn)
            $this->localeConventions->n_sign_posn = 3;
    }
}
MvcCore API Documentation API documentation generated by ApiGen