Changeset 15897

Timestamp:

01/18/12 23:41:12 (4 months ago)

Author:

Alexander Trofimov

Message:

Page - refactoring, docs, cache implementation.

Location:

trunk

Files:

• inc/classes/BxDolPage.php (modified) (4 diffs)
• inc/classes/BxDolTemplate.php (modified) (3 diffs)
• install/sql/v70.sql (modified) (2 diffs)
• samples/page.php (modified) (2 diffs)
• templates/base/_header.html (modified) (1 diff)
• templates/base/scripts/BxBasePage.php (modified) (7 diffs)

trunk/inc/classes/BxDolPage.php

@@ -19 +19 @@
  * Pages. 
  *
- * It allows to display pages build from studio.
+ * It allows to display pages build from studio. 
+ *  
+ * The new system has the following page features:
+ * - layouts: page can have any page structure, not just columns.
+ * - SEO: page can have own SEO options, like meta tags and meta keywords, as well as instructions for search bots.
+ * - cache: page can be cached on server or in client's browser.
+ * - visibility: page access can be controlled using member levels.
+ * 
+ * 
+ * 
+ * @section page_create Creating the Page object:
+ *
+ * 1. add record to 'sys_objects_page' table:
+ *
+ * - object: name of the page object, in the format: vendor prefix, underscore, module prefix, underscore, internal identifier or nothing; for example: bx_profiles_view - profile view page.
+ * - title: title to display as page title.
+ * - module: the module this page belongs to.
+ * - layout_id: page layout to use, it is id of the record from 'sys_pages_layouts' table.
+ * - visibile_for_levels: bit field with set of member level ids. To use member level id in bit field - the level id minus 1 as power of 2 is used, for example:
+ *      - user level id = 1 -> 2^(1-1) = 1
+ *      - user level id = 2 -> 2^(2-1) = 2
+ *      - user level id = 3 -> 2^(3-1) = 4
+ *      - user level id = 4 -> 2^(4-1) = 8
+ * - visibile_for_levels_editable: it determines if 'visibile_for_levels' field is ediable from page builder, visibility options can be overriden by custom class and shouldn't editable in this case.
+ * - url: the page url, if it is static page.
+ * - meta_description: meta description of the page.
+ * - meta_keywords: meta keywords of the page.
+ * - meta_robots: instructions for search bots.
+ * - cache_server: number of seconds to store cache for on the server.
+ * - cache_editable: it determines if cache can be edited from page builder.
+ * - deletable: it determines if page can be deleted from page builder.
+ * - override_class_name: user defined class name which is derived from BxTemplPage.
+ * - override_class_file: the location of the user defined class, leave it empty if class is located in system folders.
+ * 
+ * Page layout are stored in 'sys_pages_layouts' table:
+ * - name: inner unique layout name.
+ * - icon: layout icon to display in page builder, it should represent basic view of the layout to help studio operator determine the layout structure.
+ * - title: layout name to display in page builder.
+ * - template: template name to use to display page with certain layout.
+ * - cells_number: number of areas in the layout, page blocks can be places into this areas(cells).
+ * To define areas in the layout they should be named as '__cell_N__', where N is cell number, starting from 1.
+ * 
+ * 
+ * 2. Add page blocks to 'sys_pages_blocks' table:
+ * - object: page object name this block belongs to.
+ * - cell_id: cell number in page layout to place block to.
+ * - module: module name this block belongs to.
+ * - title: block title.
+ * - designbox_id: design box to use to diplay page block, it is id of the record from 'sys_pages_blocks' table.
+ * - visibile_for_levels: bit field with set of member level ids. To use member level id in bit field - the level id minus 1 as power of 2 is used, for example:
+ *      - user level id = 1 -> 2^(1-1) = 1
+ *      - user level id = 2 -> 2^(2-1) = 2
+ *      - user level id = 3 -> 2^(3-1) = 4
+ *      - user level id = 4 -> 2^(4-1) = 8
+ * - type: block type
+ *      - raw: HTML block, displayed in page builder as HTML textarea.
+ *      - html: HTML block, displayed in page builder as visual editor, line TinyMCE.
+ *      - lang: translatable language string, displayed in page builder as editable language key.
+ *      - image: just an image, displayed in page builder as HTML upload form.
+ *      - rss: RSS block, displayed in page builder as editable URL to RSS resource, along with number of displayed items.
+ *      - menu: menu block, displayed as menu selector.
+ *      - service: to display block content, the provided serice method is used.
+ * - content: depending on 'type' field:
+ *      - raw: HTML string.
+ *      - html: HTML string.
+ *      - lang: language key.
+ *      - image: image id in the storage.
+ *      - rss: URL to RSS with number of displayed items, for example: http://www.example.com/rss#4
+ *      - menu: menu object name.
+ *      - service: serialized array of service call parameters: module - module name, method - service method name, params - array of parameters.
+ * - deletable: is block deletable from page builder
+ * - copyable: is block can be copied to any other page from page builder.
+ * - order: block order in some cell.
+ * 
+ * Block design boxes are stored in 'sys_pages_design_boxes' table:
+ * - id: consistent id, there are the following defines can be used in the code for each system block style:
+ *      - 0 - BX_DB_CONTENT_ONLY: design box with content only - no borders, no background, no caption.
+ *      - 1 - BX_DB_DEF: default design box with content, borders and caption.
+ *      - 2 - BX_DB_EMPTY: just empty design box, without anything.
+ *      - 3 - BX_DB_NO_CAPTION: design box with content, like BX_DB_DEF but without caption.
+ *      - 10 - BX_DB_PADDING_CONTENT_ONLY: design box with content only wrapped with default padding - no borders, no background, no caption; it can be used to just wrap content with default padding.
+ *      - 11 - BX_DB_PADDING_DEF: default design box with content wrapped with default padding, borders and caption.
+ *      - 13 - BX_DB_PADDING_NO_CAPTION: design box with content wrapped with default padding, like BX_DB_DEF but without caption.
+ * - title: block name which is displayed in studio, describes block styles.
+ * - template: template name to use to display page block.
+ *
+ *
+ * 3. Display Page.
+ * Use the following sample code to display page:
+ * @code
+ *     bx_import('BxDolPage');
+ *     $oPage = BxDolPage::getObjectInstance('sample'); // 'sample' is 'object' field from 'sys_objects_page' table, it automatically creates instance of default or custom class by object name
+ *     if ($oPage)
+ *         echo $oPage->getCode(); // print page
+ * @endcode
+ *
  */
 
