# 第一个应用

作者创建了专门的使用示例项目，里面编写了Dce的几乎全部功能特性的使用示例，建议你拉取该项目查看源码及尝试运行，会加深你的理解让你更快上手。你可以点击这里使用composer拉取，或者去Github拉取。

# Cgi网页版Hello World

# 新建项目

在项目根目录下建立一个hello目录
在新建hello目录下建立config、controller、template目录

此时的项目目录结构如下:

├─project                       项目根目录
│  ├─hello                      自定义的名为hello的项目
│  │  ├─config                  项目配置目录
│  │  ├─controller              项目控制器目录
│  │  ├─template                渲染模板目录

1
2
3
4
5

# 配置节点

提示

4.2.1新增注解式节点支持，可以更方便的编写接口，点击查看详情

在项目配置目录下建立nodes.php
在nodes.php中输入如下节点配置

return [
    [
        'path' => 'hello',
        'controller' => 'DefaultController->index'
    ],
];

1
2
3
4
5
6

# 新建控制器

在项目控制器目录下建立DefaultController.php
将下面的脚本替换填充到DefaultController.php中

namespace hello\controller;

use dce\project\Controller;

class DefaultController extends Controller {
    public function index() {
        $this->assign("message", "Hello World !");
    }
}

1
2
3
4
5
6
7
8
9

# 访问

访问之前需先部署，你可以用Nginx、Apache、IIS部署，将默认文档设置为index.php，并将文档根目录设为APP_WWW
部署完成可访问你部署的地址（如，http://127.0.0.1/?/hello），得到如下json结果，表示访问成功。（Dce为了得到友好的Url，做了最简Url设计，如左，只比静态多了/?，当然你也可以配置Url重写去掉/?依赖）

{"data":{"message":"Hello World !"}}

# 新建布局视图

上面的例子，默认响应的json，是一个接口型页面。Dce当然也支持响应传统的Html页面，按下述步骤可以建立一个Html页面。

修改nodes.php配置，指定模版文件路径

return [
    [
        'path' => 'hello',
        'controller' => 'DefaultController->index',
        'render' => 'index.php',
    ],
];

1
2
3
4
5
6
7

在template中建立模板文件index.php并填充为以下内容

<!doctype html>
<html lang="zh-cn">
<head>
<meta charset="UTF-8">
<title>Dce html response test</title>
</head>
<body>
控制器映射的变量$message的值为: <?=$message?>
</body>
</html>

1
2
3
4
5
6
7
8
9
10

刷新之前的部署地址，看到如下内容，则表示你的Html页面创建成功

控制器映射的变量$message的值为: Hello World !

├─project                           项目根目录
│  ├─hello                          自定义的名为hello的项目
│  │  ├─config                      项目配置目录
│  │  │  ├─nodes.php                项目节点配置
│  │  ├─controller                  项目控制器目录
│  │  │  ├─DefaultController.php    自定义控制器
│  │  ├─template                    渲染模板目录
│  │  │  ├─index.php                自定义Html模板

1
2
3
4
5
6
7
8

# 命令行（Cli）Hello World

命令行模式与Cgi模式的开发方式一样，下面是一些细微区别。

# 配置节点

[
    'methods' => 'cli', // 属性的详细说明参见节点章
    'path' => 'hello/cli',
    'controller' => 'CliController->index',
];

1
2
3
4
5

# 新建控制器

新建文件CliController.php
填充脚本如下

namespace hello\controller;

use dce\project\Controller;

class CliController extends Controller {
    public function index() {
        $this->print("Hello World !");
    }
}

1
2
3
4
5
6
7
8
9

访问测试

# {$APP_ROOT}替换为你的应用根目录
cd {$APP_ROOT}

1
2

执行你的控制器方法

dce hello cli

看到如下响应则表示脚本执行成功

Hello World !

# Http服务器

Dce内置了Http服务器，是基于Swoole的Http Server封装开发的，Swoole需要在Linux运行，本例后续所有服务皆需在Linux下运行。Dce Http被以内置项目的形式封装在Dce中，下述为启动执行步骤

