phacility/phabricator · error · PhabricatorConfigValidationException

Config option '%s' is invalid. The URI must start with '%s'

Error message

Config option '%s' is invalid. The URI must start with '%s' or '%s'.

What it means

Error "Config option '%s' is invalid. The URI must start with '%s' or '%s'." thrown in phacility/phabricator.

Source

Thrown at src/applications/config/option/PhabricatorSecurityConfigOptions.php:301

              'setting.')),
        $this->newOption('keyring', $keyring_type, array())
          ->setHidden(true)
          ->setSummary(pht('Configure master encryption keys.'))
          ->setDescription($keyring_description),
    );
  }

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

    $key = $option->getKey();
    if ($key == 'security.alternate-file-domain') {

      $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 ('.'), ".
            "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/'));

View on GitHub (pinned to 5720a38cfe)

When it happens

Trigger: Thrown at src/applications/config/option/PhabricatorSecurityConfigOptions.php:301 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of phacility/phabricator@5720a38cfe (2026-08-21). Data as JSON: /api/errors/dea951198eadad1e. Report an issue: GitHub.