web/enmi/Zend/Tool/Project/Provider/Abstract.php
changeset 19 1c2f13fd785c
parent 0 4eba9c11703f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/web/enmi/Zend/Tool/Project/Provider/Abstract.php	Thu Jan 20 19:30:54 2011 +0100
@@ -0,0 +1,279 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category   Zend
+ * @package    Zend_Tool
+ * @subpackage Framework
+ * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ * @version    $Id: Abstract.php 23202 2010-10-21 15:08:15Z ralph $
+ */
+
+/**
+ * @see Zend_Tool_Project_Profile
+ */
+require_once 'Zend/Tool/Project/Profile.php';
+
+/**
+ * @see Zend_Tool_Framework_Provider_Abstract
+ */
+require_once 'Zend/Tool/Framework/Provider/Abstract.php';
+
+/**
+ * @see Zend_Tool_Project_Context_Repository
+ */
+require_once 'Zend/Tool/Project/Context/Repository.php';
+
+/**
+ * @see Zend_Tool_Project_Profile_FileParser_Xml
+ */
+require_once 'Zend/Tool/Project/Profile/FileParser/Xml.php';
+
+/**
+ * @see Zend_Tool_Framework_Registry
+ */
+require_once 'Zend/Tool/Framework/Registry.php';
+
+require_once 'Zend/Tool/Framework/Provider/Initializable.php';
+
+/**
+ * @category   Zend
+ * @package    Zend_Tool
+ * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license    http://framework.zend.com/license/new-bsd     New BSD License
+ */
+abstract class Zend_Tool_Project_Provider_Abstract
+    extends Zend_Tool_Framework_Provider_Abstract
+    implements Zend_Tool_Framework_Provider_Initializable
+{
+
+    const NO_PROFILE_THROW_EXCEPTION = true;
+    const NO_PROFILE_RETURN_FALSE    = false;
+
+    /**
+     * @var bool
+     */
+    protected static $_isInitialized = false;
+
+    protected $_projectPath = null;
+
+    /**
+     * @var Zend_Tool_Project_Profile
+     */
+    protected $_loadedProfile = null;
+
+    public function initialize()
+    {
+        // initialize the ZF Contexts (only once per php request)
+        if (!self::$_isInitialized) {
+            
+            // load all base contexts ONCE
+            $contextRegistry = Zend_Tool_Project_Context_Repository::getInstance();
+            $contextRegistry->addContextsFromDirectory(
+                dirname(dirname(__FILE__)) . '/Context/Zf/', 'Zend_Tool_Project_Context_Zf_'
+            );
+            $contextRegistry->addContextsFromDirectory(
+                dirname(dirname(__FILE__)) . '/Context/Filesystem/', 'Zend_Tool_Project_Context_Filesystem_'
+            );
+            
+            // determine if there are project specfic providers ONCE
+            $profilePath = $this->_findProfileDirectory();
+            if ($this->_hasProjectProviderDirectory($profilePath . DIRECTORY_SEPARATOR . '.zfproject.xml')) {
+                $profile = $this->_loadProfile();
+                // project providers directory resource
+                $ppd = $profile->search('ProjectProvidersDirectory');
+                $ppd->loadProviders($this->_registry);
+            }
+            
+            self::$_isInitialized = true;
+        }
+
+        // load up the extending providers required context classes
+        if ($contextClasses = $this->getContextClasses()) {
+            $this->_loadContextClassesIntoRegistry($contextClasses);
+        }
+
+    }
+
+    public function getContextClasses()
+    {
+        return array();
+    }
+
+    /**
+     * _getProject is designed to find if there is project file in the context of where
+     * the client has been called from..   The search order is as follows..
+     *    - traversing downwards from (PWD) - current working directory
+     *    - if an enpoint variable has been registered in teh client registry - key=workingDirectory
+     *    - if an ENV variable with the key ZFPROJECT_PATH is found
+     *
+     * @param $loadProfileFlag bool Whether or not to throw an exception when no profile is found
+     * @param $projectDirectory string The project directory to use to search
+     * @param $searchParentDirectories bool Whether or not to search upper level direcotries
+     * @return Zend_Tool_Project_Profile
+     */
+    protected function _loadProfile($loadProfileFlag = self::NO_PROFILE_THROW_EXCEPTION, $projectDirectory = null, $searchParentDirectories = true)
+    {
+        $foundPath = $this->_findProfileDirectory($projectDirectory, $searchParentDirectories);
+
+        if ($foundPath == false) {
+            if ($loadProfileFlag == self::NO_PROFILE_THROW_EXCEPTION) {
+                throw new Zend_Tool_Project_Provider_Exception('A project profile was not found.');
+            } else {
+                return false;
+            }
+        }
+        
+        $profile = new Zend_Tool_Project_Profile();
+        $profile->setAttribute('projectDirectory', $foundPath);
+        $profile->loadFromFile();
+        $this->_loadedProfile = $profile;
+        return $profile;
+    }
+    
+    protected function _findProfileDirectory($projectDirectory = null, $searchParentDirectories = true)
+    {
+        // use the cwd if no directory was provided
+        if ($projectDirectory == null) {
+            $projectDirectory = getcwd();
+        } elseif (realpath($projectDirectory) == false) {
+            throw new Zend_Tool_Project_Provider_Exception('The $projectDirectory supplied does not exist.');
+        }
+
+        $profile = new Zend_Tool_Project_Profile();
+
+        $parentDirectoriesArray = explode(DIRECTORY_SEPARATOR, ltrim($projectDirectory, DIRECTORY_SEPARATOR));
+        while ($parentDirectoriesArray) {
+            $projectDirectoryAssembled = implode(DIRECTORY_SEPARATOR, $parentDirectoriesArray);
+
+            if (DIRECTORY_SEPARATOR !== "\\") {
+                $projectDirectoryAssembled = DIRECTORY_SEPARATOR . $projectDirectoryAssembled;
+            }
+
+            $profile->setAttribute('projectDirectory', $projectDirectoryAssembled);
+            if ($profile->isLoadableFromFile()) {
+                unset($profile);
+                return $projectDirectoryAssembled;
+            }
+            
+            // break after first run if we are not to check upper directories
+            if ($searchParentDirectories == false) {
+                break;
+            }
+
+            array_pop($parentDirectoriesArray);
+        }
+        
+        return false;
+    }
+    
+    /**
+     * Load the project profile from the current working directory, if not throw exception
+     *
+     * @return Zend_Tool_Project_Profile
+     */
+    protected function _loadProfileRequired()
+    {
+        $profile = $this->_loadProfile();
+        if ($profile === false) {
+            require_once 'Zend/Tool/Project/Provider/Exception.php';
+            throw new Zend_Tool_Project_Provider_Exception('A project profile was not found in the current working directory.');
+        }
+        return $profile;
+    }
+
+    /**
+     * Return the currently loaded profile
+     *
+     * @return Zend_Tool_Project_Profile
+     */
+    protected function _getProfile($loadProfileFlag = self::NO_PROFILE_THROW_EXCEPTION)
+    {
+        if (!$this->_loadedProfile) {
+            if (($this->_loadProfile($loadProfileFlag) === false) && ($loadProfileFlag === self::NO_PROFILE_RETURN_FALSE)) {
+                return false;
+            }
+        }
+
+        return $this->_loadedProfile;
+    }
+
+    /**
+     * _storeProfile()
+     *
+     * This method will store the profile into its proper location
+     *
+     */
+    protected function _storeProfile()
+    {
+        $projectProfileFile = $this->_loadedProfile->search('ProjectProfileFile');
+
+        $name = $projectProfileFile->getContext()->getPath();
+
+        $this->_registry->getResponse()->appendContent('Updating project profile \'' . $name . '\'');
+
+        $projectProfileFile->getContext()->save();
+    }
+
+    protected function _getContentForContext(Zend_Tool_Project_Context_Interface $context, $methodName, $parameters)
+    {
+        $storage = $this->_registry->getStorage();
+        if (!$storage->isEnabled()) {
+            return false;
+        }
+
+        if (!class_exists('Zend_Tool_Project_Context_Content_Engine')) {
+            require_once 'Zend/Tool/Project/Context/Content/Engine.php';
+        }
+
+        $engine = new Zend_Tool_Project_Context_Content_Engine($storage);
+        return $engine->getContent($context, $methodName, $parameters);
+    }
+
+    protected function _hasProjectProviderDirectory($pathToProfileFile)
+    {
+        // do some static analysis of the file so that we can determin whether or not to incure
+        // the cost of loading the profile before the system is fully bootstrapped
+        if (!file_exists($pathToProfileFile)) {
+            return false;
+        }
+        
+        $contents = file_get_contents($pathToProfileFile);
+        if (strstr($contents, '<projectProvidersDirectory') === false) {
+            return false;
+        }
+        
+        if (strstr($contents, '<projectProvidersDirectory enabled="false"')) {
+            return false;
+        }
+        
+        return true;
+    }
+    
+    /**
+     * _loadContextClassesIntoRegistry() - This is called by the constructor
+     * so that child providers can provide a list of contexts to load into the
+     * context repository
+     *
+     * @param array $contextClasses
+     */
+    private function _loadContextClassesIntoRegistry($contextClasses)
+    {
+        $registry = Zend_Tool_Project_Context_Repository::getInstance();
+
+        foreach ($contextClasses as $contextClass) {
+            $registry->addContextClass($contextClass);
+        }
+    }
+}