Koa 框架教程

Koa 框架教程

做者: 阮一峰javascript

日期: 2017年8月 9日html

珠峰培训

Node 主要用在开发 Web 应用。这决定了使用 Node,每每离不开 Web 应用框架。前端

Koa 就是一种简单好用的 Web 框架。它的特色是优雅、简洁、表达力强、自由度高。自己代码只有1000多行,全部功能都经过插件实现,很符合 Unix 哲学。java

本文从零开始,按部就班,教会你如何使用 Koa 写出本身的 Web 应用。每一步都有简洁易懂的示例,但愿让你们一看就懂。node

零、准备

首先,检查 Node 版本。git

$ node -v v8.0.0 

Koa 必须使用 7.6 以上的版本。若是你的版本低于这个要求,就要先升级 Node。es6

而后,克隆本文的配套示例库。(若是不方便使用 Git,也能够下载 zip 文件解压。)github

$ git clone https://github.com/ruanyf/koa-demos.git 

接着,进入示例库,安装依赖。web

$ cd koa-demos $ npm install 

全部示例源码,都在 demos 目录下面。算法

1、基本用法

1.1 架设 HTTP 服务

只要三行代码,就能够用 Koa 架设一个 HTTP 服务。

 // demos/01.js const Koa = require('koa'); const app = new Koa(); app.listen(3000); 

运行这个脚本。

$ node demos/01.js 

打开浏览器,访问 http://127.0.0.1:3000 。你会看到页面显示"Not Found",表示没有发现任何内容。这是由于咱们并无告诉 Koa 应该显示什么内容。

1.2 Context 对象

Koa 提供一个 Context 对象,表示一次对话的上下文(包括 HTTP 请求和 HTTP 回复)。经过加工这个对象,就能够控制返回给用户的内容。

Context.response.body属性就是发送给用户的内容。请看下面的例子(完整的代码看这里)。

 // demos/02.js const Koa = require('koa'); const app = new Koa(); const main = ctx => { ctx.response.body = 'Hello World'; }; app.use(main); app.listen(3000); 

上面代码中,main函数用来设置ctx.response.body。而后,使用app.use方法加载main函数。

你可能已经猜到了,ctx.response表明 HTTP Response。一样地,ctx.request表明 HTTP Request。

运行这个 demo。

$ node demos/02.js 

访问 http://127.0.0.1:3000 ,如今就能够看到"Hello World"了。

1.3 HTTP Response 的类型

Koa 默认的返回类型是text/plain,若是想返回其余类型的内容,能够先用ctx.request.accepts判断一下,客户端但愿接受什么数据(根据 HTTP Request 的Accept字段),而后使用ctx.response.type指定返回类型。请看下面的例子(完整代码看这里)。

 // demos/03.js const main = ctx => { if (ctx.request.accepts('xml')) { ctx.response.type = 'xml'; ctx.response.body = '<data>Hello World</data>'; } else if (ctx.request.accepts('json')) { ctx.response.type = 'json'; ctx.response.body = { data: 'Hello World' }; } else if (ctx.request.accepts('html')) { ctx.response.type = 'html'; ctx.response.body = '<p>Hello World</p>'; } else { ctx.response.type = 'text'; ctx.response.body = 'Hello World'; } }; 

运行这个 demo。

$ node demos/03.js 

访问 http://127.0.0.1:3000 ,如今看到的就是一个 XML 文档了。

1.4 网页模板

实际开发中,返回给用户的网页每每都写成模板文件。咱们可让 Koa 先读取模板文件,而后将这个模板返回给用户。请看下面的例子(完整代码看这里)。

 // demos/04.js const fs = require('fs'); const main = ctx => { ctx.response.type = 'html'; ctx.response.body = fs.createReadStream('./demos/template.html'); }; 

运行这个 Demo。

$ node demos/04.js 

访问 http://127.0.0.1:3000 ,看到的就是模板文件的内容了。

2、路由

2.1 原生路由

网站通常都有多个页面。经过ctx.request.path能够获取用户请求的路径,由此实现简单的路由。请看下面的例子(完整代码看这里)。

 // demos/05.js const main = ctx => { if (ctx.request.path !== '/') { ctx.response.type = 'html'; ctx.response.body = '<a href="/">Index Page</a>'; } else { ctx.response.body = 'Hello World'; } }; 

