Discuz x3.5 核心文件 class_core.php

admin

[PHP] 純文本查看 復制代碼

<?php

/**
 *      [Discuz!] (C)2001-2099 Comsenz Inc.
 *      This is NOT a freeware, use is subject to license terms
 *
 *      $Id: class_core.php 33982 2013-09-12 06:36:35Z hypowang $
 */

error_reporting(E_ALL);

define('IN_DISCUZ', true);
define('DISCUZ_ROOT', substr(dirname(__FILE__), 0, -12));
define('DISCUZ_CORE_DEBUG', false);
define('DISCUZ_TABLE_EXTENDABLE', false);

set_exception_handler(array('core', 'handleException'));

if(DISCUZ_CORE_DEBUG) {
	set_error_handler(array('core', 'handleError'));
	register_shutdown_function(array('core', 'handleShutdown'));
}

spl_autoload_register(array('core', 'autoload'));

C::creatapp();

class core
{
	private static $_tables;
	private static $_imports;
	private static $_app;
	private static $_memory;

	public static function app() {
		return self::$_app;
	}
	/**
	 * 創建并返回一個應用實例。
	 *
	 * @return discuz_application 應用實例。
	 */
	public static function creatapp() {
	    if(!is_object(self::$_app)) {
	        self::$_app = discuz_application::instance();
	    }
	    return self::$_app;
	}

	/**
	 * 根據名稱創建并返回一個表對象。
	 *
	 * @param string $name 表的名稱。
	 * @return object 表對象。
	 */
	public static function t($name) {
	    return self::_make_obj($name, 'table', DISCUZ_TABLE_EXTENDABLE);
	}

	/**
	 * 根據名稱創建并返回一個模型對象。
	 *
	 * @param string $name 模型的名稱。
	 * @return object 模型對象。
	 */
	public static function m($name) {
	    $args = array();
	    if(func_num_args() > 1) {
	        $args = func_get_args();
	        unset($args[0]);
	    }
	    return self::_make_obj($name, 'model', true, $args);
	}

