AcsfConfig.php in Acquia Cloud Site Factory Connector 8

Namespace

Drupal\acsf

File

src/AcsfConfig.php

<?php

namespace Drupal\acsf;


/**
 * Provides an interface to define how our message configuration should work.
 */
abstract class AcsfConfig {

  /**
   * The URL of the remote service (factory).
   *
   * @var string
   */
  protected $url;

  /**
   * The username of the remote service.
   *
   * @var string
   */
  protected $username;

  /**
   * The password of the remote service.
   *
   * @var string
   */
  protected $password;

  /**
   * The optional signup suffix of the Factory. See getUrlSuffix() for caveat.
   *
   * @var string
   */
  protected $urlSuffix;

  /**
   * The optional source URL of the factory which our sites were staged from.
   *
   * @var string
   */
  protected $sourceUrl;

  /**
   * An optional Acquia Hosting sitegroup.
   *
   * @var string
   */
  protected $ahSite;

  /**
   * An optional Acquia Hosting environment.
   *
   * @var string
   */
  protected $ahEnv;

  /**
   * Constructor.
   *
   * @param string $ah_site
   *   (Optional) Acquia Hosting sitegroup.
   * @param string $ah_env
   *   (Optional) Acquia Hosting environment.
   *
   * @throws AcsfConfigIncompleteException
   */
  public function __construct($ah_site = NULL, $ah_env = NULL) {
    if (function_exists('is_acquia_host') && !is_acquia_host()) {
      return;
    }

    // If none specified, pick the site group and environment from $_ENV.
    if (empty($ah_site)) {
      $ah_site = $_ENV['AH_SITE_GROUP'];
    }
    if (empty($ah_env)) {
      $ah_env = $_ENV['AH_SITE_ENVIRONMENT'];
    }
    $this->ahSite = $ah_site;
    $this->ahEnv = $ah_env;
    $this
      ->loadConfig();

    // Require the loadConfig implementation to set required values.
    foreach ([
      'url',
      'username',
      'password',
    ] as $key) {
      if (empty($this->{$key})) {
        throw new AcsfConfigIncompleteException(sprintf('The ACSF configuration was incomplete, no value was found for %s.', $key));
      }
    }
  }

  /**
   * Retrieves the config username.
   */
  public function getUsername() {
    return $this->username;
  }

  /**
   * Retrieves the config password.
   */
  public function getPassword() {
    return $this->password;
  }

  /**
   * Retrieves the URL of the remote service (factory).
   */
  public function getUrl() {
    return $this->url;
  }

  /**
   * Retrieves the domain suffix used for sites hosted on this ACSF environment.
   *
   * Please note: this is not always equal to the suffix of the factory URL. In
   * practice it is, except when the site factory governs sites hosted in
   * multiple regions across the world. In that case, sites hosted in specific
   * regions have a specific domain suffix - which differs from the factory
   * URL for at least one region.
   *
   * This value is empty on production sites; it is only set for staged sites.
   */
  public function getUrlSuffix() {
    return $this->urlSuffix;
  }

  /**
   * Retrieves the URL of the production factory.
   *
   * This value is empty on production sites; it is only set for staged sites.
   */
  public function getSourceUrl() {
    return $this->sourceUrl;
  }

  /**
   * Loads the configuration.
   *
   * Client code MUST populate the url, username and password properties.
   */
  protected abstract function loadConfig();

}

Classes

Name	Description
AcsfConfig	Provides an interface to define how our message configuration should work.