xuby0615/scra

作者 xuby0615

版本信息 Version 2.2.0

框架名称 Scra

---------------更新日志v2.2.0 20160906---------------

1、修正Linux下文件读写错误问题

---------------更新日志v2.1.0 20160702---------------

1、更新数据库类，新添加模糊查询和条件查询

2、增加全局公用函数

一、环境信息

PHP最低版本 5.4
Apache版本 2.4
MySQL版本 5.6

二、入口文件

index.php

在入口文件中：

可以自定义修改应用目录名：application/，不建议修改系统目录system/
入口文件中，加载配置文件和路由文件
我们建议您，在入口文件中，无需做修改

三、路由信息

url访问方式：http://www.example.com/controller/foo?param1=val1&param2=val2

框架初始化：http://www.example.com

四、配置文件

1.系统配置文件：application/config/config.php

我们为您提供了：

1.Javascript：jQuery、AngularJs，以及用户自定义的Js文件

2.CSS：Bootstrap模板，Font Awesome WEB字体库

3.Image：Image文件

您只需要查看配置文件，即可调用。在配置文件中，您几乎可以修改配置文件中的所有内容。同时，您还可以修改系统默认的控制器及方法：

默认控制器：Index.php

默认方法：home()

2.数据库配置文件：application/config/database.php

详细配置信息请参看该文件

3、smarty配置文件：application/config/smarty.php

Scra采用Smarty模板引擎，详细配置信息请参看该文件

五、缓存文件

位于application/cache下，用于存储smarty引擎产生的缓存文件

六、控制器文件

位于application/controller文件夹，控制器类必须扩展自SC_Controller类，foo命名规则：param_paramA_paramB，不包含数字

您可以在Example控制器中，定义foo方法：

class Example extends SC_Controller{
	function __construct{
		parent::__construct();
	}
	
	public function foo(){
		echo 'Hello World';
	}
}

然后，您可以在地址栏中访问：http://www.example.com/example/foo，就可以在页面中显示“Hello World”

七、模型读取

模型文件位于application/model，模型类必须扩展自SC_Model类

DI::set('model',Factory::model($modelname)); //注册使用模型
$model = DI::get('model');					 //获取已注册模型

数据库操作，请见数据库类。

八、模型类

在数据模型中：

class UserModel extends SC_Model{
	protected $_conn;							//设置链接
	private static $_table = 'tablename';		//设置当前数据表
	
	function __construct(){
		parent::__construct();					
		$this->_conn = $this->conn();			//获取数据库链接信息
	}
}

1、获取数据库链接：

$this->_conn = $this->conn();

2、获取当前表所有数据：

$this->_conn->getAll(self::$_table);

3、获取带有查询条件的数据：

$this->_conn->select($table , $param , $where , $mode)，
	
$table：数据表名，字符串
$param：查询字段，数组，array(字段一,字段二,字段三)，如果不传值，默认为*
$where：查询条件，数组，array(array(字段一，数值，比较符),array(字段一，数值，比较符))，如果不传值，默认为空；其中，比较符为">","<","=","<=",">=","!="
$mode：返回模式，0代表返回关联数组，1代表返回数字数组，2代表返回结果集

4、获取模糊查询的数据：

$this->_conn->getFuzzy($table , $param , $where , $mode = 0)

$table：数据表名，字符串
$param：查询字段，数组，array(字段一,字段二,字段三)，如果不传值，默认为*
$where：查询条件，数组，array(模糊范围，数值，字段),
		其中，模糊范围可选参数为：
			left：左模糊，对应sql中：'%value'
			right：右模糊，对应sql中：'value%'
			all：全模糊，对应sql中：'%value%'
$mode：返回模式，0代表返回关联数组，1代表返回数字数组，2代表返回结果集

5、更新数据表：

$this->_conn->update($value,$conditoin,$table)

$table：数据表名，字符串
$value：更新值，数组，array(字段一=>值一,字段二=>值二)
$condition：条件，数组，array(字段一=>值一,字段二=>值二)