运行这个 demo。

$ node demos/05.js 

访问 http://127.0.0.1:3000/about ,能够看到一个连接,点击后就跳到首页。

2.2 koa-route 模块

原生路由用起来不太方便,咱们可使用封装好的koa-route模块。请看下面的例子(完整代码看这里)。

 // demos/06.js const route = require('koa-route'); const about = ctx => { ctx.response.type = 'html'; ctx.response.body = '<a href="/">Index Page</a>'; }; const main = ctx => { ctx.response.body = 'Hello World'; }; app.use(route.get('/', main)); app.use(route.get('/about', about)); 

上面代码中,根路径/的处理函数是main/about路径的处理函数是about

运行这个 demo。

$ node demos/06.js 

访问 http://127.0.0.1:3000/about ,效果与上一个例子彻底相同。

2.3 静态资源

若是网站提供静态资源(图片、字体、样式表、脚本......),为它们一个个写路由就很麻烦,也不必。koa-static模块封装了这部分的请求。请看下面的例子(完整代码看这里)。

 // demos/12.js const path = require('path'); const serve = require('koa-static'); const main = serve(path.join(__dirname)); app.use(main); 

运行这个 Demo。

$ node demos/12.js 

访问 http://127.0.0.1:3000/12.js,在浏览器里就能够看到这个脚本的内容。

2.4 重定向

有些场合,服务器须要重定向(redirect)访问请求。好比,用户登录之后,将他重定向到登录前的页面。ctx.response.redirect()方法能够发出一个302跳转,将用户导向另外一个路由。请看下面的例子(完整代码看这里)。

 // demos/13.js const redirect = ctx => { ctx.response.redirect('/'); ctx.response.body = '<a href="/">Index Page</a>'; }; app.use(route.get('/redirect', redirect)); 

运行这个 demo。

$ node demos/13.js 

访问 http://127.0.0.1:3000/redirect ,浏览器会将用户导向根路由。

3、中间件

3.1 Logger 功能

Koa 的最大特点,也是最重要的一个设计,就是中间件(middleware)。为了理解中间件,咱们先看一下 Logger (打印日志)功能的实现。

最简单的写法就是在main函数里面增长一行(完整代码看这里)。

 // demos/07.js const main = ctx => { console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`); ctx.response.body = 'Hello World'; }; 

运行这个 Demo。

$ node demos/07.js 

访问 http://127.0.0.1:3000 ,命令行就会输出日志。

1502144902843 GET / 

3.2 中间件的概念

上一个例子里面的 Logger 功能,能够拆分红一个独立函数(完整代码看这里)。

 // demos/08.js const logger = (ctx, next) => { console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`); next(); } app.use(logger); 

像上面代码中的logger函数就叫作"中间件"(middleware),由于它处在 HTTP Request 和 HTTP Response 中间,用来实现某种中间功能。app.use()用来加载中间件。

基本上,Koa 全部的功能都是经过中间件实现的,前面例子里面的main也是中间件。每一个中间件默认接受两个参数,第一个参数是 Context 对象,第二个参数是next函数。只要调用next函数,就能够把执行权转交给下一个中间件。

运行这个 demo。

$ node demos/08.js 

访问 http://127.0.0.1:3000 ,命令行窗口会显示与上一个例子相同的日志输出。

3.3 中间件栈

多个中间件会造成一个栈结构(middle stack),以"先进后出"(first-in-last-out)的顺序执行。

  1. 最外层的中间件首先执行。
  2. 调用next函数,把执行权交给下一个中间件。
  3. ...
  4. 最内层的中间件最后执行。
  5. 执行结束后,把执行权交回上一层的中间件。
  6. ...
  7. 最外层的中间件收回执行权以后,执行next函数后面的代码。

请看下面的例子(完整代码看这里)。

 // demos/09.js const one = (ctx, next) => { console.log('>> one'); next(); console.log('<< one'); } const two = (ctx, next) => { console.log('>> two'); next(); console.log('<< two'); } const three = (ctx, next) => { console.log('>> three'); next(); console.log('<< three'); } app.use(one); app.use(two); app.use(three); 

运行这个 demo。

$ node demos/09.js 

访问 http://127.0.0.1:3000 ,命令行窗口会有以下输出。

