OXID eShop CE  4.9.7
 All Classes Files Functions Variables Pages
oxUtils Class Reference
+ Inheritance diagram for oxUtils:
+ Collaboration diagram for oxUtils:

Public Member Functions

 strMan ($sVal, $sKey=null)
 strRem ($sVal, $sKey=null)
 getArrFldName ($sName)
 assignValuesFromText ($sIn, $dVat=null)
 assignValuesToText ($aIn)
 currency2Float ($sValue)
 string2Float ($sValue)
 isSearchEngine ($sClient=null)
 setSearchEngine ($blIsSe=null, $sClient=null)
 isValidEmail ($sEmail)
 loadAdminProfile ($aInterfaceProfiles)
 fRound ($sVal, $oCur=null)
 arrayStringSearch ($sNeedle, $aHaystack)
 toStaticCache ($sName, $sContent, $sKey=null)
 fromStaticCache ($sName)
 cleanStaticCache ($sCacheName=null)
 toPhpFileCache ($sKey, $mContents)
 fromPhpFileCache ($sKey)
 getCacheMeta ($sKey)
 setCacheMeta ($sKey, $aMeta)
 toFileCache ($sKey, $mContents, $iTtl=0)
 fromFileCache ($sKey)
 commitFileCache ()
 oxResetFileCache ()
 resetTemplateCache ($aTemplates)
 resetLanguageCache ()
 resetMenuCache ()
 getRemoteCachePath ($sRemote, $sLocal)
 canPreview ()
 getPreviewId ()
 checkAccessRights ()
 seoIsActive ($blReset=false, $sShopId=null, $iActLang=null)
 isValidAlpha ($sField)
 redirectOffline ($iHeaderCode=302)
 redirect ($sUrl, $blAddRedirectParam=true, $iHeaderCode=302)
 showMessageAndExit ($sMsg)
 setHeader ($sHeader)
 oxMimeContentType ($sFileName)
 logger ($sText, $blNewline=false)
 strRot13 ($sStr)
 getCacheFilePath ($sCacheName, $blPathOnly=false, $sExtension= 'txt')
 getLangCache ($sCacheName)
 setLangCache ($sCacheName, $aLangCache)
 checkUrlEndingSlash ($sUrl)
 writeToLog ($sLogMessage, $sLogFileName)
 handlePageNotFoundError ($sUrl= '')
 extractDomain ($sHost)
- Public Member Functions inherited from oxSuperCfg
 __call ($sMethod, $aArgs)
 __construct ()
 getConfig ()
 setConfig ($oConfig)
 getSession ()
 setSession ($oSession)
 getUser ()
 setUser ($oUser)
 isAdmin ()
 setAdminMode ($blAdmin)

Protected Member Functions

 _readFile ($sFilePath)
 _includeFile ($sFilePath)
 _processCache ($sKey, $mContents)
 _lockFile ($sFilePath, $sIdent, $iLockMode=LOCK_EX)
 _releaseFile ($sIdent, $iLockMode=LOCK_EX)
 _simpleRedirect ($sUrl, $sHeaderCode)
 _addUrlParameters ($sUrl, $aParams)
 _fillExplodeArray ($aName, $dVat=null)
 _preparePrice ($dPrice, $dVat)
 _isPriceViewModeNetto ()
 _getArticleUser ()

Protected Attributes

 $_iCurPrecision = null
 $_sPermanentCachePattern = "/c_fieldnames_|c_tbdsc_|_allfields_/"
 $_sLanguageCachePattern = "/c_langcache_/i"
 $_sMenuCachePattern = "/c_menu_/i"
 $_aLockedFileHandles = array()
 $_aFileCacheContents = array()
 $_blIsSe = null
 $_aStaticCache
 $_blSeoIsActive = null

Additional Inherited Members

- Static Protected Attributes inherited from oxSuperCfg
static $_oConfig = null
static $_oSession = null
static $_oRights = null
static $_oActUser = null
static $_blIsAdmin = null

