2011-1-1---------------mage.php -----------函数分析！！！

************************************************************

/**

     * Retrieve application root absolute path

     *

     * @return string

     */

    public static function getRoot()

    {

        return self::$_appRoot;

    }

 

    /**

     * Retrieve Events Collection

     *

     * @return Varien_Event_Collection $collection

     */

    public static function getEvents()

    {

        return self::$_events;

    }

 

得到mage的静态变量值，一般都是执行了set函数之后执行的。getRoot()  getEvents

 

************************************************************

 

1

 public static function getVersion()

    {

        $i = self::getVersionInfo();

        return trim("{$i['major']}.{$i['minor']}.{$i['revision']}" . ($i['patch'] != '' ? ".{$i['patch']}" : "") . "-{$i['stability']}{$i['number']}", '.-');

    }

 

 

2

 public static function getVersionInfo()

    {

        return array(

            'major'     => '1',

            'minor'     => '4',

            'revision'  => '1',

            'patch'     => '1',

            'stability' => '',

            'number'    => '',

        );

    }

 

3字符的叠加，加字符处理函数：

trim

 

截去字符串首尾的空格。

************************************************************

 

1.

 

/**

     * Register a new variable

     *

     * @param string $key

     * @param mixed $value

     * @param bool $graceful

     * @throws Mage_Core_Exception

     */

    public static function register($key, $value, $graceful = false)

    {

        if (isset(self::$_registry[$key])) {

            if ($graceful) {

                return;

            }

            self::throwException('Mage registry key "'.$key.'" already exists');

        }

        self::$_registry[$key] = $value;

    }

 

2.

此函数，该key存在的时候， $graceful为true，则return，否则，则抛出异常。

key值不存在，则，将其写入$_registry[]函数。

 

************************************************************

 /**

     * Retrieve a value from registry by a key

     *

     * @param string $key

     * @return mixed

     */

    public static function registry($key)

    {

        if (isset(self::$_registry[$key])) {

            return self::$_registry[$key];

        }

        return null;

    }

 

 

************************************************************

 

1.  

/**

     * Set all my static data to defaults

     *

     */

    public static function reset()

    {

        self::$_registry        = array();

        self::$_app             = null;

        self::$_config          = null;

        self::$_events          = null;

        self::$_objects         = null;

        self::$_isDownloader    = false;

        self::$_isDeveloperMode = false;

        // do not reset $headersSentThrowsException

    }

 

注意：注释--- do not reset $headersSentThrowsException

 

 

************************************************************

 

 

 

1

 

 public static function setRoot($appRoot = '')

    {

        if (self::$_appRoot) {

            return ;

        }

 

        if ('' === $appRoot) {

            // automagically find application root by dirname of Mage.php

            $appRoot = dirname(__FILE__);

        }

 

        $appRoot = realpath($appRoot);

 

        if (is_dir($appRoot) and is_readable($appRoot)) {

            self::$_appRoot = $appRoot;

        } else {

            self::throwException($appRoot . ' is not a directory or not readable by this user');

        }

    }

 

 

 

 

1

if ('' === $appRoot) {

            // automagically find application root by dirname of Mage.php

$appRoot = dirname(__FILE__);

 

dirname(__FILE__) 返回当前相对目录。

2

realpath

 

realpath() 函数返回绝对路径。

该函数删除所有符号连接（比如 '/./', '/../' 以及多余的 '/'），返回绝对路径名。

若失败，则返回 false。比如说文件不存在的话。

 

3

is_dir() 

is_dir

 

测试文件是否为目录。

 

语法: boolean is_dir(string filename);

 

返回值: 布尔值

 

函数种类: 文件存取

4

is_readable

The is_readable() function checks whether the specified file is readable.

is_readable()函数的作用是：判断给定文件名是否可读

 

判断：1.得到绝对地址，2是否是目录，3是否可读（文件权限）

 

相对地址-->绝对地址--->是否为目录---->目录是否可读。。

 

 

realpath() 函数返回绝对路径。

该函数删除所有符号连接（比如 '/./', '/../' 以及多余的 '/'），返回绝对路径名。

若失败，则返回 false。比如说文件不存在的话。

*************************************************************

 1.

/**

     * Unregister a variable from register by key

     *

     * @param string $key

     */

    public static function unregister($key)

    {

        if (isset(self::$_registry[$key])) {

            if (is_object(self::$_registry[$key]) && (method_exists(self::$_registry[$key], '__destruct'))) {

                self::$_registry[$key]->__destruct();

            }

            unset(self::$_registry[$key]);

        }

    }

2.

 

当在$_registery[key]对应value是字符串，则直接使用unset()方法，将其从$_registery[]数组中删除

如果$_registery[key]对应的value是对象，而且存在__destruct()方法，则先执行__destruct()方法。此处要注意，先通过对象自己删除，然后再将其从$_registery[]中删除。

*************************************************************

 /**

     * Varien Objects Cache

     *

     * @param string $key optional, if specified will load this key

     * @return Varien_Object_Cache

     */

    public static function objects($key = null)

    {

        if (!self::$_objects) {

            self::$_objects = new Varien_Object_Cache;

        }

        if (is_null($key)) {

            return self::$_objects;

        } else {

            return self::$_objects->load($key);

        }

    }