>> one >> two >> three << three << two << one 

若是中间件内部没有调用next函数,那么执行权就不会传递下去。做为练习,你能够将two函数里面next()这一行注释掉再执行,看看会有什么结果。

3.4 异步中间件

迄今为止,全部例子的中间件都是同步的,不包含异步操做。若是有异步操做(好比读取数据库),中间件就必须写成 async 函数。请看下面的例子(完整代码看这里)。

 // demos/10.js const fs = require('fs.promised'); const Koa = require('koa'); const app = new Koa(); const main = async function (ctx, next) { ctx.response.type = 'html'; ctx.response.body = await fs.readFile('./demos/template.html', 'utf8'); }; app.use(main); app.listen(3000); 

上面代码中,fs.readFile是一个异步操做,必须写成await fs.readFile(),而后中间件必须写成 async 函数。

运行这个 demo。

$ node demos/10.js 

访问 http://127.0.0.1:3000 ,就能够看到模板文件的内容。

3.5 中间件的合成

koa-compose模块能够将多个中间件合成为一个。请看下面的例子(完整代码看这里)。

 // demos/11.js const compose = require('koa-compose'); const logger = (ctx, next) => { console.log(`${Date.now()} ${ctx.request.method} ${ctx.request.url}`); next(); } const main = ctx => { ctx.response.body = 'Hello World'; }; const middlewares = compose([logger, main]); app.use(middlewares); 

运行这个 demo。

$ node demos/11.js 

访问 http://127.0.0.1:3000 ,就能够在命令行窗口看到日志信息。

4、错误处理

4.1 500 错误

若是代码运行过程当中发生错误,咱们须要把错误信息返回给用户。HTTP 协定约定这时要返回500状态码。Koa 提供了ctx.throw()方法,用来抛出错误,ctx.throw(500)就是抛出500错误。请看下面的例子(完整代码看这里)。

 // demos/14.js const main = ctx => { ctx.throw(500); }; 

运行这个 demo。

$ node demos/14.js 

访问 http://127.0.0.1:3000,你会看到一个500错误页"Internal Server Error"。

4.2 404错误

若是将ctx.response.status设置成404,就至关于ctx.throw(404),返回404错误。请看下面的例子(完整代码看这里)。

 // demos/15.js const main = ctx => { ctx.response.status = 404; ctx.response.body = 'Page Not Found'; }; 

运行这个 demo。

$ node demos/15.js 

访问 http://127.0.0.1:3000 ,你就看到一个404页面"Page Not Found"。

4.3 处理错误的中间件

为了方便处理错误,最好使用try...catch将其捕获。可是,为每一个中间件都写try...catch太麻烦,咱们可让最外层的中间件,负责全部中间件的错误处理。请看下面的例子(完整代码看这里)。

 // demos/16.js const handler = async (ctx, next) => { try { await next(); } catch (err) { ctx.response.status = err.statusCode || err.status || 500; ctx.response.body = { message: err.message }; } }; const main = ctx => { ctx.throw(500); }; app.use(handler); app.use(main); 

运行这个 demo。

$ node demos/16.js 

访问 http://127.0.0.1:3000 ,你会看到一个500页,里面有报错提示 {"message":"Internal Server Error"}

4.4 error 事件的监听

运行过程当中一旦出错,Koa 会触发一个error事件。监听这个事件,也能够处理错误。请看下面的例子(完整代码看这里)。

 // demos/17.js const main = ctx => { ctx.throw(500); }; app.on('error', (err, ctx) => console.error('server error', err); ); 

运行这个 demo。

$ node demos/17.js 

访问 http://127.0.0.1:3000 ,你会在命令行窗口看到"server error xxx"。

4.5 释放 error 事件

须要注意的是,若是错误被try...catch捕获,就不会触发error事件。这时,必须调用ctx.app.emit(),手动释放error事件,才能让监听函数生效。请看下面的例子(完整代码看这里)。

 // demos/18.js` const handler = async (ctx, next) => { try { await next(); } catch (err) { ctx.response.status = err.statusCode || err.status || 500; ctx.response.type = 'html'; ctx.response.body = '<p>Something wrong, please contact administrator.</p>'; ctx.app.emit('error', err, ctx); } }; const main = ctx => { ctx.throw(500); }; app.on('error', function(err) { console.log('logging error ', err.message); console.log(err); }); 

