Publish the new version ✈️ | Look description please!

# FAQ

### Looking for free support?

	http://support.iris-go.com
    https://kataras.rocket.chat/channel/iris

### Looking for previous versions?

    https://github.com/kataras/iris#version

### Should I upgrade my Iris?

Developers are not forced to upgrade if they don't really need it. Upgrade whenever you feel ready.
> Iris uses the [vendor directory](https://docs.google.com/document/d/1Bz5-UB7g2uPBdOx-rw5t9MxJwkfpx90cqG9AFL0JAYo) feature, so you get truly reproducible builds, as this method guards against upstream renames and deletes.

**How to upgrade**: Open your command-line and execute this command: `go get -u github.com/kataras/iris`.
For further installation support, please click [here](http://support.iris-go.com/d/16-how-to-install-iris-web-framework).

### About our new home page
    http://iris-go.com

Thanks to [Santosh Anand](https://github.com/santoshanand) the http://iris-go.com has been upgraded and it's really awesome!

[Santosh](https://github.com/santoshanand) is a freelancer, he has a great knowledge of nodejs and express js, Android, iOS, React Native, Vue.js etc, if you need a developer to find or create a solution for your problem or task, please contact with him.

The amount of the next two or three donations you'll send they will be immediately transferred to his own account balance, so be generous please!

Read more at https://github.com/kataras/iris/blob/master/HISTORY.md


Former-commit-id: eec2d71bbe011d6b48d2526eb25919e36e5ad94e

_examples/intermediate/graceful-shutdown/basic/main.go

@@ -0,0 +1,48 @@
+package main
+
+import (
+	stdContext "context"
+	"time"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/core/host"
+)
+
+// Before continue, please read the below notes:
+//
+// Current version of Iris is auto-graceful on control+C/command+C
+// or whenever host's .Shutdown called.
+//
+// In order to add a custom interrupt handler(ctrl+c/cmd+c) or
+// shutdown manually you have to "schedule a host supervisor's task" or
+// use the core/host package manually or use a pure http.Server as we already seen at "custom-server" example.
+//
+// At this example, we will disable the interrupt handler and set our own interrupt handler.
+func main() {
+	app := iris.New()
+	// output startup banner and error logs on os.Stdout
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.HTML(" <h1>hi, I just exist in order to see if the server is closed</h1>")
+	})
+
+	// tasks are always running in their go-routine by-default.
+	//
+	// register custom interrupt handler, fires when ctrl+C/cmd+C pressed.
+	app.Scheduler.Schedule(host.OnInterrupt(func(proc host.TaskProcess) {
+		println("Shutdown the server gracefully...")
+
+		timeout := 5 * time.Second // give the server 5 seconds to wait for idle connections.
+		ctx, cancel := stdContext.WithTimeout(stdContext.Background(), timeout)
+		defer cancel()
+		proc.Host().Shutdown(ctx) // Shutdown the underline supervisor's server
+	}))
+
+	// Start the server and disable the default interrupt handler in order to use our scheduled interrupt task.
+	app.Run(iris.Addr(":8080"), iris.WithoutInterruptHandler)
+}
+
+// Note:
+// You can just use an http.Handler with your own signal notify channel and do that as you did with the net/http
+// package. I will not show this way, but you can find many examples on the internet.

_examples/intermediate/graceful-shutdown/custom-host/main.go

@@ -0,0 +1,72 @@
+package main
+
+import (
+	stdContext "context"
+	"net/http"
+	"time"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/core/host"
+)
+
+// The difference from its parent main.go is that
+// with a custom host we're able to call the host's shutdown
+// and be notified about its .Shutdown call.
+// Almost the same as before.
+func main() {
+	app := iris.New()
+	// output startup banner and error logs on os.Stdout
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.HTML(" <h1>hi, I just exist in order to see if the server is closed</h1>")
+	})
+
+	// build the framework when all routing-relative actions are declared.
+	if err := app.Build(); err != nil {
+		panic(err)
+	}
+
+	// create our custom host supervisor by adapting
+	// a custom http server
+	srv := host.New(&http.Server{Addr: ":8080", Handler: app})
+
+	// tasks are always running in their go-routine by-default.
+	//
+	// register custom interrupt handler, fires when ctrl+C/cmd+C pressed, as we did before.
+	srv.Schedule(host.OnInterrupt(func(proc host.TaskProcess) {
+		println("Shutdown the server gracefully...")
+
+		timeout := 5 * time.Second // give the server 5 seconds to wait for idle connections.
+		ctx, cancel := stdContext.WithTimeout(stdContext.Background(), timeout)
+		defer cancel()
+		proc.Host().DeferFlow() // defer the exit, in order to catch the event
+		srv.Shutdown(ctx)       // Shutdown the supervisor, only this way the proc.Host().Done will be notified
+		// the proc.Host().Shutdown, closes the underline server but no the supervisor.
+		// This behavior was choosen because is inneed for custom maintanance services
+		// (i.e restart server every week without loosing connections) which you can easly adapt with Iris.
+	}))
+
+	// schedule a task to be notify when the server was closed by our interrutp handler,
+	// optionally ofcourse.
+	srv.ScheduleFunc(func(proc host.TaskProcess) {
+		select {
+		case <-proc.Host().Done(): // when .Host.Shutdown(ctx) called.
+			println("Server was closed.")
+			proc.Host().RestoreFlow() // Restore the flow in order to exit(continue after the srv.ListenAndServe)
+		}
+	})
+
+	// Start our custom host
+	println("Server is running at :8080")
+	srv.ListenAndServe()
+	// Go to the console and press ctrl+c(for windows and linux) or cmd+c for osx.
+	// The output should be:
+	// Server is running at:8080
+	// Shutdown the server gracefully...
+	// Server was closed.
+}
+
+// Note:
+// You can just use an http.Handler with your own signal notify channel and do that as you did with the net/http
+// package. I will not show this way, but you can find many examples on the internet.

_examples/intermediate/graceful-shutdown/main.go

@@ -1,32 +0,0 @@
-package main
-
-import (
-	"context"
-	"time"
-
-	"gopkg.in/kataras/iris.v6"
-	"gopkg.in/kataras/iris.v6/adaptors/httprouter"
-)
-
-func main() {
-	app := iris.New()
-	// output startup banner and error logs on os.Stdout
-	app.Adapt(iris.DevLogger())
-	// set the router, you can choose gorillamux too
-	app.Adapt(httprouter.New())
-
-	app.Get("/hi", func(ctx *iris.Context) {
-		ctx.HTML(iris.StatusOK, " <h1>hi, I just exist in order to see if the server is closed</h1>")
-	})
-
-	app.Adapt(iris.EventPolicy{
-		// Interrupt Event means when control+C pressed on terminal.
-		Interrupted: func(*iris.Framework) {
-			// shut down gracefully, but wait 5 seconds the maximum before closed
-			ctx, _ := context.WithTimeout(context.Background(), 5*time.Second)
-			app.Shutdown(ctx)
-		},
-	})
-
-	app.Listen(":8080")
-}