pictcode / lib / Cake / Console / Command / Task / TemplateTask.php @ 0b1b8047
履歴 | 表示 | アノテート | ダウンロード (6.194 KB)
1 | 635eef61 | spyder1211 | <?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 | } |