编辑“SpeedPHP/类实例化函数spClass”

{{SpeedPHP top}}
在基于sp框架的程序开发中，spClass可以算得上是开发者最常使用到的核心函数了，甚至还要比dump调试程序用地更多。spClass——sp框架类实例化程序，可以说在任何sp程序中都能见到它的身影。

spClass的作用和[[PHP]]本身的new关键字作用相似，都是进行将类实例化成对象的操作，不过spClass比new要更强大，而且也有着很多非常实用的特性。接下来我们来介绍一下spClass的使用。

==spClass—类实例化程序==
用法：
 spClass($class_name, $args = null, $dir = null)
参数：
*$class_name，需要实例化的类名称，同时也可以是一个文件名称与类名相同的文件名。
*$args，类实例化时的参数。
*$dir，如果限制该类的文件是在某个目录，$dir将取值为该目录。如果$dir没有设置，则spClass将使用import来自动搜索相关路径以载入类定义文件。
使用spClass将为我们带来以下的多个好处：
*spClass在实例化前，将检查该类是否已经实例化，如已经实例化，将直接返回该实例化后的对象句柄，以免增加不必要的对象资源开销。
*spClass可以设置载入类文件的路径，我们可直接指定载入路径，spClass将一次自动完成载入文件及实例化等相关操作。
*spClass使用了import方式自动搜索类定义文件，使得在很多时候，我们只要直接spClass(类名)就可以类实例化了。
*spClass使用了更友好的spError错误提示。
这里我们介绍一个关于spClass的更简便的用法。

比如在留言本中我们调用留言模型类guestbook来进行findAll的操作，代码：
<pre><?php
class main extends spController
{
  ...
    function guestbooks(){
        $gb = spClass('guestbook'); // 初始化类
        $result = $gb->findAll(); // 执行findAll，获得返回结果
        $this->gblist = $result; // 将结果赋值给模板中的gblist变量
        $this->display('main_guestbooks.html'); // 输出模板
    }
  ...
}		
</pre>
但是我们的spClass可以简化上面的操作：
<pre><?php
class main extends spController
{
  ...
    function guestbooks(){
        $this->gblist = spClass('guestbook')->findAll(); // spClass一次完成了对象初始化及查找操作，同时将结果赋值给模板中的gblist变量
        $this->display('main_guestbooks.html'); // 输出模板
    }
  ...
}		
</pre>
如果加上自动模板输出，那么我们的[[代码]]可以更简捷了：
<pre><?php
class main extends spController
{
  ...
    function guestbooks(){
        $this->gblist = spClass('guestbook')->findAll(); 
    } // 视图类将自动输出main_guestbooks.html模板
  ...
}	
</pre>

==参考来源==
http://speedphp.com/manual.html

{{SpeedPHP}}

[[category:SpeedPHP|L]]