Skip to content

Latest commit

 

History

History
888 lines (469 loc) · 17.3 KB

README.md

File metadata and controls

888 lines (469 loc) · 17.3 KB
Raw

前言

Thunder，是一个免费开源的，快速、简单的面向对象的轻量级PHP开发框架。

目录结构

project 应用部署目录

├─app		            应用目录
│  │ 
│  ├─模块1              项目模块1（例 Home）
│  │  ├─common      	配置目录
│  │  ├─controller      控制器目录
│  │  └─views     	视图
│  │  
│  ├─模块2              项目模块2（例 Admin）
│  │  ├─common      	配置目录
│  │  ├─controller      控制器目录
│  │  └─views     	视图
│  │  
│  ├─模型1              （例Student.php）
│  │  
│  ├─模型2              （例Teacher.php）
│  │  
│  └─ ...
├─core	                框架系统目录
│
├─log	                日志及缓存目录
│
├─public                WEB 部署目录（对外访问目录）
│
├─routes                路由配置文件目录
│  └─www.php            
│
├─vendor                第三方类库目录（Composer）
│
├─.env             	env全局配置文件
│
├─.htaccess             用于 apache 的重写
│
├─composer.json         composer 定义文件
│
├─index.php             入口文件
│
└─README.md             README 文件

URL访问

http://serverName/index.php（或不写）/模块/控制器/操作/[参数名/参数值...]

出于优化的URL访问原则，还通过URL重写隐藏入口文件，下面以Apache为例说明隐藏应用入口文件index.php的.htaccess设置。

<IfModule mod_rewrite.c>

    <IfModule mod_negotiation.c>

        Options -MultiViews

    </IfModule>

    RewriteEngine On    

    # Redirect Trailing Slashes If Not A Folder...

    RewriteCond %{REQUEST_FILENAME} !-d

    RewriteRule ^(.*)/$ /$1 [L,R=301]
    
    # Handle Front Controller...

    RewriteCond %{REQUEST_FILENAME} !-d

    RewriteCond %{REQUEST_FILENAME} !-f

    RewriteRule ^ index.php [L]    

    # Handle Authorization Header

    RewriteCond %{HTTP:Authorization} .

    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

</IfModule>

命名空间

如果不清楚命名空间的基本概念，可以参考PHP手册：命名空间

模型：namespace app ; 控制器：namespace 模块名 \ controller ;

Traits

简单来讲，PHP是单继承的语言，在PHP 5.4 Traits出现之前，PHP的类无法同时从两个基类继承属性或方法，php的Traits和Go语言的组合功能类似（可以理解为横向扩展），通过在类中使用use关键字声明要组合的Trait名称，而具体某个Trait的声明使用trait关键词，Trait不能直接实例化。Thunder中的视图层则是利用Trait引入。具体用法请看下面的代码：

定义一个trait

namespace thunder;
trait View{
public function display(){
		//
	}
}

使用他

namespace Home\controller;
use \thunder\View;
class IndexController{
use View;
public function index(){
		$this->display();
	}
}

API模式数据

API数据的输出

控制器中直接使用return
namespace Home\controller;
class IndexController{
public function index(){
	$data = ['name'=>'thunder','url'=>'guolifu.pw'];
	return ['data'=>$data,'code'=>1,'message'=>'ok'];
	//返回纯数组
	return ['data'=>$data,'code'=>1,'message'=>'ok','TO_ARRAY'=>true];
	//返回jsonp
	return ['data'=>$data,'code'=>1,'message'=>'ok','TO_JSONP'=>true];
	}
}
浏览器显示：

{"data": {"name":"thunder","url":"guolifu.pw"},"code":1,"message":"ok"}

配置

配置文件位于 core\config中，包括数据库，日志存储，模板后缀，默认路由等配置，还可在分组下的common（如 Home\common\config\创建覆盖配置文件）

.env作为全局环境变量配置，目前只定义了数据库配置，具体可根据需求使用getenv()全局获取

路由

Thunder中的路由十分简介强大，请看介绍：

url中直接访问：

http://serverName/index.php（或不写）/module/controller/action/param1/value1/param2/value2/...

