PHP-ES

框架简介

PHP-ES 是一款极简、灵活、高性能、扩建性强、上手快php 框架; 以“快速开发、轻松上手、高速执行”为理念，助你成为web开发的能手！

开发缘由

与其说开发此框架，更准确说法应该是一次代码的整理，本人在接触将近10年的php开发过程中，陆续也接触了一些优秀的框架。不仅仅php 有asp.net mvc、php laravel、php yii、python web.py、python django、golang beego 等等框架各自有各自的优势，但是使用场景和性能方面各有所长，在2015年给公司同事分享mvc核心**的时候，我在想既然用了这些框架那是不是自己整理出一些核心的、或者说是开发过程中最需要的部分，来写自己的这么一个极简型框架，如此便有了 ES。

框架结构

整个框架核心五个文件，所有文件加起来放在一起总行数不超过400 行，总大小 18k。

|--src //受保护代码文件夹
  |--core
    |--es.php //启动文件
    |- helper.php //实现流程的核心方法类
    |--controller.php //控制器文件
    |--model.php //模型文件
    |--view.php //视图引擎
  |--controller //控制器业务文件
  |--view //视图文件
  |--model //模型一般小型业务可以省略，数据操作直接放到controller 
  |--config.php //全局配置文件，业务相关的配置也可以放这里，或者自己建立一个独立的配置文件index.php 文件引用
|--res //静态资源
|--logs // 日志记录路径 可以省如果有请保证有写入权限
|--index.php //入口文件

安装

下载

git clone https://github.com/Echosong/es（web建立到当前文件夹）

各种web 服务器配置重定向

.hitaccess(Apache):

RewriteEngine On
RewriteBase /

# Allow any files or directories that exist to be displayed directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^(.*)$ index.php/$1 [QSA,L]

.htaccess(Nginx):

rewrite ^/(.*)/$ /$1 redirect;

if (!-e $request_filename){
    rewrite ^(.*)$ /index.php break;
}

配置域名访问比如： http://es.dev/ (hosts 修改)

