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