#1 jake

载入包含文件

bool import(string sfilename, bool auto_search, bool auto_error)

import()可以载入包含的PHP文件，功能类似于PHP的require()，但import()功能更为强大。

在开发中建议开发者使用import()来替代require()，以便有更好的开发体会。
和require()的不同点在于：

  • import()不仅可以和require()一样直接载入文件，而且在sfilename不是路径或不能载入文件的时候，自动搜索应用程序配置的相关多个目录以找到文件进行载入。
  • import()载入文件之前会先检查该文件是否已经载入，如果发现是已经载入的文件，import()将不做任何的载入操作并且返回TRUE，类似与require_once()。
  • import()检查文件存在时会使用spError()来提示文件读取出错信息。
框架的类初始化函数spClass()是以import()作为载入类定义文件的方法。
参数：

  • string sfilename 文件名或文件路径
  • bool auto_search 是否自动搜索文件，搜索路径的先后如下：

    • 用户程序扩展类载入路径 - include_path
    • 用户模型程序的路径定义 - model_path
    • 框架扩展功能载入路径 - sp_include_path

  • bool auto_error 在文件未能找到的情况下是否提示出错（使用spError()），默认关闭而返回FALSE。


2012-08-06 20:51:43