drupal-civicrm/sites/all/modules/civicrm/CRM/Extension/Container/Basic.php
2018-01-14 13:10:16 +00:00

283 lines
8 KiB
PHP

<?php
/*
+--------------------------------------------------------------------+
| CiviCRM version 4.7 |
+--------------------------------------------------------------------+
| Copyright CiviCRM LLC (c) 2004-2017 |
+--------------------------------------------------------------------+
| This file is a part of CiviCRM. |
| |
| CiviCRM is free software; you can copy, modify, and distribute it |
| under the terms of the GNU Affero General Public License |
| Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
| |
| CiviCRM is distributed in the hope that it will be useful, but |
| WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
| See the GNU Affero General Public License for more details. |
| |
| You should have received a copy of the GNU Affero General Public |
| License and the CiviCRM Licensing Exception along |
| with this program; if not, contact CiviCRM LLC |
| at info[AT]civicrm[DOT]org. If you have questions about the |
| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
*/
/**
* @package CRM
* @copyright CiviCRM LLC (c) 2004-2017
*/
/**
* An extension container is a locally-accessible source tree which can be
* scanned for extensions.
*/
class CRM_Extension_Container_Basic implements CRM_Extension_Container_Interface {
/**
* @var string
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $baseDir;
/**
* @var string
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $baseUrl;
/**
* @var CRM_Utils_Cache_Interface|NULL
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $cache;
/**
* @var string the cache key used for any data stored by this container
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $cacheKey;
/**
* @var array($key => $relPath)
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $relPaths = FALSE;
/**
* @var array($key => $relUrl)
*
* Derived from $relPaths. On Unix systems (where file-paths and
* URL-paths both use '/' separator), this isn't necessary. On Windows
* systems, this is derived from $relPaths.
*
* Note: Treat as private. This is only public to facilitate debugging.
*/
public $relUrls = FALSE;
/**
* @param string $baseDir
* Local path to the container.
* @param string $baseUrl
* Public URL of the container.
* @param CRM_Utils_Cache_Interface $cache
* Cache in which to store extension metadata.
* @param string $cacheKey
* Unique name for this container.
*/
public function __construct($baseDir, $baseUrl, CRM_Utils_Cache_Interface $cache = NULL, $cacheKey = NULL) {
$this->cache = $cache;
$this->cacheKey = $cacheKey;
$this->baseDir = rtrim($baseDir, '/');
$this->baseUrl = rtrim($baseUrl, '/');
}
/**
* @inheritDoc
*
* @return array
*/
public function checkRequirements() {
$errors = array();
if (empty($this->baseDir) || !is_dir($this->baseDir)) {
$errors[] = array(
'title' => ts('Invalid Base Directory'),
'message' => ts('An extension container has been defined with a blank directory.'),
);
}
if (empty($this->baseUrl)) {
$errors[] = array(
'title' => ts('Invalid Base URL'),
'message' => ts('An extension container has been defined with a blank URL.'),
);
}
return $errors;
}
/**
* @inheritDoc
*
* @return array_keys
*/
public function getKeys() {
return array_keys($this->getRelPaths());
}
/**
* @inheritDoc
*/
public function getPath($key) {
return $this->baseDir . $this->getRelPath($key);
}
/**
* @inheritDoc
*/
public function getResUrl($key) {
if (!$this->baseUrl) {
CRM_Core_Session::setStatus(
ts('Failed to determine URL for extension (%1). Please update <a href="%2">Resource URLs</a>.',
array(
1 => $key,
2 => CRM_Utils_System::url('civicrm/admin/setting/url', 'reset=1'),
)
)
);
}
return $this->baseUrl . $this->getRelUrl($key);
}
/**
* @inheritDoc
*/
public function refresh() {
$this->relPaths = NULL;
if ($this->cache) {
$this->cache->delete($this->cacheKey);
}
}
/**
* @return string
*/
public function getBaseDir() {
return $this->baseDir;
}
/**
* Determine the relative path of an extension directory.
*
* @param string $key
* Extension name.
*
* @throws CRM_Extension_Exception_MissingException
* @return string
*/
protected function getRelPath($key) {
$keypaths = $this->getRelPaths();
if (!isset($keypaths[$key])) {
throw new CRM_Extension_Exception_MissingException("Failed to find extension: $key");
}
return $keypaths[$key];
}
/**
* Scan $basedir for a list of extension-keys
*
* @return array
* ($key => $relPath)
*/
protected function getRelPaths() {
if (!is_array($this->relPaths)) {
if ($this->cache) {
$this->relPaths = $this->cache->get($this->cacheKey);
}
if (!is_array($this->relPaths)) {
$this->relPaths = array();
$infoPaths = CRM_Utils_File::findFiles($this->baseDir, 'info.xml');
foreach ($infoPaths as $infoPath) {
$relPath = CRM_Utils_File::relativize(dirname($infoPath), $this->baseDir);
try {
$info = CRM_Extension_Info::loadFromFile($infoPath);
}
catch (CRM_Extension_Exception_ParseException $e) {
CRM_Core_Session::setStatus(ts('Parse error in extension: %1', array(
1 => $e->getMessage(),
)), '', 'error');
CRM_Core_Error::debug_log_message("Parse error in extension: " . $e->getMessage());
continue;
}
$this->relPaths[$info->key] = $relPath;
}
if ($this->cache) {
$this->cache->set($this->cacheKey, $this->relPaths);
}
}
}
return $this->relPaths;
}
/**
* Determine the relative path of an extension directory.
*
* @param string $key
* Extension name.
*
* @throws CRM_Extension_Exception_MissingException
* @return string
*/
protected function getRelUrl($key) {
$relUrls = $this->getRelUrls();
if (!isset($relUrls[$key])) {
throw new CRM_Extension_Exception_MissingException("Failed to find extension: $key");
}
return $relUrls[$key];
}
/**
* Scan $basedir for a list of extension-keys
*
* @return array
* ($key => $relUrl)
*/
protected function getRelUrls() {
if (DIRECTORY_SEPARATOR == '/') {
return $this->getRelPaths();
}
if (!is_array($this->relUrls)) {
$this->relUrls = self::convertPathsToUrls(DIRECTORY_SEPARATOR, $this->getRelPaths());
}
return $this->relUrls;
}
/**
* Convert a list of relative paths to relative URLs.
*
* Note: Treat as private. This is only public to facilitate testing.
*
* @param string $dirSep
* Directory separator ("/" or "\").
* @param array $relPaths
* Array($key => $relPath).
* @return array
* Array($key => $relUrl).
*/
public static function convertPathsToUrls($dirSep, $relPaths) {
$relUrls = array();
foreach ($relPaths as $key => $relPath) {
$relUrls[$key] = str_replace($dirSep, '/', $relPath);
}
return $relUrls;
}
}