说明
php7由于新框架须要安装swoole，只能linux环境运行，这里本机开发是win10(：debian云服务器主机上git clone 项目，再同步到本机phpstorm、修改提交；或使用win10的docker安装)。
这里docker有个bug：无法感知主机文件的热更新，所以运行加了 --rm 选项，手动热启动。
1.安装
官方提供docker方式简便快捷：
(git clone https://github.com/swoft-clou... 下载swoft到目标文件夹，如/root/tmp/dk/vuejs/swoft)
#/root/tmp/dk/vuejs/swoft 为当前swoft主机映射目录
#启动项目的http访问，启动命令情况参考根目录的Dockerfile文件
docker run -p 18306:18306 --name swoft -v /root/tmp/dk/vuejs/swoft:/var/www/swoft --rm swoft/swoft
2.http访问请求
a.http响应
复制 .env.example 为 .env ，修改参数为调试模式；端口配置在 app/bean.php 不修改。
参考HomeController和官网说明，添加控制器 app/Http/Controller/TestController.php：
namespace AppHttpController;
use SwoftContextContext;
use SwoftHttpMessageContentType;
use SwoftHttpMessageResponse;
use SwoftHttpServerAnnotationMappingController;
use SwoftHttpServerAnnotationMappingRequestMapping;
use Throwable;
/**
* 测试类
*
* @Controller("/test")
*/
class TestController
{
/** 网络地址 http://host:18306/test/a
* @RequestMapping("/test/a")
* @throws Throwable
*
* 方法注释
*/
public function index(): Response
{
return Context::mustGet()->getResponse()->withContentType(ContentType::HTML)->withContent("12345");
}
}
这里请求返回：获取协程上下文->获取响应对象->包含HTML头部的字符串。
注解路由：
从启动文件 bin/swoft 一直ctrl+点击下去，可以看到启动配置文件后，注解路由类的加载。
[
new EnvProcessor($this),
new ConfigProcessor($this),
new AnnotationProcessor($this),
new BeanProcessor($this),
new EventProcessor($this),
new ConsoleProcessor($this),
]
初始化加载流程：
(new AppApplication()) ==> __construct()->$this->init() ==> $this->processors() => new [] ：实例化上面4个启动类；
AnnotationRegister::load() ==> AnnotationResource()->load()..loadAnnotation()..parseAnnotation()..parseOneClassAnnotation() ==> DoctrineCommonAnnotationsAnnotationReader ，扫描注解类。
b.http中间件
参考官网，配置文件 app/bean.php 里 httpDispatcher['middlewares'] 是http请求分发时的中间件，可以在此配置出添加类名、模拟ViewMiddleware.php编写中间件。
默认已经有个空的未加入，添加到配置 app/bean.php：
'httpDispatcher' => [
// Add global http middleware
'middlewares' => [
// Allow use @View tag
AppHttpMiddlewareControllerMiddleware::class,
SwoftViewMiddlewareViewMiddleware::class,
],
],
并修改它app/Http/Middleware/ControllerMiddleware.php：
namespace AppHttpMiddleware;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
use PsrHttpServerRequestHandlerInterface;
use SwoftBeanAnnotationMappingBean;
use SwoftContextContext;
use SwoftHttpMessageResponse;
use SwoftHttpServerContractMiddlewareInterface;
use Throwable;
/**
* Class ControllerMiddleware - The middleware of httpDispatcher
*
* @Bean()
*/
class ControllerMiddleware implements MiddlewareInterface
{
/**
* Process an incoming server request.
*
* @param ServerRequestInterface $request
* @param RequestHandlerInterface $handler
*
* @return ResponseInterface
* @inheritdoc
* @throws Throwable
*/
public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
{
/** @var Response $response */
$status = 2;
$date = date("Y-m-d H:i:s ");
if ( $status == 0 ) {
//直接处理之后的 响应
$response = $handler->handle($request);
var_dump($response);
return $response->withData($date); //已完成、处理无效
return $response;
} elseif ( $status == 1) {
//验证失败的 响应
$json = ['code'=>0,'msg'=>'授权失败','time'=>$date];
$response = Context::mustGet()->getResponse();
return $response->withData($json);
} elseif ( $status == 2 ) {
$response = Context::mustGet()->getResponse();
return $response->withData("ok")->withStatus(404);
} else {
$method = $request->getMethod();
$response = Context::mustGet()->getResponse();
return $response->withData($method);
}
}
}
访问浏览器，可看到响应的结果。加到启动配置 httpDispatcher 里的会在 onRequest准备返回前 加载。
withData()：如果是string类型：会放到返回数组的data字段里，数组类型：原样返回。
c.RESTful API
由于swoft使用的是注解路由，请求方式也在注解中添加。
编辑器中点击 @RequestMapping() 注解，可以看到有method私有属性，公共方法getMethod() Array。
## app/Http/Controller/TestController.php：
use SwoftHttpServerAnnotationMappingRequestMethod;
/**
* @RequestMapping(route="/test/rs", method={RequestMethod::POST, RequestMethod::PUT})
* @throws Throwable
*
* 方法注释
*/
public function restful(): Response
{
//SwoftTestHttpServerTestingControllerRouteController
//* @RequestMapping("method", method={RequestMethod::POST, RequestMethod::PUT})
//SwoftDevtoolHttpControllerGenController
//* @RequestMapping(route="preview", method=RequestMethod::POST)
return Context::mustGet()->getResponse()->withContentType(ContentType::HTML)->withContent("hiaa");
}
}
## app/Http/Middleware/ControllerMiddleware.php：
namespace AppHttpMiddleware;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
use PsrHttpServerRequestHandlerInterface;
use SwoftBeanAnnotationMappingBean;
use SwoftContextContext;
use SwoftHttpMessageResponse;
use SwoftHttpServerContractMiddlewareInterface;
use Throwable;
/**
* Class ControllerMiddleware - The middleware of httpDispatcher
*
* @Bean()
*/
class ControllerMiddleware implements MiddlewareInterface
{
/**
* Process an incoming server request.
*
* @param ServerRequestInterface $request
* @param RequestHandlerInterface $handler
*
* @return ResponseInterface
* @inheritdoc
* @throws Throwable
*/
public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
{
/** @var Response $response */
$date = date("Y-m-d H:i:s ");
$method = $request->getMethod();
$router = SwoftBeanBeanFactory::getSingleton('httpRouter');
$uriPath = $request->getUriPath();
$routeData = $router->match($uriPath, $method);
if( $routeData[0] == SwoftHttpServerRouterRouter::NOT_FOUND ){
$response = Context::mustGet()->getResponse();
var_dump(1111111);
return $response->withData([$method ."拒绝访问"]);
}
$status = 0;
if ( $status == 0 ) {
//直接处理之后的 响应
$response = $handler->handle($request);
var_dump("直接响应");
return $response->withData($date); //已完成、处理无效
return $response;
} elseif ( $status == 1) {
//验证失败的 响应
$json = ['code'=>0,'msg'=>'授权失败','time'=>$date];
$response = Context::mustGet()->getResponse();
return $response->withData($json);
} elseif ( $status == 2 ) {
$response = Context::mustGet()->getResponse();
return $response->withData("ok")->withStatus(404);
} else {
$response = Context::mustGet()->getResponse();
return $response->withData($method);
}
}
}
中间件的控制官方没有手册，头大。