CSpeed v1.1.8 框架发布新版本啦，新增模型，DI注入容器等

时间  2019-11-30
标签 cspeed v1.1.8 框架 发布 新版本 新增 模型 注入 容器 繁體版
原文   原文链接

CSpeed micro framework

GitHub

Github:

    https://github.com/liqiongfan/cspeed复制代码

开发环境

Linux kernel 4.4.x、PHP7.1.八、Nginx1.12.1

扩展只支持PHP7.x以上版本，低于PHP7.x如下的版本请先升级PHP版本

在WEB应用模式下，扩展经过解析 PATH_INFO 参数信息进行路由转发，请先确保 WEB服务器支持 PATH_INFO 模式，而且须要隐藏index.php
不然系统不生效,没法完成路由解析。

推荐的Nginx配置：

location / {
    try_files $uri $uri/ /index.php$uri$args;
}

location ~ \.php {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_split_path_info ^(.+\.php)(.*)$;     
    fastcgi_param  PATH_INFO $fastcgi_path_info;    
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}复制代码

CSpeed安装

下载源码后，进入cspeed目录，按照如下三个步骤进行便可：php

一、/usr/path_to_php/bin/phpize

二、./congure --with-php-config=/usr/path_to_php/bin/php-config

三、make -j8 install

四、重启服务器Apache或者Nginx的PHP-FPM复制代码

通过以上步骤后，能够经过在phpinfo()中查看cspeed扩展或者使用以下函数检测：
if (extension_loaded('cspeed')) {
// 扩展成功安装，赶快尝试吧。
}html

简单的 WEB 示例

WEB 目录设置为以下：mysql

+public
|--index.php          入口文件
+controllers
|--Index.php          Index默认控制器
+admin                新增admin模块
|--controllers         admin模块下的控制器目录
     |--Index.php     admin模块的Index控制器
+fronted               fronted模块
|--controllers         fronted模块控制器目录
    |--Index.php      fronted模块Index控制器复制代码

public 目录下 index.php 内容以下：git

$app = new \Cs\App();

$app->run();
/* 超简单的框架已经完成，只须要上面两行代码就可完成一个MVC框架 */

/* 注意App类构造函数可选参数Di类对象，如： */
$di = new \Cs\di\Di();

$di->set('view', function(){
    $view = new \Cs\mvc\View();
    $view->setModuleDir('index');
    return $view;
});
/*那么能够将此对象传入App构造函数中*/
$app = new \Cs\App($di);

/* 当进行了上面的步骤后，在控制器中可使用$this-get('view')来获取设置的对象，
以达到对象复用的目的, 注意控制器必须继承自 \Cs\mvc\Controller 才能
使用 $this->get('xx') 语法 */复制代码

在 public 同级的controllers目录下建立一个 Index.php 文件,内容以下：github

Index.php:

class Index {
    function indexAction(){
    // 当须要渲染视图的时候，请使用 $this->view 得到 View 引擎而后使用引擎具备的方法进行视图渲染 
    echo '<h1>Hello CSpeed</h1>';
    }
}复制代码

配置好 Nginx 路由，打开浏览器，输入配置好的网站地址就会看到刚刚输入的内容：web

http://path_to_cspeed复制代码

WEB应用路由规则：sql

假设配置的Nginx如上，配置网站 www.supjos.cn 指向：public目录下的index.php文件

那么，路由规则以下三种状况所示：

1)、www.supjos.cn
    不带PATH_INFO的路由指向与public目录同级的controllers下的Index.php控制器的indexAction方法
2)、www.supjos.cn/backend/goods/lists
    路由到backend模块的goods控制器下的listsAction方法
3)、www.supjos.cn/sys/info
    路由到与public同级的controllers目录下Sys.php下的infoAction方法复制代码

注意

控制器文件首字母必须大写

以下路由所示：
    www.supjos.cn/web/index/lists
    模　块: web        一个模块对应一个目录，此处对应web目录
    控制器: index        控制器文件命名为 Index.php
    方　法: listsAction      CSpeed系统方法名都以Action结尾复制代码

简单的 API 应用

public 目录下的 index.php 内容以下：json

index.php

/* 当实例化一个 \Cs\App 类后，系统自动进行 autoload， autoload的机制参见下面介绍 */
$app = new \Cs\App();    