-/*
 
-CREATE TABLE IF NOT EXISTS `sys_objects_page` (
-  `id` int(11) NOT NULL AUTO_INCREMENT,
-  `object` varchar(32) COLLATE utf8_unicode_ci NOT NULL,
-  `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `module` varchar(32) COLLATE utf8_unicode_ci NOT NULL,
-  `layout_id` int(11) NOT NULL,
-  `visibile_for_levels` int(11) NOT NULL,
-  `visibile_for_levels_editable` tinyint(4) NOT NULL DEFAULT '1',
-  `url` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `meta_description` text COLLATE utf8_unicode_ci NOT NULL,
-  `meta_keywords` text COLLATE utf8_unicode_ci NOT NULL,
-  `meta_robots` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `cache_server` int(11) NOT NULL,
-  `cache_server_params` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `cache_client` int(11) NOT NULL,
-  `cache_editable` tinyint(4) NOT NULL,
-  `deletable` tinyint(1) NOT NULL,
-  PRIMARY KEY (`id`),
-  UNIQUE KEY `object` (`object`)
-) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;
-
--- --------------------------------------------------------
-
-CREATE TABLE IF NOT EXISTS `sys_pages_blocks` (
-  `id` int(11) NOT NULL AUTO_INCREMENT,
-  `object` varchar(32) COLLATE utf8_unicode_ci NOT NULL,
-  `cell_id` int(11) NOT NULL,
-  `module` varchar(32) COLLATE utf8_unicode_ci NOT NULL,
-  `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `designbox_id` int(11) NOT NULL,
-  `visibile_for_levels` int(11) NOT NULL,
-  `type` enum('raw','html','lang','image','rss','menu','service') COLLATE utf8_unicode_ci NOT NULL DEFAULT 'raw',
-  `content` text COLLATE utf8_unicode_ci NOT NULL,
-  `deletable` tinyint(4) NOT NULL,
-  `copyable` tinyint(4) NOT NULL,
-  `order` int(11) NOT NULL,
-  PRIMARY KEY (`id`)
-) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;
-
--- --------------------------------------------------------
-
-CREATE TABLE IF NOT EXISTS `sys_pages_design_boxes` (
-  `id` int(11) NOT NULL,
-  `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `template` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  PRIMARY KEY (`id`)
-) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
-
-INSERT INTO `sys_pages_design_boxes` (`id`, `title`, `template`) VALUES
-(0, '_sys_designbox_0', 'designbox_0.html'),
-(1, '_sys_designbox_1', 'designbox_1.html'),
-(2, '_sys_designbox_2', 'designbox_2.html'),
-(3, '_sys_designbox_3', 'designbox_3.html'),
-(10, '_sys_designbox_10', 'designbox_10.html'),
-(11, '_sys_designbox_11', 'designbox_11.html'),
-(13, '_sys_designbox_13', 'designbox_13.html');
-
--- --------------------------------------------------------
-
-CREATE TABLE IF NOT EXISTS `sys_pages_layouts` (
-  `id` int(11) NOT NULL AUTO_INCREMENT,
-  `icon` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `title` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `template` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
-  `cells_number` int(11) NOT NULL,
-  PRIMARY KEY (`id`)
-) ENGINE=MyISAM  DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=2 ;
-
-INSERT INTO `sys_pages_layouts` (`id`, `icon`, `title`, `template`, `cells_number`) VALUES
-(1, 'layout_bar_left.png', '_sys_layout_bar_left', 'layout_bar_left.html', 2);
-
-*/
 
 class BxDolPage extends BxDol {
@@ -144 +166 @@
     }    
 