成功返回true，失败返回false

6、删除数据

$this->_conn->delete($value,$table)

$table：数据表名，字符串
$value：条件，数组，array(字段一=>值一,字段二=>值二)

成功返回true，失败返回false

九、模板加载

位于application/view文件，Scra使用Smarty进行模板加载，使用方式参见smarty使用方式

十、第三方类

在V2.2.0中，暂时提供一下四种常见类

1、邮件类

在控制器中，您可以直接使用$this->mail()，来实例化邮件类。

    $this->mail()->IsSMTP(); 								//选择SMTP服务
    $this->mail()->CharSet='UTF-8'; 						//设置邮件的字符编码，这很重要，不然中文乱码 
    $this->mail()->SMTPAuth = true; 						//开启认证 
    $this->mail()->Port = 25; 								//服务端口，smtp服务一般为25
    $this->mail()->Host = "smtp.163.com"; 					//smtp服务器名，以163为例
    $this->mail()->Username = "Domain@Url.com"; 			//发件人邮箱用户名
    $this->mail()->Password = "Password";	 				//发件人邮箱密码
    $this->mail()->AddReplyTo("Domain@Url.com","Name");		//回复地址 
    $this->mail()->From = "Domain@Url.com"; 				//来自于
    $this->mail()->FromName = "Admin"; 						//显示名称
    $to = "Domain1@Url1.com"; 								//收件人地址
    $this->mail()->AddAddress($to); 						//设置收件人地址
    $this->mail()->Subject = "邮件发送测试"; 					//发送标题
    $this->mail()->Body = "如收到本邮件，则表示发送成功"; 			//邮件具体内容
    $this->mail()->AltBody = "To view the message, please use an HTML compatible email viewer!"; //当邮件不支持html时备用显示，可以省略 
    $this->mail()->WordWrap = 80; 							//设置每行字符串的长度 
    $this->mail()->AddAttachment("f:/test.png"); 			//可以添加附件 
    $this->mail()->IsHTML(true); 							//经由html
    $this->mail()->Send(); 									//发送邮件

异常处理:

phpmailerException $e

2、分页类

注册服务：$pagination = DI::set('pagination',Factory::pagination($page_size))
分页总数：$pagination->total($total)
偏移量：$pagination->offset($total,$page)

$page_size:每页数
$total:总数
$page:当前页数

3、验证码类

使用Scra的验证码类，需开启GD2扩展

在控制器中，您可以使用scra提供的验证码类

配置信息，四项配置信息是必填的：

$config = array(
		'codelen' => 4,		//生成验证码位数
		'width'	  => 100,	//验证码图片长度
		'height'  => 50,	//验证码图片宽度
		'fontsize'=> 20		//验证码文字大小
	);

注册验证码类：

DI::set('captcha',Factory::captcha($config));

实例化并成生成验证码：

$captcha = DI::get('captcha');
$captcha->doimg();   //生成验证码
$captcha->getCode()；//获取生成验证码的路径和对应验证码

4、文件上传类

Scra在文件上传中使用了AjaxFileUpload.js文件，支持多文件上传

在头文件中引用<script src="<?=UPLOAD_JS?>" type="text/javascript" ></script>此JS文件即可

控制器中写入配置文件：

$config = array(
	'up_path' => UPLOAD_PATH,	//上传路径，系统自带
	'up_size' => 10,			//单位：MB，上传文件大小单位为B
	'up_type' => 'jpg|bmp|exe',	//上传文件格式，以|分割
	'up_code' => 'GBK'			//文件名编码，防止中文文件名乱码
);

注册服务：

DI::set('upload',Factory::Upload($config));

获取服务：

$upload = DI::get('upload');

文件上传：

$result = $upload->doUpload($_FILES);

返回值包含字段：

code：不为0代表上传失败，调用$upload->errorLog($result)方法，即可查看对应错误信息
name：文件名
path：上传成功时，返回文件存放路径

xuby0615 / scra