ctfang/universe

The Swoole Framework.

Installs: 13

Dependents: 0

Suggesters: 0

Security: 0

Stars: 11

Watchers: 4

Forks: 2

Open Issues: 0

Type:project

0.1.2 2018-02-11 09:34 UTC

This package is auto-updated.

Last update: 2020-10-15 11:09:51 UTC


README

这是一个基于swoole扩展的php框架,调试模式下代码跟普通php-fpm模式一样,是实时生效的;框架部分大量参考了phalcon和laravel代码的实现,例如框架骨架使用了DI服务,所有框架先注册进入DI树,注册完后才使用,这样可以更好的扩展框架功能,哪怕是覆盖框架核心服务都行。因为universe是常住内存运行的,所以DI服务都是一次注册多次使用。

Build Status License

About Universe

2.0.* 版本已经抛弃fpm模式运行,调试模式可以自动reload,实现代码实时生效

Note: Universe的目标是所有注册进di的服务都由第三方开发,让更多的人参与开发

已经实现的功能列表

安装使用

composer安装

composer create-project ctfang/universe

git安装

git clone https://github.com/ctfang/Universe.git
cd Universe
composer install

运行,单独运行php server有帮助命令,例如http使用:

// 守护模式,调试下支持代码更改实时生效
php server http:start
// 非守护模式
php server http:start --daemonize=0
// 重启服务
php server http:reload
php server http:stop

启动时,会输出域名端口基本信息

 ----------------- -------------------------------------------------------
  配置key           值
 ----------------- -------------------------------------------------------
  监听域名          0.0.0.0
  监听端口          8081
  log_file          /data/webpages/swoole-demo/storage/swoole.log
  pid_file          /data/webpages/swoole-demo/bootstrap/cache/server.pid
  log_level         5
  worker_num        4
  task_worker_num   0
  守护模式          是
 ----------------- -------------------------------------------------------

如果需要访问静态资源,html、css、js等;可以配置nginx服务器,配置模板 bootstrap\swoole.app.conf

server {
    listen       80;
    server_name  demo.app;

    root /data/webpages/swoole-demo/public;

    index index.html;

    location / {
        try_files $uri @swoole;
    }

    location @swoole {
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://php:8081;
    }
}
代码即时生效

借助中间件,在所有业务处理完后,向server发起reload,新的请求就运行新的代码。 注入di的服务不会立即更新

配置载入

所有的配置都在config目录下,默认加载配置文件

universe/config/app.php
控制器

一个基础的控制器定义

namespace App\Http\Controllers;

class IndexController extends Controller
{
    public function getString()
    {
        return '输出字符串;获取请求参数:'.$this->request->get('id','int',0);
    }

    public function getJson()
    {
        return [
            'time'=>time(),
            'string'=>'响应json格式,自动加Json Header',
        ];
    }
}

访问上面示范两个函数需要添加路由,路由文件在 /config/route.php

Route::get('/string', 'IndexController@getString');
Route::get('/index/json', 'IndexController@getJson');

路由器访问 http://test.test/index/json 就可以进入 getJson

路由

所有接口都必须在路由文件/config/route.php注册

Route::get('/string', 'IndexController@getString');
Route::get('/index/json', 'IndexController@getJson');

// 注册一个分组,分组内的路由都会添加 /test 前缀
// middleware参数是所有请求都会进入login中间件,例如实现/test开头的路由都必须登录后才能访问
Route::group(['prefix' => '/test', 'middleware' => 'login'],function () {
    Route::get('/one', 'IndexController@one');
    Route::get('/two', 'IndexController@two');
});
中间件

中间的使用基本和laravel一模一样,中间件在控制器前还是后执行,是有中间件本身决定的,所有中间件都在目录/app/http/middleware下

namespace App\Http\Middleware;


use Universe\Support\Middleware;
use Universe\Servers\RequestServer;

class AuthMiddleware extends Middleware
{
    /**
     * @param RequestServer $request
     * @param $next
     */
    public function handle(RequestServer $request, $next)
    {
        // 这里的代码在控制器前运行
        
        $response = $next($request);
        
        // 这里的代码在控制器后运行
        
        return $response;
    }
}

完全由 $next($request) 决定中间件的运行前后。

当然中间一般都用来权限校验或者重定向等。

class AuthMiddleware extends Middleware
{
    /**
     * @param RequestServer $request
     * @param $next
     */
    public function handle(RequestServer $request, $next)
    {
        if( !is_login() ){
            // 没有登录重定向到登陆页面
            $request->setUri('/login');
            // 需要重新向新地址,返回 新地址 对象即可
            return $request;
        }
        
        if( !$request->get('token') ){
            /**
             * 需要验证token的接口,没有参数
             * 返回数组,获取字符串,就可以停止执行
             */
            return [
                'error'=>'403',
                'error_msg'=>'没有权限',
            ];
        }
        // 可以进入控制器
        return $next($request);
    }
}
异常服务

/app/Exceptions/Kernel.php 注册异常需要经过的handler

class Kernel extends ExceptionKernel
{
    /**
     * 注册异常处理
     *
     * @return mixed
     * @author 明月有色 <2206582181@qq.com>
     */
    public function register()
    {
        if( is_debug() ){
            // 如果调试,把错误展示出来
            $this->server->pushHandler(new PrettyPageHandler());
        }
        // 所有错误日记记录
        $this->server->pushHandler(new LoggerHandler());
        // 404 优先处理
        $this->server->pushHandler(new NotFoundHandler());
    }
}

上面注册了3个handler

  • 把所有错误写入日记
  • 把错误显示出来
  • 404展示一个简单页面
数据模型
dump(DB::table('test')->find(1));
User::find(1);l

使用上完全跟laravel一样,因为集成的是相同的composer包,如果需要用其他的orm,重新注册DI即可

事件系统
App::get('events')
数据迁移

输入命令查看帮助,集成phinx

php moon

连接池,如果需要orm默认使用连接池执行,可以在database注入时,传入新的Connection 默认Connection在 /illuminate/database/Connection.php 新Connection继承/illuminate/database/Connection.php,并且参考651行runQueryCallback函数

如何加入开发组

  • 提交commit,例如开发一个非常漂亮的异常 handler处理
  • 给已有的成员发送邮件

开发组