原文地址:http://bbs.phpchina.com/thread-233224-1-1.html

github 地址: https://github.com/easychen/LazyPHP

LazyPHP(以下简称LP)是一个轻框架.

之所以开发这么一个框架,是因为其他框架给的太多。在高压力的情况下,ORM和盘根错节的对象树反而将简单的页面请求处理复杂化,在调试和性能上带来反面效果。

LP采用函数式接口封装对象,对内通过面向对象实现代码重用,对外则提供简明扼要的操作函数。开发者甚至不用理解面向对象就能很好的使用,这让一些初级程序员很容易就开发出强壮的应用。

在数据库等模块的加载上,LP采用LazyLoad方式,并用$GLOBALS实现全局单件,在方便和高效之间找到了一个平衡点。这也是LP框架名字中Lazy的来源。

LP在新浪大量使用已经将近3年,每天承载的请求达千万级别。由于LP易读易学,使用LP的开发者之间沟通非常容易,而新同事也可以很快融入进来。

LP3是LP最新的版本,最主要的调整是重新定义了Layout规则,以应对日益增多的Ajax,Mobile和Rest请求。同样是由于这个原因,LP3和之前的版本不兼容,我们建议大家在新项目中采用LP3。


LP3简明教程

LP是一个轻框架。它只是打算帮你处理掉每个Web应用都需要重新开始的那部分东西,并不打算成为一个大而全的Lib(我说的真的不是ZendFrameWork)。

LP只包含一个FrontController+Layout系统+20个常用函数。你只需要花上10分钟了解这些东西,就能完全得掌握LP。


FRONTCONTROLLER

FrontController(以 下简称FC)翻译过来叫前端控制器,在LP中,所有的动态请求(不包括静态文件)都会经过FC。使用FC的好处是可以统一控制全部请求,举例而言,你只需 要在FC中添加几行代码,就可以精确控制哪些controller和action不可以访问。

LP3的FC你可以看成就是ROOT/index.php(实际上分发逻辑在_lp/index.php),所有的请求都在这里处理。不管你是用户登录还是浏览文章,在LP上用户访问的页面都是index.php。

FC根据Controller和Action对请求进行分组,并调用对应的模块来进行处理。如何定义Controller和Action?最简单的办法是把一个数据表对应到一个Controller,而对这个数据表的相关操作自然就成为了Action。

比如,我们会定义一个叫做User的Controller,而把Login,Logout,Detail 作为User的Action。

我们在访问LP时,把要请求的Controller和Action通过参数c和a传递给FC。

/index.php?c=user&a=login

上边这个访问告诉FC去加载名为User的Controller,并调用名为Login的方法。

在实现上,Controller被放到AROOT.controller目录下,以Class形式存在,而Action就是这个Class的一个方法。

下边几行伪代码描述了这个其实很简单的过程:

// FC取得参数
 $c = $_REQUEST['c'] ;
 $a = $_REQUEST['a'] ;
 // controller文件名和Class名
 $cont_file = AROOT . ‘controller/’ . $c . ‘/’ . $a . ‘.class.php’;
 $class_name =$c . ucfirst($a) .’Controller’ ;
 // 载入文件
 require_once( $cont_file );
 // 调用方法
 $o = new $class_name;
 call_user_func( array( $o , $a ) );

实际上编写应用的过程其实就是不断的添加Controller和Action并把它实现。

下边是一个Controller Class的样子:

class defaultController extends appController
 {
 function __construct()
 {
 parent::__construct();
 }
 function index()
 {
 $data['title'] = $data['top_title'] = ‘首页’;
 render( $data );
 }
 }


MVC和LAYOUT

LP是遵循MVC模式的,它的业务逻辑和显示逻辑是完全分离的。Controller处理了业务逻辑,我们使用模板来处理显示逻辑。

LP所有的模板都被放在AROOT.view下边,通过在Controller中使用Render函数来渲染模板。

以下是Render函数的伪代码:

function render( $data = NULL , $layout = NULL , $style = ‘default’ )
 {
 $layout_file = AROOT . ‘view/layout/’ . $layout . ‘/’ . $style . ‘.tpl.html’;
 @extract( $data );
 require( $layout_file );
 }

