handler.go

package http

import (
	"net"
	"net/http"
	"strconv"
	"strings"
	"sync"
	"time"

	"github.com/hashicorp/go-multierror"
	"github.com/spiral/errors"
	"github.com/spiral/roadrunner-plugins/logger"
	"github.com/spiral/roadrunner/v2/interfaces/events"
	"github.com/spiral/roadrunner/v2/interfaces/pool"
)

const (
	// EventResponse thrown after the request been processed. See ErrorEvent as payload.
	EventResponse = iota + 500

	// EventError thrown on any non job error provided by road runner server.
	EventError
)

const MB = 1024 * 1024

type Handle interface {
	AddListener(l events.EventListener)
	ServeHTTP(w http.ResponseWriter, r *http.Request)
}

// ErrorEvent represents singular http error event.
type ErrorEvent struct {
	// Request contains client request, must not be stored.
	Request *http.Request

	// Error - associated error, if any.
	Error error

	// event timings
	start   time.Time
	elapsed time.Duration
}

// Elapsed returns duration of the invocation.
func (e *ErrorEvent) Elapsed() time.Duration {
	return e.elapsed
}

// ResponseEvent represents singular http response event.
type ResponseEvent struct {
	// Request contains client request, must not be stored.
	Request *Request

	// Response contains service response.
	Response *Response

	// event timings
	start   time.Time
	elapsed time.Duration
}

// Elapsed returns duration of the invocation.
func (e *ResponseEvent) Elapsed() time.Duration {
	return e.elapsed
}

// Handler serves http connections to underlying PHP application using PSR-7 protocol. Context will include request headers,
// parsed files and query, payload will include parsed form dataTree (if any).
type handler struct {
	maxRequestSize uint64
	uploads        UploadsConfig
	trusted        Cidrs
	log            logger.Logger
	pool           pool.Pool
	mul            sync.Mutex
	lsn            events.EventListener
}

func NewHandler(maxReqSize uint64, uploads UploadsConfig, trusted Cidrs, pool pool.Pool) (Handle, error) {
	if pool == nil {
		return nil, errors.E(errors.Str("pool should be initialized"))
	}
	return &handler{
		maxRequestSize: maxReqSize * MB,
		uploads:        uploads,
		pool:           pool,
		trusted:        trusted,
	}, nil
}

// Listen attaches handler event controller.
func (h *handler) AddListener(l events.EventListener) {
	h.mul.Lock()
	defer h.mul.Unlock()

	h.lsn = l
}

// mdwr serve using PSR-7 requests passed to underlying application. Attempts to serve static files first if enabled.
func (h *handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	const op = errors.Op("ServeHTTP")
	start := time.Now()

	// validating request size
	if h.maxRequestSize != 0 {
		err := h.maxSize(w, r, start, op)
		if err != nil {
			return
		}
	}

	req, err := NewRequest(r, h.uploads)
	if err != nil {
		h.handleError(w, r, err, start)
		return
	}

	// proxy IP resolution
	h.resolveIP(req)

	req.Open(h.log)
	defer req.Close(h.log)

	p, err := req.Payload()
	if err != nil {
		h.handleError(w, r, err, start)
		return
	}

	rsp, err := h.pool.Exec(p)
	if err != nil {
		h.handleError(w, r, err, start)
		return
	}

	resp, err := NewResponse(rsp)
	if err != nil {
		h.handleError(w, r, err, start)
		return
	}

	h.handleResponse(req, resp, start)
	err = resp.Write(w)
	if err != nil {
		h.handleError(w, r, err, start)
	}
}

func (h *handler) maxSize(w http.ResponseWriter, r *http.Request, start time.Time, op errors.Op) error {
	if length := r.Header.Get("content-length"); length != "" {
		if size, err := strconv.ParseInt(length, 10, 64); err != nil {
			h.handleError(w, r, err, start)
			return err
		} else if size > int64(h.maxRequestSize) {
			h.handleError(w, r, errors.E(op, errors.Str("request body max size is exceeded")), start)
			return err
		}
	}
	return nil
}

// handleError sends error.
func (h *handler) handleError(w http.ResponseWriter, r *http.Request, err error, start time.Time) {
	h.mul.Lock()
	defer h.mul.Unlock()
	// if pipe is broken, there is no sense to write the header
	// in this case we just report about error
	if err == errEPIPE {
		h.throw(ErrorEvent{Request: r, Error: err, start: start, elapsed: time.Since(start)})
		return
	}
	err = multierror.Append(err)
	// ResponseWriter is ok, write the error code
	w.WriteHeader(500)
	_, err2 := w.Write([]byte(err.Error()))
	// error during the writing to the ResponseWriter
	if err2 != nil {
		err = multierror.Append(err2, err)
		// concat original error with ResponseWriter error
		h.throw(ErrorEvent{Request: r, Error: errors.E(err), start: start, elapsed: time.Since(start)})
		return
	}
	h.throw(ErrorEvent{Request: r, Error: err, start: start, elapsed: time.Since(start)})
}

// handleResponse triggers response event.
func (h *handler) handleResponse(req *Request, resp *Response, start time.Time) {
	h.throw(ResponseEvent{Request: req, Response: resp, start: start, elapsed: time.Since(start)})
}

// throw invokes event handler if any.
func (h *handler) throw(event interface{}) {
	if h.lsn != nil {
		h.lsn(event)
	}
}

// get real ip passing multiple proxy
func (h *handler) resolveIP(r *Request) {
	if h.trusted.IsTrusted(r.RemoteAddr) == false {
		return
	}

	if r.Header.Get("X-Forwarded-For") != "" {
		ips := strings.Split(r.Header.Get("X-Forwarded-For"), ",")
		ipCount := len(ips)

		for i := ipCount - 1; i >= 0; i-- {
			addr := strings.TrimSpace(ips[i])
			if net.ParseIP(addr) != nil {
				r.RemoteAddr = addr
				return
			}
		}

		return
	}

	// The logic here is the following:
	// In general case, we only expect X-Real-Ip header. If it exist, we get the IP address from header and set request Remote address
	// But, if there is no X-Real-Ip header, we also trying to check CloudFlare headers
	// True-Client-IP is a general CF header in which copied information from X-Real-Ip in CF.
	// CF-Connecting-IP is an Enterprise feature and we check it last in order.
	// This operations are near O(1) because Headers struct are the map type -> type MIMEHeader map[string][]string
	if r.Header.Get("X-Real-Ip") != "" {
		r.RemoteAddr = fetchIP(r.Header.Get("X-Real-Ip"))
		return
	}

	if r.Header.Get("True-Client-IP") != "" {
		r.RemoteAddr = fetchIP(r.Header.Get("True-Client-IP"))
		return
	}

	if r.Header.Get("CF-Connecting-IP") != "" {
		r.RemoteAddr = fetchIP(r.Header.Get("CF-Connecting-IP"))
	}
}