+    /**
+     * Check if page block is visible.
+     */
     protected function _isVisibleBlock ($a) {
         bx_import('BxDolAcl');
@@ -149 +174 @@
     }
 
+    /**
+     * Check if page is visible.
+     */
     protected function _isVisiblePage ($a) {
         bx_import('BxDolAcl');
@@ -154 +182 @@
     }
 
-    public function getCode () {
-
-    }
 }
 

trunk/inc/classes/BxDolTemplate.php

@@ -290 +290 @@
             'keywords' => array(),
             'description'  => '',
+            'robots' => '',
             'css_name' => array(),
             'css_compiled' => array(),
@@ -406 +407 @@
 
     /**
+     * Set page meta robots.
+     *
+     * @param string $s page meta robots.
+     */
+    function setPageMetaRobots($s) {
+        $this->aPage['robots'] = $s;
+    }
+
+    /**
      * Set page content for some variable.
      * @param string $sVar name of content variable
@@ -805 +815 @@
             case 'page_charset':
                 $sRet = 'UTF-8';
+                break;
+            case 'page_robots':
+                if(!empty($this->aPage['robots']) && is_string($this->aPage['robots']))
+                    $sRet = '<meta name="robots" content="' . bx_html_attribute($this->aPage['robots']) . '" />';
                 break;
             case 'page_keywords':

trunk/install/sql/v70.sql

@@ -971 +971 @@
 (@iCategoryId, 'sys_pb_cache_enable', 'Enable page blocks cache', '', 'checkbox', '', '', '', 23),
 (@iCategoryId, 'sys_pb_cache_engine', 'Page blocks cache engine (other than File option may require custom server setup)', 'File', 'select', 'File,EAccelerator,Memcache,APC,XCache', '', '', 24),
-(@iCategoryId, 'sys_mm_cache_engine', 'Member menu cache engine (other than File option may require custom server setup)', 'File', 'select', 'File,EAccelerator,Memcache,APC,XCache', '', '', 25);
+(@iCategoryId, 'sys_mm_cache_engine', 'Member menu cache engine (other than File option may require custom server setup)', 'File', 'select', 'File,EAccelerator,Memcache,APC,XCache', '', '', 25),
+(@iCategoryId, 'sys_page_cache_enable', 'Enable Page cache', '', 'checkbox', '', '', '', 26),
+(@iCategoryId, 'sys_page_cache_engine', 'Page cache engine (other than File option may require custom server setup)', 'File', 'select', 'File,EAccelerator,Memcache,APC,XCache', '', '', 27);
 
 
@@ -4830 +4832 @@
   `meta_robots` varchar(255) NOT NULL,
   `cache_server` int(11) NOT NULL DEFAULT '0',
-  `cache_server_params` varchar(255) NOT NULL,
-  `cache_client` int(11) NOT NULL DEFAULT '0',
   `cache_editable` tinyint(4) NOT NULL DEFAULT '1',
   `deletable` tinyint(1) NOT NULL,
+  `override_class_name` varchar(255) NOT NULL,
+  `override_class_file` varchar(255) NOT NULL,
   PRIMARY KEY (`id`),
   UNIQUE KEY `object` (`object`)

trunk/samples/page.php

@@ -15 +15 @@
 $aPathInfo = pathinfo(__FILE__);
 require_once ($aPathInfo['dirname'] . '/../inc/header.inc.php');
-require_once(BX_DIRECTORY_PATH_INC . "languages.inc.php");
 require_once(BX_DIRECTORY_PATH_INC . "params.inc.php");
 require_once(BX_DIRECTORY_PATH_INC . "design.inc.php");
 
+bx_import('BxDolLanguages');
+
 $oTemplate = BxDolTemplate::getInstance();
 $oTemplate->setPageNameIndex (BX_PAGE_DEFAULT);
-$oTemplate->setPageHeader ("Sample page");
 $oTemplate->setPageContent ('page_main_code', PageCompMainCode());
 $oTemplate->getPageCode();
@@ -33 +33 @@
 
     bx_import('BxDolPage');
-    $oGrid = BxDolPage::getObjectInstance('sample'); // it automatically creates instance of default or custom class by object name
-    if ($oGrid)
-        echo $oGrid->getCode(); // print page
+    $oPage = BxDolPage::getObjectInstance('sample'); // it automatically creates instance of default or custom class by object name
+    if ($oPage)
+        echo $oPage->getCode(); // print page
 
     return ob_get_clean();

trunk/templates/base/_header.html

@@ -7 +7 @@
     __page_description__
     __page_keywords__
+    __page_robots__
 
     <meta http-equiv="Content-Style-Type" content="text/css" />

trunk/templates/base/scripts/BxBasePage.php

@@ -17 +17 @@
 
     protected $_oTemplate;
+    protected $_oPageCacheObject = null;
 
     public function __construct ($aObject, $oTemplate) {
@@ -27 +28 @@
     }
 
-
-    public function getCode () {                
+    /**
+     * Get page code with automatic caching, adding necessary css/js files and system template vars. 
+     * @return string.
+     */
+    public function getCode () {
 
         if (!$this->_isVisiblePage($this->_aObject))
-            return MsgBox(_t('_Access denied'));
-
+            return $this->_getPageAccessDeniedMsg ();
+
+        $this->_addJsCss();
+ 
+        $this->_addSysTemplateVars();
+
+        // TODO: insert profiler call here 
+
+        if (!getParam('sys_page_cache_enable') || !$this->_aObject['cache_server'])
+            return $this->_getPageCode();
+        
+        $oCache = $this->_getPageCacheObject();
+        $sKey = $this->_getPageCacheKey();
+
+        $mixedRet = $oCache->getData($sKey, $this->_aObject['cache_server']);
+
+        if ($mixedRet !== null) {
+            return $mixedRet;
+        } else {
+            $sPageCode = $this->_getPageCode();
+            $oCache->setData($sKey, $sPageCode, $this->_aObject['cache_server']);
+        }        
+
+        return $sPageCode;
+    }
+    
+    /**
+     * Get page code only.
+     * @return string
+     */
+    protected function _getPageCode () {
         $aVars = array ();
         $aBlocks = $this->_oQuery->getPageBlocks();
@@ -38 +71 @@
             $sCell = '';
             foreach ($aCell as $aBlock) {
-
-                if (isset($GLOBALS['bx_profiler'])) $GLOBALS['bx_profiler']->beginPageBlock(_t($aBlock['title']), $aBlock['id']);
-
-                if (!$this->_isVisibleBlock($aBlock))
-                    continue;
-
-                $sFunc = '_getBlock' . ucfirst($aBlock['type']);
-                $mixedContent = $this->$sFunc($aBlock);
-
-                if (is_array($mixedContent)) {
-                    // TODO: get top, bottom, content code from array
-                } elseif (is_string($mixedContent)) {
-                    $sContentWithBox = DesignBoxContent(_t($aBlock['title']), $mixedContent, $aBlock['designbox_id']);
-                } else {
-                    $sContentWithBox = false;
-                }
+                $sContentWithBox = $this->_getBlockCode($aBlock);
                 if ($sContentWithBox)
                     $sCell .= '<div class="bx-page-block-container" id="bx-page-block-' . $aBlock['id'] . '">' . $sContentWithBox . '</div>';
-
-                if (isset($GLOBALS['bx_profiler'])) $GLOBALS['bx_profiler']->endPageBlock($aBlock['id'], $sContentWithBox ? false : true, false );
             }
             $aVars[$sKey] = $sCell;
         }
