Skip to main content

Static Files

Images, JavaScript, CSS, PDF, Fonts and so on...

Using Static Middleware

See

Using Echo#Static()

Echo#Static(prefix, root string) registers a new route with path prefix to serve static files from the provided root directory.

Usage 1

e := echo.New()
e.Static("/static","assets")

Example above will serve any file from the assets directory for path /static/*. For example, a request to /static/js/main.js will fetch and serve assets/js/main.js file.

Usage 2

e := echo.New()
e.Static("/","assets")

Example above will serve any file from the assets directory for path /*. For example, a request to /js/main.js will fetch and serve assets/js/main.js file.

Using Echo#StaticFS()

Static files can be served from an embed.FS instance. Be sure to use echo.MustSubFS as embed.FS includes subdirectories as their own entries and staticFS needs to server files from the correct root directory.

//go:embed "assets/images"
var images embed.FS

funcmain(){
e := echo.New()

e.StaticFS("/images", echo.MustSubFS(images,"assets/images"))

sc := echo.StartConfig{Address:":1323"}
if err := sc.Start(context.Background(), e); err !=nil{
e.Logger.Error("failed to start server","error", err)
}
}

Using Echo#File()

Echo#File(path, file string) registers a new route with path to serve a static file.

Usage 1

Serving an index page from public/index.html

e.File("/","public/index.html")

Usage 2

Serving a favicon from images/favicon.ico

e.File("/favicon.ico","images/favicon.ico")

AltStyle によって変換されたページ (->オリジナル) /