pictcode / lib / Cake / Console / Command / Task / TemplateTask.php @ 1a69c38c
履歴 | 表示 | アノテート | ダウンロード (6.194 KB)
| 1 | 
      <?php
     | 
  
|---|---|
| 2 | 
      /**
     | 
  
| 3 | 
       * Template Task can generate templated output Used in other Tasks
     | 
  
| 4 | 
       *
     | 
  
| 5 | 
       * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
     | 
  
| 6 | 
       * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
     | 
  
| 7 | 
       *
     | 
  
| 8 | 
       * Licensed under The MIT License
     | 
  
| 9 | 
       * For full copyright and license information, please see the LICENSE.txt
     | 
  
| 10 | 
       * Redistributions of files must retain the above copyright notice.
     | 
  
| 11 | 
       *
     | 
  
| 12 | 
       * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
     | 
  
| 13 | 
       * @link          http://cakephp.org CakePHP(tm) Project
     | 
  
| 14 | 
       * @since         CakePHP(tm) v 1.3
     | 
  
| 15 | 
       * @license       http://www.opensource.org/licenses/mit-license.php MIT License
     | 
  
| 16 | 
       */
     | 
  
| 17 | 
       | 
  
| 18 | 
      App::uses('AppShell', 'Console/Command');  | 
  
| 19 | 
      App::uses('Folder', 'Utility');  | 
  
| 20 | 
       | 
  
| 21 | 
      /**
     | 
  
| 22 | 
       * Template Task can generate templated output Used in other Tasks.
     | 
  
| 23 | 
       * Acts like a simplified View class.
     | 
  
| 24 | 
       *
     | 
  
| 25 | 
       * @package       Cake.Console.Command.Task
     | 
  
| 26 | 
       */
     | 
  