如上述 cli类接口一样，打开终端，进入应用根目录
启动Http服务

dce http start

访问之前定义的接口：http://127.0.0.1:20460/?/hello（默认HttpServer端口为20460，可以通过common/config/http.php自定义，详细参见内置Http服务篇）
看到响应"Hello World !"表示Http服务器正常

# Websocket服务器

Websocket也是以内置项目的形式封装的，Dce完全接管了websocket的message事件，将之作为请求响应式处理，当然你也可以只处理请求而不响应，或者异步响应。Dce会对数据以explode(";", $data)的形式拆包，第一部分将作为请求路径，会根据该路径定位Node节点，第二部分作为请求数据，如果该数据为json，则会自动解析为PHP数组存在$request->request上，你也可以通过$request->rawData取原始数据。当然这些拆包方法及定位Node等所有行为，你都可以自定义实现，完整介绍请参见内置Websocket服务

配置节点，在nodes.php追加下述内容

[
    'methods' => 'websocket',
    'path' => 'hello/websocket',
    'controller' => 'WebsocketController->index',
],

1
2
3
4
5

创建控制器WebsocketController.php

namespace hello\controller;

use dce\project\Controller;

class WebsocketController extends Controller {
    public function index() {
        $this->assign("message", "Server received: {$this->request->rawData}");
        $this->response();
    }
}

1
2
3
4
5
6
7
8
9
10

启动Websocket服务器

dce websocket start

打开Chrome，按F12打开开发者工具，切换到Console，粘贴执行下述代码

const ws = new WebSocket("ws://127.0.0.1:20461/");
ws.onopen = () => {
    ws.send("hello/websocket;Data from client");
};
ws.onmessage = (evt) => {
    console.log("Received data from server: " + evt.data);
    ws.close();
};

1
2
3
4
5
6
7
8

若看到打印的下述数据，则表示发送接收成功。（经历了连接-客户端发送-服务端接收-服务端解包-服务端定位并执行控制器-服务端打包-服务端发送-客户端接收这些过程）

Received data from server: hello/websocket;{"data":{"message":"Server received: Data from client"}}

你可能会说你需要发送到指定的客户端而不仅仅是响应某个消息，Dce当然支持，你可以到内置Websocket服务器篇查看完整介绍以了解。

# Tcp服务器

Tcp的封装与Websocket的非常相似，Dce完全接管了receive事件，打包拆包等默认行为与Websocket相同。完整介绍请参见内置Tcp/Udp服务

配置节点，在nodes.php追加下述内容

[
    'methods' => ['tcp', 'udp'], // 兼容tcp/udp
    'path' => 'hello/tcp',
    'controller' => 'TcpController->index',
],

1
2
3
4
5

创建控制器TcpController.php

namespace hello\controller;

use dce\project\Controller;

class TcpController extends Controller {
    public function index() {
        $this->assign("message", "Server received: {$this->request->rawData}");
        $this->response();
    }
}

1
2
3
4
5
6
7
8
9
10

启动Tcp服务

dce tcp start

使用netcat测试Tcp/Udp服务器

# 测试Tcp连接
./nc 127.0.0.1 20462
hello/tcp;Tcp data from client

# 测试Udp连接 (若为docker环境, 需要在映射端口指明为udp端口, 如-p 20463:20463/udp)
./nc -u 127.0.0.1 20463
hello/tcp;Udp data from client

1
2
3
4
5
6
7

若看到打印的下述数据，则表示发送接收成功。（经历了连接-客户端发送-服务端接收-服务端解包-服务端定位并执行控制器-服务端打包-服务端发送-客户端接收这些过程）

# Tcp通信成功响应
hello/tcp;{"data":{"message":"Server received: Tcp data from client\n"}}

# Udp通信成功响应
hello/tcp;{"data":{"message":"Server received: Udp data from client\n"}}

1
2
3
4
5

← 获取全局组件 →