Convert cluster/projects config options to newer modular structure

Summary: Ref T12845. Converts the cluster and project config options to the new stuff; this is mostly just shifting boilerplate around.

Test Plan: Edited, deleted, and mangled these options from the web UI and CLI.

Reviewers: chad, amckinley

Reviewed By: amckinley

Maniphest Tasks: T12845

Differential Revision: https://secure.phabricator.com/D18166

src/__phutil_library_map__.php

···
     'PhabricatorChunkedFileStorageEngine' => 'applications/files/engine/PhabricatorChunkedFileStorageEngine.php',
     'PhabricatorClassConfigType' => 'applications/config/type/PhabricatorClassConfigType.php',
     'PhabricatorClusterConfigOptions' => 'applications/config/option/PhabricatorClusterConfigOptions.php',
-    'PhabricatorClusterDatabasesConfigOptionType' => 'infrastructure/cluster/config/PhabricatorClusterDatabasesConfigOptionType.php',
+    'PhabricatorClusterDatabasesConfigType' => 'infrastructure/cluster/config/PhabricatorClusterDatabasesConfigType.php',
     'PhabricatorClusterException' => 'infrastructure/cluster/exception/PhabricatorClusterException.php',
     'PhabricatorClusterExceptionHandler' => 'infrastructure/cluster/exception/PhabricatorClusterExceptionHandler.php',
     'PhabricatorClusterImpossibleWriteException' => 'infrastructure/cluster/exception/PhabricatorClusterImpossibleWriteException.php',
     'PhabricatorClusterImproperWriteException' => 'infrastructure/cluster/exception/PhabricatorClusterImproperWriteException.php',
     'PhabricatorClusterNoHostForRoleException' => 'infrastructure/cluster/exception/PhabricatorClusterNoHostForRoleException.php',
-    'PhabricatorClusterSearchConfigOptionType' => 'infrastructure/cluster/config/PhabricatorClusterSearchConfigOptionType.php',
+    'PhabricatorClusterSearchConfigType' => 'infrastructure/cluster/config/PhabricatorClusterSearchConfigType.php',
     'PhabricatorClusterServiceHealthRecord' => 'infrastructure/cluster/PhabricatorClusterServiceHealthRecord.php',
     'PhabricatorClusterStrandedException' => 'infrastructure/cluster/exception/PhabricatorClusterStrandedException.php',
     'PhabricatorColumnProxyInterface' => 'applications/project/interface/PhabricatorColumnProxyInterface.php',
···
     'PhabricatorNotificationQuery' => 'applications/notification/query/PhabricatorNotificationQuery.php',
     'PhabricatorNotificationSearchEngine' => 'applications/notification/query/PhabricatorNotificationSearchEngine.php',
     'PhabricatorNotificationServerRef' => 'applications/notification/client/PhabricatorNotificationServerRef.php',
-    'PhabricatorNotificationServersConfigOptionType' => 'applications/notification/config/PhabricatorNotificationServersConfigOptionType.php',
+    'PhabricatorNotificationServersConfigType' => 'applications/notification/config/PhabricatorNotificationServersConfigType.php',
     'PhabricatorNotificationStatusView' => 'applications/notification/view/PhabricatorNotificationStatusView.php',
     'PhabricatorNotificationTestController' => 'applications/notification/controller/PhabricatorNotificationTestController.php',
     'PhabricatorNotificationTestFeedStory' => 'applications/notification/feed/PhabricatorNotificationTestFeedStory.php',
···
     'PhabricatorProjectBoardViewController' => 'applications/project/controller/PhabricatorProjectBoardViewController.php',
     'PhabricatorProjectCardView' => 'applications/project/view/PhabricatorProjectCardView.php',
     'PhabricatorProjectColorTransaction' => 'applications/project/xaction/PhabricatorProjectColorTransaction.php',
-    'PhabricatorProjectColorsConfigOptionType' => 'applications/project/config/PhabricatorProjectColorsConfigOptionType.php',
+    'PhabricatorProjectColorsConfigType' => 'applications/project/config/PhabricatorProjectColorsConfigType.php',
     'PhabricatorProjectColumn' => 'applications/project/storage/PhabricatorProjectColumn.php',
     'PhabricatorProjectColumnDetailController' => 'applications/project/controller/PhabricatorProjectColumnDetailController.php',
     'PhabricatorProjectColumnEditController' => 'applications/project/controller/PhabricatorProjectColumnEditController.php',
