config

type Config struct {
	Runner    runner.Options `yaml:"runner"`
	Flatstack Flatstack      `yaml:"flatstack"`
	Routes    Routes         `yaml:"routes"`
	Server    Server         `yaml:"server"`
	Telemetry Telemetry      `yaml:"telemetry"`
	Env       []string       `yaml:"env"`

	// DocumentRoot is the directory beneath the application root that is
	// served over HTTP. It is "public" and almost never worth setting; it
	// exists for a site whose tree already names that directory something
	// else.
	DocumentRoot string `yaml:"document_root"`

	// Autoindex answers a directory that has no index page with a listing of
	// what is in it, the way nginx's autoindex does. It is off, because
	// publishing every file below the document root is a decision a site
	// makes and not one it should arrive at by leaving an index.html out.
	Autoindex bool `yaml:"autoindex"`

	// VirtualHost is the list of sites this server routes by domain. Each
	// entry names an application root whose phpscript.yml is the
	// configuration that site runs under.
	VirtualHost []VirtualHost `yaml:"virtualhost"`
}

type Flatstack struct {
	Enabled bool `yaml:"enabled"`
}

type Routes struct {
	Enabled bool `yaml:"enabled"`
}

type Server struct {
	// Addr is the address the HTTP server listens on.
	Addr string `yaml:"addr"`

	// Quiet turns down platform lifecycle logging.
	Quiet bool `yaml:"quiet"`

	// Modules limits which platform modules load, by name. An empty list
	// loads all of them.
	Modules []string `yaml:"modules"`
}

type Telemetry struct {
	telemetry.Options `yaml:",inline"`
	Driver            string `yaml:"driver"`
	StoragePath       string `yaml:"storage_path"`
}

type VirtualHost struct {
	// Domain is the Host headers this entry answers for, separated by
	// spaces. Every name reaches the same site, not a copy of it: one
	// application root, one configuration, one set of connections and one
	// recorder, no matter which name a request arrived under. The usual case
	// is a bare domain and its www form, "example.com www.example.com".
	//
	// The first name is the site's own, the one it is reported under.
	Domain string `yaml:"domain"`

	// Root is the application root, the directory holding the site's
	// phpscript.yml.
	Root string `yaml:"root"`

	// DocumentRoot is the directory under Root served over HTTP. It defaults
	// to public and rarely needs setting: it is here for a site whose tree
	// already names that directory something else, not a field an operator is
	// expected to fill in.
	DocumentRoot string `yaml:"document_root"`
}