3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.3 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
29 * This class handles downloads of remotely-provided extensions
32 * @copyright CiviCRM LLC (c) 2004-2013
36 class CRM_Extension_Downloader
{
38 * @var CRM_Extension_Container_Basic the place where downloaded extensions are ultimately stored
43 * @var string local path to a temporary data directory
48 * @param string $containerDir the place to store downloaded & extracted extensions
49 * @param string $tmpDir
51 public function __construct(CRM_Extension_Manager
$manager, $containerDir, $tmpDir) {
52 $this->manager
= $manager;
53 $this->containerDir
= $containerDir;
54 $this->tmpDir
= $tmpDir;
58 * Determine whether downloading is supported
60 * @return array list of error messages; empty if OK
62 public function checkRequirements() {
65 if (!$this->containerDir ||
!is_dir($this->containerDir
) ||
!is_writeable($this->containerDir
)) {
66 $civicrmDestination = urlencode(CRM_Utils_System
::url('civicrm/admin/extensions', 'reset=1'));
67 $url = CRM_Utils_System
::url('civicrm/admin/setting/path', "reset=1&civicrmDestination=${civicrmDestination}");
69 'title' => ts('Directory Unwritable'),
70 //'message' => ts('Your extensions directory: %1 is not web server writable. Please go to the <a href="%2">path setting page</a> and correct it.<br/>',
71 'message' => ts("Your extensions directory is not set or is not writable. Click <a href='%1'>here</a> to set the extensions directory.",
73 //1 => $this->containerDir,
80 if (!class_exists('ZipArchive')) {
82 'title' => ts('ZIP Support Required'),
83 'message' => ts('You will not be able to install extensions at this time because your installation of PHP does not support ZIP archives. Please ask your system administrator to install the standard PHP-ZIP extension.'),
91 * Install or upgrade an extension from a remote URL
93 * @param string $key the name of the extension being installed
94 * @param string $downloadUrl URL of a .zip file
95 * @return bool TRUE for success
96 * @throws CRM_Extension_Exception
98 public function download($key, $downloadUrl) {
99 $filename = $this->tmpDir
. DIRECTORY_SEPARATOR
. $key . '.zip';
100 $destDir = $this->containerDir
. DIRECTORY_SEPARATOR
. $key;
103 CRM_Core_Error
::fatal('Cannot install this extension - downloadUrl is not set!');
106 if (! $this->fetch($downloadUrl, $filename)) {
110 $extractedZipPath = $this->extractFiles($key, $filename);
111 if (! $extractedZipPath) {
115 if (! $this->validateFiles($key, $extractedZipPath)) {
119 $this->manager
->replace($extractedZipPath);
125 * Download the remote zipfile.
127 * @param string $remoteFile URL of a .zip file
128 * @param string $localFile path at which to store the .zip file
129 * @return boolean Whether the download was successful.
131 public function fetch($remoteFile, $localFile) {
132 $result = CRM_Utils_HttpClient
::singleton()->fetch($remoteFile, $localFile);
134 case CRM_Utils_HttpClient
::STATUS_OK
:
142 * Extract an extension from a zip file
144 * @param string $key the name of the extension being installed; this usually matches the basedir in the .zip
145 * @param string $zipFile the local path to a .zip file
146 * @return string|FALSE zip file path
148 public function extractFiles($key, $zipFile) {
149 $config = CRM_Core_Config
::singleton();
151 $zip = new ZipArchive();
152 $res = $zip->open($zipFile);
154 $zipSubDir = CRM_Utils_Zip
::guessBasedir($zip, $key);
155 if ($zipSubDir === FALSE) {
156 CRM_Core_Session
::setStatus(ts('Unable to extract the extension: bad directory structure'), '', 'error');
159 $extractedZipPath = $this->tmpDir
. DIRECTORY_SEPARATOR
. $zipSubDir;
160 if (is_dir($extractedZipPath)) {
161 if (!CRM_Utils_File
::cleanDir($extractedZipPath, TRUE, FALSE)) {
162 CRM_Core_Session
::setStatus(ts('Unable to extract the extension: %1 cannot be cleared', array(1 => $extractedZipPath)), ts('Installation Error'), 'error');
166 if (!$zip->extractTo($this->tmpDir
)) {
167 CRM_Core_Session
::setStatus(ts('Unable to extract the extension to %1.', array(1 => $this->tmpDir
)), ts('Installation Error'), 'error');
173 CRM_Core_Session
::setStatus(ts('Unable to extract the extension.'), '', 'error');
177 return $extractedZipPath;
181 * Validate that $extractedZipPath contains valid for extension $key
185 function validateFiles($key, $extractedZipPath) {
186 $filename = $extractedZipPath . DIRECTORY_SEPARATOR
. CRM_Extension_Info
::FILENAME
;
187 if (!is_readable($filename)) {
188 CRM_Core_Session
::setStatus(ts('Failed reading data from %1 during installation', array(1 => $filename)), ts('Installation Error'), 'error');
193 $newInfo = CRM_Extension_Info
::loadFromFile($filename);
194 } catch (Exception
$e) {
195 CRM_Core_Session
::setStatus(ts('Failed reading data from %1 during installation', array(1 => $filename)), ts('Installation Error'), 'error');
199 if ($newInfo->key
!= $key) {
200 CRM_Core_Error
::fatal('Cannot install - there are differences between extdir XML file and archive XML file!');