No OneTemporary
Actions

Size

41 KB

Referenced Files

None

Subscribers

None

View Options

	diff --git a/src/applications/config/issue/PhabricatorSetupIssue.php b/src/applications/config/issue/PhabricatorSetupIssue.php
	index a2e9532ede..cadedfc7da 100644
	--- a/src/applications/config/issue/PhabricatorSetupIssue.php
	+++ b/src/applications/config/issue/PhabricatorSetupIssue.php
	@@ -1,230 +1,231 @@
	<?php

	final class PhabricatorSetupIssue extends Phobject {

	private $issueKey;
	private $name;
	private $message;
	private $isFatal;
	private $summary;
	private $shortName;
	private $group;
	private $databaseRef;

	private $isIgnored = false;
	private $phpExtensions = array();
	private $phabricatorConfig = array();
	private $relatedPhabricatorConfig = array();
	private $phpConfig = array();
	private $commands = array();
	private $mysqlConfig = array();
	private $originalPHPConfigValues = array();
	private $links;

	public static function newDatabaseConnectionIssue(
	Exception $ex,
	$is_fatal) {

	$message = pht(
	"Unable to connect to MySQL!\n\n".
	"%s\n\n".
	- "Make sure Phabricator and MySQL are correctly configured.",
	+ "Make sure databases connection information and MySQL are ".
	+ "correctly configured.",
	$ex->getMessage());

	$issue = id(new self())
	->setIssueKey('mysql.connect')
	->setName(pht('Can Not Connect to MySQL'))
	->setMessage($message)
	->setIsFatal($is_fatal)
	->addRelatedPhabricatorConfig('mysql.host')
	->addRelatedPhabricatorConfig('mysql.port')
	->addRelatedPhabricatorConfig('mysql.user')
	->addRelatedPhabricatorConfig('mysql.pass');

	if (PhabricatorEnv::getEnvConfig('cluster.databases')) {
	$issue->addRelatedPhabricatorConfig('cluster.databases');
	}

	return $issue;
	}

	public function addCommand($command) {
	$this->commands[] = $command;
	return $this;
	}

	public function getCommands() {
	return $this->commands;
	}

	public function setShortName($short_name) {
	$this->shortName = $short_name;
	return $this;
	}

	public function getShortName() {
	if ($this->shortName === null) {
	return $this->getName();
	}
	return $this->shortName;
	}

	public function setDatabaseRef(PhabricatorDatabaseRef $database_ref) {
	$this->databaseRef = $database_ref;
	return $this;
	}

	public function getDatabaseRef() {
	return $this->databaseRef;
	}

	public function setGroup($group) {
	$this->group = $group;
	return $this;
	}

	public function getGroup() {
	if ($this->group) {
	return $this->group;
	} else {
	return PhabricatorSetupCheck::GROUP_OTHER;
	}
	}

	public function setName($name) {
	$this->name = $name;
	return $this;
	}

	public function getName() {
	return $this->name;
	}

	public function setSummary($summary) {
	$this->summary = $summary;
	return $this;
	}

	public function getSummary() {
	if ($this->summary === null) {
	return $this->getMessage();
	}
	return $this->summary;
	}

	public function setIssueKey($issue_key) {
	$this->issueKey = $issue_key;
	return $this;
	}

	public function getIssueKey() {
	return $this->issueKey;
	}

	public function setIsFatal($is_fatal) {
	$this->isFatal = $is_fatal;
	return $this;
	}

	public function getIsFatal() {
	return $this->isFatal;
	}

	public function addPHPConfig($php_config) {
	$this->phpConfig[] = $php_config;
	return $this;
	}

	/**
	* Set an explicit value to display when showing the user PHP configuration
	* values.
	*
	* If Phabricator has changed a value by the time a config issue is raised,
	* you can provide the original value here so the UI makes sense. For example,
	* we alter `memory_limit` during startup, so if the original value is not
	* provided it will look like it is always set to `-1`.
	*
	* @param string PHP configuration option to provide a value for.
	* @param string Explicit value to show in the UI.
	* @return this
	*/
	public function addPHPConfigOriginalValue($php_config, $value) {
	$this->originalPHPConfigValues[$php_config] = $value;
	return $this;
	}

	public function getPHPConfigOriginalValue($php_config, $default = null) {
	return idx($this->originalPHPConfigValues, $php_config, $default);
	}

	public function getPHPConfig() {
	return $this->phpConfig;
	}

	public function addMySQLConfig($mysql_config) {
	$this->mysqlConfig[] = $mysql_config;
	return $this;
	}

	public function getMySQLConfig() {
	return $this->mysqlConfig;
	}

	public function addPhabricatorConfig($phabricator_config) {
	$this->phabricatorConfig[] = $phabricator_config;
	return $this;
	}

	public function getPhabricatorConfig() {
	return $this->phabricatorConfig;
	}

	public function addRelatedPhabricatorConfig($phabricator_config) {
	$this->relatedPhabricatorConfig[] = $phabricator_config;
	return $this;
	}

	public function getRelatedPhabricatorConfig() {
	return $this->relatedPhabricatorConfig;
	}

	public function addPHPExtension($php_extension) {
	$this->phpExtensions[] = $php_extension;
	return $this;
	}

	public function getPHPExtensions() {
	return $this->phpExtensions;
	}

	public function setMessage($message) {
	$this->message = $message;
	return $this;
	}

	public function getMessage() {
	return $this->message;
	}

	public function setIsIgnored($is_ignored) {
	$this->isIgnored = $is_ignored;
	return $this;
	}

	public function getIsIgnored() {
	return $this->isIgnored;
	}

	public function addLink($href, $name) {
	$this->links[] = array(
	'href' => $href,
	'name' => $name,
	);
	return $this;
	}

	public function getLinks() {
	return $this->links;
	}

	}
	diff --git a/src/applications/config/option/PhabricatorAWSConfigOptions.php b/src/applications/config/option/PhabricatorAWSConfigOptions.php
	index 5f2246fdaa..a7a3a1e2ea 100644
	--- a/src/applications/config/option/PhabricatorAWSConfigOptions.php
	+++ b/src/applications/config/option/PhabricatorAWSConfigOptions.php
	@@ -1,60 +1,60 @@
	<?php

	final class PhabricatorAWSConfigOptions
	extends PhabricatorApplicationConfigOptions {

	public function getName() {
	return pht('Amazon Web Services');
	}

	public function getDescription() {
	return pht('Configure integration with AWS (EC2, SES, S3, etc).');
	}

	public function getIcon() {
	return 'fa-server';
	}

	public function getGroup() {
	return 'core';
	}

	public function getOptions() {
	return array(
	$this->newOption('amazon-s3.access-key', 'string', null)
	->setLocked(true)
	->setDescription(pht('Access key for Amazon S3.')),
	$this->newOption('amazon-s3.secret-key', 'string', null)
	->setHidden(true)
	->setDescription(pht('Secret key for Amazon S3.')),
	$this->newOption('amazon-s3.region', 'string', null)
	->setLocked(true)
	->setDescription(
	pht(
	'Amazon S3 region where your S3 bucket is located. When you '.
	'specify a region, you should also specify a corresponding '.
	'endpoint with `amazon-s3.endpoint`. You can find a list of '.
	'available regions and endpoints in the AWS documentation.'))
	->addExample('us-west-1', pht('USWest Region')),
	$this->newOption('amazon-s3.endpoint', 'string', null)
	->setLocked(true)
	->setDescription(
	pht(
	'Explicit S3 endpoint to use. This should be the endpoint '.
	'which corresponds to the region you have selected in '.
	- '`amazon-s3.region`. Phabricator can not determine the correct '.
	+ '`amazon-s3.region`. This software can not determine the correct '.
	'endpoint automatically because some endpoint locations are '.
	'irregular.'))
	->addExample(
	's3-us-west-1.amazonaws.com',
	pht('Use specific endpoint')),
	$this->newOption('amazon-ec2.access-key', 'string', null)
	->setLocked(true)
	->setDescription(pht('Access key for Amazon EC2.')),
	$this->newOption('amazon-ec2.secret-key', 'string', null)
	->setHidden(true)
	->setDescription(pht('Secret key for Amazon EC2.')),
	);
	}

	}
	diff --git a/src/applications/config/option/PhabricatorAccessLogConfigOptions.php b/src/applications/config/option/PhabricatorAccessLogConfigOptions.php
	index 45f730b977..0e3d336fc5 100644
	--- a/src/applications/config/option/PhabricatorAccessLogConfigOptions.php
	+++ b/src/applications/config/option/PhabricatorAccessLogConfigOptions.php
	@@ -1,154 +1,154 @@
	<?php

	final class PhabricatorAccessLogConfigOptions
	extends PhabricatorApplicationConfigOptions {

	public function getName() {
	return pht('Access Logs');
	}

	public function getDescription() {
	return pht('Configure the access logs, which log HTTP/SSH requests.');
	}

	public function getIcon() {
	return 'fa-list';
	}

	public function getGroup() {
	return 'core';
	}

	public function getOptions() {
	$common_map = array(
	'C' => pht('The controller or workflow which handled the request.'),
	'c' => pht('The HTTP response code or process exit code.'),
	'D' => pht('The request date.'),
	'e' => pht('Epoch timestamp.'),
	'h' => pht("The webserver's host name."),
	'p' => pht('The PID of the server process.'),
	'r' => pht('The remote IP.'),
	'T' => pht('The request duration, in microseconds.'),
	'U' => pht('The request path, or request target.'),
	'm' => pht('For conduit, the Conduit method which was invoked.'),
	'u' => pht('The logged-in username, if one is logged in.'),
	'P' => pht('The logged-in user PHID, if one is logged in.'),
	'i' => pht('Request input, in bytes.'),
	'o' => pht('Request output, in bytes.'),
	'I' => pht('Cluster instance name, if configured.'),
	);

	$http_map = $common_map + array(
	'R' => pht('The HTTP referrer.'),
	'M' => pht('The HTTP method.'),
	);

	$ssh_map = $common_map + array(
	's' => pht('The system user.'),
	'S' => pht('The system sudo user.'),
	'k' => pht('ID of the SSH key used to authenticate the request.'),

	// TODO: This is a reasonable thing to support in the HTTP access
	// log, too.
	'Q' => pht('A random, unique string which identifies the request.'),
	);

	$http_desc = pht(
	'Format for the HTTP access log. Use `%s` to set the path. '.
	'Available variables are:',
	'log.access.path');
	$http_desc .= "\n\n";
	$http_desc .= $this->renderMapHelp($http_map);

	$ssh_desc = pht(
	'Format for the SSH access log. Use %s to set the path. '.
	'Available variables are:',
	'log.ssh.path');
	$ssh_desc .= "\n\n";
	$ssh_desc .= $this->renderMapHelp($ssh_map);

	return array(
	$this->newOption('log.access.path', 'string', null)
	->setLocked(true)
	->setSummary(pht('Access log location.'))
	->setDescription(
	pht(
	- "To enable the Phabricator access log, specify a path. The ".
	- "Phabricator access than normal HTTP access logs (for instance, ".
	+ "To enable the HTTP access log, specify a path. This log is ".
	+ "more detailed than normal HTTP access logs (for instance, ".
	"it can show logged-in users, controllers, and other application ".
	"data).\n\n".
	"If not set, no log will be written."))
	->addExample(
	null,
	pht('Disable access log.'))
	->addExample(
	- '/var/log/phabricator/access.log',
	+ '/var/log/devtools/access.log',
	pht('Write access log here.')),
	$this->newOption(
	'log.access.format',
	// NOTE: This is 'wild' intead of 'string' so "\t" and such can be
	// specified.
	'wild',
	"[%D]\t%p\t%h\t%r\t%u\t%C\t%m\t%U\t%R\t%c\t%T")
	->setLocked(true)
	->setSummary(pht('Access log format.'))
	->setDescription($http_desc),
	$this->newOption('log.ssh.path', 'string', null)
	->setLocked(true)
	->setSummary(pht('SSH log location.'))
	->setDescription(
	pht(
	- "To enable the Phabricator SSH log, specify a path. The ".
	- "access log can provide more detailed information about SSH ".
	- "access than a normal SSH log (for instance, it can show ".
	- "logged-in users, commands, and other application data).\n\n".
	+ "To enable the SSH log, specify a path. This log can provide ".
	+ "more detailed information about SSH access than a normal SSH ".
	+ "log (for instance, it can show logged-in users, commands, and ".
	+ "other application data).\n\n".
	"If not set, no log will be written."))
	->addExample(
	null,
	pht('Disable SSH log.'))
	->addExample(
	- '/var/log/phabricator/ssh.log',
	+ '/var/log/devtools/ssh.log',
	pht('Write SSH log here.')),
	$this->newOption(
	'log.ssh.format',
	'wild',
	"[%D]\t%p\t%h\t%r\t%s\t%S\t%u\t%C\t%U\t%c\t%T\t%i\t%o")
	->setLocked(true)
	->setSummary(pht('SSH log format.'))
	->setDescription($ssh_desc),
	$this->newOption('log.ssh-error.path', 'string', null)
	->setLocked(true)
	->setSummary(pht('SSH error log location.'))
	->setDescription(
	pht(
	- 'To enable the Phabricator SSH error log, specify a path. Errors '.
	- 'occurring in contexts where Phabricator is serving SSH requests '.
	+ 'To enable the SSH error log, specify a path. Errors occurring '.
	+ 'in contexts where this software is serving SSH requests '.
	'will be written to this log.'.
	"\n\n".
	'If not set, no log will be written.'))
	->addExample(null, pht('Disable SSH error log.'))
	->addExample(
	- '/var/log/phabricator/ssh-error.log',
	+ '/var/log/devtools/ssh-error.log',
	pht('Write SSH error log here.')),
	);
	}

	private function renderMapHelp(array $map) {
	$desc = '';
	foreach ($map as $key => $kdesc) {
	$desc .= " - `%".$key."` ".$kdesc."\n";
	}
	$desc .= "\n";
	$desc .= pht(
	"If a variable isn't available (for example, %%m appears in the file ".
	"format but the request is not a Conduit request), it will be rendered ".
	"as '-'");
	$desc .= "\n\n";
	$desc .= pht(
	"Note that the default format is subject to change in the future, so ".
	"if you rely on the log's format, specify it explicitly.");

	return $desc;
	}

	}
	diff --git a/src/applications/config/option/PhabricatorAuthenticationConfigOptions.php b/src/applications/config/option/PhabricatorAuthenticationConfigOptions.php
	index 8058ecafcb..976e27b324 100644
	--- a/src/applications/config/option/PhabricatorAuthenticationConfigOptions.php
	+++ b/src/applications/config/option/PhabricatorAuthenticationConfigOptions.php
	@@ -1,123 +1,123 @@
	<?php

	final class PhabricatorAuthenticationConfigOptions
	extends PhabricatorApplicationConfigOptions {

	public function getName() {
	return pht('Authentication');
	}

	public function getDescription() {
	return pht('Options relating to authentication.');
	}

	public function getIcon() {
	return 'fa-key';
	}

	public function getGroup() {
	return 'core';
	}

	public function getOptions() {
	return array(
	$this->newOption('auth.require-email-verification', 'bool', false)
	->setBoolOptions(
	array(
	pht('Require email verification'),
	pht("Don't require email verification"),
	))
	->setSummary(
	pht('Require email verification before a user can log in.'))
	->setDescription(
	pht(
	'If true, email addresses must be verified (by clicking a link '.
	'in an email) before a user can login. By default, verification '.
	'is optional unless @{config:auth.email-domains} is nonempty.')),
	$this->newOption('auth.require-approval', 'bool', true)
	->setBoolOptions(
	array(
	pht('Require Administrators to Approve Accounts'),
	pht("Don't Require Manual Approval"),
	))
	->setSummary(
	pht('Require administrators to approve new accounts.'))
	->setDescription(
	pht(
	- "Newly registered Phabricator accounts can either be placed ".
	+ "Newly registered accounts can either be placed ".
	"into a manual approval queue for administrative review, or ".
	"automatically activated immediately. The approval queue is ".
	"enabled by default because it gives you greater control over ".
	- "who can register an account and access Phabricator.\n\n".
	+ "who can register an account and access the server.\n\n".
	"If your install is completely public, or on a VPN, or users can ".
	"only register with a trusted provider like LDAP, or you've ".
	- "otherwise configured Phabricator to prevent unauthorized ".
	+ "otherwise configured the server to prevent unauthorized ".
	"registration, you can disable the queue to reduce administrative ".
	"overhead.\n\n".
	"NOTE: Before you disable the queue, make sure ".
	"@{config:auth.email-domains} is configured correctly ".
	"for your install!")),
	$this->newOption('auth.email-domains', 'list<string>', array())
	->setSummary(pht('Only allow registration from particular domains.'))
	->setDescription(
	pht(
	"You can restrict allowed email addresses to certain domains ".
	"(like `yourcompany.com`) by setting a list of allowed domains ".
	"here.\n\nUsers will only be allowed to register using email ".
	"addresses at one of the domains, and will only be able to add ".
	"new email addresses for these domains. If you configure this, ".
	"it implies @{config:auth.require-email-verification}.\n\n".
	"You should omit the `@` from domains. Note that the domain must ".
	"match exactly. If you allow `yourcompany.com`, that permits ".
	"`joe@yourcompany.com` but rejects `joe@mail.yourcompany.com`."))
	->addExample(
	"yourcompany.com\nmail.yourcompany.com",
	pht('Valid Setting')),
	$this->newOption('auth.lock-config', 'bool', false)
	->setBoolOptions(
	array(
	pht('Auth provider config must be unlocked before editing'),
	pht('Auth provider config can be edited without unlocking'),
	))
	->setSummary(
	pht(
	'Require administrators to unlock the authentication provider '.
	'configuration from the CLI before it can be edited.'))
	->setDescription(
	pht(
	'When set to `true`, the authentication provider configuration '.
	'for this instance can not be modified without first running '.
	'`bin/auth unlock` from the command line. This is to reduce '.
	'the security impact of a compromised administrator account. '.
	"\n\n".
	'After running `bin/auth unlock` and making your changes to the '.
	'authentication provider config, you should run `bin/auth lock`.'))
	->setLocked(true),
	$this->newOption('account.editable', 'bool', true)
	->setBoolOptions(
	array(
	pht('Allow editing'),
	pht('Prevent editing'),
	))
	->setSummary(
	pht(
	'Determines whether or not basic account information is editable.'))
	->setDescription(
	pht(
	'This option controls whether users can edit account email '.
	'addresses and profile real names.'.
	"\n\n".
	- 'If you set up Phabricator to automatically synchronize account '.
	+ 'If you set things up to automatically synchronize account '.
	'information from some other authoritative system, you can '.
	'prevent users from making these edits to ensure information '.
	'remains consistent across both systems.')),
	$this->newOption('account.minimum-password-length', 'int', 8)
	->setSummary(pht('Minimum password length.'))
	->setDescription(
	pht(
	'When users set or reset a password, it must have at least this '.
	'many characters.')),
	);
	}

	}
	diff --git a/src/applications/config/option/PhabricatorCoreConfigOptions.php b/src/applications/config/option/PhabricatorCoreConfigOptions.php
	index 1682101659..b09c12e269 100644
	--- a/src/applications/config/option/PhabricatorCoreConfigOptions.php
	+++ b/src/applications/config/option/PhabricatorCoreConfigOptions.php
	@@ -1,335 +1,335 @@
	<?php

	final class PhabricatorCoreConfigOptions
	extends PhabricatorApplicationConfigOptions {

	public function getName() {
	return pht('Core');
	}

	public function getDescription() {
	return pht('Configure core options, including URIs.');
	}

	public function getIcon() {
	return 'fa-bullseye';
	}

	public function getGroup() {
	return 'core';
	}

	public function getOptions() {
	if (phutil_is_windows()) {
	$paths = array();
	} else {
	$paths = array(
	'/bin',
	'/usr/bin',
	'/usr/local/bin',
	);
	}

	$path = getenv('PATH');

	$proto_doc_href = PhabricatorEnv::getDoclink(
	'User Guide: Prototype Applications');
	$proto_doc_name = pht('User Guide: Prototype Applications');
	$applications_app_href = '/applications/';

	$silent_description = $this->deformat(pht(<<<EOREMARKUP
	This option allows you to stop this service from sending data to most external
	services: it will disable email, SMS, repository mirroring, remote builds,
	Doorkeeper writes, and webhooks.

	This option is intended to allow an instance to be exported, copied, imported,
	and run in a test environment without impacting users. For example, if you are
	migrating to new hardware, you could perform a test migration first with this
	flag set, make sure things work, and then do a production cutover later with
	higher confidence and less disruption.

	Without making use of this flag to silence the temporary test environment,
	users would receive duplicate email during the time the test instance and old
	production instance were both in operation.
	EOREMARKUP
	));

	$timezone_description = $this->deformat(pht(<<<EOREMARKUP
	PHP date functions will emit a warning if they are called when no default
	server timezone is configured.

	Usually, you configure a default timezone in `php.ini` by setting the
	configuration value `date.timezone`.

	If you prefer, you can configure a default timezone here instead. To configure
	a default timezone, select a timezone from the
	[[ %s \| PHP List of Supported Timezones ]].
	EOREMARKUP
	,
	'https://php.net/manual/timezones.php'));


	return array(
	$this->newOption('phabricator.base-uri', 'string', null)
	->setLocked(true)
	->setSummary(pht('URI where this software is installed.'))
	->setDescription(
	pht(
	'Set the URI where this software is installed. Setting this '.
	'improves security by preventing cookies from being set on other '.
	'domains, and allows daemons to send emails with links that have '.
	'the correct domain.'))
	->addExample('http://devtools.example.com/', pht('Valid Setting')),
	$this->newOption('phabricator.production-uri', 'string', null)
	->setSummary(
	pht('Primary install URI, for multi-environment installs.'))
	->setDescription(
	pht(
	'If you have multiple %s environments (like a '.
	'development/staging environment and a production environment), '.
	'set the production environment URI here so that emails and other '.
	'durable URIs will always generate with links pointing at the '.
	'production environment. If unset, defaults to `%s`. Most '.
	'installs do not need to set this option.',
	PlatformSymbols::getPlatformServerName(),
	'phabricator.base-uri'))
	->addExample('http://devtools.example.com/', pht('Valid Setting')),
	$this->newOption('phabricator.allowed-uris', 'list<string>', array())
	->setLocked(true)
	->setSummary(pht('Alternative URIs that can access this service.'))
	->setDescription(
	pht(
	"These alternative URIs will be able to access 'normal' pages ".
	"on your this install. Other features such as OAuth ".
	"won't work. The major use case for this is moving installs ".
	"across domains."))
	->addExample(
	"http://phabricator2.example.com/\n".
	"http://phabricator3.example.com/",
	pht('Valid Setting')),
	$this->newOption('phabricator.timezone', 'string', null)
	->setSummary(
	pht('The timezone this software should use by default.'))
	->setDescription($timezone_description)
	->addExample('America/New_York', pht('US East (EDT)'))
	->addExample('America/Chicago', pht('US Central (CDT)'))
	->addExample('America/Boise', pht('US Mountain (MDT)'))
	->addExample('America/Los_Angeles', pht('US West (PDT)')),
	$this->newOption('phabricator.cookie-prefix', 'string', null)
	->setLocked(true)
	->setSummary(
	pht(
	'Set a string this software should use to prefix cookie names.'))
	->setDescription(
	pht(
	'Cookies set for x.com are also sent for y.x.com. Assuming '.
	'instances are running on both domains, this will create a '.
	'collision preventing you from logging in.'))
	->addExample('dev', pht('Prefix cookie with "%s"', 'dev')),
	$this->newOption('phabricator.show-prototypes', 'bool', false)
	->setLocked(true)
	->setBoolOptions(
	array(
	pht('Enable Prototypes'),
	pht('Disable Prototypes'),
	))
	->setSummary(
	pht(
	'Install applications which are still under development.'))
	->setDescription(
	pht(
	"IMPORTANT: The upstream does not provide support for prototype ".
	"applications.".
	"\n\n".
	"This platform includes prototype applications which are in an ".
	"early stage of development. By default, prototype ".
	"applications are not installed, because they are often not yet ".
	"developed enough to be generally usable. You can enable ".
	"this option to install them if you're developing applications ".
	"or are interested in previewing upcoming features.".
	"\n\n".
	"To learn more about prototypes, see [[ %s \| %s ]].".
	"\n\n".
	"After enabling prototypes, you can selectively uninstall them ".
	"(like normal applications).",
	$proto_doc_href,
	$proto_doc_name)),
	$this->newOption('phabricator.serious-business', 'bool', false)
	->setBoolOptions(
	array(
	pht('Serious business'),
	pht('Shenanigans'), // That should be interesting to translate. :P
	))
	->setSummary(
	pht('Allows you to remove levity and jokes from the UI.'))
	->setDescription(
	pht(
	'By default, this software includes some flavor text in the UI, '.
	'like a prompt to "Weigh In" rather than "Add Comment" in '.
	'Maniphest. If you\'d prefer more traditional UI strings like '.
	'"Add Comment", you can set this flag to disable most of the '.
	'extra flavor.')),
	$this->newOption(
	'remarkup.ignored-object-names',
	'string',

	// Q1, Q2, etc., are common abbreviations for "Quarter".
	// V1, V2, etc., are common abbreviations for "Version".
	// P1, P2, etc., are common abbreviations for "Priority".

	// M1 is a computer chip manufactured by Apple.
	// M2 (commonly spelled "M.2") is an expansion slot on motherboards.
	// M4 is a carbine.
	// M8 is a phonetic spelling of "mate", used in culturally significant
	// copypasta about navy seals.

	'/^(Q\|V\|M\|P)\d$/')
	->setSummary(
	pht('Text values that match this regex and are also object names '.
	'will not be linked.'))
	->setDescription(
	pht(
	'By default, this software links object names in Remarkup fields '.
	'to the corresponding object. This regex can be used to modify '.
	'this behavior; object names that match this regex will not be '.
	'linked.')),
	$this->newOption('environment.append-paths', 'list<string>', $paths)
	->setSummary(
	pht(
	'These paths get appended to your %s environment variable.',
	'$PATH'))
	->setDescription(
	pht(
	"Thhi software sometimes executes other binaries on the ".
	"server. An example of this is the `%s` command, used to ".
	"syntax-highlight code written in languages other than PHP. By ".
	"default, it is assumed that these binaries are in the %s of the ".
	"user running this software (normally 'apache', 'httpd', or ".
	"'nobody'). Here you can add extra directories to the %s ".
	"environment variable, for when these binaries are in ".
	"non-standard locations.\n\n".
	"Note that you can also put binaries in `%s` (for example, by ".
	"symlinking them).\n\n".
	"The current value of PATH after configuration is applied is:\n\n".
	" lang=text\n".
	" %s",
	'pygmentize',
	'$PATH',
	'$PATH',
	'support/bin/',
	$path))
	->setLocked(true)
	->addExample('/usr/local/bin', pht('Add One Path'))
	->addExample("/usr/bin\n/usr/local/bin", pht('Add Multiple Paths')),
	$this->newOption('config.lock', 'set', array())
	->setLocked(true)
	->setDescription(pht('Additional configuration options to lock.')),
	$this->newOption('config.hide', 'set', array())
	->setLocked(true)
	->setDescription(pht('Additional configuration options to hide.')),
	$this->newOption('config.ignore-issues', 'set', array())
	->setLocked(true)
	->setDescription(pht('Setup issues to ignore.')),
	$this->newOption('phabricator.env', 'string', null)
	->setLocked(true)
	->setDescription(pht('Internal.')),
	$this->newOption('test.value', 'wild', null)
	->setLocked(true)
	->setDescription(pht('Unit test value.')),
	$this->newOption('phabricator.uninstalled-applications', 'set', array())
	->setLocked(true)
	->setLockedMessage(pht(
	'Use the %s to manage installed applications.',
	phutil_tag(
	'a',
	array(
	'href' => $applications_app_href,
	),
	pht('Applications application'))))
	->setDescription(
	pht('Array containing list of uninstalled applications.')),
	$this->newOption('phabricator.application-settings', 'wild', array())
	->setLocked(true)
	->setDescription(
	- pht('Customized settings for Phabricator applications.')),
	+ pht('Customized settings for applications.')),
	$this->newOption('phabricator.cache-namespace', 'string', 'phabricator')
	->setLocked(true)
	->setDescription(pht('Cache namespace.')),
	$this->newOption('phabricator.silent', 'bool', false)
	->setLocked(true)
	->setBoolOptions(
	array(
	pht('Run Silently'),
	pht('Run Normally'),
	))
	->setSummary(pht('Stop this software from sending any email, etc.'))
	->setDescription($silent_description),
	);

	}

	protected function didValidateOption(
	PhabricatorConfigOption $option,
	$value) {

	$key = $option->getKey();
	if ($key == 'phabricator.base-uri' \|\|
	$key == 'phabricator.production-uri') {

	$uri = new PhutilURI($value);
	$protocol = $uri->getProtocol();
	if ($protocol !== 'http' && $protocol !== 'https') {
	throw new PhabricatorConfigValidationException(
	pht(
	'Config option "%s" is invalid. The URI must start with '.
	'"%s" or "%s".',
	$key,
	'http://',
	'https://'));
	}

	$domain = $uri->getDomain();
	if (strpos($domain, '.') === false) {
	throw new PhabricatorConfigValidationException(
	pht(
	'Config option "%s" is invalid. The URI must contain a dot '.
	'("%s"), like "%s", not just a bare name like "%s". Some web '.
	'browsers will not set cookies on domains with no TLD.',
	$key,
	'.',
	'http://example.com/',
	'http://example/'));
	}

	$path = $uri->getPath();
	if ($path !== '' && $path !== '/') {
	throw new PhabricatorConfigValidationException(
	pht(
	"Config option '%s' is invalid. The URI must NOT have a path, ".
	"e.g. '%s' is OK, but '%s' is not. This software must be '.
	'installed on an entire domain; it can not be installed on a path.",
	$key,
	'http://devtools.example.com/',
	'http://example.com/devtools/'));
	}
	}


	if ($key === 'phabricator.timezone') {
	$old = date_default_timezone_get();
	$ok = @date_default_timezone_set($value);
	@date_default_timezone_set($old);

	if (!$ok) {
	throw new PhabricatorConfigValidationException(
	pht(
	'Config option "%s" is invalid. The timezone identifier must '.
	'be a valid timezone identifier recognized by PHP, like "%s".',
	$key,
	'America/Los_Angeles'));
	}
	}
	}


	}
	diff --git a/src/applications/config/option/PhabricatorPHDConfigOptions.php b/src/applications/config/option/PhabricatorPHDConfigOptions.php
	index 259660d562..5243bb3ee8 100644
	--- a/src/applications/config/option/PhabricatorPHDConfigOptions.php
	+++ b/src/applications/config/option/PhabricatorPHDConfigOptions.php
	@@ -1,69 +1,69 @@
	<?php

	final class PhabricatorPHDConfigOptions
	extends PhabricatorApplicationConfigOptions {

	public function getName() {
	return pht('Daemons');
	}

	public function getDescription() {
	return pht('Options relating to PHD (daemons).');
	}

	public function getIcon() {
	return 'fa-pied-piper-alt';
	}

	public function getGroup() {
	return 'core';
	}

	public function getOptions() {
	return array(
	$this->newOption('phd.log-directory', 'string', '/var/tmp/phd/log')
	->setLocked(true)
	->setDescription(
	pht('Directory that the daemons should use to store log files.')),
	$this->newOption('phd.taskmasters', 'int', 4)
	->setLocked(true)
	->setSummary(pht('Maximum taskmaster daemon pool size.'))
	->setDescription(
	pht(
	"Maximum number of taskmaster daemons to run at once. Raising ".
	"this can increase the maximum throughput of the task queue. The ".
	"pool will automatically scale down when unutilized.".
	"\n\n".
	"If you are running a cluster, this limit applies separately ".
	"to each instance of `phd`. For example, if this limit is set ".
	"to `4` and you have three hosts running daemons, the effective ".
	"global limit will be 12.".
	"\n\n".
	"After changing this value, you must restart the daemons. Most ".
	"configuration changes are picked up by the daemons ".
	"automatically, but pool sizes can not be changed without a ".
	"restart.")),
	$this->newOption('phd.user', 'string', null)
	->setLocked(true)
	->setSummary(pht('System user to run daemons as.'))
	->setDescription(
	pht(
	'Specify a system user to run the daemons as. Primarily, this '.
	'user will own the working copies of any repositories that '.
	- 'Phabricator imports or manages. This option is new and '.
	+ 'this software imports or manages. This option is new and '.
	'experimental.')),
	$this->newOption('phd.garbage-collection', 'wild', array())
	->setLocked(true)
	->setLockedMessage(
	pht(
	'This option can not be edited from the web UI. Use %s to adjust '.
	'garbage collector policies.',
	phutil_tag('tt', array(), 'bin/garbage set-policy')))
	->setSummary(pht('Retention policies for garbage collection.'))
	->setDescription(
	pht(
	'Customizes retention policies for garbage collectors.')),
	);
	}

	}
	diff --git a/src/applications/daemon/management/PhabricatorDaemonManagementRestartWorkflow.php b/src/applications/daemon/management/PhabricatorDaemonManagementRestartWorkflow.php
	index eb2d5d229c..a9778724af 100644
	--- a/src/applications/daemon/management/PhabricatorDaemonManagementRestartWorkflow.php
	+++ b/src/applications/daemon/management/PhabricatorDaemonManagementRestartWorkflow.php
	@@ -1,54 +1,54 @@
	<?php

	final class PhabricatorDaemonManagementRestartWorkflow
	extends PhabricatorDaemonManagementWorkflow {

	protected function didConstruct() {
	$this
	->setName('restart')
	->setSynopsis(
	pht(
	'Stop daemon processes on this host, then start the standard '.
	'daemon loadout.'))
	->setArguments(
	array(
	array(
	'name' => 'graceful',
	'param' => 'seconds',
	'help' => pht(
	'Grace period for daemons to attempt a clean shutdown, in '.
	'seconds. Defaults to __15__ seconds.'),
	'default' => 15,
	),
	array(
	'name' => 'force',
	'help' => pht(
	'Stop all daemon processes on this host, even if they belong '.
	- 'to another Phabricator instance.'),
	+ 'to another instance.'),
	),
	array(
	'name' => 'gently',
	'help' => pht('Deprecated. Has no effect.'),
	),
	$this->getAutoscaleReserveArgument(),
	));
	}

	public function execute(PhutilArgumentParser $args) {
	$err = $this->executeStopCommand(
	array(
	'graceful' => $args->getArg('graceful'),
	'force' => $args->getArg('force'),
	));

	if ($err) {
	return $err;
	}

	return $this->executeStartCommand(
	array(
	'reserve' => (float)$args->getArg('autoscale-reserve'),
	));
	}

	}
	diff --git a/src/applications/daemon/management/PhabricatorDaemonManagementStartWorkflow.php b/src/applications/daemon/management/PhabricatorDaemonManagementStartWorkflow.php
	index bd23d3bc7d..0aca9e5c71 100644
	--- a/src/applications/daemon/management/PhabricatorDaemonManagementStartWorkflow.php
	+++ b/src/applications/daemon/management/PhabricatorDaemonManagementStartWorkflow.php
	@@ -1,41 +1,41 @@
	<?php

	final class PhabricatorDaemonManagementStartWorkflow
	extends PhabricatorDaemonManagementWorkflow {

	protected function didConstruct() {
	$this
	->setName('start')
	->setSynopsis(
	pht(
	- 'Start the standard configured collection of Phabricator daemons. '.
	+ 'Start the standard configured collection of daemons. '.
	'This is appropriate for most installs. Use %s to '.
	'customize which daemons are launched.',
	'phd launch'))
	->setArguments(
	array(
	array(
	'name' => 'keep-leases',
	'help' => pht(
	'By default, %s will free all task leases held by '.
	'the daemons. With this flag, this step will be skipped.',
	'phd start'),
	),
	array(
	'name' => 'force',
	'help' => pht('Start daemons even if daemons are already running.'),
	),
	$this->getAutoscaleReserveArgument(),
	));
	}

	public function execute(PhutilArgumentParser $args) {
	return $this->executeStartCommand(
	array(
	'keep-leases' => $args->getArg('keep-leases'),
	'force' => $args->getArg('force'),
	'reserve' => (float)$args->getArg('autoscale-reserve'),
	));
	}

	}

File Metadata

Mime Type: text/x-diff
Expires: Sun, Jul 27, 2:28 PM (1 w, 9 h ago)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 185876
Default Alt Text: (41 KB)

No OneTemporaryActions

View Options

File Metadata

Event Timeline

No OneTemporary
Actions