joomla1.56 loader.php

分享一下，有错误请写出来，谢谢啦

1. <?php
2. /**
3. * @version $Id: loader.php 10381 2008-06-01 03:35:53Z pasamio $
4. * @package      Joomla.Framework
5. * @copyright    Copyright (C) 2005 - 2008 Open Source Matters. All rights reserved.
6. * @license      GNU/GPL, see LICENSE.php
7. * Joomla! is free software. This version may have been modified pursuant
8. * to the GNU General Public License, and as distributed it includes or
9. * is derivative of works licensed under the GNU General Public License or
10. * other free or open source software licenses.
11. * See COPYRIGHT.php for copyright notices and details.
12. */
13. //定义分隔符
14. if(!defined('DS')) {
15.     define( 'DS', DIRECTORY_SEPARATOR );
16. }
18. /**
19.  * @package     Joomla.Framework
20.  */
21. class JLoader
22. {
23.      /**
24.      * Loads a class from specified directories.
25.      *
26.      * @param string $name  The class name to look for ( dot notation ).
27.      * @param string $base  Search this directory for the class.
28.      * @param string $key   String used as a prefix to denote the full path of the file ( dot notation ).
29.      * @return void
30.      * @since 1.5
31.      */
32.     function import( $filePath, $base = null, $key = 'libraries.' )
33.     {
34.         static $paths;//保存 $paths[***.***.**.**] = bool 或者 include...
36.         if (!isset($paths)) { //头一回
37.             $paths = array();//设置为空数组
38.         }
39.         //在原路径中加上前缀,$keypath是作为$paths的键名，静态保存   
40.         $keyPath = $key ? $key . $filePath : $filePath;
41.         //如果没设置这个键名
42.         if (!isset($paths[$keyPath]))
43.         {
44.             if ( ! $base ) {//基本路径为空
45.                 $base =  dirname( __FILE__ );//其实就是JPATH_LIBRARIES
46.             }
47.             //把原路径依.分开
48.             $parts = explode( '.', $filePath );
49.             //取出最后一个，就是类名
50.             $classname = array_pop( $parts );
51.             switch($classname)//判断下类名
52.             {
53.                 case 'helper' ://如果是'helper'
54.                     //再取一个双大写组合
55.                     $classname = ucfirst(array_pop( $parts )).ucfirst($classname);
56.                     break;
58.                 default ://默认的话就类名开头大写
59.                     $classname = ucfirst($classname);
60.                     break;
61.             }
62.             //路径更改, .变DS
63.             $path  = str_replace( '.', DS, $filePath );
64.             //joomla开头
65.             if (strpos($filePath, 'joomla') === 0)
66.             {
67.                 /*
68.                  * If we are loading a joomla class prepend the classname with a
69.                  * capital J.
70.                  */
71.                 $classname  = 'J'.$classname;//J+类名
72.                 //注册一下
73.                 $classes    = JLoader::register($classname, $base.DS.$path.'.php');
74.                 //是否设置了
75.                 $rs         = isset($classes[strtolower($classname)]);
76.             }
77.             else
78.             {
79.                 /*
80.                  * If it is not in the joomla namespace then we have no idea if
81.                  * it uses our pattern for class names/files so just include.
82.                  */
83.                 //直接导入
84.                 $rs   = include($base.DS.$path.'.php');
85.             }
86.             $paths[$keyPath] = $rs;
87.         }
88.         //返回的可以是bool或是导入的内容
89.         return $paths[$keyPath];
90.     }
92.     /**
93.      * Add a class to autoload
94.      *
95.      * @param   string $classname   The class name
96.      * @param   string $file        Full path to the file that holds the class
97.      * @return  array|boolean       Array of classes
98.      * @since   1.5
99.      */
100.     /**
101.      * 配合php5的自动读取
102.      *
103.      * @param   string $classname   类名
104.      * @param   string $file        绝对路径
105.      * @return  array|boolean       Array of classes
106.      * @since   1.5
107.      */
108.     function & register ($class = null, $file = null)
109.     {
110.         static $classes;//classes[(小写)类名] = 路径
112.         if(!isset($classes)) {//如果头一回
113.             $classes    = array();//为空数组
114.         }
116.         if($class && is_file($file))//if都没问题
117.         {
118.             // Force to lower case.
119.             $class = strtolower($class);//强制小写
120.             $classes[$class] = $file; //classes[(小写)类名] = 路径
122.             // In php4 we load the class immediately.
123.             if((version_compare( phpversion(), '5.0' ) < 0)) {//PHP就直接读取class
124.                 JLoader::load($class);
125.             }
127.         }
128.         //return classes
129.         return $classes;
130.     }
133.     /**
134.      * Load the file for a class
135.      *
136.      * @access  public
137.      * @param   string  $class  The class that will be loaded
138.      * @return  boolean True on success
139.      * @since   1.5
140.      */
141.     /**
142.      * 从注册函数中返回classes,$class是classes的键值就包括进来
143.      * @access public
144.      * @param  string $class
145.      * @return boolean True on success
146.      */
147.     function load( $class )
148.     {
149.         $class = strtolower($class); //强制小写
151.         if (class_exists($class)) {//最在返回空
152.               return;
153.         }
155.         $classes = JLoader::register();//取得所有注册的类
156.         if(array_key_exists( strtolower($class), $classes)) {
157.             //如果存在，包括进来
158.             include($classes[$class]);
159.             return true;
160.         }
161.         //否则返回 false
162.         return false;
163.     }
164. }
167. /**
168.  * When calling a class that hasn't been defined, __autoload will attempt to
169.  * include the correct file for that class.
170.  *
171.  * This function get's called by PHP. Never call this function yourself.
172.  *
173.  * @param   string  $class
174.  * @access  public
175.  * @return  boolean
176.  * @since   1.5
177.  */
178. //PHP5的新特性，包括已经注册的类
179. function __autoload($class)
180. {
181.     if(JLoader::load($class)) {
182.         return true;
183.     }
184.     return false;
185. }
187. /**
188.  * Global application exit.全局的退出函数
189.  *
190.  * This function provides a single exit point for the framework.
191.  *
192.  * @param mixed Exit code or string. Defaults to zero.
193.  */
194. function jexit($message = 0) {
195.     exit($message);
196. }
198. /**
199.  * Intelligent file importer一个系统内部的导入，因为是用libraries.开始
200.  * 
201.  * @access public
202.  * @param string $path A dot syntax path
203.  * @since 1.5
204.  */
205. function jimport( $path ) {
206.     return JLoader::import($path);
207. }