新特性列表 面向php7 忘记php5吧,忘记吧!
多应用程序源代码集合 这里主要借鉴了java的项目机制。
一个项目所有php源代码,都基于src目录下,而不再基于app或application目录。 src下必须声明一个命名空间,如:\mytest,那么controller(\mytest\controller)、model(\mytest\model)等代码都基于这个命名空间下。 假定我有一个项目,叫做x-erp,这个项目的命名空间基于:\xerp,然后我需要创建一个新项目(\myerp),这里我希望能重用x-erp的代码,于是我可以有几个做法:
做法1: 将xerp放入新项目的src目录内,新项目内,src目录下,有src\myerp和src\xerp。
在新项目中,类可以直接继承自xerp的类
namespace myerp\model;class user extends xerp\model\user {}
如果希望能重用xerp的视图组件(view、component、layout),则只要手动注册目录即可。
$web->component->setdirs([ 'xerpview' => [$app->src('xerp/view'), 200, component::view], 'xerpcomponent' => [$app->src('xerp/component'), 200],]);
做法2: 为新项目,注册旧项目的目录所在。
$app->getloader()->setdirs([ 'xerpsrc' => ['any_path', 200], 'xerphelper' => ['any_path/helper', 200, loader::helper],]);
loader和component(loader) \ke\loader用于项目的class、helper(functions)的加载。
\ke\web\component用于项目的view、widget、layout加载。
这里都支持注册多个目录,进行多个目录的检索。并允许控制权重值。
更好composer兼容 要加载composer,在项目的bootstrap.php文件,进行加载即可。
通过面向对象定义配置入口、重载入口、事件入口 这是一个不太好说明的问题,也是我从2012年开始思考至今。
配置入口 传统基于数组的方式进行配置,虽然很实用,但是在代码层面,并不友好,尤其是在对数据全面性判断时,需要做大量的判断。
现在完全改用类属性的方式,比如app的全局应用程序配置,直接改用类属性进行配置。
namespace myapp;class app extends ke\app { protected $name = 'myapp'; protected $salt = 'xxxxxxxxxxxxxx';}
重载入口 这次重新封装,三大入口:app、web、console,都允许在实际的应用程序继承,并重载。
核心类库提供一种默认的行事风格,但是并不完全封闭重构这个行事风格的入口。
核心类库必要隐藏的属性和特性,通过对象实例进行隐蔽,继承类只要关心自己要实现什么逻辑即可。
比如,默认的controller,当碰到action不存在的时候,会抛出异常,但用户可以重载onmissing的方法,来自行控制:
class index extends controller { protected function onmissing(string $action) { // 原来的做法 // throw new \exception(action {$action} not found!); }}
事件入口 其实我个人并不喜欢,如wordpress的action和filter一般机制(通过字符串的方式来声明、调用事件),一方面来说,这种做法实在不是什么高性能的做法,其次,大规模的普及这种事件钩子,对于开发人员来说,实在太痛苦了,需要记得事件表太多了。
各个主要核心的类(app、web、console、command、controller、renderer),都提供on为前缀的事件方法,并且都是protected的,这些方法,在源代码层面都是可被代码编辑器智能感知的。
model层的命名保留以前ror的风格:before*、after*。
这种做法的目的,核心的思想就是,通过面向对象的方式(使代码可被感知易于提示的情况下),开放、开放,彻底的开放。使框架可以成为开发者自己的框架,而不是别人的框架。
command彻底重做,实现reflectioncommand 重做的目的,就是要彻底的简单化,简单化,更加简单,不要思考,只要动手写业务逻辑即可。
反射的命令的用法如下:
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 * 该参数为必须的参数 * * @var string * @type string * @require true * @field 1 */ protected $name = ''; /** * 对应执行命令时候的第一个参数,如:php ke.php my_cmd -s= * 该参数不是必须的 * * @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) { // 命令执行时的实际入口 // 这个方法是必须的 }}
通过上述类的属性声明,会自动对应到执行命令时所执行的参数,并自动做值类型的过滤和转换。一般来说,只要针对实际的业务逻辑进行编程即可,不会考虑多余事情。
command的检索顺序 假定用户输入了new_cmd的命令,会转化为几个版本如:new_cmd、newcmd、new_cmd、newcmd,进行匹配 优先检查src/cmd,其次是kephp类库内的命令。 kephp本身提供许多命令,比如gitexport,这个命令主要用于导出当前项目和上一个版本(或指定版本)更新了的文件,并放入指定的目录,执行命令为: php ke.php git_export。
如果用户希望在这里基础上,增加一些新的功能,可以在项目添加:src/cmd/gitexport
namespace cmd\gitexport;class gitexport extends \ke\cli\cmd\gitexport {}
那么同样在执行这个命令时候,会优先加载用户设定的类,并且并不会和全局的classloader产生冲突。
command的调用 除了使用命令的方式调用,还可以通过实例化一个command来调用(可以参考\ke\cli\cmd\add)指令。
$cmd = new updatemodel([null, 'user']);$cmd->execute();
router转发风格 现在对于webrouter的做法,有很多新的做法,比如:$web->get('/post/:id/edit'),这种,还有middleware的模式等。
请恕我鲁钝,无法接受那些五花八门的东西,我坚持一个原则:一个项目的路由分发,应该只在一个地方进行统一、集中的配置,而不应该到处都能分发,不然要找现在到底是哪个分发器起作用,或者是去找这个action下一步又跳转去哪个action去了。
这里和过往mst library、agimvc里面所坚持的编程方针有关。
因为model是具有数据、具有行为能力(方法)的实体,所以业务逻辑应该作为model的接口行为,而controller\action层面,则应该只包含最简单的流程控制。所有涉及数据实体的操作,应该一律放在model层(同样的道理,所有展现相关的,应该放在view层),model层和view层中间,使用helper进行无状态衔接。
新版本的router配置仍然采用数组的方式:
routes = [ // 根空间分发 '*' => [ ], // 匹配所有hello/*的请求 'hello' => [ 'namespace' => 'hi', 'mappings' => [ ['world/{name}', 'controller#action', ['name' => '[a-z0-9_-]+']], ] ], 'admin' => [ 'path' => 'management', // 允许通过path字段,对前缀进行修改,匹配management/*,而不会匹配admin // 这里没有指定命名空间,他会使用节点名admin,注意不是path的management ],];
上述所示,是传统路由器的分发模式,每个节点,代表着的是一个基础的前缀路径(同时也是命名空间)。每个节点都可以配置相关的 mappings字段。
如果没指定,则按照 controller/action/tail的方式进行匹配。
新版本增加了两种匹配的模式:
一、controller分发模式
routes = [ // 根空间分发 'user' => [ 'controller' => 'user', ],];
这种分发模式,会将所有user/*的请求,绑定到user控制器,user/profile => { controller: user, action: profile }。
二、class分发模式
routes = [ // 根空间分发 'assets' => [ 'class' => myapp\controller\asset::class, 'action' => 'output', ],];
这种模式下,会 将所有assets/*请求都转发到asset这个类,注意这个类必须继承自controller。
并且指定了默认的action,除非指定了mappings,否则所有的请求都会使用output这个action。
controller和class模式,会使用action/tail的方式进行默认的匹配。区别于传统模式。
controller-action命名 默认行为中:
controller、action,都会强制转为小写 如果controller包含namespace,也会强制小写,类分隔符 \,会替换为linux的目录分隔符 /,如:admin/post controller的类名:驼峰首字母大写,保留下划线,如:hello_world/say_hi => hello_world/say_hi action的方法名:强制小写,保卫下划线(.-都会替换为_)。 当然,如上述,这只是一个保守的默认行为而已,所有命名风格,允许用户继承web,并进行重载相关的方法。但是前后一致性的问题,需要自行处理。
默认行为中, namespace/controller#action为字符表达格式。
action执行 假定有动作:login,如果只是get请求,只会关联方法 login,如果是post请求,则会进一步关联 login和 post_login,两者共享一个当前的controller实例。
默认行为,如果不存在login方法,会抛出异常。
action输出,有三种方法:
什么都不return(return null),默认以controller/action进行view匹配。 return false,什么都不输出。 $this->view()、$this->text()、$this->json()、$this->redirect(),执行具体的输出(不需要加return)。 在 login和 post_login的时候,
什么都不return依旧生效,对应的实体是 login。 如果在 login优先执行了上述3.的强制输出(view/text/json/redirect),则不再会执行 post_login 实际上核心判断的标准是,检测当前的 $web->isrender(),如果任何操作出发了wen渲染,则其他操作都不会再生效。
默认的输出,可以通过重载controller的 defaultreturn方法进行控制。
router匹配到的特定变量,会作为action执行时的参数,比如:
routes = [ // 根空间分发 'assets' => [ 'class' => myapp\controller\asset::class, 'mappings' => [ ['{path}', '#output', ['path' => '.*']], ], ],];
上述的匹配,默认行为,会匹配:
namespace myapp\controller;class asset extends controller { public function output($path = '') { }}
如果希望定制传入的参数,可以重载controller的 getactionargs(array $params)方法的返回结果。
web\context 在实际项目中的 index.php
dispatch();
如果属于自己定制的web,可以改为 new \myapp\web()。
而用户不必特别去global标识$web,通过: \myapp\web::getweb(),或者 \ke\web\web::getweb(),都可以获取回这个实例(\ke\cli\console和\ke\app都是类似的道理),为了保证开放性,没有严格限制web和console的重复创建实例的问题,app则限制了重复实例。
web部分的结构:
web -> router -> controller -> context -> renderer
变量的传递,不需要在调用 $this->view()的方法中传递,只需要将变量绑定到controller上(注意要public),就会自动传递到context上。
context是渲染视图时的上下文变量环境,通过controller的$this绑定的变量,被视作超级全局变量,直接绑定到context上,比如:
class user extends controller { protected $tempvar = 'temp'; // 这个属性不会传递到context中 public $topwidget = 'user_bar'; // 这个变量会传递到context public function index() { $this->user = user::loadcache(1); // 这个也会传递到context }}
相应的,在 user/indexview中:
topwidget; // user_bar$this->user; // user::loadcache(1);?>
在view环境下,$this指向的就是当前web渲染时的context实例。
在view环境下,拥有两个变量: $this和 $web,$this对应的是context,$web则对应的是web的实例。
而在layout中,会多一个变量: $content,这个是加载视图时获取到的内容,你只要 print $content ''。
在component中,情况就会复杂一些,但也只是复杂一些,假定在view中,我加载了一个component:
component('user_bar', ['user' => $this->user]);
那么在 user_bar这个component中:
user; // 是context中的变量,user::loadcache(1);$user; // 则是加载这个component时,传递过来的局部变量,他只在当前的component中有效。
component的加载,还允许增加一个layout,这是一个很变态的做法,很多时候,我们的前端都会将一个区块的代码,做成一个可复用的module,比如:
title
body
恩,很好很规整,那么我们只要把上述的代码稍微修改,并放入src/component/layout/user_module.phtml中:
然后在需要的时候调用
component('user_profile', 'user_module', ['title' => '个人资料']);
而且如果你想的,可以进一步的将他封装为一个函数,反正是你的自由。
最后说一点:
$web->setcontext(new myapp\helper\usercontext);
你懂的。
model层优化 一、重新调整columns的生成,尽量不破坏原columns的内容。
二、dbcolumns()接口,为数据库的声明,请不要随意修改,请直接修改 protected static $columns属性
三、columns声明增加update和create的区别:
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都会触发 ];}
四、重新调整model缓存的问题,增加相应的接口: oncreatecache, onupdatecache, onsavecache, ondeletecache。可缓存model,要求必须有主键的model才可以。加载缓存: mode::loadcache(1)。 before*和 after*系列接口就不用介绍了。
五、数据更新前会做差异化比较。
六、去掉很多没用的东西、代码优化。
cachemodel和cachemodeltrait 这个是专门用来针对缓存数据的模型。呃,如果不能理解为什么会有这样的东西,这段就跳过吧。
preparedata,接口必须实现,用于实现一个缓存数据模型的装填和准备阶段。
oncreate, onupdate, onsave, ondelete接口。
query 新版本的查询构造器,都改用 query实现,可以通过数组的方式构建。
$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');
如果希望绑定到model实例上:
user::query()->where(...); // 通过model调用的,可以不需要 写from
model和query的特定查询构造 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 ] ];}
假定我需要复用这个查询:
user::query('logs')->where('tb1.id', '>', 100)->limit(20); // 这里会clone一个新的查询,而不会污染原来的查询构造。
其他 \ke\uri 所有生成uri的地方,都使用了这个类,比如: $web->uri('hello/world');
注意,这里要生成uri的时候,需要使用 $uri->newuri()的方法。这个方法会clone一个新的实例。当然web和asset的代码,已经进行相关的封装,一般用户不用关心这个问题。
假定你的网站根目录为: /my_app,那么注意传参数时候的区别:
$baseuri->newuri('hello/world'); // => /my_app/hello/world/,注意,如果不是xxx.yyy的结尾,会强制补/$baseuri->newuri('/good'); // => /good/$baseuri->newuri('.././good'); // => /my_app/../good/,注意这里不会做../的目录缩进的处理,而交给服务器吧。但是会去掉./
同样的,查询字符串也会自动合并:
$baseuri->newuri('what?id=1', ['id' => 2]); // 最终生成是:/my_app/what/?id=2
\ke\mimetype 这是文件media type的匹配,本来是希望作为一个静态类来使用的,谁没事搞几个版本的mime呢?不过为了保持这个版本的风格一致,还是使用了对象实例的方式。
php ke.php scan_tables 哦哦,根据当前项目配置的数据库自动生成model文件,如果文件存在,则更新。很爽。
\ke\outputbuffer $content = $ob->getfunctionbuffer(null, function() { echo 'hello world'; var_dump('good!');});$content = $ob->getimportbuffer(null, 'test.php', ['var1' => 123]);
嗯……
版本说明 当前为先行版本,包含实现了主要特性,不过不要放入实际项目中,还有一些东西没做。
