]>
Commit | Line | Data |
---|---|---|
59c06b17 CS |
1 | <?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); |
2 | /** | |
3 | * CodeIgniter | |
4 | * | |
5 | * An open source application development framework for PHP 5.1.6 or newer | |
6 | * | |
7 | * @package CodeIgniter | |
8 | * @author EllisLab Dev Team | |
9 | * @copyright Copyright (c) 2006 - 2012, EllisLab, Inc. | |
10 | * @license http://codeigniter.com/user_guide/license.html | |
11 | * @link http://codeigniter.com | |
12 | * @since Version 1.0 | |
13 | * @filesource | |
14 | */ | |
15 | ||
16 | // ------------------------------------------------------------------------ | |
17 | ||
18 | /** | |
19 | * CodeIgniter Driver Library Class | |
20 | * | |
21 | * This class enables you to create "Driver" libraries that add runtime ability | |
22 | * to extend the capabilities of a class via additional driver objects | |
23 | * | |
24 | * @package CodeIgniter | |
25 | * @subpackage Libraries | |
26 | * @category Libraries | |
27 | * @author EllisLab Dev Team | |
28 | * @link | |
29 | */ | |
30 | class CI_Driver_Library { | |
31 | ||
32 | protected $valid_drivers = array(); | |
33 | protected $lib_name; | |
34 | ||
35 | // The first time a child is used it won't exist, so we instantiate it | |
36 | // subsequents calls will go straight to the proper child. | |
37 | function __get($child) | |
38 | { | |
39 | if ( ! isset($this->lib_name)) | |
40 | { | |
41 | $this->lib_name = get_class($this); | |
42 | } | |
43 | ||
44 | // The class will be prefixed with the parent lib | |
45 | $child_class = $this->lib_name.'_'.$child; | |
46 | ||
47 | // Remove the CI_ prefix and lowercase | |
48 | $lib_name = ucfirst(strtolower(str_replace('CI_', '', $this->lib_name))); | |
49 | $driver_name = strtolower(str_replace('CI_', '', $child_class)); | |
50 | ||
51 | if (in_array($driver_name, array_map('strtolower', $this->valid_drivers))) | |
52 | { | |
53 | // check and see if the driver is in a separate file | |
54 | if ( ! class_exists($child_class)) | |
55 | { | |
56 | // check application path first | |
57 | foreach (get_instance()->load->get_package_paths(TRUE) as $path) | |
58 | { | |
59 | // loves me some nesting! | |
60 | foreach (array(ucfirst($driver_name), $driver_name) as $class) | |
61 | { | |
62 | $filepath = $path.'libraries/'.$lib_name.'/drivers/'.$class.'.php'; | |
63 | ||
64 | if (file_exists($filepath)) | |
65 | { | |
66 | include_once $filepath; | |
67 | break; | |
68 | } | |
69 | } | |
70 | } | |
71 | ||
72 | // it's a valid driver, but the file simply can't be found | |
73 | if ( ! class_exists($child_class)) | |
74 | { | |
75 | log_message('error', "Unable to load the requested driver: ".$child_class); | |
76 | show_error("Unable to load the requested driver: ".$child_class); | |
77 | } | |
78 | } | |
79 | ||
80 | $obj = new $child_class; | |
81 | $obj->decorate($this); | |
82 | $this->$child = $obj; | |
83 | return $this->$child; | |
84 | } | |
85 | ||
86 | // The requested driver isn't valid! | |
87 | log_message('error', "Invalid driver requested: ".$child_class); | |
88 | show_error("Invalid driver requested: ".$child_class); | |
89 | } | |
90 | ||
91 | // -------------------------------------------------------------------- | |
92 | ||
93 | } | |
94 | // END CI_Driver_Library CLASS | |
95 | ||
96 | ||
97 | /** | |
98 | * CodeIgniter Driver Class | |
99 | * | |
100 | * This class enables you to create drivers for a Library based on the Driver Library. | |
101 | * It handles the drivers' access to the parent library | |
102 | * | |
103 | * @package CodeIgniter | |
104 | * @subpackage Libraries | |
105 | * @category Libraries | |
106 | * @author EllisLab Dev Team | |
107 | * @link | |
108 | */ | |
109 | class CI_Driver { | |
110 | protected $parent; | |
111 | ||
112 | private $methods = array(); | |
113 | private $properties = array(); | |
114 | ||
115 | private static $reflections = array(); | |
116 | ||
117 | /** | |
118 | * Decorate | |
119 | * | |
120 | * Decorates the child with the parent driver lib's methods and properties | |
121 | * | |
122 | * @param object | |
123 | * @return void | |
124 | */ | |
125 | public function decorate($parent) | |
126 | { | |
127 | $this->parent = $parent; | |
128 | ||
129 | // Lock down attributes to what is defined in the class | |
130 | // and speed up references in magic methods | |
131 | ||
132 | $class_name = get_class($parent); | |
133 | ||
134 | if ( ! isset(self::$reflections[$class_name])) | |
135 | { | |
136 | $r = new ReflectionObject($parent); | |
137 | ||
138 | foreach ($r->getMethods() as $method) | |
139 | { | |
140 | if ($method->isPublic()) | |
141 | { | |
142 | $this->methods[] = $method->getName(); | |
143 | } | |
144 | } | |
145 | ||
146 | foreach ($r->getProperties() as $prop) | |
147 | { | |
148 | if ($prop->isPublic()) | |
149 | { | |
150 | $this->properties[] = $prop->getName(); | |
151 | } | |
152 | } | |
153 | ||
154 | self::$reflections[$class_name] = array($this->methods, $this->properties); | |
155 | } | |
156 | else | |
157 | { | |
158 | list($this->methods, $this->properties) = self::$reflections[$class_name]; | |
159 | } | |
160 | } | |
161 | ||
162 | // -------------------------------------------------------------------- | |
163 | ||
164 | /** | |
165 | * __call magic method | |
166 | * | |
167 | * Handles access to the parent driver library's methods | |
168 | * | |
169 | * @access public | |
170 | * @param string | |
171 | * @param array | |
172 | * @return mixed | |
173 | */ | |
174 | public function __call($method, $args = array()) | |
175 | { | |
176 | if (in_array($method, $this->methods)) | |
177 | { | |
178 | return call_user_func_array(array($this->parent, $method), $args); | |
179 | } | |
180 | ||
181 | $trace = debug_backtrace(); | |
182 | _exception_handler(E_ERROR, "No such method '{$method}'", $trace[1]['file'], $trace[1]['line']); | |
183 | exit; | |
184 | } | |
185 | ||
186 | // -------------------------------------------------------------------- | |
187 | ||
188 | /** | |
189 | * __get magic method | |
190 | * | |
191 | * Handles reading of the parent driver library's properties | |
192 | * | |
193 | * @param string | |
194 | * @return mixed | |
195 | */ | |
196 | public function __get($var) | |
197 | { | |
198 | if (in_array($var, $this->properties)) | |
199 | { | |
200 | return $this->parent->$var; | |
201 | } | |
202 | } | |
203 | ||
204 | // -------------------------------------------------------------------- | |
205 | ||
206 | /** | |
207 | * __set magic method | |
208 | * | |
209 | * Handles writing to the parent driver library's properties | |
210 | * | |
211 | * @param string | |
212 | * @param array | |
213 | * @return mixed | |
214 | */ | |
215 | public function __set($var, $val) | |
216 | { | |
217 | if (in_array($var, $this->properties)) | |
218 | { | |
219 | $this->parent->$var = $val; | |
220 | } | |
221 | } | |
222 | ||
223 | // -------------------------------------------------------------------- | |
224 | ||
225 | } | |
226 | // END CI_Driver CLASS | |
227 | ||
228 | /* End of file Driver.php */ | |
229 | /* Location: ./system/libraries/Driver.php */ |