Detailed Description

Includes Smarty engine class. General utils class

Definition at line 12 of file oxutils.php.

Member Function Documentation

oxUtils::_addUrlParameters (   $sUrl,
  $aParams 
)
protected

adds the given parameters at the end of the given url

Parameters
string$sUrla url
array$aParamsthe params which will be added
Returns
string

Definition at line 1155 of file oxutils.php.

oxUtils::_fillExplodeArray (   $aName,
  $dVat = null 
)
protected

Fill array.

Parameters
array$aNameInitial array of strings
float$dVatArticle VAT
Returns
string

Definition at line 1177 of file oxutils.php.

oxUtils::_getArticleUser ( )
protected

Return article user.

Returns
oxUser

Definition at line 1278 of file oxutils.php.

oxUtils::_includeFile (   $sFilePath)
protected

Includes cache file

Parameters
string$sFilePathcache file path
Returns
mixed

Definition at line 607 of file oxutils.php.

oxUtils::_isPriceViewModeNetto ( )
protected

Checks and return true if price view mode is netto.

Returns
bool

Definition at line 1262 of file oxutils.php.

oxUtils::_lockFile (   $sFilePath,
  $sIdent,
  $iLockMode = LOCK_EX 
)
protected

Locks cache file and returns its handle on success or false on failure

Parameters
string$sFilePathname of file to lock
string$sIdentlock identifier
int$iLockModelock mode - LOCK_EX/LOCK_SH
Returns
mixed lock file resource or false on error

Definition at line 676 of file oxutils.php.

oxUtils::_preparePrice (   $dPrice,
  $dVat 
)
protected

Prepares price depending what options are used(show as net, brutto, etc.) for displaying

Parameters
double$dPricePrice
double$dVatVAT
Returns
float

Definition at line 1241 of file oxutils.php.

oxUtils::_processCache (   $sKey,
  $mContents 
)
protected

Serializes or writes php array for class file cache

Parameters
string$sKeycache key
mixed$mContentscache data
Returns
mixed

Definition at line 623 of file oxutils.php.

oxUtils::_readFile (   $sFilePath)
protected

Reads and returns cache file contents

Parameters
string$sFilePathcache fiel path
Returns
string

Definition at line 593 of file oxutils.php.

oxUtils::_releaseFile (   $sIdent,
  $iLockMode = LOCK_EX 
)
protected

Releases file lock and returns release state

Parameters
string$sIdentlock ident
int$iLockModelock mode
Returns
bool

Definition at line 731 of file oxutils.php.

oxUtils::_simpleRedirect (   $sUrl,
  $sHeaderCode 
)
protected

redirects browser to given url, nothing else done just header send may be used for redirection in case of an exception or similar things