···
     'PhabricatorProjectHovercardEngineExtension' => 'applications/project/engineextension/PhabricatorProjectHovercardEngineExtension.php',
     'PhabricatorProjectIconSet' => 'applications/project/icon/PhabricatorProjectIconSet.php',
     'PhabricatorProjectIconTransaction' => 'applications/project/xaction/PhabricatorProjectIconTransaction.php',
-    'PhabricatorProjectIconsConfigOptionType' => 'applications/project/config/PhabricatorProjectIconsConfigOptionType.php',
+    'PhabricatorProjectIconsConfigType' => 'applications/project/config/PhabricatorProjectIconsConfigType.php',
     'PhabricatorProjectImageTransaction' => 'applications/project/xaction/PhabricatorProjectImageTransaction.php',
     'PhabricatorProjectInterface' => 'applications/project/interface/PhabricatorProjectInterface.php',
     'PhabricatorProjectListController' => 'applications/project/controller/PhabricatorProjectListController.php',
···
     'PhabricatorChunkedFileStorageEngine' => 'PhabricatorFileStorageEngine',
     'PhabricatorClassConfigType' => 'PhabricatorTextConfigType',
     'PhabricatorClusterConfigOptions' => 'PhabricatorApplicationConfigOptions',
-    'PhabricatorClusterDatabasesConfigOptionType' => 'PhabricatorConfigJSONOptionType',
+    'PhabricatorClusterDatabasesConfigType' => 'PhabricatorJSONConfigType',
     'PhabricatorClusterException' => 'Exception',
     'PhabricatorClusterExceptionHandler' => 'PhabricatorRequestExceptionHandler',
     'PhabricatorClusterImpossibleWriteException' => 'PhabricatorClusterException',
     'PhabricatorClusterImproperWriteException' => 'PhabricatorClusterException',
     'PhabricatorClusterNoHostForRoleException' => 'Exception',
-    'PhabricatorClusterSearchConfigOptionType' => 'PhabricatorConfigJSONOptionType',
+    'PhabricatorClusterSearchConfigType' => 'PhabricatorJSONConfigType',
     'PhabricatorClusterServiceHealthRecord' => 'Phobject',
     'PhabricatorClusterStrandedException' => 'PhabricatorClusterException',
     'PhabricatorColumnsEditField' => 'PhabricatorPHIDListEditField',
···
     'PhabricatorNotificationQuery' => 'PhabricatorCursorPagedPolicyAwareQuery',
     'PhabricatorNotificationSearchEngine' => 'PhabricatorApplicationSearchEngine',
     'PhabricatorNotificationServerRef' => 'Phobject',
-    'PhabricatorNotificationServersConfigOptionType' => 'PhabricatorConfigJSONOptionType',
+    'PhabricatorNotificationServersConfigType' => 'PhabricatorJSONConfigType',
     'PhabricatorNotificationStatusView' => 'AphrontTagView',
     'PhabricatorNotificationTestController' => 'PhabricatorNotificationController',
     'PhabricatorNotificationTestFeedStory' => 'PhabricatorFeedStory',
···
     'PhabricatorProjectBoardViewController' => 'PhabricatorProjectBoardController',
     'PhabricatorProjectCardView' => 'AphrontTagView',
     'PhabricatorProjectColorTransaction' => 'PhabricatorProjectTransactionType',
