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"`

	// 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 header this entry answers for.
	Domain string `yaml:"domain"`

	// Aliases are further Host headers reaching the same site. They are the
	// same site, not copies 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.
	Aliases []string `yaml:"aliases"`

	// 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"`
}