上面代码中,main函数抛出错误,被handler函数捕获。catch代码块里面使用ctx.app.emit()手动释放error事件,才能让监听函数监听到。

运行这个 demo。

$ node demos/18.js 

访问 http://127.0.0.1:3000 ,你会在命令行窗口看到logging error

5、Web App 的功能

5.1 Cookies

ctx.cookies用来读写 Cookie。请看下面的例子(完整代码看这里)。

 // demos/19.js const main = function(ctx) { const n = Number(ctx.cookies.get('view') || 0) + 1; ctx.cookies.set('view', n); ctx.response.body = n + ' views'; } 

运行这个 demo。

$ node demos/19.js 

访问 http://127.0.0.1:3000 ,你会看到1 views。刷新一次页面,就变成了2 views。再刷新,每次都会计数增长1。

5.2 表单

Web 应用离不开处理表单。本质上,表单就是 POST 方法发送到服务器的键值对。koa-body模块能够用来从 POST 请求的数据体里面提取键值对。请看下面的例子(完整代码看这里)。

 // demos/20.js const koaBody = require('koa-body'); const main = async function(ctx) { const body = ctx.request.body; if (!body.name) ctx.throw(400, '.name required'); ctx.body = { name: body.name }; }; app.use(koaBody()); 

运行这个 demo。

$ node demos/20.js 

打开另外一个命令行窗口,运行下面的命令。

$ curl -X POST --data "name=Jack" 127.0.0.1:3000 {"name":"Jack"} $ curl -X POST --data "name" 127.0.0.1:3000 name required 

上面代码使用 POST 方法向服务器发送一个键值对,会被正确解析。若是发送的数据不正确,就会收到错误提示。

2.3 文件上传

koa-body模块还能够用来处理文件上传。请看下面的例子(完整代码看这里)。

 // demos/21.js const os = require('os'); const path = require('path'); const koaBody = require('koa-body'); const main = async function(ctx) { const tmpdir = os.tmpdir(); const filePaths = []; const files = ctx.request.body.files || {}; for (let key in files) { const file = files[key]; const filePath = path.join(tmpdir, file.name); const reader = fs.createReadStream(file.path); const writer = fs.createWriteStream(filePath); reader.pipe(writer); filePaths.push(filePath); } ctx.body = filePaths; }; app.use(koaBody({ multipart: true })); 

运行这个 demo。

$ node demos/21.js 

打开另外一个命令行窗口,运行下面的命令,上传一个文件。注意,/path/to/file要更换为真实的文件路径。

$ curl --form upload=@/path/to/file http://127.0.0.1:3000 ["/tmp/file"] 

6、参考连接

(完)

QCon

腾讯课堂

留言(92条)

正在用koa 教程这就来了!

简单易用

讲的很详细!
Koa -- 基于 Node.js 平台的下一代 web 开发框架!

感谢,以前一直在用express

阮老师为啥不直接介绍 egg.js

不是很理解为何要把多个中间件合成为一个

感谢阮一峰老师。

讲的很详细 赞

感谢分享~前几天恰好在入门Koa2

koa和express哪一个比较好 我如今一直在用express 据说koa小 想试试

不太理解为什么要作中间件的合成(koa-compose),阮一峰老师,不知这有什么应用的场景?既然都是中间件,都是按顺序执行,为什么还有作合成?是方便多个中间件,有公用的部分,可屡次应用在不一样中间件上?

正在学习koa2!

感受koa和express都是简洁的小框架。
像ror或者django那种大框架好像有sails和adonis,不过感受也不是很成熟

阮老师的文章都是图文并茂,并且demo和源码都很详细!koa框架正在学习中!

阮老师的入门系列一贯简介明了

我记得koa文档中koa.request/koa.response是其自身封装的对象吧。koa.req/koa.res是node的对象。

我用koa2几个月了,
路由用的最多的是koa-router,
文件上传能够试试koa-multer

膜拜一下前端界的大佬。分享了最新又是值得学习的框架,学习前留个言。

引用龙卷的发言:

正在用koa 教程这就来了!

哈哈哈 我也是,瞌睡送枕头呢。

是时候从 express 换到 koa 了!