/**
 * 方法的第一个参数支持正则匹配，第二个参数是一个Closure闭包函数
 * 第一个参数支持使用替代符 ： {name} 与 {id}, 其中 {name} 表示匹配字母数字横线而且首字母不是数字的字符串， {id}表示匹配任何数字，注意当使用了替代符的时候，匿名函数包含有一个参数 $match 来一一对应与匹配的替代符，如：
 * $app->get('/index/cspeed-v1/18$', function($match){
 * 
 * });
 * 那么 $match[1] 则表示 cspeed-v1 $match[2]表示为18，依次类推
 */
$app->get('/index$', function(){
    echo '<h1>Hello CSpeed</h1>';
});

/* CSpeeed支持常见的请求方法，除了上面的 GET 外，还支持 POST、PUT、DELETE、OPTIONS、HEAD，具体见 API 文档 */
$app->post('/goods/index/2$', function(){
    /* Your code here. */
});复制代码

CSpeed自动加载机制

当实例化一个 \Cs\App 类后，系统自动进行未引用文件的加载, 加载机制采用 “别名引用”机制，具体的原理以下：

系统自动内置一个 app 命名别名，指向 index.php 的上级目录，以下目录所示：

+--cspeed                          网站目录
   +--public
       |--index.php                入口文件
   +--controllers                  默认控制器加载目录
       |--Index.php
       |--Goods.php
   +--backend                    新增模块backend
       |--controllers              backend模块的控制器目录
       |--Index.php            
       |--Goods.php                            


若是目录结构如上所示：

那么 默认的 `app` 别名指向 cspeed 目录。
开发者能够经过 $app->setAlias()来设置别名，具体的设置方法以下：

假设须要设置一个 backend 的别名 指向目录 /data/supjos/backend ，那么调用方法以下：
    $app->setAlias('@backend', '/data/supjos/backend');

用户能够本身建立一个以下的文件：

<?php

namespace app\controllers;

class Index {
    function getVersion()
    {
    return 'v2.1.8';
    }
}

那么当你在CSpeed框架中须要使用 \app\controllers\Index类的时候，可使用以下两种方法使用：

方法1：
    use app\controllers\Index;

    $index = new Index();

方法2：
    $index = new \app\controllers\Index();

以上两种方法均可以使得CSpeed框架自动加载您刚刚编写的Index.php文件。复制代码

CSpeed 框架的视图引擎

$view = new \Cs\mvc\View();

/* 方法包含两个参数，
 * 第一个参数为：须要渲染的视图的文件名
 * 第二个参数为：须要在视图中使用的变量，传入一个数组或者不传入
 */
$view->render('index', ['name'=>'CSpeed', 'version'=>'v2.1.8']);

/* 若是须要添加单个变量到视图模块中，可使用 setVar 方法 */
$view->setVar('addVar', ['a', 'b' ,'c', 'd']);

/* 若是须要或者视图的渲染效果可是并不输入输出至浏览器可使用 getRender 方法，参数与 render 方法一致 */
$viewResult = $view->getRender('index', ['name'=>'CSpeed', 'version'=>'v2.1.8']);

/* 默认的渲染视图后缀为 phtml，能够经过 setSuffix 方法进行更改 */
$view->setSuffix('ppht');

/* 默认视图文件夹保存在 public 目录同级的 views 目录下, 能够经过 setViewDir 进行更改, 目录不能以 "/" 结尾 */
$view->setViewDir('../views');

/*视图内渲染*/
$view->partial('layouts/head', ['a', 'b', 'c']);复制代码

模型

CSpeed框架仅提供一个简单的MySql类以及一个ModelInterface接口供用户本身实现模型或者加强现有的模型：

$mysql = new \Cs\db\pdo\MySql([
    'dsn'          =>    'mysql:host=localhost;dbname=cspeed',
    'username' =>     'root',
    'password'  =>    '3333'
]);

/* 查询一条记录 */
$mysql->select(['id', 'price', 'name'])->from('www_product')
      ->where(['id' => 88])->find();

/* 查询知足条件的全部记录 */
    $mysql->select(['id', 'price', 'name'])->from('www_product')->findAll();

    /* 执行原生SQL查询 */
    $mysql->query(" SELECT * FROM www_product ");
    $results = $mysql->execute(); 

    /* 执行预处理 */
    $mysql->query(' INSERT INTO www_product (id, price, name) VALUES (:id, :price, :name) ', [':id' => 33, ':price'=>3.33, ":name"=>"Apple"]);
    $mysql->exeucte();
    /* 获取刚刚插入的数据ID */
    $id = $mysql->lastInsertId();复制代码

测试结果

测试机器：    
    一、SSD 240GB
    二、Intel Core i7-4790k
    三、16GB 1866GHZ内存 
    四、Linux Debian 8.x kernel 4.4.x
    五、PHP 7.1.8
    六、Nginx 1.12.1

siege 3.0.8

    测试命令: siege -c100 -t5m -b http://localhost/web

    共完成一百九十多万请求，每次请求4.4kb数据，零错误,CPU占用23%左右内存占用极低。复制代码

API 索引

Cs\App 类

/* 构造函数 */
public function __construct($di);
参数：
    $di:    
        Cs\di\Di类的对象

/* 框架的自动加载函数 */
public function autoload();

/* 匹配GET请求 */
public function get($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数

/* 匹配POST请求 */
public function post($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数

/* 匹配PUT请求 */
public function put($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数


/* 匹配PATCH请求 */
public function patch($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数


/* 匹配DELETE请求 */
public function delete($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数

/* 匹配 HEAD 请求 */
public function head($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数

/* 匹配 OPTIONS 请求 */
public function options($url, $closure);
参数：
    $url:    
        可选正则URL匹配表达式，替代符{name}:字符数字横线，且首字母不是数字
    $closure:
        闭包函数，当URL匹配成功后执行的函数

/* 设置别名，系统凭借别名导入文件 */
public function setAlias($aliasKey, $aliasFullPath);
    参数:
        $aliasKey:
            别名名称
        $aliasFullPath:
            别名指向的绝对路径

/* CSpeed 框架执行URL分析 */
public function run();复制代码

Cs\db\ModelInterface 接口

/* SQL SELECT 字段 */
public function select( array $fields);
    参数:
        $fields:
            数组类型，SELECT查询的字段内容如：['id', 'price', 'name']

/* FROM */
public function from($from);
    参数：
        $from:
            SELECT查询的表名，字符串类型

/* WHERE */
public function where(array $where);
    参数：
        $where:
            数组类型，WHERE条件，如：['id'=>22, 'name'=>'cspeed']

/* GROUP BY */
public function groupBy($groupBy);
    参数：
        $groupBy:
            数组类型，GROUP BY条件， 如：[ 'name', 'price' ]

/* HAVING */
public function having($having);
    参数：
        $having:
            数组类型，HAVING条件，如：[ 'id' => 22 ]

/* ORDER BY */
public function orderBy($orderBy);
    参数：
        $orderBy:
            数组类型, ORDER BY条件，如：[ 'price DESC', 'create_time DESC' ]

/* LIMIT */
public function limit($num, $offset);
    参数：
        $num : 
            查询的数量，如：20
        $offset:
            查询偏移量，如：2

/* 执行原生的SQL语句，支持预处理绑定变量 */
public function query($rawSql, $bindParms);
    参数：
        $rawSql:
            字符串类型，执行的SQL语句，如：
                SELECT * FROM www_product
        $bindParams:
            数组类型，绑定变量，若是SQL中使用了绑定变量的，那么此参数对应，如：query('INSERT INTO www_product (name, price) VALUES(:name, :price)', [ ':name' => 'Apple', ':price' => '8.8' ]);

/* 执行原生查询的结果 */
public function execute();复制代码

Cs\db\pdo\MySql 类

继承自 : Cs\db\ModelInterface

自增的方法以下，其他方法同ModelInterface类

/* WHERE */
public function andWhere($andWhere);
    参数：
        $andWhere:
            数组类型， 同where方法，能够屡次调用本方法，来组合多个WHERE条件

/* 启用事务 */
public function begin();

/* 回退事务 */
public function rollback();

/* 提交事务 */
public function commit();

/* 最新的一条记录的ID */
public function lastInsertId();

/* 受影响的记录数 */
public function rowCount();

/* 查询一条知足条件的SQL，并返回结果 */
public function find();

/* 查询知足条件的SQL，返回结果集 */
public function findAll();复制代码

Cs\di\Di 类

/* 执行构造函数 */
public function __construct();

/* 容器注入 */
public function set($key, $closure);
    参数：
        $key:
            容器对象的字符串索引，如：'view'
        $closure:
            闭包函数，返回一个相应的对象实例，如：
    $di = new Cs\di\Di();
    $di->set('view', function(){
        return new \Cs\mvc\View();
    })

/* 容器的对象取出 */
public function get($key);
    参数：
        $key:
            字符串类型，须要从容器中取出的对象的字符串索引,如：
    $di = new Cs\di\Di();
    $view = $di->get('view');复制代码

Cs\mvc\Controller

继承自 Cs\di\Di 类

CSpeed框架的默认控制器， 用户控制器通常须要继承自本控制器复制代码

Cs\mvc\View 类

CSpeed框架的默认视图引擎

/* 构造函数 */
public function __construct();

/* 渲染视图模板 */
public function render($template, $variables);
    参数：
        $template:
            待渲染的视图模板名称，不须要带后缀，默认的文件后缀为 phtml
        $variables:
            数组类型，模板中须要使用的变量

/* 设置模板的后缀 */
public function setSuffix($suffixName);
    参数：
        $suffixName:    模板的后缀名称，默认为 phtml，如需替换为html，则：
    setSuffix('html')， 便可。

/* 设置模板中须要使用的变量，能够屡次调用 */
public function setVar($varName, $varValue);
    参数：
        $varName:    变量名称
        $varValue:        变量内容

/* 获取模板的渲染结果，并返回不进行输出操做 */
public function getRender($template, $variables);
    参数：同render，这里不在重复讲解

/* 设置视图目录路径名 */
public function setViewDir($dirPath);
    参数：
        $dirPath:
            设置视图的路径目录名，默认为 ../views，表示上一级目录的views文件夹内，如需更改成 上一级目录的 view 目录下，则以下调用：
    setViewDir('../view');

/* 设置模板的模板名路径 */
public function setModuleDir($moduleName);
    参数：
        $moduleName:    默认为 "." 表示当前目录，除非有须要请勿更改。

/* 渲染视图 */
public function partial($template, $variables);
    参数：
        $template: 模板路径名称，相对于当前的模块而言
        $variables: 在模板中使用的变量集合，数组类型复制代码

Cs\net\Request 类

/* 获取 host 信息 */
public function getHttpHost();

/* 获取 User Agent 信息 */
public function getHttpUserAgent();

/* 获取 Server Name 信息 */
public function getServerName();

/* 获取 Server Addr 信息 */
public function getServerAddr();

/* 获取 Remote Port 信息 */
public function getRemotePort();

/* 获取 Remote Addr 信息 */
public function getRemoteAddr();

/* 获取 Request Scheme 信息 */
public function getReqeustScheme();

/* 获取 Server Protocol 信息 */
public function getServerProtocol();

/* 获取 Document Root 信息 */
public function getDocumentRoot();

/* 获取 Request Uri 信息 */
public function getRequestUri();

/* 获取 Script Name 信息 */
public function getScriptName();

/* 获取 PATH-INFO 信息 */
public function getPathInfo();

/* 获取Query String 信息 */
public function getQueryString();

/* 是否GET请求 */
public function isGet();

/* 是否 PUT 请求 */
public function isPut();

/* 是否PATCH请求 */
public function isPatch();

/* 是否DELETE请求 */
public function isDelete();

/* 是否HEAD请求 */
public function isHead();

/* 是否OPTIONS请求 */
public function isOptions();

/* 获取 $_GET 参数 */
public function get();

/* 获取 $_POST 参数 */
public function getPost();复制代码

Cs\net\Response 类

/* 构造函数 */
public function __construct();

/* 设置RESPONSE HEADER */
public function setHeader($headerName, $headerValue);
    参数：
        $headerName:    HTTP header 信息
        $headerValue:    HTTP header值，如：
    setHeader('Content-Type', 'application/json;charset=UTF8');

/* 取消设置的HTTP header */
public function unsetHeader($heaerName);
    参数：
        $headerName : 经过setHeader设置的 $headerName 值

/* 发送HTTP内容与http header */
public function send();

/* 设置响应内容为JSON */
public function setJsonContent($content);
    参数：
        $content:    须要响应的JSON内容， 如：
    setJsonContent(['status' => 'OK', 'data' => ['a', 'b', 'c'], 'code' => '200']);

/* 设置原始响应内容 */
public function setRawContent($content);
    参数：
        $content:    须要响应的内容， 如：
    setRawContent('<h1>Hello CSpeed</h1>');复制代码
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程