-    'PhabricatorProjectColorsConfigOptionType' => 'PhabricatorConfigJSONOptionType',
+    'PhabricatorProjectColorsConfigType' => 'PhabricatorJSONConfigType',
     'PhabricatorProjectColumn' => array(
       'PhabricatorProjectDAO',
       'PhabricatorApplicationTransactionInterface',
···
     'PhabricatorProjectHovercardEngineExtension' => 'PhabricatorHovercardEngineExtension',
     'PhabricatorProjectIconSet' => 'PhabricatorIconSet',
     'PhabricatorProjectIconTransaction' => 'PhabricatorProjectTransactionType',
-    'PhabricatorProjectIconsConfigOptionType' => 'PhabricatorConfigJSONOptionType',
+    'PhabricatorProjectIconsConfigType' => 'PhabricatorJSONConfigType',
     'PhabricatorProjectImageTransaction' => 'PhabricatorProjectTransactionType',
     'PhabricatorProjectListController' => 'PhabricatorProjectController',
     'PhabricatorProjectListView' => 'AphrontView',

src/applications/config/option/PhabricatorClusterConfigOptions.php

···
   }
 
   public function getOptions() {
-    $databases_type = 'custom:PhabricatorClusterDatabasesConfigOptionType';
+    $databases_type = 'cluster.databases';
     $databases_help = $this->deformat(pht(<<<EOTEXT
 WARNING: This is a prototype option and the description below is currently pure
 fantasy.
···
     $intro_href = PhabricatorEnv::getDoclink('Clustering Introduction');
     $intro_name = pht('Clustering Introduction');
 
-    $search_type = 'custom:PhabricatorClusterSearchConfigOptionType';
+    $search_type = 'cluster.search';
     $search_help = $this->deformat(pht(<<<EOTEXT
 Define one or more fulltext storage services. Here you can configure which
 hosts will handle fulltext search queries and indexing. For help with

src/applications/config/option/PhabricatorNotificationConfigOptions.php

···
   }
 
   public function getOptions() {
-    $servers_type = 'custom:PhabricatorNotificationServersConfigOptionType';
+    $servers_type = 'cluster.notifications';
     $servers_help = $this->deformat(pht(<<<EOTEXT
 Provide a list of notification servers to enable real-time notifications.
 

src/applications/config/type/PhabricatorConfigType.php

···
 
   abstract protected function newHTTPParameterType();
 
-  public function validateValue(PhabricatorConfigOption $option, $value) {
-    return array();
-  }
-
   public function newTransaction(
     PhabricatorConfigOption $option,
     $value) {

src/applications/notification/config/PhabricatorNotificationServersConfigOptionType.php src/applications/notification/config/PhabricatorNotificationServersConfigType.php

···
 <?php
 
-final class PhabricatorNotificationServersConfigOptionType
-  extends PhabricatorConfigJSONOptionType {
+final class PhabricatorNotificationServersConfigType
+  extends PhabricatorJSONConfigType {
 
-  public function validateOption(PhabricatorConfigOption $option, $value) {
-    if (!is_array($value)) {
-      throw new Exception(
-        pht(
-          'Notification server configuration is not valid: value must be a '.
-          'list of servers'));
-    }
+  const TYPEKEY = 'cluster.notifications';
+
+  public function validateStoredValue(
+    PhabricatorConfigOption $option,
+    $value) {
 
     foreach ($value as $index => $spec) {
       if (!is_array($spec)) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration is not valid: each entry in '.
             'the list must be a dictionary describing a service, but '.
···
             'disabled' => 'optional bool',
           ));
       } catch (Exception $ex) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration has an invalid service '.
             'specification (at index "%s"): %s.',
···
           }
           break;
         default:
-          throw new Exception(
+          throw $this->newException(
             pht(
               'Notification server configuration describes an invalid '.
               'host ("%s", at index "%s") with an unrecognized type ("%s"). '.
···
         case 'https':
           break;
         default:
-          throw new Exception(
+          throw $this->newException(
             pht(
               'Notification server configuration describes an invalid '.
               'host ("%s", at index "%s") with an invalid protocol ("%s"). '.
···
 
       $path = idx($spec, 'path');
       if ($type == 'admin' && strlen($path)) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration describes an invalid host '.
             '("%s", at index "%s"). This is an "admin" service but it has a '.
···
       // mistakes.
       $key = "{$host}:{$port}";
       if (isset($map[$key])) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration is invalid: it describes the '.
             'same host and port ("%s") multiple times. Each host and port '.
···
 
     if ($value) {
       if (!$has_admin) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration is invalid: it does not '.
             'specify any enabled servers with type "admin". Notifications '.
···
       }
 
       if (!$has_client) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Notification server configuration is invalid: it does not '.
             'specify any enabled servers with type "client". Notifications '.

src/applications/project/config/PhabricatorProjectColorsConfigOptionType.php

···
-<?php
-
-final class PhabricatorProjectColorsConfigOptionType
-  extends PhabricatorConfigJSONOptionType {
-
-  public function validateOption(PhabricatorConfigOption $option, $value) {
-    PhabricatorProjectIconSet::validateColorConfiguration($value);
-  }
-
-}

src/applications/project/config/PhabricatorProjectColorsConfigType.php

···
+<?php
+
+final class PhabricatorProjectColorsConfigType
+  extends PhabricatorJSONConfigType {
+
+  const TYPEKEY = 'project.colors';
+
+  public function validateStoredValue(
+    PhabricatorConfigOption $option,
+    $value) {
+    PhabricatorProjectIconSet::validateColorConfiguration($value);
+  }
+
+}

src/applications/project/config/PhabricatorProjectConfigOptions.php

···
 
   public function getOptions() {
     $default_icons = PhabricatorProjectIconSet::getDefaultConfiguration();
-    $icons_type = 'custom:PhabricatorProjectIconsConfigOptionType';
+    $icons_type = 'project.icons';
 
     $icons_description = $this->deformat(pht(<<<EOTEXT
 Allows you to change and customize the available project icons.
···
       ));
 
     $default_colors = PhabricatorProjectIconSet::getDefaultColorMap();
-    $colors_type = 'custom:PhabricatorProjectColorsConfigOptionType';
+    $colors_type = 'project.colors';
 
     $colors_description = $this->deformat(pht(<<<EOTEXT
 Allows you to relabel project colors.

src/applications/project/config/PhabricatorProjectIconsConfigOptionType.php

···
-<?php
-
-final class PhabricatorProjectIconsConfigOptionType
-  extends PhabricatorConfigJSONOptionType {
-
-  public function validateOption(PhabricatorConfigOption $option, $value) {
-    PhabricatorProjectIconSet::validateConfiguration($value);
-  }
-
-}

src/applications/project/config/PhabricatorProjectIconsConfigType.php

···
+<?php
+
+final class PhabricatorProjectIconsConfigType
+  extends PhabricatorJSONConfigType {
+
+  const TYPEKEY = 'project.icons';
+
+  public function validateStoredValue(
+    PhabricatorConfigOption $option,
+    $value) {
+    PhabricatorProjectIconSet::validateConfiguration($value);
+  }
+
+}

src/applications/search/management/PhabricatorSearchManagementWorkflow.php

···
     $config_value = PhabricatorEnv::getEnvConfig($config_key);
 
     try {
-      PhabricatorClusterSearchConfigOptionType::validateValue($config_value);
+      PhabricatorClusterSearchConfigType::validateValue($config_value);
     } catch (Exception $ex) {
       throw new PhutilArgumentUsageException(
         pht(

src/infrastructure/cluster/config/PhabricatorClusterDatabasesConfigOptionType.php src/infrastructure/cluster/config/PhabricatorClusterDatabasesConfigType.php

···
 <?php
 
-final class PhabricatorClusterDatabasesConfigOptionType
-  extends PhabricatorConfigJSONOptionType {
+final class PhabricatorClusterDatabasesConfigType
+  extends PhabricatorJSONConfigType {
 
-  public function validateOption(PhabricatorConfigOption $option, $value) {
-    if (!is_array($value)) {
-      throw new Exception(
-        pht(
-          'Database cluster configuration is not valid: value must be a '.
-          'list of database hosts.'));
-    }
+  const TYPEKEY = 'cluster.databases';
+
+  public function validateStoredValue(
+    PhabricatorConfigOption $option,
+    $value) {
 
     foreach ($value as $index => $spec) {
       if (!is_array($spec)) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Database cluster configuration is not valid: each entry in the '.
             'list must be a dictionary describing a database host, but '.
···
             'persistent' => 'optional bool',
           ));
       } catch (Exception $ex) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Database cluster configuration has an invalid host '.
             'specification (at index "%s"): %s.',
···
         case 'replica':
           break;
         default:
-          throw new Exception(
+          throw $this->newException(
             pht(
               'Database cluster configuration describes an invalid '.
               'host ("%s", at index "%s") with an unrecognized role ("%s"). '.
···
       // mistakes.
       $key = "{$host}:{$port}";
       if (isset($map[$key])) {
-        throw new Exception(
+        throw $this->newException(
           pht(
             'Database cluster configuration is invalid: it describes the '.
             'same host ("%s") multiple times. Each host should appear only '.

src/infrastructure/cluster/config/PhabricatorClusterSearchConfigOptionType.php src/infrastructure/cluster/config/PhabricatorClusterSearchConfigType.php

···
 <?php
 
-final class PhabricatorClusterSearchConfigOptionType
-  extends PhabricatorConfigJSONOptionType {
+final class PhabricatorClusterSearchConfigType
+  extends PhabricatorJSONConfigType {
+
+  const TYPEKEY = 'cluster.search';
 
-  public function validateOption(PhabricatorConfigOption $option, $value) {
+  public function validateStoredValue(
+    PhabricatorConfigOption $option,
+    $value) {
     self::validateValue($value);
   }
 
   public static function validateValue($value) {
-    if (!is_array($value)) {
-      throw new Exception(
-        pht(
-          'Search cluster configuration is not valid: value must be a '.
-          'list of search hosts.'));
-    }
-
     $engines = PhabricatorSearchService::loadAllFulltextStorageEngines();
 
     foreach ($value as $index => $spec) {