Node 主要用在开发 Web 应用。这决定了使用 Node,往往离不开 Web 应用框架。
Koa 就是一种简单好用的 Web 框架。它的特点是优雅、简洁、表达力强、自由度高。本身代码只有1000多行,所有功能都通过插件实现,很符合 Unix 哲学。
本文从零开始,循序渐进,教会你如何使用 Koa 写出自己的 Web 应用。每一步都有简洁易懂的示例,希望让大家一看就懂。
零、准备
首先,检查 Node 版本。
$ node -v v8.0.0
Koa 必须使用 7.6 以上的版本。如果你的版本低于这个要求,就要先升级 Node。
然后,克隆本文的配套示例库。(如果不方便使用 Git,也可以下载 zip 文件解压。)
$ git clone https://github.com/ruanyf/koa-demos.git
接着,进入示例库,安装依赖。
$ cd koa-demos $ npm install
所有示例源码,都在 demos 目录下面。
一、基本用法
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.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.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)的顺序执行。
- 最外层的中间件首先执行。
- 调用
next
函数,把执行权交给下一个中间件。- ...
- 最内层的中间件最后执行。
- 执行结束后,把执行权交回上一层的中间件。
- ...
- 最外层的中间件收回执行权之后,执行
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.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
。
五、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"]
六、参考链接
(完)
龙卷 说:
正在用koa 教程这就来了!
2017年8月 9日 08:35 | # | 引用
韩帅 说:
简单易用
2017年8月 9日 09:15 | # | 引用
业余草 说:
讲的很详细!
Koa -- 基于 Node.js 平台的下一代 web 开发框架!
2017年8月 9日 09:22 | # | 引用
陈恺垣 说:
感谢,之前一直在用express
2017年8月 9日 09:36 | # | 引用
理斯特 说:
阮老师为啥不直接介绍 egg.js
2017年8月 9日 09:40 | # | 引用
disguiser 说:
不是很理解为什么要把多个中间件合成为一个
2017年8月 9日 10:26 | # | 引用
MarshallStan 说:
感谢阮一峰老师。
2017年8月 9日 10:33 | # | 引用
wuyang 说:
讲的很详细 赞
2017年8月 9日 12:32 | # | 引用
shadow 说:
感谢分享~前几天刚好在入门Koa2
2017年8月 9日 13:38 | # | 引用
csjiabin 说:
koa和express哪个比较好 我现在一直在用express 听说koa小 想试试
2017年8月 9日 13:50 | # | 引用
郭 说:
不太理解为何要做中间件的合成(koa-compose),阮一峰老师,不知这有什么应用的场景?既然都是中间件,都是按顺序执行,为何还有做合成?是方便多个中间件,有公用的部分,可多次应用在不同中间件上?
2017年8月 9日 15:42 | # | 引用
诗与远方 说:
正在学习koa2!
2017年8月 9日 15:59 | # | 引用
magicbing 说:
感觉koa和express都是简洁的小框架。
像ror或者django那种大框架好像有sails和adonis,不过感觉也不是很成熟
2017年8月 9日 16:32 | # | 引用
CODE大全 说:
阮老师的文章都是图文并茂,而且demo和源码都很详细!koa框架正在学习中!
2017年8月 9日 16:54 | # | 引用
cshenger 说:
阮老师的入门系列一向简介明了
2017年8月 9日 17:49 | # | 引用
cdd 说:
我记得koa文档中koa.request/koa.response是其自身封装的对象吧。koa.req/koa.res是node的对象。
2017年8月 9日 19:38 | # | 引用
李家梁 说:
我用koa2几个月了,
路由用的最多的是koa-router,
文件上传可以试试koa-multer
2017年8月 9日 19:43 | # | 引用
久伴我暖 说:
膜拜一下前端界的大佬。分享了最新又是值得学习的框架,学习前留个言。
2017年8月 9日 22:05 | # | 引用
MorningTZH 说:
哈哈哈 我也是,瞌睡送枕头呢。
2017年8月 9日 22:40 | # | 引用
宇宙全栈 说:
是时候从 express 换到 koa 了!
2017年8月10日 11:41 | # | 引用
Naomi 说:
node 检查出来是6的版本,但是用brew更新的是8的版本,会有影响吗
2017年8月10日 12:22 | # | 引用
MurakamiKennzo 说:
受益匪浅
2017年8月10日 15:55 | # | 引用
阮荣军 说:
passport 官网 http://www.passportjs.org/
2017年8月10日 16:10 | # | 引用
安晗 说:
非常想提升一下自身作为web前端的能力和素质,看了一些帖子,都推荐来看一下阮老师的教程,以后我会多多关注您,把您的教程都好好学习,祝阮老师身体健康,为我们写出更多的精品教程。
2017年8月10日 16:36 | # | 引用
feilong 说:
Error: Cannot find module 'koa' = =,老师怎么回事?
2017年8月10日 17:44 | # | 引用
桂梅桑 说:
清晰明了~
2017年8月10日 21:56 | # | 引用
coldxu 说:
阮老师写的太全了,几乎初学所有点都涵盖到了,感谢。
2017年8月10日 22:43 | # | 引用
Phlip 说:
阮老师,求分享算法和互联网架构的内容。
2017年8月11日 14:33 | # | 引用
刘煜 说:
你没有安装依赖,在node demos/01.js之前,你需要命令行执行npm install
2017年8月14日 15:05 | # | 引用
distance 说:
好小巧啊~~以前一点点地开始学node.js感觉什么都要自己考虑到,各种处理。后来看了express,使用起来方便多了,也很小巧~~现在又在这里看了koa
2017年8月14日 15:05 | # | 引用
vista-hey 说:
阮老师 ··又是4个多月才等的您的一次更新··但是值得
2017年8月14日 18:03 | # | 引用
wells 说:
官方文档是这样
2017年8月14日 20:06 | # | 引用
van 说:
3.5 中件 是中间件吧,少打了一个字。
2017年8月15日 16:57 | # | 引用
阮一峰 说:
@van:谢谢指出,已经改正了。
2017年8月15日 18:12 | # | 引用
kindhj 说:
数据库逻辑处理呢。。?本人小白
2017年8月15日 19:55 | # | 引用
bianhognfei 说:
阮哥你好,你都用什么工具写博客的,我现在也想做一个自己的博客,来写博客。
2017年8月21日 16:23 | # | 引用
ovnrain 说:
用Koa自己写一个啊^_^
2017年8月23日 18:56 | # | 引用
谢东磊 说:
const handler = async (ctx, next) => {
^
SyntaxError: Unexpected token
好几个例子报这样的错误是怎么回事
2017年8月25日 22:29 | # | 引用
~~~ 说:
@谢东磊:
不识别箭头函数吧
2017年8月28日 17:51 | # | 引用
mdz 说:
为什么路由介绍使用的是koa-route没有使用koa-router
2017年8月29日 13:08 | # | 引用
十三 说:
koa2 因为需要async await 的原因需要node版本在7以上,koa1不需要
2017年9月 2日 18:09 | # | 引用
hdp 说:
2017年9月 8日 13:33 | # | 引用
linzx 说:
DeprecationWarning: Calling an asynchronous function wit
hout callback is deprecated.
3.4节使用async异步编程那里报了这个错,查了下,说这个API废弃了,大家是怎么解决的啊
2017年9月13日 22:53 | # | 引用
达文西12138 说:
有类似Express那种已经搭建好一点的koa框架模板吗?一些404,路由等都配置好了的
2017年9月14日 16:21 | # | 引用
张志成 说:
是koa-router不是koa-route,少了个r
2017年9月23日 22:45 | # | 引用
张志成 说:
说错了,这两个插件都存在,koa-route貌似是官方的,但是koa-router的star多一点
2017年9月23日 23:29 | # | 引用
老黄 说:
sequelize
2017年9月25日 16:40 | # | 引用
海的女儿前端博客 说:
用koa架设http服务器的,来看下,以后可能会用到
2017年10月 9日 16:34 | # | 引用
microbingbing 说:
为什么是下一代?比express有什么优势么?
2017年10月11日 16:35 | # | 引用
小涛 说:
好像有个小的笔误,应该是koa-router, 而不是koa-route
2017年10月14日 10:38 | # | 引用
顿顿 说:
06.js 这句是多余的?
app.use(main);
2017年10月21日 00:23 | # | 引用
G小健 说:
比官网讲得好。每次有什么问题不懂,发现阮老师写过日志,就安心了
2017年10月25日 16:53 | # | 引用
hackjay 说:
确实看到你的文章比较多,谢谢你的分享,会继续关注你的,希望出些实用的高级课程学学
2017年11月10日 18:08 | # | 引用
GS 说:
koa-route 和 koa-router 两个太像了!阮一峰用的 koa-route, 廖雪峰用的 koa-router
2017年11月14日 14:34 | # | 引用
JQ_Chan 说:
我想请问下在异步中间件的demo中main前面还可以增加其他中间件么?怎么加了好像会报错
2017年12月 8日 16:22 | # | 引用
stillyu 说:
5.2表单
ctx.body = ''
写错了
2017年12月21日 12:51 | # | 引用
王 说:
koa比express好很多,正在学习node,发现如果用express框架编写程序是要私人的感觉,各种回掉,还是koa比较正常一点,受教了!
2017年12月27日 02:33 | # | 引用
青伢子 说:
两个都是可以的
2018年1月10日 23:45 | # | 引用
金牌红豆 说:
太棒了!受益匪浅!! 前端学习这个感觉像打开了新世界的大门!!感谢阮老师
2018年1月19日 16:52 | # | 引用
姜珊 说:
Koa是默认127.0.0.1的主机名吗?在哪里可以更改
2018年1月25日 20:24 | # | 引用
姜珊 说:
koa可以处理PUT请求吗?
2018年1月27日 10:03 | # | 引用
杨毅 说:
最后一节的用来上传的那里有点不明白,可以展示一个跟html前台页面结合的上传代码吗
2018年1月29日 15:05 | # | 引用
ranyingxia 说:
求出一个 koa 与 MongoDB 结合的 demo 教程
2018年2月 5日 18:11 | # | 引用
王泽 说:
老师您好,我想问下,demos/09.js的示例为什么我执行时触发了两次中间件?我看您的运行结果也只是触发一次呀
2018年2月 8日 22:43 | # | 引用
k 说:
demos/05.js 与 demos/06.js 不完全一样。http://127.0.0.1:3000/aboux 的结果就不一样。
2018年2月20日 13:03 | # | 引用
alisx 说:
5.2 的示例中,中间件main里,并没有 await 表示,为什么main函数需要声明成 async?
2018年2月24日 11:56 | # | 引用
alisx 说:
我去掉了main的async声明,结果同样有效
2018年2月24日 12:01 | # | 引用
lp 说:
同意!!!!!
求解
2018年2月26日 11:41 | # | 引用
好久不见 说:
用了好久的express框架,突然需要做一个blog,是基于koa并且用render后端渲染,确实koa是大势所趋
2018年2月26日 11:47 | # | 引用
Sumii 说:
懂了好多,哈哈谢谢!
2018年2月27日 15:19 | # | 引用
1Q84 说:
koa里可以用bootstrap吗?目前没找到较为详细的教程,使用中遇到很多问题
2018年3月 1日 12:52 | # | 引用
ben 说:
求解10.js运行报错是什么原因呢 Unexpected token function
2018年3月20日 11:48 | # | 引用
杨毅 说:
使用koa-body上传文件的时候,无法获取其他表单的值,这个要怎么办?
2018年3月27日 09:56 | # | 引用
小迈克 说:
一年前还看不懂阮一峰老师的教程,现在感觉简单易懂。
2018年4月 7日 13:34 | # | 引用
嘿嘿 说:
经常看阮一峰老师的博客,受益很多
2018年4月 7日 17:12 | # | 引用
Casey 说:
$ curl -X POST --data "name=Jack" 127.0.0.1:3000
{"name":"Jack"}\
curl不是内部或外部命令,这个怎么解决,在window7下
2018年4月10日 09:43 | # | 引用
灵谷 说:
今天发了一上午看完,教程简洁明了!入门法宝!非常谢谢老师!在你这里学到了很多东西!学会了很多!所谓“师傅引进门,修行看个人”,在前端这个行业,并没有系统的专业教育(反正我们学校没有),全靠自学和培训~-~。继续奋斗吧!
2018年4月13日 13:50 | # | 引用
wopelo 说:
@lp:
我感觉是因为如果有多个中间件需要使用,那么就得写多个app.use(),使用koa-compose的话直接把中间件写到参数中,最后只需要写一个app.use()即可
2018年4月16日 15:25 | # | 引用
alisx 说:
在5.2的代码示例中第4行
------------------
1 // demos/20.js
2 const koaBody = require('koa-body');
3
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,这样是好还是不好?会有性能或其他问题吗?
谢谢!
2018年4月24日 18:33 | # | 引用
天天 说:
同感!
2018年5月 9日 10:35 | # | 引用
scs 说:
看了后,有了初步的了解,比较简洁。
2018年6月11日 09:37 | # | 引用
dearest 说:
node 必须用7.6以上的版本, 写成了 “Koa 必须使用 7.6 以上的版本”
2018年6月21日 14:47 | # | 引用
青格勒 说:
我在项目中也开始使用koa了
2018年7月 8日 17:52 | # | 引用
yinsang 说:
5.1 Cookies里面
由于favicon.icon 的http会执行两次,所以views前的数变成1、3、5、7。
需要用route规避一下
2018年7月12日 10:12 | # | 引用
IndraNyo 说:
重定向这里
ctx.response.redirect('/');
ctx.response.body = 'Index Page';
第二行好像不执行 已经重定向走了 应该在 route.get('/', XXX)的route里写 才会输出吧
还是我操作不对?请老师指教
2018年7月31日 14:35 | # | 引用
jackletter 说:
“3.4 异步中间件”部分,
await fs.readFile('./demos/template.html', 'utf8')
显示报错,改成await fs.readFileSync('package.json','utf-8');就好了
2018年8月 8日 11:40 | # | 引用
Ed Me 说:
koa-router 好像更利于项目工程
2018年8月16日 15:37 | # | 引用
Jack Chen 说:
阮老师小弟是看你博客长大的
2018年9月 8日 14:24 | # | 引用
郭小帅 说:
我测试了一下,实际上是有执行,但是执行之后被重定向的内容又覆盖掉了。
2018年9月10日 18:08 | # | 引用
意外金喜 说:
fs.readFile是回调的方法吧,await后面需要返回 Promise ,回调会报错。
2018年9月13日 14:18 | # | 引用
xiaohuangmao 说:
通俗易懂
2018年9月14日 10:07 | # | 引用
hooper 说:
多此一举
2018年9月19日 18:00 | # | 引用
耿振培 说:
正在学习中,是看到thinkjs 基于这个框架才来学习的
2018年9月26日 10:11 | # | 引用
sleepq123 说:
报错是:废弃了没有回调函数的readFile
那么我们就加个回调函数不就OK了么
这个是我的例子
const fs = require('fs')
const koa = require('./node_modules/koa')
const Router = require('./node_modules/koa-router')
const app = new koa()
const router = new Router()
//封装readfile
const readFile = function(url){
return new Promise((resovle,reject)=>{
fs.readFile(url,'utf8',(err,data)=>{
if(err) reject(err)
resovle(data)
})
})
}
const main =async function(ctx,next){
ctx.response.type = 'html';
ctx.response.body = await readFile('demo.html')
}
app.use(main);
app.listen(3000)
2018年10月 7日 14:07 | # | 引用
sleepq123 说:
PS:阮老师,最近在学习您的教程,上面的教程有个问题(官方有改了一些东西)
(((使用koa-body 完成文件上传)))
您是使用ctx.request.body.files
官方为了安全,在koa-body新版本中采用ctx.request.files获取上传的文件
2018年10月 7日 16:50 | # | 引用
陈家洛 说:
文章讲解清晰明了 , 很喜欢你的文章, 经常看.
2018年10月 8日 17:24 | # | 引用
唐文博 说:
demo4:ctx.response.body = fs.createReadStream('./demos/template.html')地址错了,../demos/template.html或者./template.html
2018年10月28日 00:36 | # | 引用
xiaoxiong 说:
fs promise化了吧
2018年10月31日 16:38 | # | 引用
网友QAQ 说:
node社区的组件为啥老是改API。。。几乎所有现有教程都避不开这个讨厌的问题
2018年11月 2日 17:09 | # | 引用
treo 说:
准备看下koa啦~
2018年11月20日 16:18 | # | 引用
上校 说:
koa 怎样实现 通过域名分发路由
2018年11月26日 15:22 | # | 引用
前端开发 说:
文章要是有目录就更好了
2019年1月18日 17:11 | # | 引用
hank 说:
koa现在用的范围多吗
2019年2月25日 17:17 | # | 引用
冷风 说:
有 koa-virtual-host 插件
2019年3月 4日 14:26 | # | 引用
崮生 说:
在koa-body新版本中采用ctx.request.files获取上传的文件
2019年4月 2日 09:17 | # | 引用
ZHAOs 说:
太高效的教程了,这一页文档跟看了一本1000页的书的感觉似的。
对于一个熟手程序员来说,这种程度的言简意赅就是最合适的,大部分都懂得不说就行
2019年5月 9日 17:46 | # | 引用
大名 说:
好文章,言简意赅,坐等更新
2019年5月14日 13:19 | # | 引用
kube 说:
koa2的教程应该也有吧,目前还没看到有什么区别
2019年6月 5日 10:30 | # | 引用
好好学习 说:
一开始学的express,现在感觉koa更麻烦啊,和node一样要各种判断什么的
2019年7月12日 16:32 | # | 引用
小丸子 说:
老师,您好,提个小小的建议。
在demo5中,只判断了当前路由不为'/',就可以展示为Index Page的链接,下文中写了 访问 http://127.0.0.1:3000/about ,可以看到一个链接。这样写会让大家觉得是有歧义吧,事实是随便哪个路由(只要不是根路由)都可以看到这个链接。一个小小建议
2019年9月15日 15:53 | # | 引用
王路遥 说:
想看阮一峰老师的egg介绍
2019年10月25日 15:17 | # | 引用
六只鱼 说:
跑了一下阮老师的 cookie 那个示例,发现每次刷新页面是增加2,后来通过打印n发现可能是由于koa区别于express的「洋葱」模式的中间件执行机制,所以并不是每次刷新页面增加1
不过对于具体原因我不是很明确,感觉就是由于koa独特的中间件执行机制
2019年12月19日 10:35 | # | 引用
苗方超 说:
const state = new Promise((resolve,reject)=>{
const stream = read.pipe(write)
stream.on('error',err=>{
console.log(err)
resolve('出错了,上传失败')
})
stream.on('finish',()=>{
resolve( "上传完成")
})
})
ctx.body = await state
回调中设置ctx.body没用,必须await。这个太坑了 弄了一下午
2020年7月31日 18:31 | # | 引用
anyOne 说:
这个评论系统用的是什么呢
2022年3月11日 12:18 | # | 引用
月下追寡妇 说:
比如api中间件,可以先用户校验,在权限校验这样就可以整合一个中间件
2024年6月21日 15:14 | # | 引用