简洁路由注册：绵长冗余的url总是麻烦的。Thunder中支持预注册路由：
// routes\web.php

use \thunder\Route;

/*注册路由*/

Route::init('goRoute','Home/index/index');
随后
http://serverName/index.php（或不写）/goRoute
				<==>	
http://serverName/index.php（或不写）/goRoute/Home/index/index

注意！如此注册之后并不代表你可以传递参数

需传参写法

Route::init('goRoute/{param}','Home/index/index');
随后
http://serverName/index.php（或不写）/goRoute/param1/value1/param2/value2/.../...
<==>	
http://serverName/index.php（或不写）/goRoute/Home/index/index/param1/value1/param2/value2/.../...

请求

Thunder中获取类型是简介明了的

获取请求类型

http_method()函数获取请求类型

也可以使用

IS_GET（判断是否为GET请求）

IS_POST（判断是否为POST请求）

获取模块、控制器、方法

你可以在控制器中使用route()函数
class IndexController{

public function mvc(){

		$m = route()->module;
	
		$c = route()->ctrl;
	
		$v = route()->action;
	
		dump('模块：'.$m,'控制器：'.$c,'方法：'.$v);

	}

}

在浏览器中访问http://serverName/home/index/mvc

依次会打印出
"模块：Home"

"控制器：Index"

"方法：mvc"

数据库操作

一个灵活的框架必然会有一个灵活强大的数据库操作，Thunder为了满足开发者的各种开发习惯，封装了传统操作和ORM操作两种模式。

为了避免开发者重复new来new去，系统提供了一个强大的函数table('表名')，你可以把他想象成为一个你即将操作的数据库对象。下面简单了解一下

单条查询：

class IndexController{

	public function sql(){

		table('student')->find();		//默认查找 student 表第一条数据

		table('student')->find(2);		//返回ID为2的行的


		table('student')->find(2,'name');	//返回ID为2的学生的name值(返回字符串)


		table('student')->find(2,'id,name');	//返回ID为2的学生的id和name(返回的是数组)

		<==>

		table('student')->find(2,['id','name']);//为了清晰，可以使用数组形式(推荐)

	}

}

多条查询：

class IndexController{

	public function sql(){
	
		table('student')->all();//返回student表中全部数据
	
	}

}

基本条件查询：

你可以在查询中使用where()
class IndexController{

	public function sql(){

		table('student')->where(['name'=>'thunder'])->find();	

		table('student')->where(['id'=>1])->all();    //WHERE id  = 1		

		table('student')->where(['id[>]'=>1])->all(); //WHERE id > 1		

		table('student')->where(['id[!]'=>1])->all(); //WHERE id != 1		

		table('student')->where(['id[>=]'=>1])->all();//WHERE id >= 1

		table('student')->where(['id[<=]'=>1])->all();//WHERE id <= 1

		table('student')->where(['id[<>]'=>[1,10]])->all();//WHERE id BETWEEN 1 AND 10

		table('student')->where(['id[><]'=>[1,10]])->all();//WHERE id NOT BETWEEN 1 AND 10

		table('student')->where('city[~]'=>'lon')->all();//WHERE "city" LIKE '%lon%'

		table('student')->where('city[!~]'=>'lon')->all();//WHERE "city" NOT LIKE '%lon%'

		table('student')->where('city[~]'=>['lon','foo','bar'])->all();//WHERE "city" LIKE '%lon%' OR "city" LIKE '%foo%' OR "city" LIKE '%bar%'

		table('student')->where(["OR" => [

				"student_id" => [2, 123, 234, 54],

				"email" => ["[email protected]", "[email protected]", "[email protected]"]

			]])->all();

			

			// WHERE

			// student_id IN (2,123,234,54) OR

			// email IN ('[email protected]','[email protected]','[email protected]')		

					

		// 多条件查询

		table('student')->where(["OR" => [

			"AND" => [

				"user_name[!]" => "foo",

				"student_id[!]" => 1024,

				"email[!]" => ["[email protected]", "[email protected]", "[email protected]"],

				"city[!]" => null,

				"promoted[!]" => true

			]

		]])->all();

		// WHERE

		// `user_name` != 'foo' AND

		// `student_id` != 1024 AND

		// `email` NOT IN ('[email protected]','[email protected]','[email protected]') AND

		// `city` IS NOT NULL

		// `promoted` != 1	

	}

}