node 检查出来是6的版本,可是用brew更新的是8的版本,会有影响吗

受益不浅

Mr.阮,能来一发passport的教程么,结合koa 来一发koa-passport模块详细使用教程.

passport 官网 http://www.passportjs.org/

很是想提高一下自身做为web前端的能力和素质,看了一些帖子,都推荐来看一下阮老师的教程,之后我会多多关注您,把您的教程都好好学习,祝阮老师身体健康,为咱们写出更多的精品教程。

Error: Cannot find module 'koa' = =,老师怎么回事?

清晰明了~

阮老师写的太全了,几乎初学全部点都涵盖到了,感谢。

阮老师,求分享算法和互联网架构的内容。

引用feilong的发言:

Error: Cannot find module 'koa' = =,老师怎么回事?

你没有安装依赖,在node demos/01.js以前,你须要命令行执行npm install

好小巧啊~~之前一点点地开始学node.js感受什么都要本身考虑到,各类处理。后来看了express,使用起来方便多了,也很小巧~~如今又在这里看了koa

阮老师 ··又是4个多月才等的您的一次更新··可是值得

引用cdd的发言:

我记得koa文档中koa.request/koa.response是其自身封装的对象吧。koa.req/koa.res是node的对象。

官方文档是这样

3.5 中件 是中间件吧,少打了一个字。

@van:谢谢指出,已经改正了。

数据库逻辑处理呢。。?本人小白

阮哥你好,你都用什么工具写博客的,我如今也想作一个本身的博客,来写博客。

引用bianhognfei的发言:

阮哥你好,你都用什么工具写博客的,我如今也想作一个本身的博客,来写博客。

用Koa本身写一个啊^_^