-        $this->_addJsCss();
-    
+
         return $this->_oTemplate->parseHtmlByName($this->_aObject['template'], $aVars);
     }
-    
+
+    /**
+     * Get block code.
+     * @return string
+     */
+    protected function _getBlockCode($aBlock) {
+        $sContentWithBox = '';
+
+        if (isset($GLOBALS['bx_profiler'])) $GLOBALS['bx_profiler']->beginPageBlock(_t($aBlock['title']), $aBlock['id']);
+
+        if ($this->_isVisibleBlock($aBlock)) {
+            $sFunc = '_getBlock' . ucfirst($aBlock['type']);
+            $mixedContent = $this->$sFunc($aBlock);
+
+            if (is_array($mixedContent)) {
+                // TODO: get menu from array
+                if (isset($mixedContent['content']))
+                    $sContentWithBox = DesignBoxContent(_t($aBlock['title']), $mixedContent['content'], $aBlock['designbox_id']);
+            } elseif (is_string($mixedContent)) {
+                $sContentWithBox = DesignBoxContent(_t($aBlock['title']), $mixedContent, $aBlock['designbox_id']);
+            } else {
+                $sContentWithBox = false;
+            }
+        }
+
+        if (isset($GLOBALS['bx_profiler'])) $GLOBALS['bx_profiler']->endPageBlock($aBlock['id'], $sContentWithBox ? false : true, false );
+
+        return $sContentWithBox;
+    }
+
+    /**
+     * Add necessary js and css files.
+     */
     protected function _addJsCss() {
         $this->_oTemplate->addCss('page_layouts.css');
     }
 
