phpmcs_v9.6.0_UTF8 base.php文件分析

发现错误或有疑问请联系: linjielig@gmail.com

class pc_base {
    /*
    作用: 判断是否存在自定义文件,自定义文件名必须为原文件名前加'MY_',例如要自定义文件
    'db_factory.class.php'则自定义文件为'MY_db_factory.class.php',且要与
    原文件在同一目录下.phpcms会在包含原文件之后再包含自定义文件
    参数: $filepath 文件全路径,如'phpcms/libs/classes/db_factory.class.php'

    返回值: 存在自定义文件返回自定义文件内容,否则返回'false'
    */
    public static function my_path($filepath){}

    /*
    作用: 加载指定名字的类文件(即'phpcms/'.$path.$classname.'class.php'),
    如果'$is_initialize=1'则创建类实例,反之不创建

    参数: 
    $classname 类名字(文件为$classname.'class.php')
    $filepath 相对于目录'phpcms'的文件路径(不包含文件名字和'/'), 
    如'libs/myclasses'(即'phpcms/libs/myclasses'),
    此路径必须在'phpcms'目录下,如果为空则使用目录'libs/classes'
    $is_initialize 是否创建加载类的实例,默认为创建

    返回值: 不存在指定类文件返回false,加载成功不创建类实例返回true,
    加载成功创建类实例返回创建的类实例
    */

    public static function _load_class($classname,$filepath='',$is_initialize=1){}
    //此函数与'_load_class'函数一样
    public static function load_sys_class($classname,$filepath='',$is_initialize=1){}

    //加载'application'类(文件为'phpcms/libs/classes/application.class.php')
    public static function create_app() {}

    /*
    作用: 加载模块类,底层使用'_load_class'函数

    参数: 
    $classname 类名字(文件为$classname.'class.php')
    $modulename 模块名字,指示模块类路径,如'comment'(即'phpcms/modules/comment/classes')
    $is_initialize 是否创建类实例,默认创建

    返回值: 不存在指定类文件返回false,加载成功不创建类实例返回true,
    加载成功创建类实例返回创建的类实例
    */
    public static function load_app_class($classname,$modulename='',$is_initialize=1){}

    /*
    作用: 加载模型,底层使用'_load_class'函数

    参数:
    $classname 类名字(文件为$classname.'class.php',路径为'phpcms/model/')

    返回值: 不存在指定类文件返回false,加载成功不创建类实例返回true,
    加载成功创建类实例返回创建的类实例
    */
    public static function load_model($classname) {}

    /*
    作用: 加载函数库

    参数:
    $function_library_name 函数库名字(文件为$function_library_name.'func.php')
    $path 相对于目录'phpcms'的文件路径(不包含文件名字和'/'), 
    如'libs/myfunc'(即'phpcms/libs/myfunc'),
    此路径必须在'phpcms'目录下,如果为空则使用目录'libs/functions'

    返回值: 成功找回true,失败返回false
    */
    public static function _load_func($function_library_name,$path=''){}

    /*
    作用: 加载系统函数库,底层使用_load_func函数,使用默认目录('phpcms/libs/functions')

    参数: $function_library_name 函数库名字(文件为$function_library_name.'func.php')

    返回值: 成功返回true,失败返回false.
    */
    public static function load_sys_func($function_library_name){}

    /*
    作用: 加载指定目录下的所有函数文件,函数文件命名格式必须为'*.func.php'

    参数: $path 相对于目录'phpcms'的文件路径(不包含文件名字和'/'), 
    如'libs/autofunc'(即'phpcms/libs/autofunc'),
    此路径必须在'phpcms'目录下,如果为空则使用目录'libs/functions/autoload'

    返回值: 无
    */
    private static function _auto_load_func($path='') {}
    //与函数_auto_load_func一样
    public static function auto_load_func($path='') {}

    /*
    作用: 加载模块函数库

    参数:
    $function_library_name 函数库名字(文件为$function_library_name.'func.php')
    $module_name 模块名字,如'admin'(路径为'phpcms/modules/admin/functions'

    返回值: 成功返回true,失败返回false
    */
    public static function load_app_func($function_library_name,$module_name='')
     {}

    /*
    作用: 加载插件类库

    参数:
    $classname 类名字(文件为$classname.'class.php')
    $identification 插件标识,如'weibo'(路径为'phpcms/plugin/weibo/classes')
    $is_initialize 是否创建类实例

    返回值: 不存在指定类文件或$identification未定义返回false,加载成功不创建类实例返回true,
    加载成功创建类实例返回创建的类实例
    */
    public static function load_plugin_class($classname,$identification='',$is_initialize=1)
     {}

    /*
    作用: 加载插件函数库

    参数:
    $function_library_name 函数库名字(文件为$function_library_name.'func.php')
    $identification 插件标识,如'weibo'(路径为'phpcms/plugin/weibo/functions')

    返回值: 成功返回true,失败返回false
    */
    public static function load_plugin_func($function_library_name,$identification) {}

    /*
    作用: 加载插件模型,底层使用'_load_class'函数

    参数:
    $classname 类名字(文件为$classname.'class.php',路径为'phpcms/plugin/'.$identification.'model')
    $identification 插件标识,如'weibo'(路径为'phpcms/plugin/weibo/model')

    返回值: 不存在指定类文件或$identification未定义返回false,加载成功不创建类实例返回true,
    加载成功创建类实例返回创建的类实例
    */
    public static function load_plugin_model($classname,$identification) {}
    /*
    作用: 加载配置信息

    参数: 
    $config_filename 配置文件名字,如'cache'(文件为'cache.php',路径为'phpcms/caches/configs/cache.php')
    $config_key 配置项,如'template'(配置文件实际为php数组,配置项即为数组索引)
    $config_default_value 如果指定的配置项不存在,返回此值作为默认值
    $is_reload 如果配置文件已经加载是否重新加载,默认为否

    返回值:
    如果指定了'$config_key'返回指定配置项的值,如果不存在指定配置项的值返回'$config_default_value'作为默认值.
    如果未指定'$config_key'返回指定的配置文件,配置文件不存在返回空值
    */
    public static function load_config(
        $config_filename, 
        $config_key='', 
        $config_default_value='', 
        $is_reload=false
    ) {}