可 以看到,Render接受一个$data数组,然后将数组中的数据extract出来,这样一个原本是$data[‘user’]的数据在模板里边就能通 过$user访问了。而载入模板部分更简单,只是直接require。这是因为LP直接使用PHP来做模板的解释引擎。我们推荐大家在模板中采用PHP的 短标签语法以保持高的可读性:

<?php if( $user['level'] >= 9 ): ?>
 亲,你是鹳狸猿
 <?php else: ?>
 亲,你是平民,天黑请闭眼
 <?php endif; ?>

上边是一个使用短标签的模板的例子。if,foreach都可以这样写。切忌在模板中使用{},这会让你的模板看起来很奇葩。

为了实现模板的重用,我们引入了Layout系统。

来看一个经常遇到的例子,网站头部导航和页脚版权部分的重用。

最简单和最容易想到的处理办法是这样的:将头部保存为header.tpl.html,将页脚保存为footer.tpl.html。然后直接在模板中用include函数载入即可。

这样很OK,但是当我们有10个模板要处理的时候,你会发现每个模板都要去include header和footer。而在这些模板中,header和footer其实是不变的,变的是中间的部分。

于 是我们为这些相同模板建立一个通用的模板文件,叫做sharpA.tpl.html,在sharpA中我们指定好header和footer,然后 sharpA根据FC接收到的C和A变量(还记得吧)去加载对应子目录下模板。这样我们只需要创建C和A对应的模板就可以了。下边是一个典型的sharp 模板。

<html>
 <body>
 <div id=”hd” ><?php @include_once( dirname(__FILE__) ) . DS . ‘header.tpl.html’; ?></div>
 <div id=”bd”>
 <div id=”side”>
 <?php
 include( AROOT . ‘view’ . DS . ‘layout’ . DS . g(‘layout’) . DS . ‘side’ . DS . g(‘c’) . DS . g(‘a’) . ‘.tpl.html’ );
 ?>
 </div>
 <div id=”main”>
 <?php
 include( AROOT . ‘view’ . DS . ‘layout’ . DS . g(‘layout’) . DS . ‘main’ . DS . g(‘c’) . DS . g(‘a’) . ‘.tpl.html’ );
 ?>
 </div>
 </div>
 </div>
 <div id=”ft”><?php @include_once( dirname(__FILE__) ) . DS . ‘footer.tpl.html’; ?></div>
 </body>
 </html>

当 一个sharp满足不了需求时,我们可以再创建sharpB.tpl.html。styleB可以选择性的共享sharpA的header和 footer,也可以载入自己特定的header。我们把sharpA,sharpB…等通用模板放到一个目录下,叫做一个Layout。

目前Layout按照访问方式分为Web,Ajax,Mobile和Rest四种。当你为你的游戏机或者电视机创建一组特定风格的sharp模板时,你可以创建一个名叫TV或者PFP的Layout目录。

切换Sharp和Layout非常简单,只需要修改Render函数中第二和第三个参数就可以了。在没有指定的情况下,LP3会启用Layout下的default style模板,同时还会根据请求的方式,自动加载Web,Mobile或者Ajax Layout。

再回过头来说MVC,我们已经了解了C和V在LP的使用。而M就是根据请求参数,从数据库或者其他地方取得数据的过程。在LP3之前,数据是直接在Controller中查询数据库取得的。

function show()
 {
 $uid =  intval($_REQUEST['uid']);
 if( $uid < 1 ) return info_page(‘错误的uid’);
 $data['user'] = get_line( “SELECT * FROM `user` WHERE `uid` = ‘” . $uid . “‘ LIMIT 1″ );
 render( $data );
 }

这 种方式将SQL散落在各个Action中,不利于重用和修改。所以在LP3中,我们采用专门的model文件来放置Controller中用到的数据操作 函数。还是用上边的例子,我们假设这是一个名为User的Controller的Show Action。那么在LP3中我们推荐的做法如下:

首先在 AROOT/model目录下创建一个名为user.function.php的文件。

然后在文件中写入获取用户信息的函数:

function get_user_info_by_id( $uid )
 {
 return get_line( “SELECT `name` ,`email` , `bod` FROM `user` WHERE `uid` = ” . intval($uid) . ” LIMIT 1 ” )
 }