+    /**
+     * Set system template variables, like page title, meta description, meta keywords and meta robots.
+     */
+    protected function _addSysTemplateVars () {
+        $sPageTitle = $this->_getPageTitle();
+        if ($sPageTitle)
+            $this->_oTemplate->setPageHeader ($sPageTitle);
+   
+        $sMetaDesc = $this->_getPageMetaDesc();
+        if ($sMetaDesc)
+            $this->_oTemplate->setPageDescription ($sMetaDesc);
+
+        $sMetaKeywords = $this->_getPageMetaKeywords();
+        if ($sMetaKeywords)
+            $this->_oTemplate->addPageKeywords ($sMetaKeywords);
+
+        $sMetaRobots = $this->_getPageMetaRobots();
+        if ($sMetaRobots)
+            $this->_oTemplate->setPageMetaRobots ($sMetaRobots);
+    }
+
+    /**
+     * Get content for 'raw' block type.
+     * @return string
+     */
     protected function _getBlockRaw ($aBlock) {
         return $aBlock['content'];
     }
 
+    /**
+     * Get content for 'html' block type.
+     * @return string
+     */
     protected function _getBlockHtml ($aBlock) {
         return $this->_getBlockRaw ($aBlock);
     }
 
+    /**
+     * Get content for 'lang' block type.
+     * @return string
+     */
     protected function _getBlockLang ($aBlock) {
         return _t(trim($aBlock['content']));
     }
 
