ko.class.php

<?php
/**
 * @package ko
 * @author zhangchu
 */

define('KO_VERSION', '0.9.0');

if (!defined('DS'))
{
	/**
	 * 目录分隔符
	 */
	define('DS', DIRECTORY_SEPARATOR);
}

if (!defined('KO_DEBUG'))
{
	/**
	 * 取值0-9，为0为生产状态，其他为调试状态，调试状态输出调试内容，调试信息输出到 KO_LOG_FILE 定义的文件，取值越大，信息越多
	 * 1: SQL 语句，cache 统计
	 * 2: 其他中间层请求
	 */
	define('KO_DEBUG', 0);
}

if (!defined('KO_TEMPDIR'))
{
	/**
	 * 临时文件目录
	 */
	define('KO_TEMPDIR', DS === '\\' ? 'C:\\' : '/tmp/');
}

if (!defined('KO_LOG_FILE'))
{
	/**
	 * 保存调试信息的文件名
	 */
	define('KO_LOG_FILE', KO_TEMPDIR.'ko.log');
}

if (!defined('KO_DIR'))
{
	/**
	 * KO 部署的路径
	 */
	define('KO_DIR', dirname(__FILE__).DS);
}

if (!defined('KO_INCLUDE_DIR'))
{
	/**
	 * 应用 include 路径
	 */
	define('KO_INCLUDE_DIR', dirname(KO_DIR).DS);
}

if (!defined('KO_APPS_DIR'))
{
	/**
	 * 组件根路径
	 */
	define('KO_APPS_DIR', KO_DIR.DS.'apps'.DS);
}

if (!defined('KO_APPS_NS'))
{
	/**
	 * 组件命名空间前缀
	 */
	define('KO_APPS_NS', 'koApps');
}

if (!defined('KO_ENC'))
{
	/**
	 * 使用的序列化编码算法，Vbs/Serialize/IgBinary
	 */
	define('KO_ENC', 'Serialize');
}

if (!defined('KO_CHARSET'))
{
	/**
	 * 页面字符集，cgi 输入参数分析使用
	 */
	define('KO_CHARSET', 'UTF-8');
}

if (!defined('KO_VIEW_AUTOTAG'))
{
	/**
	 * 模版中使用的下面标记开头的变量可以由程序自动分析
	 */
	define('KO_VIEW_AUTOTAG', 'koAuto');
}

if (!defined('KO_PROXY'))
{
	/**
	 * KProxy 位置的服务器
	 */
	define('KO_PROXY', '');
}
if (!defined('KO_DB_ENGINE'))
{
	/**
	 * 配置数据库连接使用哪种引擎，如：kproxy/mysql/mysql-pdo
	 */
	define('KO_DB_ENGINE', 'mysql-pdo');
}
if (!defined('KO_DB_HOST'))
{
	/**
	 * 配置数据库主机端口，直连数据库的时候使用
	 */
	define('KO_DB_HOST', '192.168.0.140');
}
if (!defined('KO_DB_USER'))
{
	/**
	 * 配置数据库用户名
	 */
	define('KO_DB_USER', 'dev');
}
if (!defined('KO_DB_PASS'))
{
	/**
	 * 配置数据库密码
	 */
	define('KO_DB_PASS', 'dev2008');
}
if (!defined('KO_DB_NAME'))
{
	/**
	 * 配置数据库库名
	 */
	define('KO_DB_NAME', 'dev_config');
}
if (!defined('KO_DB_SPLIT_CONF'))
{
	/**
	 * 分表配置，保存kind到split字段的映射关系
	 */
	define('KO_DB_SPLIT_CONF', '');
}
if (!defined('KO_DB_CACHE_ENC'))
{
	/**
	 * 数据库缓存使用的编码方式
	 */
	define('KO_DB_CACHE_ENC', KO_ENC);
}

if (!defined('KO_MONGO_HOST'))
{
	/**
	 * 配置 MongoDB Host
	 */
	define('KO_MONGO_HOST', '192.168.1.190:27017,192.168.1.190:27018,192.168.1.190:27019');
}
if (!defined('KO_MONGO_REPLICASET'))
{
	/**
	 * 配置 MongoDB 副本集
	 */
	define('KO_MONGO_REPLICASET', 'rs0');
}
if (!defined('KO_MONGO_USER'))
{
	/**
	 * 配置 MongoDB 用户
	 */
	define('KO_MONGO_USER', '');
}
if (!defined('KO_MONGO_PASS'))
{
	/**
	 * 配置 MongoDB 密码
	 */
	define('KO_MONGO_PASS', '');
}
if (!defined('KO_MONGO_NAME'))
{
	/**
	 * 配置 MongoDB 数据库名称
	 */
	define('KO_MONGO_NAME', 'testdb');
}
if (!defined('KO_MONGO_SAFE'))
{
	/**
	 * 配置 MongoDB 缺省的安全模式
	 */
	define('KO_MONGO_SAFE', 1);
}

if (!defined('KO_IMAGE'))
{
	/**
	 * 使用的图形库，Gd/Imagick
	 */
	define('KO_IMAGE', 'Imagick');
}

if (!defined('KO_MC_ENGINE'))
{
	/**
	 * 配置使用的 memcache 的连接方式，kproxy/memcache/saemc
	 */
	define('KO_MC_ENGINE', 'memcache');
}
if (!defined('KO_MC_HOST'))
{
	/**
	 * 配置使用的 memcache 服务器，KO_MC_ENGINE 为 memcache 有效
	 */
	define('KO_MC_HOST', 'localhost:11211');
}
if (!defined('KO_LC_ENGINE'))
{
	/**
	 * 配置使用的 localcache 的连接方式，kproxy
	 */
	define('KO_LC_ENGINE', 'kproxy');
}
if (!defined('KO_REDIS_ENGINE'))
{
	/**
	 * 配置使用的 redis 的连接方式，kproxy/redis
	 */
	define('KO_REDIS_ENGINE', 'redis');
}
if (!defined('KO_REDIS_HOST'))
{
	/**
	 * 配置使用的 redis 服务器，KO_REDIS_ENGINE 为 redis 有效
	 */
	define('KO_REDIS_HOST', 'localhost:6379');
}

if (!defined('KO_SPL_AUTOLOAD'))
{
	/**
	 * KO对于 K 和 IK 开头的接口和类定义了 AutoLoad 的处理方式，如果应用需要自己处理 AutoLoad 可以设置 KO_SPL_AUTOLOAD 为 1
	 */
	define('KO_SPL_AUTOLOAD', 0);
}

if (!KO_SPL_AUTOLOAD)
{
	spl_autoload_register('koAutoload');
}

if (!defined('KO_APPS_AUTOLOAD'))
{
	/**
	 * KO对于 apps 里面的 M 和 IM 开头的接口和类定义了 AutoLoad 的处理方式，如果应用需要自己处理 AutoLoad 可以设置 KO_APPS_AUTOLOAD 为 1
	 */
	define('KO_APPS_AUTOLOAD', 0);
}

if (!KO_APPS_AUTOLOAD)
{
	spl_autoload_register('koAppsAutoload');
}

if (!defined('KO_ASSERT'))
{
	/**
	 * KO定义了断言操作的处理方式，如果应用需要自己处理，可以设置 KO_ASSERT 为 1
	 */
	define('KO_ASSERT', 0);
}

if (!KO_ASSERT)
{
	assert_options(ASSERT_ACTIVE, 1);
	assert_options(ASSERT_WARNING, 0);
	assert_options(ASSERT_BAIL, KO_DEBUG ? 1 : 0);
	assert_options(ASSERT_QUIET_EVAL, 1);
	assert_options(ASSERT_CALLBACK, 'koAssertCallback');
}

/**
 * K 和 IK 开头的类自动加载
 *
 * <ul>
 * <li>使用 K 或 IK 开头</li>
 * <li>应用的 include 目录下分级目录使用小写字母</li>
 * <li>多级目录使用下划线分隔，并且在类名中，每个目录的首字母大写</li>
 * <li>最后在跟上文件名，如：类 KO2o_Tools_geoApi 的文件应该是 include/o2o/tools/geoApi.php 或 include/o2o/tools/KO2o_Tools_geoApi.php</li>
 * </ul>
 */
function koAutoload($sClassName)
{
	if (substr($sClassName, 0, 1) !== 'K')
	{
		if (substr($sClassName, 0, 2) === 'IK')
		{
			koAutoload(substr($sClassName, 1));
		}
		return;
	}
	$pos = strrpos($sClassName, '_');
	if (false === $pos)
	{
		return;
	}
	if (substr($sClassName, 0, 3) === 'Ko_')
	{
		if ($pos < 3)
		{
			$modulename = '';
		}
		else
		{
			$modulename = substr($sClassName, 3, $pos - 3);
		}
		$includeRoot = KO_DIR;
	}
	else
	{
		$modulename = substr($sClassName, 1, $pos - 1);
		$includeRoot = KO_INCLUDE_DIR;
	}
	$modulename = strtolower($modulename);
	$modulepath = str_replace('_', DS, $modulename);

	$filename = substr($sClassName, 1 + $pos);
	$classfile = $includeRoot.$modulepath.DS.$filename.'.php';
	if (is_file($classfile))
	{
		require_once($classfile);
		return;
	}

	$classfile = $includeRoot.$modulepath.DS.$sClassName.'.php';
	if (is_file($classfile))
	{
		require_once($classfile);
		return;
	}
}

/**
 * apps 里面 M 和 IM 开头的类的自动加载
 * 类 koApps\test\MRest_demo 的路径为 apps/test/rest/demo.php
 */
function koAppsAutoload($sClassName)
{
	$items = explode('\\', $sClassName);
	$ns = array_shift($items);
	if (KO_APPS_NS === $ns)
	{
		$cname = array_pop($items);
		if ('M' === substr($cname, 0, 1))
		{
			$cnames = explode('_', $cname);
			$lastname = array_pop($cnames);
			if (!empty($cnames))
			{
				$lastname = strtolower(implode('/', $cnames)).'/'.$lastname;
			}
			$classfile = KO_APPS_DIR.implode('/', $items).'/'.substr($lastname, 1).'.php';
			if (is_file($classfile))
			{
				require_once($classfile);
			}
		}
		else if ('IM' === substr($cname, 0, 2))
		{
			$cnames = explode('_', $cname);
			$lastname = array_pop($cnames);
			if (!empty($cnames))
			{
				$lastname = strtolower(implode('/', $cnames)).'/'.$lastname;
			}
			$classfile = KO_APPS_DIR.implode('/', $items).'/'.substr($lastname, 2).'.php';
			if (is_file($classfile))
			{
				require_once($classfile);
			}
		}
	}
}

/**
 * 断言处理回调函数
 *
 * <ul>
 * <li>断言，通常应该是在开发测试过程中解决的问题</li>
 * <li>调试状态，输出断言的文件名/行号等相关信息</li>
 * <li>生产状态，抛出异常，没有详细信息</li>
 * </ul>
 */
function koAssertCallback($file, $line, $code)
{
	if (KO_DEBUG)
	{
		echo 'Assertion Failed:',"\n\t",'File ',$file,"\n\t",'Line ',$line,"\n\t",'Code ',$code,"\n";
		debug_print_backtrace();
	}
	else
	{
		$error = 'Assertion Failed!';
		throw new Exception($error);
	}
}