(ES 和 Laravel 性能比较 http://esassets.oss-cn-shanghai.aliyuncs.com/x.png )

具体实现功能

配置文件

配置路由规则

ES 没有像些重型框架单独有 Route 配置， ES的想法很简单，主要分为模块[m]，控制器[c]，动作[a] 来路由

 'rewrite' => array(
        //设置模块 碰到 http://{host}/admin/ 认为进入了后台模块 数组 0 标识默认 m
       'm'=>['web','admin','app','api'], 
       'c'=>'main', //controller 默认值
       'a'=>'index', //action 默认值,
       'isRewrite'=> TRUE //是否开启伪静态 .htaccess 文件配置
    ),

其中 m 为模块，一般我们开发小型web系统时候，后台（admin）、前端（web）、接口(api) 来划分结构；大型一点的web系统，常根据业务进行模块划分，比如 shop、order、user 等等模块划分。实际划分就对应着 controller view 里面的文件夹的安排，一般的一个模块对应其下面的一个文件夹，这样清晰的管理模块方便协作开发和解耦

另外配置中 m=>[api..] 数组就是划分的模块，对应地址栏会去选择 www.baidu.com/admin/con/index 域名部分后面的第一个 /admin/ 如果在配置中就表示为识别到的模块，否者将模块默认为 m[0] 实现代码可以参考 es：

$rewrite = $GLOBALS['rewrite'];
if ($rewrite['isRewrite']) {
    $route = explode("/", $_SERVER['PHP_SELF']);
    if (!empty($rule[1])) {
        if (in_array($rule[1], $rewrite['m'])) {
            $_GET['m'] = $route[1];
            list($_GET['c'], $_GET['a']) = array_slice($route, 2, 3);
        } else {
            $_GET['m'] = $rewrite['m'][0];
            list($_GET['c'], $_GET['a']) = array_slice($route, 1, 2);
        }
    }
}

数据库配置

数据库目前支持mysql

$dbb = array(
    'mysql' => [
        //主库
        'master'=>[
            'MYSQL_HOST' => '127.0.0.1',
            'MYSQL_PORT' => '3306',
            'MYSQL_USER' => 'root',
            'MYSQL_DB' => 'db_demo',
            'MYSQL_PASS' => '123456',
            'MYSQL_CHARSET' => 'utf8',
        ],
        //从库可以加入多个实例
        'slave'=>[
            'MYSQL_HOST' => '127.0.0.1',
            'MYSQL_PORT' => '3306',
            'MYSQL_USER' => 'root',
            'MYSQL_DB' => 'db_demo',
            'MYSQL_PASS' => '123456',
            'MYSQL_CHARSET' => 'utf8',
        ]
    ],
    'prefix' => 'mo_',
);

业务自定义配置

自定义的业务方面的配置，可以自己定义个配置文件，在config.php 进行引入，也可以直接在config.php 进行修改配置添加节点，后面使用全部用

$GLOBALS = require(APP_PATH . '../config.php'); $GLOBALS 全局数组配置进行获取相应的配置项。

核心实现文件（Helper.php）

 /**
 * 获取规则的url,统一获取url方便路由规则的对应
 * @param $c
 * @param $a
 * @param array $param
 * @return string
 */
public static function url($c, $a, $param = array())

 /**
 * 启动程序，实现了mvc的核心逻辑（根据 c , a 参数怎样去对应执行相应的controller）
 */
public static function start()

/**
 * 所有的输出格式统一
 * @param $message 输出对象
 * @param $code 输出错误码
 */
public static function responseJson($message, $code = 0)


/** 在操作完成一个事务的时候，引导调整到下一个事务，支出ajax的请求返回
 * @param $msg
 * @param string $url
 * @param int $code 非0 错误提示
 */
public static function redirect($msg,  $url = '',$code= 0)


 /** 打印文件日志方便显示调试
 * @param $errmsg
 * @param $level debug, info, error 基本类似log4
 */
public static function log($errMsg, $level = 'info')


/**
 * request获取信息设置默认值（特别的 $_GET['**'] 不存在的参数会notice,此函数很好解决了这个问题）
 * @param $name
 * @param $defult
 * @return mixed
 */
public static function request($name, $defult)

控制器

Controller

控制器（Get, Post , Head , Put ）+$_Get['a'] 的函数，直接暴露给了请求，请求可以通过 $_GET['a'] 直接调用，如果么没有指定相应http 动作时间，直接调用 public action+$_GET['a'] 的函数比如客户端get请求

/api/main/index
会路由到 controller/api/mainController.php 文件 下面 的 
public function getIndex(){} 函数，如果此函数不存在，会找个 
public function actionIndex(){} 函数

另外在写http 接口时候我们可以直接 Restful api 格式用http 请求自动对应比如

/api/good
会路由到 controller/api/goodController.php 文件 下面 的 
public function get(){} 函数
public function post(){} 函数
....已至restful Api接口写法

//获取视图数据源的值
public function __get ($name)

//此函数设置的值可以在视图模板里直接使用
public function __set ($name, $value)

//处理 action对应的模板 $tpl_name 模板地址 会自定到view 和controller 同名的文件夹 默认 $c/$a.php
public function display ($tpl_name = "", $return = false)

baseController

baseController 在每个模块里面有父类，继承系统核心Controller 主要用来处理

处理模块常用的业务（比如权限验证）
处理比如分页的数据展现样式
公共的业务处理在默认情况下没有model 那么把处理一些公共的数据操作业务也可以放到这里
做数据输出的过滤，比如同一个输入格式 {"code":0,"message":""} 诸如此类函数的处理

数据模型

es 数据库操作使用PDO pdo 本身对数据库操作，参数化，防止sql注入，请在使用元素sql 语句查询的时候，不要直接拼凑字符串。

模型类

模型类继承 Model 一般情况下可以不需要模型类之间在Action里面进行数据库操作，当我们某些业务数据库操作部分其他公用起来，那么模型类是不错的选择。

class User extends Model
{
    //模型对应的表名
    public $table_name = 'user_view';

    //定义使用的常用
    const  USER_ON = 0; 
    const  USER_OFF = 1; 

    //定义数据的一些枚举
    public static  $member =[
        self::USER_ON => '正常',
        self::USER_OFF => '禁用'
    ];
    
    //公用的操作数据方法
    public function login($username, $password)
    {
        $this->find()
        //todo 
    }
 }
 //直接实例等同 $userDb = new Model('user') 只不过模型里面只能用到原始的Model表;
 $userDb = new User();

读写分离（多数库操作）

 public function setDB($db_config_key = 'default', $is_readonly = false)

 $userDb = new Model('user');
 
//设置以下操作使用 sale0 实例
 $userDb->setDb('sale0', true);
 $user->...

查询

//查询user表数据
$userDb = new Model("user");

 /** 查询数据返回数据数组集合
     * @param array 查询条件可以是数组，也可以直接是字符串 比如 ['id'=>1] 等效 "and id = 1"
     * @param null 排序 如 " id desc"
     * @param string 查詢表字段
     * @param null $limit 这个参数比较关键，如果这个参数不为空将 可以分页
     * @return mixed
     */
public function findAll ($conditions = array(), $sort = null, $fields = '*', $limit = null) 

//分页查询
$userData = $userDb->findAll('id> 1', 'id desc', '*', 10)

//执行为上面的语句后
$userDb->page 返回一个分页数组，模板里面可以根据这个数组去做一定处理
一般情况BaseController 自定义个函数来拼凑html 显示
或者直接 是前后端分离 json 直接打印给前端处理
 
//查询单条数据
public function find ($conditions = array(), $sort = null, $fields = '*')

//sql 直接查询(注意参数化形式不要直接拼凑sql)
public function query($sql, $params = array())
$user = $userDb->query("select * from mo_user where id=:id ", [':id'=>1]);

//查询统计量等同于 sum($field) 返回直接返回整型
public function findSum($conditions, $field)

//查询统计量等同于 count(1) 返回直接返回整型
public function findCount($conditions)

各种函数的查询条件

方式一： 拼凑sql

 $user->find(" username='{$username}' and sex > $sex")
 
方式二： 简单数组实现and 连接

$user->find(['username'=>$username, 'sex>'=>$sex])

方式三： 参数化写法（类似 上面的query 函数方式）

$user->find([ "username = :username and sex > :sex and id in (:ids)" , [':username'=>$username, ':sex'=>$sex, ':ids'=>[1,3,4,..] ] ])

方式一 可能为存在sql注入问题 特别注意， 方式二简单明了，但是连接 or 条件 为能实现 方式三稍微复杂 建议使用

新增

/** 表插入记录
 * @param $row
 * @return mixed
 */
public function create($row);

演示
$userDb = new Model('user');
//插入单条记录
$userDb->create(
    ['username'=>'es',
      'password'=>'123456',
      'sex'=>1,
      '#created'=>'CURRENT_TIMESTAMP()' //带#的key 后面的value 可以直接是mysql 内置函数
    ]
);

批量插入
$userDb->create(
    [
        ['username'=>'es',password'=>'123456','#created'=>'CURRENT_TIMESTAMP()'],
        ['username'=>'es',password'=>'1234564', '#created'=>'CURRENT_TIMESTAMP()' ]...
    ]
);

更新

/**
 * @param 查询条件
 * @param 更加的数据
 * @return mixed
 */
public function update($conditions, $row)
$userDb->update(
    ['id'=>1],
    ['username'=>'es',
      'password'=>'123456',
      '+sex'=>1, // 操作符号支持 + - * / 转换成sql  sex = sex+1
      '#created'=>'CURRENT_TIMESTAMP()' //支持mysql 函数
    ]
);

删除

//按条件删除数据
public function delete($conditions)

$userDb = new Model('user');
$userDb->delete(['id'=>1]);

事务

 $Db = Model::startTrans();
 $userDb = new User();
 ......
 $Db->commit()

视图

es 采用php原始脚本作为模板标记语言，主要好处有

不需要额外学习一门新的标识语言
速度上也是最快的
实现起来简单

模板引擎

php 原始脚本，只不过模板里面能够使用的变量 只能来源controller __set 所设置的变量
保证模板使用的数据安全，按需所给。

母版

引入母版机制(具体参考案例)

<?php include $_view_obj->compile($__template_file); ?>

扩展引用

es 本身最求灵活，极简单，所有没有引入其他重型模板的功能点，比如 cache 、http 等常用模块，那么使用者，如果需要相关功能怎么办能

步骤如下：

'plugins'=>['include','plugin'] //扩展目录

扩展目录里面放入扩展类[类文件直拷贝到目录里面]

class P
{
    public function test(){
        return '扩展';
    }
}

在controller action 里面

$p = new P();
$p->test()

同理静态方法调用跟为方便

composer 机制扩展

现实开发中大部分功能模块通过composer 安装进去扩展我们的功能，这是非常棒的选择。具体建议做法

1 . index.php 里面引入

 require_once (__DIR__.'/vendor/autoload.php');

2 . plugin 里面做个静态类比如 App.php

 use RedisClient\RedisClient;
 class App
 {
     private static $_redis;
     /**
      * 缓存实现
      */
     public static function redis()
     {
         if (empty(self::$_redis)) {
             self::$_redis = new RedisClient($GLOBALS['redis']);
         }
         return self::$_redis;
     }

3 . 配置文件加入config 构造需要的参数

 'redis'=>[
        'server' => '192.168.1.61:6379',
        'timeout' => 2,
        'password' => 'songfeiok',
        'database' => 3,
    ],

3 . 使用

    $redisClient = App::redis()
    $redisClient->set("A", 1)
    $redisClient->get("A")
     .....

支持常驻脚本

//能处理shell 请求
if (!empty($argc)) {
    $_REQUEST['m'] = $argv[1];
    $_REQUEST['c'] = $argv[2];
    $_REQUEST['a'] = $argv[3];
    $_REQUEST['p'] = empty($argv[4])? '': $argv[4];
}

$ php index.php m c a "自定义参数"

注意 在脚本的 action 跟 web 有区别，shell的controller 能执行的函数是 action前缀的方法，比如 MainController -> actionIndex

联系方式

bug和建议请发送至：313690636@qq.com；
技术支持、技术合作或咨询请联系作者QQ:313690636、群：571627871。
博客地址：http://www.cnblogs.com/echosong/

Echosong/ES