复合查询：你可以使用"AND" 或 "OR" 来拼接非常复杂的SQL语句

class IndexController{

	public function sql(){

		table('student')->where(["OR" => [

			"AND" => [     //实际应用时这儿可以使用AND或者OR

				"OR" => [  //第一个条件

					"user_name" => "foo",

					"email" => "[email protected]"

				],

				"OR" => [ //第二个条件

					"user_name" => "bar",

					"email" => "[email protected]"

				]

			]

		]])->all();

			

		// WHERE (

		//  (

		//      "user_name" = 'foo' OR "email" = '[email protected]'

		//  )

		//  AND

		//  (

		//      "user_name" = 'bar' OR "email" = '[email protected]'

		//  )

		// )

	}

}

关联查询：

[>] == LEFT JOIN [<] == RIGH JOIN [<>] == FULL JOIN [><] == INNER JOIN class IndexController{

	public function sql(){
	
		table('student')->join(["[>]class"=>['s_id'=>'class_id']])->all();		
		// LEFT JOIN `class` ON `student`.`class_id` =`s_id`
	
	}

}

连贯操作：

//之前的条件查询where()就是连贯操作的一种，剩下的请看例子，非常容易理解。

class IndexController{

public function sql(){

	//field()筛选字段 参数可以如下写，也可以写做数组形式

	table('student')->field('name(别名),num')->all();

	table('student')->field(['name','num(别名)'])->all();

	

	//order()排序 参数可写多个，靠前权重高

	table('student')->order(['字段名'=>'排序（如ASC，DESC需大写）'])->all();

	

	//limit()条数限制

	table('student')->limit(l)->all();//表示从返回结果集中取l条数据;

	table('student')->limit([n,m])->all();//表示从返回结果集中的第n+1条开始，取m条数据;

	

	//以上方法均可连贯操作

	table('student')->join(["[>]class"=>['s_id'=>'class_id']])->where(['class[>]'=>1])->limit([5,10])->order(['id'=>'DESC'])->field('name')->all();

    }

}

新增数据：

public function sql(){

	$data = ['name'=>'xiaoming','age'=>18];

	table('student')->add($data);

	

	//也可以批量新增

	$data = [

		['name'=>'xiaoming','age'=>18],

		['name'=>'zhangsan','age'=>17],

		['name'=>'liergou','age'=>16]

	];

	table('student')->add($data);

}

修改数据：

public function sql(){

	$data = ['name'=>'xiaoming','email'=>'[email protected]'];

	//使用update()时可以连贯使用where()作为条件。

	table('student')->where(['student_id'=>3])->update($data);

	//根据id修改数据时系统提供简介方法

	table('student')->setOne(1,$data);

}

删除数据：

public function sql(){

	table('student')->destroy(1);	//根据id删除数据

	table('student')->flushall();	//清空数据表（慎重使用）

}

统计数据：

public function sql(){

	table('student')->count();	//统计条数

	table('student')->max();	//统计字段最大

	table('student')->min();	//统计字段最小

	table('student')->avg();	//统计字段平均值

	table('student')->sum();	//统计字段求和

}

原生查询：

public function sql(){

	table()->query("SELECT * FROM student")->fetchAll();

}

事物操作：

//不是每个数据库引擎都支持事务。你必须在使用前检查。如果返回false，则回滚事务。

public function sql(){

	$database = table('student');

	$database->action(function ($database){

		$database->add(['name'=>'事物']);

		$res = $database->setOne(1,['name'=>'action']);

		return $res->rowCount()==0? false:true;

		return false;

	});

}

//如果修改没有成功，返回false，则回滚事务。不会修改成功也不会添加成功。

模型

这里的ORM模型就不详细说明了，系统提供了model('表名')函数以供调用ORM模型。具体请移步到https://docs.golaravel.com/docs/4.1/eloquent/

视图

Thunder封装了强大的模板引擎供开发者使用。在控制器中use \thunder\View;并且在类中use View;你就可以尽情的使用强大的引擎来协助你的工作

模板赋值：