	/**
	 * 根據名稱和類型創建并返回一個對象實例。
	 *
	 * @param string $name 對象的名稱。
	 * @param string $type 對象的類型。
	 * @param bool $extendable 是否可擴展。
	 * @param array $p 傳遞給對象構造函數的參數數組。
	 * @return object 創建的對象實例。
	 */
	protected static function _make_obj($name, $type, $extendable = false, $p = array()) {
	    $pluginid = null;
	    if($name[0] === '#') {
	        list(, $pluginid, $name) = explode('#', $name);
	    }
	    $cname = $type.'_'.$name;
	    if(!isset(self::$_tables[$cname])) {
	        if(!class_exists($cname, false)) {
	            self::import(($pluginid ? 'plugin/'.$pluginid : 'class').'/'.$type.'/'.$name);
	        }
	        if($extendable) {
	            self::$_tables[$cname] = new discuz_container();
	            switch (count($p)) {
	                case 0:   self::$_tables[$cname]->obj = new $cname();break;
	                case 1:   self::$_tables[$cname]->obj = new $cname($p[1]);break;
	                case 2:   self::$_tables[$cname]->obj = new $cname($p[1], $p[2]);break;
	                case 3:   self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3]);break;
	                case 4:   self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3], $p[4]);break;
	                case 5:   self::$_tables[$cname]->obj = new $cname($p[1], $p[2], $p[3], $p[4], $p[5]);break;
	                default:  $ref = new ReflectionClass($cname);self::$_tables[$cname]->obj = $ref->newInstanceArgs($p);unset($ref);break;
	            }
	        } else {
	            self::$_tables[$cname] = new $cname();
	        }
	    }
	    return self::$_tables[$cname];
	}

	/**
	 * 創建并返回一個內存管理對象實例。
	 *
	 * @return discuz_memory 內存管理對象實例。
	 */
	public static function memory() {
	    if(!self::$_memory) {
	        self::$_memory = new discuz_memory();
	        self::$_memory->init(self::app()->config['memory']);
	    }
	    return self::$_memory;
	}

	/**
	 * 導入指定的文件。
	 *
	 * @param string $name 要導入的文件名稱。
	 * @param string $folder 文件所在的文件夾。
	 * @param bool $force 是否強制導入。
	 * @return bool 導入成功返回true，否則返回false。
	 */
	public static function import($name, $folder = '', $force = true) {
	    $key = $folder.$name;
	    if(!isset(self::$_imports[$key])) {
	        $path = DISCUZ_ROOT.'/source/'.$folder;
	        if(strpos($name, '/') !== false) {
	            $pre = basename(dirname($name));
	            $filename = dirname($name).'/'.$pre.'_'.basename($name).'.php';
	        } else {
	            $filename = $name.'.php';
	        }

	        if(is_file($path.'/'.$filename)) {
	            include $path.'/'.$filename;
	            self::$_imports[$key] = true;

	            return true;
	        } elseif(!$force) {
	            return false;
	        } else {
	            throw new Exception('Oops! System file lost: '.$filename);
	        }
	    }
	    return true;
	}

	/**
	 * 處理未捕獲的異常。
	 *
	 * @param Exception $exception 異常對象。
	 */
	public static function handleException($exception) {
	    discuz_error::exception_error($exception);
	}

	/**
	 * 處理PHP錯誤。
	 *
	 * @param int $errno 錯誤級別。
	 * @param string $errstr 錯誤信息。
	 * @param string $errfile 發生錯誤的文件。
	 * @param int $errline 發生錯誤的行號。
	 */
	public static function handleError($errno, $errstr, $errfile, $errline) {
	    if($errno & DISCUZ_CORE_DEBUG) {
	        discuz_error::system_error($errstr, false, true, false);
	    }
	}

	/**
	 * PHP腳本關閉時執行的函數，用于處理關閉時的錯誤。
	 */
	public static function handleShutdown() {
	    if(($error = error_get_last()) && $error['type'] & DISCUZ_CORE_DEBUG) {
	        discuz_error::system_error($error['message'], false, true, false);
	    }
	}

	/**
	 * 自動加載類文件。
	 *
	 * @param string $class 要加載的類名。
	 * @return bool 類加載成功返回true，否則返回false。
	 */
	public static function autoload($class) {
	    $class = strtolower($class);
	    if(strpos($class, '_') !== false) {
	        list($folder) = explode('_', $class);
	        $file = 'class/'.$folder.'/'.substr($class, strlen($folder) + 1);
	    } else {
	        $file = 'class/'.$class;
	    }

	    try {

	        self::import($file);
	        return true;

	    } catch (Exception $exc) {

	        $trace = $exc->getTrace();
	        foreach ($trace as $log) {
	            if(empty($log['class']) && $log['function'] == 'class_exists') {
	                return false;
	            }
	        }
	        discuz_error::exception_error($exc);
	    }
	}
	/**
	 * 開始分析計時器。
	 *
	 * 該函數用于標記某個分析段的開始時間以及開始時的內存使用情況。支持通過名稱和可選的鍵來標識分析段，
	 * 允許對不同的分析組進行統計。
	 *
	 * @param string $name 分析段的名稱。若以'#'開頭，后續內容被視為鍵名，不帶'#'的為分析段名稱。
	 */
	public static function analysisStart($name){
		$key = 'other'; // 默認鍵名
		if($name[0] === '#') { // 檢查名稱是否以'#'開頭，以區分鍵名和分析段名
			list(, $key, $name) = explode('#', $name); // 解析出鍵名和分析段名
		}
		if(!isset($_ENV['analysis'])) { // 確保分析數組已初始化
			$_ENV['analysis'] = array();
		}
		if(!isset($_ENV['analysis'][$key])) { // 確保指定鍵的分析數組已初始化
			$_ENV['analysis'][$key] = array();
			$_ENV['analysis'][$key]['sum'] = 0; // 初始化總時間
		}
		// 記錄分析段開始時間及內存使用情況
		$_ENV['analysis'][$key][$name]['start'] = microtime(TRUE);
		$_ENV['analysis'][$key][$name]['start_memory_get_usage'] = memory_get_usage();
		$_ENV['analysis'][$key][$name]['start_memory_get_real_usage'] = memory_get_usage(true);
		$_ENV['analysis'][$key][$name]['start_memory_get_peak_usage'] = memory_get_peak_usage();
		$_ENV['analysis'][$key][$name]['start_memory_get_peak_real_usage'] = memory_get_peak_usage(true);
	}

	/**
	 * 停止分析計時器。
	 *
	 * 該函數用于標記某個分析段的結束時間，并計算其持續時間以及結束時的內存使用情況。會返回該分析段的統計信息。
	 *
	 * @param string $name 分析段的名稱。格式同analysisStart函數。
	 * @return array 返回指定分析段的統計信息，包括持續時間和其他內存使用指標。
	 */
	public static function analysisStop($name) {
		$key = 'other'; // 默認鍵名
		if($name[0] === '#') { // 檢查名稱是否以'#'開頭，以區分鍵名和分析段名
			list(, $key, $name) = explode('#', $name); // 解析出鍵名和分析段名
		}
		if(isset($_ENV['analysis'][$key][$name]['start'])) { // 確保分析段已開始
			$diff = round((microtime(TRUE) - $_ENV['analysis'][$key][$name]['start']) * 1000, 5); // 計算并格式化持續時間
			$_ENV['analysis'][$key][$name]['time'] = $diff; // 記錄持續時間
			$_ENV['analysis'][$key]['sum'] = $_ENV['analysis'][$key]['sum'] + $diff; // 更新總時間
			unset($_ENV['analysis'][$key][$name]['start']); // 清除開始時間標記
			// 記錄分析段結束時的內存使用情況
			$_ENV['analysis'][$key][$name]['stop_memory_get_usage'] = memory_get_usage();
			$_ENV['analysis'][$key][$name]['stop_memory_get_real_usage'] = memory_get_usage(true);
			$_ENV['analysis'][$key][$name]['stop_memory_get_peak_usage'] = memory_get_peak_usage();
			$_ENV['analysis'][$key][$name]['stop_memory_get_peak_real_usage'] = memory_get_peak_usage(true);
		}
		return $_ENV['analysis'][$key][$name]; // 返回分析段的統計信息
	}
}

class C extends core {}
class DB extends discuz_database {}

?>