docs: add server middleware and plugins explanation

This commit is contained in:
Alper Doğan 2023-07-15 18:35:53 +03:00
parent d1e3f53a36
commit d9ee37a31e

View File

@ -4,7 +4,7 @@ description: Using server directory to create middlewares, plugins and API easil
# Server Directory
Nuxt scans files and create middlewares, plugins and API routes to create features to use inside components or pages.
Nuxt scans files under server directory to create middlewares, plugins and API routes to create features to use inside components or pages.
Each file under these folders must return a function defined with `defineEventHandler()`.
@ -32,3 +32,21 @@ Server route file will automatically match with `GET` method and it can be chang
Routes may accept parameters, body and query parameters to get some values.
:ReadMore{link="/docs/guide/directory-structure/server#matching-route-parameters"}
## Server Middleware
Nuxt will read anything under `~/server/middleware` folder and create middlewares for you to tweak request information.
```ts [server/middleware/log.ts]
export default defineEventHandler((event) => {
event.context.auth = { user: 123 }
})
```
:ReadMore{link="/docs/guide/directory-structure/server#server-middleware"}
## Server Plugins
Any files under `~/server/plugins` folder will be registered as Nitro Plugin for changing [Nitro](https://nitro.unjs.io/)'s behavior.
:ReadMore{link="/docs/guide/directory-structure/server#server-plugins"}