| 27 | 
      class TemplateTask extends AppShell {  | 
  
| 28 | 
       | 
  
| 29 | 
      /**
     | 
  
| 30 | 
       * variables to add to template scope
     | 
  
| 31 | 
       *
     | 
  
| 32 | 
       * @var array
     | 
  
| 33 | 
       */
     | 
  
| 34 | 
      public $templateVars = array();  | 
  
| 35 | 
       | 
  
| 36 | 
      /**
     | 
  
| 37 | 
       * Paths to look for templates on.
     | 
  
| 38 | 
       * Contains a list of $theme => $path
     | 
  
| 39 | 
       *
     | 
  
| 40 | 
       * @var array
     | 
  
| 41 | 
       */
     | 
  
| 42 | 
      public $templatePaths = array();  | 
  
| 43 | 
       | 
  
| 44 | 
      /**
     | 
  
| 45 | 
       * Initialize callback. Setup paths for the template task.
     | 
  
| 46 | 
       *
     | 
  
| 47 | 
       * @return void
     | 
  
| 48 | 
       */
     | 
  
| 49 | 
      public function initialize() {  | 
  
| 50 | 
      $this->templatePaths = $this->_findThemes();  | 
  
| 51 | 
      }  | 
  
| 52 | 
       | 
  
| 53 | 
      /**
     | 
  
| 54 | 
       * Find the paths to all the installed shell themes in the app.
     | 
  
| 55 | 
       *
     | 
  
| 56 | 
       * Bake themes are directories not named `skel` inside a `Console/Templates` path.
     | 
  
| 57 | 
       * They are listed in this order: app -> plugin -> default
     | 
  
| 58 | 
       *
     | 
  
| 59 | 
       * @return array Array of bake themes that are installed.
     | 
  
| 60 | 
       */
     | 
  
| 61 | 
      protected function _findThemes() {  | 
  
| 62 | 
      $paths = App::path('Console');  | 
  
| 63 | 
       | 
  
| 64 | 
      $plugins = App::objects('plugin');  | 
  
| 65 | 
      foreach ($plugins as $plugin) {  | 
  
| 66 | 
      $paths[] = $this->_pluginPath($plugin) . 'Console' . DS;  | 
  
| 67 | 
      }  | 
  
| 68 | 
       | 
  
| 69 | 
      $core = current(App::core('Console'));  | 
  
| 70 | 
      $separator = DS === '/' ? '/' : '\\\\';  | 
  
| 71 | 
      $core = preg_replace('#shells' . $separator . '$#', '', $core);  | 
  
| 72 | 
       | 
  
| 73 | 
      $Folder = new Folder($core . 'Templates' . DS . 'default');  | 
  
| 74 | 
       | 
  
| 75 | 
      $contents = $Folder->read();  | 
  
| 76 | 
      $themeFolders = $contents[0];  | 
  
| 77 | 
       | 
  
| 78 | 
      $paths[] = $core;  | 
  
| 79 | 
       | 
  
| 80 | 
      foreach ($paths as $i => $path) {  | 
  
| 81 | 
      $paths[$i] = rtrim($path, DS) . DS;  | 
  
| 82 | 
      }  | 
  
| 83 | 
       | 
  
| 84 | 
      $themes = array();  | 
  
| 85 | 
      foreach ($paths as $path) {  | 
  
| 86 | 
      $Folder = new Folder($path . 'Templates', false);  | 
  
| 87 | 
      $contents = $Folder->read();  | 
  
| 88 | 
      $subDirs = $contents[0];  | 
  
| 89 | 
      foreach ($subDirs as $dir) {  | 
  
| 90 | 
      if (empty($dir) || preg_match('@^skel$|_skel$@', $dir)) {  | 
  
| 91 | 
                                              continue;
     | 
  
| 92 | 
      }  | 
  
| 93 | 
      $Folder = new Folder($path . 'Templates' . DS . $dir);  | 
  
| 94 | 
      $contents = $Folder->read();  | 
  
| 95 | 
      $subDirs = $contents[0];  | 
  
| 96 | 
      if (array_intersect($contents[0], $themeFolders)) {  | 
  
| 97 | 
      $templateDir = $path . 'Templates' . DS . $dir . DS;  | 
  
| 98 | 
      $themes[$dir] = $templateDir;  | 
  
| 99 | 
      }  | 
  
| 100 | 
      }  | 
  
| 101 | 
      }  | 
  
| 102 | 
      return $themes;  | 
  
| 103 | 
      }  | 
  
| 104 | 
       | 
  
| 105 | 
      /**
     | 
  
| 106 | 
       * Set variable values to the template scope
     | 
  
| 107 | 
       *
     | 
  
| 108 | 
       * @param string|array $one A string or an array of data.
     | 
  
| 109 | 
       * @param string|array $two Value in case $one is a string (which then works as the key).
     | 
  
| 110 | 
       *   Unused if $one is an associative array, otherwise serves as the values to $one's keys.
     | 
  
| 111 | 
       * @return void
     | 
  
| 112 | 
       */
     | 
  
| 113 | 
      public function set($one, $two = null) {  | 
  
| 114 | 
      if (is_array($one)) {  | 
  
| 115 | 
      if (is_array($two)) {  | 
  
| 116 | 
      $data = array_combine($one, $two);  | 
  
| 117 | 
                              } else {
     | 
  
| 118 | 
      $data = $one;  | 
  
| 119 | 
      }  | 
  
| 120 | 
                      } else {
     | 
  
| 121 | 
      $data = array($one => $two);  | 
  
| 122 | 
      }  | 
  
| 123 | 
       | 
  
| 124 | 
      if (!$data) {  | 
  
| 125 | 
      return false;  | 
  
| 126 | 
      }  | 
  
| 127 | 
      $this->templateVars = $data + $this->templateVars;  | 
  
| 128 | 
      }  | 
  
| 129 | 
       | 
  
| 130 | 
      /**
     | 
  
| 131 | 
       * Runs the template
     | 
  
| 132 | 
       *
     | 
  
| 133 | 
       * @param string $directory directory / type of thing you want
     | 
  
| 134 | 
       * @param string $filename template name
     | 
  
| 135 | 
       * @param array $vars Additional vars to set to template scope.
     | 
  
| 136 | 
       * @return string contents of generated code template
     | 
  
| 137 | 
       */
     | 
  
| 138 | 
      public function generate($directory, $filename, $vars = null) {  | 
  
| 139 | 
      if ($vars !== null) {  | 
  
| 140 | 
      $this->set($vars);  | 
  
| 141 | 
      }  | 
  
| 142 | 
      if (empty($this->templatePaths)) {  | 
  
| 143 | 
                              $this->initialize();
     | 
  
| 144 | 
      }  | 
  
| 145 | 
      $themePath = $this->getThemePath();  | 
  
| 146 | 
      $templateFile = $this->_findTemplate($themePath, $directory, $filename);  | 
  
| 147 | 
      if ($templateFile) {  | 
  
| 148 | 
      extract($this->templateVars);  | 
  
| 149 | 
      ob_start();  | 
  
| 150 | 
                              ob_implicit_flush(0);
     | 
  
| 151 | 
      include $templateFile;  | 
  
| 152 | 
                              $content = ob_get_clean();
     | 
  
| 153 | 
      return $content;  | 
  
| 154 | 
      }  | 
  
| 155 | 
      return '';  | 
  
| 156 | 
      }  | 
  
| 157 | 
       | 
  
| 158 | 
      /**
     | 
  
| 159 | 
       * Find the theme name for the current operation.
     | 
  
| 160 | 
       * If there is only one theme in $templatePaths it will be used.
     | 
  
| 161 | 
       * If there is a -theme param in the cli args, it will be used.
     | 
  
| 162 | 
       * If there is more than one installed theme user interaction will happen
     | 
  
| 163 | 
       *
     | 
  
| 164 | 
       * @return string returns the path to the selected theme.
     | 
  
| 165 | 
       */
     | 
  
| 166 | 
      public function getThemePath() {  | 
  
| 167 | 
      if (count($this->templatePaths) === 1) {  | 
  
| 168 | 
      $paths = array_values($this->templatePaths);  | 
  
| 169 | 
      return $paths[0];  | 
  
| 170 | 
      }  | 
  
| 171 | 
      if (!empty($this->params['theme']) && isset($this->templatePaths[$this->params['theme']])) {  | 
  
| 172 | 
      return $this->templatePaths[$this->params['theme']];  | 
  
| 173 | 
      }  | 
  
| 174 | 
       | 
  
| 175 | 
                      $this->hr();
     | 
  
| 176 | 
      $this->out(__d('cake_console', 'You have more than one set of templates installed.'));  | 
  
| 177 | 
      $this->out(__d('cake_console', 'Please choose the template set you wish to use:'));  | 
  
| 178 | 
                      $this->hr();
     | 
  
| 179 | 
       | 
  
| 180 | 
      $i = 1;  | 
  
| 181 | 
      $indexedPaths = array();  | 
  
| 182 | 
      foreach ($this->templatePaths as $key => $path) {  | 
  
| 183 | 
      $this->out($i . '. ' . $key);  | 
  
| 184 | 
      $indexedPaths[$i] = $path;  | 
  
| 185 | 
                              $i++;
     | 
  
| 186 | 
      }  | 
  
| 187 | 
      $index = $this->in(__d('cake_console', 'Which bake theme would you like to use?'), range(1, $i - 1), 1);  | 
  
| 188 | 
      $themeNames = array_keys($this->templatePaths);  | 
  
| 189 | 
      $this->params['theme'] = $themeNames[$index - 1];  | 
  
| 190 | 
      return $indexedPaths[$index];  | 
  
| 191 | 
      }  | 
  
| 192 | 
       | 
  
| 193 | 
      /**
     | 
  
| 194 | 
       * Find a template inside a directory inside a path.
     | 
  
| 195 | 
       * Will scan all other theme dirs if the template is not found in the first directory.
     | 
  
| 196 | 
       *
     | 
  
| 197 | 
       * @param string $path The initial path to look for the file on. If it is not found fallbacks will be used.
     | 
  
| 198 | 
       * @param string $directory Subdirectory to look for ie. 'views', 'objects'
     | 
  
| 199 | 
       * @param string $filename lower_case_underscored filename you want.
     | 
  
| 200 | 
       * @return string filename will exit program if template is not found.
     | 
  
| 201 | 
       */
     | 
  
| 202 | 
      protected function _findTemplate($path, $directory, $filename) {  | 
  
| 203 | 
      $themeFile = $path . $directory . DS . $filename . '.ctp';  | 
  
| 204 | 
      if (file_exists($themeFile)) {  | 
  
| 205 | 
      return $themeFile;  | 
  
| 206 | 
      }  | 
  
| 207 | 
      foreach ($this->templatePaths as $path) {  | 
  
| 208 | 
      $templatePath = $path . $directory . DS . $filename . '.ctp';  | 
  
| 209 | 
      if (file_exists($templatePath)) {  | 
  
| 210 | 
      return $templatePath;  | 
  
| 211 | 
      }  | 
  
| 212 | 
      }  | 
  
| 213 | 
      $this->err(__d('cake_console', 'Could not find template for %s', $filename));  | 
  
| 214 | 
      return false;  | 
  
| 215 | 
      }  | 
  
| 216 | 
       | 
  
| 217 | 
      }  |