Parameters
string$sUrlthe URL to redirect to
string$sHeaderCodecode to add to the header(e.g. "HTTP/1.1 301 Moved Permanently", or "HTTP/1.1 500 Internal Server Error"

Definition at line 1045 of file oxutils.php.

oxUtils::arrayStringSearch (   $sNeedle,
  $aHaystack 
)

Alphanumeric oxid and pure numeric oxid that start with the numeric part and only differ in postfixed alphabetical characters (e.g. "123" and "123X") are cast to the wrong type php internally which might result in wrong array_search results.

Wrapper for php internal array_search function, ony usable for string search. In case we get unclear results make sure we typecast all data to string before performing array search.

Parameters
string$sNeedle
array$aHaystack
Returns
mixed

Definition at line 394 of file oxutils.php.

oxUtils::assignValuesFromText (   $sIn,
  $dVat = null 
)

Takes a string and assign all values, returns array with values.

Parameters
string$sInInitial string
float$dVatArticle VAT (optional)
Returns
array

Definition at line 136 of file oxutils.php.

oxUtils::assignValuesToText (   $aIn)

Takes an array and builds again a string. Returns string with values.

Parameters
array$aInInitial array of strings
Returns
string

Definition at line 159 of file oxutils.php.

oxUtils::canPreview ( )

Checks if preview mode is ON

Returns
bool

Definition at line 886 of file oxutils.php.

oxUtils::checkAccessRights ( )

This function checks if logged in user has access to admin or not

Returns
bool

Definition at line 920 of file oxutils.php.

oxUtils::checkUrlEndingSlash (   $sUrl)

Checks if url has ending slash / - if not, adds it

Parameters
string$sUrlurl string
Returns
string

Definition at line 1420 of file oxutils.php.

oxUtils::cleanStaticCache (   $sCacheName = null)

Cleans all or specific data from static cache

Parameters
string$sCacheNameCache name

Definition at line 449 of file oxutils.php.

oxUtils::commitFileCache ( )

Writes all cache contents to file at once. This method was introduced due to possible race conditions. Cache is cleaned up after commit

Definition at line 642 of file oxutils.php.

oxUtils::currency2Float (   $sValue)

Returns formatted currency string, according to formatting standards.

Parameters
string$sValueFormatted price
Returns
float

Definition at line 180 of file oxutils.php.

oxUtils::extractDomain (   $sHost)

Extracts domain name from given host

Parameters
string$sHosthost name
Returns
string

Definition at line 1484 of file oxutils.php.

oxUtils::fromFileCache (   $sKey)

Fetches contents from file cache.

Parameters
string$sKeyCache key
Returns
mixed

Definition at line 550 of file oxutils.php.

oxUtils::fromPhpFileCache (   $sKey)

Includes cached php file and loads stored contents.

Parameters
string$sKeyCache key.
Returns
null;

Definition at line 485 of file oxutils.php.

oxUtils::fromStaticCache (   $sName)

Retrieves something from static cache

Parameters
string$sNamename under which the content is stored in the static cache
Returns
mixed

Definition at line 435 of file oxutils.php.

oxUtils::fRound (   $sVal,
  $oCur = null 
)

Rounds the value to currency cents. This method does NOT format the number.

Parameters
string$sValthe value that should be rounded
object$oCurCurrency Object
Returns
float

Definition at line 347 of file oxutils.php.

oxUtils::getArrFldName (   $sName)

Returns string witch "." symbols were replaced with "__".

Parameters
string$sNameString to search replaceable char
Returns
string

Definition at line 123 of file oxutils.php.

oxUtils::getCacheFilePath (   $sCacheName,
  $blPathOnly = false,
  $sExtension = 'txt' 
)

Returns full path (including file name) to cache file

Parameters
string$sCacheNamecache file name
bool$blPathOnlyif TRUE, name parameter will be ignored and only cache folder will be returned (default FALSE)
string$sExtensioncache file extension
Returns
string

Definition at line 1365 of file oxutils.php.

oxUtils::getCacheMeta (   $sKey)

If available returns cache meta data array

Parameters
string$sKeymeta data/cache key
Returns
mixed

Definition at line 500 of file oxutils.php.

oxUtils::getLangCache (   $sCacheName)

Tries to load lang cache array from cache file

Parameters
string$sCacheNamecache file name
Returns
array

Definition at line 1386 of file oxutils.php.

oxUtils::getPreviewId ( )

Returns id which is used for product preview in shop during administration

Returns
string

Definition at line 907 of file oxutils.php.

oxUtils::getRemoteCachePath (   $sRemote,
  $sLocal 
)

If $sLocal file is older than 24h or does not exist, tries to download it from $sRemote and save it as $sLocal

Parameters
string$sRemotethe file
string$sLocalthe address of the remote source
Returns
mixed

Definition at line 834 of file oxutils.php.

oxUtils::handlePageNotFoundError (   $sUrl = '')

handler for 404 (page not found) error

Parameters
string$sUrlurl which was given, can be not specified in some cases

Definition at line 1455 of file oxutils.php.

oxUtils::isSearchEngine (   $sClient = null)

Checks if current web client is Search Engine. Returns true on success.

Parameters
string$sClientuser browser agent
Returns
bool

Definition at line 233 of file oxutils.php.

oxUtils::isValidAlpha (   $sField)

Checks if string is only alpha numeric symbols

Parameters
string$sFieldfield name to test
Returns
bool

Definition at line 1033 of file oxutils.php.

oxUtils::isValidEmail (   $sEmail)

User email validation function. Returns true if email is OK otherwise - false; Syntax validation is performed only.

Parameters
string$sEmailuser email
Deprecated:
since v4.9.0/v5.2.0 (2014-06-17); Use MailValidator::isValidEmail().
Returns
bool

Definition at line 295 of file oxutils.php.

oxUtils::loadAdminProfile (   $aInterfaceProfiles)

Parses profile configuration, loads stored info in cookie

Parameters
array$aInterfaceProfiles($myConfig->getConfigParam( 'aInterfaceProfiles' ))
Returns
null

Definition at line 309 of file oxutils.php.

oxUtils::logger (   $sText,
  $blNewline = false 
)

Processes logging.

Parameters
string$sTextLog message text
bool$blNewlineIf true, writes message to new line (default false)

Definition at line 1327 of file oxutils.php.

oxUtils::oxMimeContentType (   $sFileName)

returns manually set mime types

Parameters
string$sFileNamethe file
Returns
string

Definition at line 1294 of file oxutils.php.

oxUtils::oxResetFileCache ( )

Removes most files stored in cache (default 'tmp') folder. Some files e.g. table files names description, are left. Excluded cache file name patterns are defined in oxUtils::_sPermanentCachePattern parameter

Definition at line 752 of file oxutils.php.

oxUtils::redirect (   $sUrl,
  $blAddRedirectParam = true,
  $iHeaderCode = 302 
)

redirect user to the specified URL

Parameters
string$sUrlURL to be redirected
bool$blAddRedirectParamadd "redirect" param
int$iHeaderCodeheader code, default 302
Returns
null or exit

Definition at line 1074 of file oxutils.php.

oxUtils::redirectOffline (   $iHeaderCode = 302)

Redirects to shop offline page

Parameters
int$iHeaderCodeheader code, default 302

Definition at line 1059 of file oxutils.php.

oxUtils::resetLanguageCache ( )

Removes language constant cache

Definition at line 796 of file oxutils.php.

oxUtils::resetMenuCache ( )

Removes admin menu cache

Definition at line 812 of file oxutils.php.

oxUtils::resetTemplateCache (   $aTemplates)

Removes smarty template cache for given templates

Parameters
array$aTemplatesTemplate name array

Definition at line 769 of file oxutils.php.

oxUtils::seoIsActive (   $blReset = false,
  $sShopId = null,
  $iActLang = null 
)

Checks if Seo mode should be used

Parameters
bool$blResetused to reset cached SEO mode
string$sShopIdshop id (optional; if not passed active session shop id will be used)
int$iActLanglanguage id (optional; if not passed active session language will be used)
Returns
bool

Definition at line 1002 of file oxutils.php.

oxUtils::setCacheMeta (   $sKey,
  $aMeta 
)

Saves cache meta data (information)

Parameters
string$sKeymeta data/cache key
array$aMetameta data array

Definition at line 511 of file oxutils.php.

oxUtils::setHeader (   $sHeader)

set header sent to browser

Parameters
string$sHeaderheader to sent

Definition at line 1142 of file oxutils.php.

oxUtils::setLangCache (   $sCacheName,
  $aLangCache 
)

Writes language array to file cache

Parameters
string$sCacheNamename of cache file
array$aLangCachelanguage array
Returns
null

Definition at line 1405 of file oxutils.php.

oxUtils::setSearchEngine (   $blIsSe = null,
  $sClient = null 
)

Sets if current web client is Search Engine.

Parameters
bool$blIsSesets if Search Engine is on
string$sClientuser browser agent
Returns
null

Definition at line 250 of file oxutils.php.

oxUtils::showMessageAndExit (   $sMsg)

shows given message and quits message might be whole content like 404 page.

Parameters
string$sMsgmessage to show
Returns
null dies

Definition at line 1124 of file oxutils.php.

oxUtils::string2Float (   $sValue)

Returns formatted float, according to formatting standards.

Parameters
string$sValueFormatted price
Returns
float

Definition at line 203 of file oxutils.php.

oxUtils::strMan (   $sVal,
  $sKey = null 
)

OXID specific string manipulation method

Parameters
string$sValstring
string$sKeykey
Deprecated:
since v5.2 (2014-08-11); use oxEncryptor::encrypt() instead.
Returns
string

Definition at line 90 of file oxutils.php.

oxUtils::strRem (   $sVal,
  $sKey = null 
)

OXID specific string manipulation method

Parameters
string$sValstring
string$sKeykey
Deprecated:
since v5.2 (2014-08-11); use oxDecryptor::decrypt() instead.
Returns
string

Definition at line 108 of file oxutils.php.

oxUtils::strRot13 (   $sStr)

Applies ROT13 encoding to $sStr

Parameters
string$sStrto encoding string
Returns
string

Definition at line 1348 of file oxutils.php.

oxUtils::toFileCache (   $sKey,
  $mContents,
  $iTtl = 0 
)

Adds contents to cache contents by given key. Returns true on success. All file caches are supposed to be written once by commitFileCache() method.

Parameters
string$sKeyCache key
mixed$mContentsContents to cache
int$iTtlTime to live in seconds (0 for forever).
Returns
bool

Definition at line 527 of file oxutils.php.

oxUtils::toPhpFileCache (   $sKey,
  $mContents 
)

Generates php file, which could later be loaded as include instead of parsed data. Currently this method supports simple arrays only.

Parameters
string$sKeyCache key
mixed$mContentsCache contents. At this moment only simple array type is supported.

Definition at line 465 of file oxutils.php.

oxUtils::toStaticCache (   $sName,
  $sContent,
  $sKey = null 
)

Stores something into static cache to avoid double loading

Parameters
string$sNamename of the content
mixed$sContentthe content
string$sKeyoptional key, where to store the content

Definition at line 418 of file oxutils.php.

oxUtils::writeToLog (   $sLogMessage,
  $sLogFileName 
)

Writes given log message. Returns write state

Parameters
string$sLogMessagelog message
string$sLogFileNamelog file name
Returns
bool

Definition at line 1437 of file oxutils.php.

Member Data Documentation

oxUtils::$_aFileCacheContents = array()
protected

Definition at line 57 of file oxutils.php.

oxUtils::$_aLockedFileHandles = array()
protected

Definition at line 50 of file oxutils.php.

oxUtils::$_aStaticCache
protected

Definition at line 71 of file oxutils.php.

oxUtils::$_blIsSe = null
protected

Definition at line 64 of file oxutils.php.

oxUtils::$_blSeoIsActive = null
protected

Definition at line 78 of file oxutils.php.

oxUtils::$_iCurPrecision = null
protected

Definition at line 20 of file oxutils.php.

oxUtils::$_sLanguageCachePattern = "/c_langcache_/i"
protected

Definition at line 36 of file oxutils.php.

oxUtils::$_sMenuCachePattern = "/c_menu_/i"
protected

Definition at line 43 of file oxutils.php.

oxUtils::$_sPermanentCachePattern = "/c_fieldnames_|c_tbdsc_|_allfields_/"
protected

Definition at line 29 of file oxutils.php.


The documentation for this class was generated from the following file: