<?php
namespace MyErp\Model;


class User extends xErp\Model\User 
{

}

<?php
$web->component->setDirs([
	'xErpView'      => [$app->src('xErp/View'), 200, Component::VIEW],
	'xErpComponent' => [$app->src('xErp/Component'), 200],
]);

<?php
$app->getLoader()->setDirs([
	'xErpSrc'    => ['any_path', 200],
	'xErpHelper' => ['any_path/Helper', 200, Loader::HELPER],
]);

<?php
namespace MyApp;

class App extends Ke\App 
{

	protected $name = 'MyApp';

	protected $salt = 'xxxxxxxxxxxxxx';

}

<?php
class Index extends Controller {

	protected function onMissing(string $action)
	{
		// 原来的做法
		// throw new \Exception("Action {$action} not found!");
	}

}

<?php
class MyCmd extends ReflectionCommand
{

	protected static $commandName = 'my_cmd';

	protected static $commandDescription = '';

	// define fields: type|require|default|field|shortcut
	//         types: string|integer|double|bool|dir|file|realpath|json|concat|dirs|files|any...
	/**
	 * 对应执行命令时候的第一个参数，如：php ke.php my_cmd <name>
	 * 该参数为必须的参数
     * 
	 * @var string
	 * @type string
	 * @require true
	 * @field   1
	 */
	protected $name = '';

	/**
	 * 对应执行命令时候的第一个参数，如：php ke.php my_cmd <name> -s=<source>
	 * 该参数不是必须的
	 * 
	 * @var string
	 * @type string
	 * @field s
	 */
	protected $source = '';

	/**
	 * @var string
	 * @type string
	 * @field s
	 */
	protected $source = null;

	protected $tip = 'Creating model';

	protected function onConstruct($argv = null)
	{
		// 命令实例化接口
	}

	protected function onPrepare($argv = null)
	{
		// 命令执行前的预备阶段
	}

	protected function onExecute($argv = null)
	{
		// 命令执行时的实际入口
		// 这个方法是必须的
	}
}

<?php
namespace Cmd\GitExport;

class GitExport extends \Ke\Cli\Cmd\GitExport 
{

	
}

<?php
$cmd = new UpdateModel([null, 'User']);
$cmd->execute();

<?php
// config/routes.php

$router->routes = [
	// 根空间分发
	'*' => [
	],
	// 匹配所有hello/*的请求
	'hello' => [
		'namespace' => 'hi',
		'mappings' => [
			['world/{name}', 'controller#action', ['name' => '[a-z0-9_-]+']],
		]
	],
	'admin' => [
		'path' => 'management', // 允许通过path字段，对前缀进行修改，匹配management/*，而不会匹配admin
		// 这里没有指定命名空间，他会使用节点名admin，注意不是path的management
	],
];

<?php
// config/routes.php

$router->routes = [
	// 根空间分发
	'user' => [
		'controller' => 'user',
	],
];

<?php
// config/routes.php

$router->routes = [
	// 根空间分发
	'assets' => [
		'class' => MyApp\Controller\Asset::class,
		'action' => 'output',
	],
];

<?php
// config/routes.php

$router->routes = [
	// 根空间分发
	'assets' => [
		'class' => MyApp\Controller\Asset::class,
		'mappings' => [
			['{path}', '#output', ['path' => '.*']],
		],
	],
];

<?php

require '../bootstrap.php';

$web = new \Ke\Web\Web();
$web->dispatch();

<?php

class User extends Controller {

	protected $tempVar = 'temp'; // 这个属性不会传递到Context中

	public $topWidget = 'user_bar'; // 这个变量会传递到Context

	public function index() {
		$this->user = User::loadCache(1); // 这个也会传递到Context
	}


}

<?php

$this->topWidget; // user_bar
$this->user; // User::loadCache(1);

?>

<?php

$this->component('user_bar', ['user' => $this->user]);

<?php

$this->user; // 是Context中的变量，User::loadCache(1);

$user; // 则是加载这个component时，传递过来的局部变量，他只在当前的component中有效。

<div class="module user-module">
	<div class="title">
		<?php print $title ?? '' ?>
	</div>
	<div class="body">
		<?php print $content ?? '' ?>
	</div>
</div>

<?php

$this->component('user_profile', 'user_module', ['title' => '个人资料']);

<?php

namespace MyApp\Model;


class User extends \Ke\Model {

	protected static $columns = [
		'email' => ['label' => '邮箱', 'require' => 1, 'unique' => 1, 'min' => 5, 'max' => 128, 'email' => true],
		'name' => [
			'label' => '姓名',
			self::ON_UPDATE => [ 'require' => 1, 'min' => 3 ], // 嗯这样的逻辑比较奇葩，只是为了展示特性
		],
		'created_at' => [self::ON_CREATE => 'now'],
		'updated_at' => [self::ON_UPDATE => 'now'],
		'saved_at'   => [self::ON_SAVE   => 'now'], // create update都会触发
	];
	
}

<?php

$query = (new Query())->select('id', 'name', 'email', ['login_id', '...'])->from('user');
$query->where('status', '=', 1)->addWhere([
	['id', 'in', 1,2,[4,5],6,7,8,9,10],
	'OR',
	[
		['name', 'like', 'jan%'],
		'AND',
		['email', '=', 'janpoem@163.com'],
	]
]);
$query->join(QueryBuilder::LEFT_JOIN, 'user_log.user_id', 'user.id');
// 输出调试的sql，这里会让变量放入sql字符串中，方便直接调试。
$query->sql();

$query->find(); // 查全部
$query->findOne(); // 查一条
$query->count(); // 查记录数
$query->column('id'); // 取id这一列
$query->columnOne('id');

<?php

User::query()->where(...); // 通过Model调用的，可以不需要 写from

<?php

class User extends Model {

	protected static $queries = [
		'logs' => [
			'select' => 'tb1.*',
			'from'   => 'user', // 这个其实不是必须写的，并且表索引会自动关联tb1
			'join'   => [
				[QueryBuilder::LEFT_JOIN, 'user_log.user_id', 'tb1.id']
			],
			'order'  => ['status', 'updated_at', -1], // -1是DESC，1是ASC 
		]
	];

}

<?php

User::query('logs')->where('tb1.id', '>', 100)->limit(20); // 这里会clone一个新的查询，而不会污染原来的查询构造。

<?php

namespace xErp\Model\Dept;

use Ke\Adm\Model;
use Ke\Adm\TreeSort;
use Ke\Adm\TreeSortImpl;

class Dept extends Model implements TreeSortImpl
{

	protected static $cacheSource = null;

	public static function getTreeSort(): TreeSort
	{
		if (!isset(self::$treeSort)) {
			$key = static::class . '.TreeSort';
			$ttl = static::$cacheTTL;
			$adapter = static::getCacheAdapter();
			$cache = $adapter->get($key);
			if ($cache === false) {
				$data = (new \Ke\Adm\Query())->from(static::getTable())->select('id', 'parent_id', 'position')->find();
				$tree = new TreeSort($data);
				$tree->prepare();
				$adapter->set($key, $tree, $ttl);
				self::$treeSort = $tree;
			}
			else {
				self::$treeSort = $cache;
			}
		}
		return self::$treeSort;
	}

	public static function updateTreeSort()
	{
		$key = static::class . '.TreeSort';
		$ttl = static::$cacheTTL;
		static::getCacheAdapter()->set($key, static::getTreeSort(), $ttl);
	}

	protected function afterSave($process, array &$data)
	{
		// 在数据本身变更的时候，更新无限分类的缓存结构
		static::getTreeSort()->updateData($this, $data);
		static::updateTreeSort();
	}

	protected function afterDestroy()
	{
		// 在数据被删除的时候，将相关的数据从无限分类中删除掉
		static::getTreeSort()->deleteData($this);
		static::updateTreeSort();
	}

	// 取得当前数据在整个无限分类数中的深度
	public function getDepth(): int
	{
		if ($this->isNew())
			return -1;
		$treeSort = static::getTreeSort();
		return $treeSort->getDepth($this->id);
	}

	// 取得直系上级的数据对象
	public function getParent(): Dept
	{
		return static::loadCache($this->parent_id ?? 0);
	}

	// 取得所有上级对象，并将相关数据保存在$_parents变量中
	public function getParents(bool $includeSelf = false): array
	{
		if ($this->_parents === false) {
			$treeSort = static::getTreeSort();
			$parents = $treeSort->getParents($this->id, 'id', false);
			if (empty($parents))
				$this->_parents = [];
			else {
				foreach ($parents as $id) {
					$this->_parents[$id] = static::loadCache($id);
				}
			}
		}
		if ($includeSelf) {
			$parents = $this->_parents;
			$parents[] = $this;
			return $parents;
		}
		return $this->_parents;
	}

	// 取得当前直系的子节点数据
	public function getChildren(): array
	{
		if ($this->_children === false) {
			$treeSort = static::getTreeSort();
			$children = $treeSort->getChildren($this->id, 'id');
			if (empty($children))
				$this->_children = [];
			else {
				foreach ($children as $id) {
					$this->_children[$id] = static::loadCache($id);
				}
			}
		}
		return $this->_children;
	}
}

<?php

$tree = Dept::getTreeSort();
$tree->paginate(5, $this->http->query('page', 1));
Dept::query()->in('id', $tree->getPaginateIds());
$dataList = $query->find();
$dataList->setTreeSort($tree);

<?php
print $html->tableList($dataList); // 这里$dataList已经绑定了TreeSort了，剩下的就自动处理了。

<?php

use \Ke\Utils\DocMen\DocMen;

global $app;

DocMen::register(new DocMen($app->doc('kephp'), $app->kephp(), 'docmen'));

<?php

$docMen = new DocMen($app->doc('mydoc'), 'mydoc_src', 'mydoc', function() {
	// 加载这个源代码库的自动加载器，$this->source对应的就是'mydoc_src'
	import($this->source . '/autoload.php');
	// 以下用于将参数传递给Scanner的参数，目前只有以下三个参数有效
	$this->setScannerOptions([
		// 是否自动加载文件，默认为true，有些类库有自己的autoLoader，所以可以将这里设为false
		\Ke\Utils\DocMen\SourceScanner::OPS_AUTO_IMPORT     => false,
		// 命名空间的风格
		// DocMen::NS_STYLE_NEW，默认值，为PHP 5.3以后，使用\作为namespace的分隔符
		// DocMen::NS_STYLE_OLD_PEAR，为PHP 5.3以前，旧版本的PEAR规范，以_作为分隔符
		// DocMen::NS_STYLE_MIXED，混合，则当一个Class的namespaceName为空的时候，则自动转用DocMen::NS_STYLE_OLD_PEAR模式
		\Ke\Utils\DocMen\SourceScanner::OPS_NS_STYLE        => DocMen::NS_STYLE_MIXED,
		// 忽略解析的文件，以数组方式存放正则表达式，这里表示的是忽略解析，但他还是会将这个文件注册到mainData
		\Ke\Utils\DocMen\SourceScanner::OPS_NOT_PARSE_FILES => [
			'#bootstrap(_.*)?.php$#',
		],
	]);
	// 该DocMen是否显示源文件，以下false表示不显示，则所有相关源文件的link都会变成普通文本，file这个http路径也会失效。
	$this->setShowFile(false);
});

<?php
// config/routes.php
// 这里，不能再直接通过写入整个routes的方式来声明了。
//$router->routes = [
//	'*'      => [
//		'controller' => 'index',
//	],
//];

// 拦截route，并重写，指定到某个具体的controller上，这里是mydoc
$router->setNode('docmen', [
	'class'      => null,
	'controller' => 'mydoc',
	'namespace'  => '',
]);

<?php
namespace Demo\Controller;

use Ke\Utils\DocMen\DocController;
use Ke\Utils\DocMen\DocMen;

class Mydoc extends DocController
{


	protected function onConstruct()
	{
		$this->doc = DocMen::getInstance('docmen');
		parent::onConstruct(); // TODO: Change the autogenerated stub
	}

	public function index()
	{

	}

	public function show()
	{
		return parent::show();
	}
}

<?php
/** @var \Ke\Web\Html $html */
$html = $this->html;
/** @var \Ke\Web\Http $http */
$http = $web->http;

// 重用组件
$this->component('docmen/show');

<?php
namespace Demo\Helper;

class MyDocHtml extends Ke\Utils\DocMen\Html 
{
}

<?php
namespace Demo\Controller;

use Ke\Utils\DocMen\DocController;
use Ke\Utils\DocMen\DocMen;

class Mydoc extends DocController
{

	protected function onConstruct()
	{
		$this->doc = DocMen::getInstance('docmen');
		$this->html = new Demo\Helper\MyDocHtml();
		parent::onConstruct(); // TODO: Change the autogenerated stub
	}
}

<?php
$baseUri->newUri('hello/world'); // => /my_app/hello/world/，注意，如果不是xxx.yyy的结尾，会强制补/
$baseUri->newUri('/good'); // => /good/

$baseUri->newUri('.././good'); // => /my_app/../good/，注意这里不会做../的目录缩进的处理，而交给服务器吧。但是会去掉./ 

<?php
$baseUri->newUri('what?id=1', ['id' => 2]); // 最终生成是：/my_app/what/?id=2

<?php
$content = $ob->getFunctionBuffer(null, function() {
	echo 'hello world';
	var_dump('good!');
});

$content = $ob->getImportBuffer(null, 'test.php', ['var1' => 123]);

<?php
$this->html->tag('div', 'hello world', ['id' => 'id']);
$this->html->textInput('value');

<?php
interface UI
{

	public function getHtml(); // 返回当前web环境所使用的Html Helper

	public function getContext(); // 返回当前Web环境所实行的Context

}

<?php
$web->setUI(new MyUI());