const handler = async (ctx, next) => {
^
SyntaxError: Unexpected token

好几个例子报这样的错误是怎么回事

@谢东磊:

不识别箭头函数吧

为何路由介绍使用的是koa-route没有使用koa-router

koa2 由于须要async await 的缘由须要node版本在7以上,koa1不须要

引用谢东磊的发言:

const handler = async (ctx, next) => {
^
SyntaxError: Unexpected token

好几个例子报这样的错误是怎么回事

感受你node版本过低

DeprecationWarning: Calling an asynchronous function wit
hout callback is deprecated.

3.4节使用async异步编程那里报了这个错,查了下,说这个API废弃了,你们是怎么解决的啊

有相似Express那种已经搭建好一点的koa框架模板吗?一些404,路由等都配置好了的

是koa-router不是koa-route,少了个r

引用张志成的发言:

是koa-router不是koa-route,少了个r

说错了,这两个插件都存在,koa-route貌似是官方的,可是koa-router的star多一点

引用kindhj的发言:

数据库逻辑处理呢。。?本人小白

sequelize

用koa架设http服务器的,来看下,之后可能会用到

引用业余草的发言:

讲的很详细!
Koa -- 基于 Node.js 平台的下一代 web 开发框架!

为何是下一代?比express有什么优点么?

好像有个小的笔误,应该是koa-router, 而不是koa-route

06.js 这句是多余的?

app.use(main);

比官网讲得好。每次有什么问题不懂,发现阮老师写过日志,就安心了

确实看到你的文章比较多,谢谢你的分享,会继续关注你的,但愿出些实用的高级课程学学

koa-route 和 koa-router 两个太像了!阮一峰用的 koa-route, 廖雪峰用的 koa-router

我想请问下在异步中间件的demo中main前面还能够增长其余中间件么?怎么加了好像会报错

5.2表单
ctx.body = ''
写错了

koa比express好不少,正在学习node,发现若是用express框架编写程序是要私人的感受,各类回掉,仍是koa比较正常一点,受教了!

引用小涛的发言:

好像有个小的笔误,应该是koa-router, 而不是koa-route

两个都是能够的

太棒了!受益不浅!! 前端学习这个感受像打开了新世界的大门!!感谢阮老师

Koa是默认127.0.0.1的主机名吗?在哪里能够更改

koa能够处理PUT请求吗?

最后一节的用来上传的那里有点不明白,能够展现一个跟html前台页面结合的上传代码吗

求出一个 koa 与 MongoDB 结合的 demo 教程

老师您好,我想问下,demos/09.js的示例为何我执行时触发了两次中间件?我看您的运行结果也只是触发一次呀

demos/05.js 与 demos/06.js 不彻底同样。http://127.0.0.1:3000/aboux 的结果就不同。

5.2 的示例中,中间件main里,并无 await 表示,为何main函数须要声明成 async?

引用alisx的发言:

5.2 的示例中,中间件main里,并无 await 表示,为何main函数须要声明成 async?

我去掉了main的async声明,结果一样有效

引用郭的发言:

不太理解为什么要作中间件的合成(koa-compose),阮一峰老师,不知这有什么应用的场景?既然都是中间件,都是按顺序执行,为什么还有作合成?是方便多个中间件,有公用的部分,可屡次应用在不一样中间件上?

赞成!!!!!
求解

引用业余草的发言:

讲的很详细!
Koa -- 基于 Node.js 平台的下一代 web 开发框架!

用了很久的express框架,忽然须要作一个blog,是基于koa而且用render后端渲染,确实koa是大势所趋

懂了好多,哈哈谢谢!

koa里能够用bootstrap吗?目前没找到较为详细的教程,使用中遇到不少问题

求解10.js运行报错是什么缘由呢 Unexpected token function

使用koa-body上传文件的时候,没法获取其余表单的值,这个要怎么办?

一年前还看不懂阮一峰老师的教程,如今感受简单易懂。

常常看阮一峰老师的博客,受益不少


$ curl -X POST --data "name=Jack" 127.0.0.1:3000
{"name":"Jack"}\

curl不是内部或外部命令,这个怎么解决,在window7下

今天发了一上午看完,教程简洁明了!入门法宝!很是谢谢老师!在你这里学到了不少东西!学会了不少!所谓“师傅引进门,修行看我的”,在前端这个行业,并无系统的专业教育(反正咱们学校没有),全靠自学和培训~-~。继续奋斗吧!

@lp:

我感受是由于若是有多个中间件须要使用,那么就得写多个app.use(),使用koa-compose的话直接把中间件写到参数中,最后只须要写一个app.use()便可

在5.2的代码示例中第4行
------------------
1 // demos/20.js
2 const koaBody = require('koa-body');

4 const main = async function(ctx) {
5 const body = ctx.request.body;
6 if (!body.name) ctx.throw(400, '.name required');
7 ctx.body = { name: body.name };
8 };
-------------------
main 是个异步方法,但从代码来看,没有异步的过程,请问
1 是否没有必要声明 async
2 是否出于将来代码变动考虑,将全部的方法都声明为 async,这样是好仍是很差?会有性能或其余问题吗?

谢谢!

引用灵谷的发言:

今天发了一上午看完,教程简洁明了!入门法宝!很是谢谢老师!在你这里学到了不少东西!学会了不少!所谓“师傅引进门,修行看我的”,在前端这个行业,并无系统的专业教育(反正咱们学校没有),全靠自学和培训~-~。继续奋斗吧!

同感!

看了后,有了初步的了解,比较简洁。

node 必须用7.6以上的版本, 写成了 “Koa 必须使用 7.6 以上的版本”

我在项目中也开始使用koa了

5.1 Cookies里面
因为favicon.icon 的http会执行两次,因此views前的数变成一、三、五、7。
须要用route规避一下

重定向这里
ctx.response.redirect('/');
ctx.response.body = 'Index Page';

第二行好像不执行 已经重定向走了 应该在 route.get('/', XXX)的route里写 才会输出吧
仍是我操做不对?请老师指教

“3.4 异步中间件”部分,
await fs.readFile('./demos/template.html', 'utf8')
显示报错,改为await fs.readFileSync('package.json','utf-8');就行了

koa-router 好像更利于项目工程

阮老师小弟是看你博客长大的

引用IndraNyo的发言:

重定向这里
ctx.response.redirect('/');
ctx.response.body = 'Index Page';

第二行好像不执行 已经重定向走了应该在 route.get('/', XXX)的route里写 才会输出吧
仍是我操做不对?请老师指教

我测试了一下,其实是有执行,可是执行以后被重定向的内容又覆盖掉了。

fs.readFile是回调的方法吧,await后面须要返回 Promise ,回调会报错。

通俗易懂

引用disguiser的发言:

不是很理解为何要把多个中间件合成为一个

画蛇添足

相关文章
相关标签/搜索