class IndexController{

public function index(){

	// 模板变量赋值
	
	$this->assign('name','Thunder');
	
	$this->assign('email','[email protected]');
	
	// 或者批量赋值
	
	$this->assign([
	
	'name'  => 'Thunder',
	
	'email' => '[email protected]'
	
	]);
	
	// 模板输出
	
	$this->display();
	
	$this->display('index1');	  //同级目录下
	
	$this->display('index/url');	  //跨控制器输出	
	
	$this->display('api/index/views');//跨模块输出



	}

}

输出替换：

在tpl配置文件中自定义规则

return array(

	'TMPL_PARSE_STRING'     =>array(         //自定义模板变量
	
		'__PUBLIC__'        => __PUBLIC__,
	
		'__ADMIN__'        => __PUBLIC__.'/'.'Admin',
	
	)

);

//在html中使用{{__PUBLIC__}}调用

资源加载：

{{asset.css('路径')}}	//规则：server/public/模块/css/路径;
{{asset.js('路径')}}	//规则：server/public/模块/js/路径;
{{asset.asset('路径')}}	//规则：server/public/模块/路径;

该方法支持第二个参数

{{asset.css('路径',true)}} //规则：server/public/Public/css/路径;代表模块公共目录路径

变量输出：

html中使用{{变量名}}

{{name}}

在页面中显示

Thunder

更多模板操作请参考twig手册

其他

Thunder的一些其他操作

session的使用：
class IndexController{

	public function index(){
	
		session()->set('name','val');
		
		session()->get('name');
		
		session()->del('name');
		
		session()->clear();
	
	}
	
}

cookie的使用：

use \thunder\Cookie;

class IndexController{

	public function index(){
	
		cookie::set('name','val');
		
		cookie::get('name');
		
		cookie::del('name');
	
	}

}

验证码：

public function create_verify(){

	$v = verify();

	$v->length = 4;	//设置长度

	$v->useNoise = false;//是否添加杂点

	$v->useCurve = false;//是否画混淆曲线

	$v->create();//生成验证码

}
验证
public function verify(){

	$code = input('post.code');
	
	$v = verify();
	
	if($v->check($code))
	
	header('Location:./index?login=1');
	
	$this->display();

}

文件上传：

public function upload(){

	if(IS_POST){
	
		$up = new \thunder\Upload();
		
		//设置属性(上传的位置， 大小， 类型， 名是是否要随机生成)
		
		$up -> set("path",__UPLOAD__.'/images');
		
		$up -> set("maxsize", 2000000);
		
		$up -> set("allowtype", array("gif", "png", "jpg","jpeg",'xls'));
		
		$up -> set("israndname", false);
	
		if($up -> upload("photo")) {
		
		//获取上传后文件名子
		
		var_dump($up->getFileName());
		
		}else {
		
			//获取上传失败以后的错误提示
			
			var_dump($up->getErrorMsg());
		
		}
	
	}

	$this->display();

}

Created by leileida. v2.0.0
1.修正了路由规则
2.增加了多模块机制
3.控制器方法重构
4.api开发模式，控制器return数组自动转换为json格式等。

5.模型层重构，模型层分离为独立层：
demo:

namespace app;
use \thunder\Model;
class Student extends Model{
　public function test(){
　　　return 'test!';
　}

6.视图机制优化，支持跨控制器，跨模块输出页面

demo:

namespace home\controller;
use \thunder\View;
class StudentController{
　use View;
　public function index(){
　　　$this->display();
　　　$this->display('index1');
　　　$this->display('index/url');
　　　$this->display('api/index/views');
　}
}

  1. fixed the routing rule
  2. increased the multi module mechanism
  3. controller method refactoring
  4. join the API development model, the controller return array automatically converted to JSON format.
5. model layer is reconstructed, and model layer is separated into independent layer:
demo:

namespace app;
use \thunder\Model;
class Student extends Model{
　public function test(){
　　　return 'test!';
　}
}

6. view mechanism optimization, support cross controller, cross module output page

namespace home\controller;
use \thunder\View;
class StudentController{
　use View;
　public function index(){
　　　$this->display();
　　　$this->display('index1');
　　　$this->display('index/url');
　　　$this->display('api/index/views');
　}
}