user.function.php将在请求参数包含?c=user 时自动加载。所以我们可以把show改为下边的样子:

function show()
 {
 $uid =  intval($_REQUEST['uid']);
 if( $uid < 1 ) return info_page(‘错误的uid’);
 $data['user'] = get_user_info_by_id(  $uid  );
 render( $data );
 }

这样再其他的Action,比如User/settings 中,我们可以通过get_user_info_by_id 函数重用代码。通过函数封装重复SQL还有一个好处是方便对SQL进行统一处理,加手工Cache就是一个经常能遇到的需求。


常用函数

LP3中的函数主要有3类,迅捷函数,功能函数和数据库函数,一共20个左右。

迅捷函数

迅捷函数是一系列的函数缩写:

function c( $str ) // 读取配置文件中$str为key的对应的value
 function v( $str ) // 取得 $_REQUEST[$str] 的数据,不存在不会报warning
 function z( $str ) // strip_tags
 function g( $str ) // 取得 $GLOBALS[$str] 的数据
 function t( $str ) // trim
 function u( $str ) // urlencode

功能性函数

function render( $data = NULL , $layout = NULL , $style = ‘default’ ) // Layout
 function info_page( $info ) // 系统提示信息
 function ajax_echo( $info ) // 输出提示信息,包含永不过期的header
 function uses( $file ); // 载入lib目录下的文件

数据库函数

function s( $str , $db = NULL ) // mysql_real_escape_string
 function prepare( $sql , $array ) // 将数组中的变量顺序替换SQL中的?
 function db() // 使用config目录下的数据库设置,创建并返回数据库链接
 function get_data( $sql , $db = NULL ) // 以二维数组的方式返回$sql对应的结果
 function get_line( $sql , $db = NULL ) // 以一维数组的方式返回$sql对应的单行结果
 function get_var( $sql , $db = NULL ) // 以变量的方式返回一个数值
 function last_id( $db = NULL ) // last id
 function run_sql( $sql , $db = NULL ) // 运行sql,不返回结果集
 function db_error() // 数据库错误信息
 function db_errno() // 数据库错误编号
 function close_db( $db ) // 显式关闭数据库链接


特别说明

其中要详细说明的有两个:

C($KEY)和配置文件

LP将应用配置信息保存在AROOT/config/app.config.php下,使用$GLOBALS[‘config’]超全局变量以数组形式保存。使用c($key)的方式,可以在MVC各个地方获取。

PREPARE()函数

这个函数是LP3新引入的,主要是希望减少SQL注入的问题。使用方式如下:

echo $sql = prepare( “SELECT * FROM `user` WHERE `name` = ?s AND `uid` = ?i AND `level` = ?s LIMIT 1″ , array( “Easy’” , ‘-1′, ’9.56′ ) );</blockquote>

输出结果为:

SELECT * FROM `user` WHERE `name` = ‘Easy\” AND `uid` = ‘-1′ AND `level` = ’9.56′ LIMIT 1

使用prepare函数时要注意:SQL必须使用双引号,【?i】表示整数,【?s】表示整数以外的其他值。prepare会无例外的mysql_real_escape_string,然后在两边加上单引号。


CSS,JAVASCRIPT和AJAX

LP3采用YUI3的CSS框架以处理在不同浏览器上CSS兼容性,其中开发者用得最多的应该是grid系统,这里是它的详细说明

JavaScript库上,LP3开始换为JQuery。这里是JQuery API的参考手册

为了方便不熟悉的同学也能使用好Ajax,LP3自己实现了Ajax传输数据的JS函数。这些函数都放在AROOT/static/script/app.js中。

$(‘#标签ID’).load(‘URL’);  // 是由JQuery自身实现的,可以方便的无刷新载入页面。
 send_form_in( ‘FROMID’ ); // 将form表单中的数据通过Ajax提交(file类型除外),并将服务器返回的HTML显示在Form表单顶部
 send_form_pop(‘FROMID’); //  将form表单中的数据通过Ajax提交(file类型除外),并将服务器返回的HTML显示在浮动图层中

好了,这里就是关于LP3 的一切了,希望LP3能让你更快的完成工作。

原文地址:http://bbs.phpchina.com/thread-233224-1-1.html