zan 简介
[zan 赞] 是一个免费开源的,快速,简单的面向对象的,轻量级PHP微框架。
之所以开发这个框架,不是因为它的性能比Yaf好,也不是因为比ci,tp功能强大,仅仅是因为我想练习设计,它只是一个产出,如果你也喜欢它的设计,或者有优雅的方式,那就一起构建吧。
我对zan的期望是:它是一个只包含了路由分发,尽可能少的基础库。始终相信在一个轻快的平台上,总能为有想法的技术人提供更多的可能和精彩。
能做什么?
controller,model,view
基础工具log,session,http,requst
composer
基本要求
PHP5.3+
composer(如需要引用其它packagist时)
zan 实例
zan 简明教程
使用zan是一件很轻松的事情,它体贴地根据uri(/app/controller/action?)转发到相应的app的controller::action中。你的开发只需要从控制器开始,剩下的交给你了,精彩看你如何自由发挥。
此例会展示在清晰的结构中,使用简单的基础库简洁优雅地实现app,相信你只需要花上5分钟了解这些东西,就能完全得掌握zan。
路由分发
当发起请求如:http://great-compayn/demo/user/login?username=zan&pass=superzan,先配置一项nginx的rewrite规则:
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
此时zan会找到App/Demo/Controller/User.php类,自动加载所需类和配置,并调用loginAction的方法。
App
└── Demo
├── Conf
│ └── User.php
├── Controller
│ └── User.php
├── Model
│ └── User.php
└── Template
├── signup.php
└── userinfo.php
zan把这部分工作交由Zan\Library\Bootstrap去处理,在找寻User.php和确认是否存在loginAction的方法过程,如有其一不存在,则返回404;如在执行过程有自定义错误或异常,将返回50x系统错误。
App 开发
由开发过程中存在多app,如openapi(开放接口),mis(运营后台),help(反馈平台)。明显的好处在于uri更符合RESTful设计,组织结构也更清晰明了。暂且我们定义一个Demo吧
Controller
实际上,编写应用的过程就是不断的添加Controller和Action并把它实现。
下边是一个Controller User的样子:
use Zan\Library\Util;
use Zan\Library\Controller;
use Zan\Library\View;
class Demo_Controller_User extends Controller {
public function __construct() {
$this->view = new View();
$this->model = new Demo_Model_User();
}
public function loginAction() {
if (Util\Request::isPost()) {
$userName = Util\Request::post('user_name');
$userPass = Util\Request::post('user_pass');
$ret = $this->model->login($userName, $userPass);
if ($ret) {
Util\Http::redirect('/demo/user/info');
} else {
$this->view->set('error_msg', '登录失败,请检查用户名和密码');
}
}
$this->view->render(array(
'action' => '/demo/user/login',
'tip' => '登录'
), 'signup.php');
}
}
在User中,使用了两种自动加载方式,一种是命名空间,另一种是下划线,前者是全局的,后者是在App工作空间内实现快速自动加载(另外个人审美原因)。
Model
Demo_Model_User会自动加载App/Demo/Model/User.php,
use Zan\Library\Util;
use Zan\Library\Model;
class Demo_Model_User extends Model {
public function __construct() {
parent::__construct('mysqli');
}
public function login($userName, $userPass) {
if (!$userName || !$userPass) {
return false;
}
$userPass = $this->getMd5Pass($userPass);
$sql = "select * from user where name = '{$userName}' and pass = '{$userPass}'";
return $this->db->fetchOne($sql);
}
}
view
模板渲染目前实现非常简单,100%原生,没有做任何正则替换。模板赋值有两种方式,$this->view->set('error_msg', '登录失败,请检查用户名和密码');;另外一种就是在最后渲染模板$this->view->render($array, $tpl)统一赋值。$tpl模板在当前App目前下Template下,即Demo/Template/signup.php
渲染方式:
Zan\Library\View;
...
public function render($array = [], $tpl = null) {
if (is_array($array) && $tpl) {
$this->_tpl = APPPATH . APP . '/Template/' . $tpl;
}
$this->mset($array);
if (!file_exists($this->_tpl)) {
throw new \ZException("can not find tpl[{$this->_tpl}]", E_ERROR);
}
ob_start();
extract($this->_extract);
include($this->_tpl);
ob_flush();
}
...
可以看到,render接受一个$array数组,然后将数组中的数据extract出来,这样一个原本是$array['tip']的数据在模板里边就能通过$tip访问了。而载入模板部分更简单,只是直接require。这是因为zan直接使用PHP来做模板的解释引擎。Template模板signup.php输出如下
= $error_msg ?>
基础库
一直在想哪些是web开发最常用的基础库,如何构建优雅的组件,以下是个开始,力争简单够用,让喜欢它的开发者能快速上手,同时让自己能这些组件优雅地开发复杂的应用。
日志
分模块、分级别
配置简单(目前0配置)
日志格式清晰易读
应用简单
http
request
session
image