+    /**
+     * Get content for 'image' block type.
+     * @return string
+     */
     protected function _getBlockImage ($aBlock) {
         // TODO:
@@ -87 +171 @@
     }
 
+    /**
+     * Get content for 'rss' block type.
+     * @return string
+     */
     protected function _getBlockRss ($aBlock) {
         list( $sUrl, $iNum ) = explode( '#', $sContent );
@@ -95 +183 @@
     }
 
+    /**
+     * Get content for 'menu' block type.
+     * @return string
+     */
     protected function _getBlockMenu ($aBlock) {
         bx_import('BxTemplMenu');
@@ -101 +193 @@
     }
 
+    /**
+     * Get content for 'service' block type.
+     * @return string
+     */
     protected function _getBlockService ($aBlock) {
         $a = @unserialize($aBlock['content']);
@@ -107 +203 @@
         return BxDolService::call($a['module'], $a['method'], $a['params']);
     }
+
+    /**
+     * Get page title.
+     * @return string
+     */
+    protected function _getPageTitle() {
+        return _t($this->_aObject['title']);
+    }
+
+    /**
+     * Get page meta description.
+     * @return string
+     */
+    protected function _getPageMetaDesc() {
+        return _t($this->_aObject['meta_description']);
+    }
+
+    /**
+     * Get page meta keywords.
+     * @return string
+     */
+    protected function _getPageMetaKeywords() {
+        return _t($this->_aObject['meta_keywords']);
+    }
+
+    /**
+     * Get page meta robots.
+     * @return string
+     */
+    protected function _getPageMetaRobots() {
+        return _t($this->_aObject['meta_robots']);
+    }
+
+    /**
+     * Get access denied message HTML.
+     * @return string
+     */
+    protected function _getPageAccessDeniedMsg () {
+        return MsgBox(_t('_Access denied'));
+    }
+
+
+    /**
+     * Get page cache object.
+     * @return cache object instance
+     */
+    protected function _getPageCacheObject () {
+        if ($this->_oPageCacheObject != null) {
+            return $this->_oPageCacheObject;
+        } else {
+            $sEngine = getParam('sys_page_cache_engine');
+            $this->_oPageCacheObject = bx_instance ('BxDolCache' . $sEngine);
+            if (!$this->_oPageCacheObject->isAvailable())
+                $this->_oPageCacheObject = bx_instance ('BxDolCacheFile');
+            return $this->_oPageCacheObject;
+        }
+    }
+
+    /**
+     * Get page cache key.
+     * @param $isPrefixOnly return key prefix only.
+     * @return string
+     */
+    protected function _getPageCacheKey ($isPrefixOnly = false) {
+        $s = 'page_' . $this->_aObject['object'] . '_';
+        if ($isPrefixOnly)
+            return $s;
+        $s .= $this->_getPageCacheParams ();
+        $s .= md5(BX_DOL_VERSION . BX_DOL_BUILD . BX_DOL_URL_ROOT) . '.php';
+        return $s;
+    }
+
+    /**
+     * Additional cache key. In the case of dynamic page. 
+     * For example - profile page, where each profile has own page.
+     * @return string
+     */
+    protected function _getPageCacheParams () {
+        return '';
+    }
+
+    /**
+     * Clean page cache.
+     * @param $isDelAllWithPagePrefix delete cache by prefix, it can be used for dynamic pages, like profile view, where for each profile separate cache is generated.
+     * @return string
+     */
+    protected function cleanCache ($isDelAllWithPagePrefix = false) {
+        $oCache = $this->_getPageCacheObject ();
+        $sKey = $this->_getPageCacheKey($isDelAllWithPagePrefix);
+
+        if ($isDelAllWithPagePrefix)
+            return $oCache->removeAllByPrefix($sKey);
+        else
+            return $oCache->delData($sKey);
+    }
 }