1
<?xml version="1.0" encoding="iso-8859-1"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml">
5
<!-- template designed by Marco Von Ballmoos -->
6
<title>File Source for PhpThumb.inc.php</title>
7
<link rel="stylesheet" href="../media/stylesheet.css" />
8
<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
11
<h1>Source for file PhpThumb.inc.php</h1>
12
<p>Documentation is available at <a href="../PhpThumb/_legacy---PhpThumb.inc.php.html">PhpThumb.inc.php</a></p>
13
<div class="src-code">
14
<div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
15
<li><div class="src-line"><a name="a2"></a><span class="src-doc">/**</span></div></li>
16
<li><div class="src-line"><a name="a3"></a><span class="src-doc"> * PhpThumb Library Definition File</span></div></li>
17
<li><div class="src-line"><a name="a4"></a><span class="src-doc"> * </span></div></li>
18
<li><div class="src-line"><a name="a5"></a><span class="src-doc"> * This file contains the definitions for the PhpThumb class.</span></div></li>
19
<li><div class="src-line"><a name="a6"></a><span class="src-doc"> * </span></div></li>
20
<li><div class="src-line"><a name="a7"></a><span class="src-doc"> * PHP Version 5 with GD 2.0+</span></div></li>
21
<li><div class="src-line"><a name="a8"></a><span class="src-doc"> * PhpThumb : PHP Thumb Library <http://phpthumb.gxdlabs.com></span></div></li>
22
<li><div class="src-line"><a name="a9"></a><span class="src-doc"> * Copyright (c) 2009, Ian Selby/Gen X Design</span></div></li>
23
<li><div class="src-line"><a name="a10"></a><span class="src-doc"> * </span></div></li>
24
<li><div class="src-line"><a name="a11"></a><span class="src-doc"> * Author(s): Ian Selby <ian@gen-x-design.com></span></div></li>
25
<li><div class="src-line"><a name="a12"></a><span class="src-doc"> * </span></div></li>
26
<li><div class="src-line"><a name="a13"></a><span class="src-doc"> * Licensed under the MIT License</span></div></li>
27
<li><div class="src-line"><a name="a14"></a><span class="src-doc"> * Redistributions of files must retain the above copyright notice.</span></div></li>
28
<li><div class="src-line"><a name="a15"></a><span class="src-doc"> * </span></div></li>
29
<li><div class="src-line"><a name="a16"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Ian Selby <ian@gen-x-design.com></span></div></li>
30
<li><div class="src-line"><a name="a17"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> Copyright (c) 2009 Gen X Design</span></div></li>
31
<li><div class="src-line"><a name="a18"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@link</span><span class="src-doc"> http://phpthumb.gxdlabs.com</span></div></li>
32
<li><div class="src-line"><a name="a19"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.opensource.org/licenses/mit-license.php The MIT License</span></div></li>
33
<li><div class="src-line"><a name="a20"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> 3.0</span></div></li>
34
<li><div class="src-line"><a name="a21"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PhpThumb</span></div></li>
35
<li><div class="src-line"><a name="a22"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@filesource</span></div></li>
36
<li><div class="src-line"><a name="a23"></a><span class="src-doc"> */</span></div></li>
37
<li><div class="src-line"><a name="a24"></a> </div></li>
38
<li><div class="src-line"><a name="a25"></a> </div></li>
39
<li><div class="src-line"><a name="a26"></a> </div></li>
40
<li><div class="src-line"><a name="a27"></a><span class="src-doc">/**</span></div></li>
41
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * PhpThumb Object</span></div></li>
42
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> * </span></div></li>
43
<li><div class="src-line"><a name="a30"></a><span class="src-doc"> * This singleton object is essentially a function library that helps with core validation</span></div></li>
44
<li><div class="src-line"><a name="a31"></a><span class="src-doc"> * and loading of the core classes and plugins. There isn't really any need to access it directly,</span></div></li>
45
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * unless you're developing a plugin and need to take advantage of any of the functionality contained</span></div></li>
46
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> * within.</span></div></li>
47
<li><div class="src-line"><a name="a34"></a><span class="src-doc"> * </span></div></li>
48
<li><div class="src-line"><a name="a35"></a><span class="src-doc"> * If you're not familiar with singleton patterns, here's how you get an instance of this class (since you</span></div></li>
49
<li><div class="src-line"><a name="a36"></a><span class="src-doc"> * can't create one via the new keyword):</span></div></li>
50
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> * <code>$pt = PhpThumb::getInstance();</code></span></div></li>
51
<li><div class="src-line"><a name="a38"></a><span class="src-doc"> * </span></div></li>
52
<li><div class="src-line"><a name="a39"></a><span class="src-doc"> * It's that simple! Outside of that, there's no need to modify anything within this class, unless you're doing</span></div></li>
53
<li><div class="src-line"><a name="a40"></a><span class="src-doc"> * some crazy customization... then knock yourself out! :)</span></div></li>
54
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> * </span></div></li>
55
<li><div class="src-line"><a name="a42"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PhpThumb</span></div></li>
56
<li><div class="src-line"><a name="a43"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@subpackage</span><span class="src-doc"> Core</span></div></li>
57
<li><div class="src-line"><a name="a44"></a><span class="src-doc"> */</span></div></li>
58
<li><div class="src-line"><a name="a45"></a><span class="src-key">class </span><a href="../PhpThumb/Core/PhpThumb.html">PhpThumb</a></div></li>
59
<li><div class="src-line"><a name="a46"></a><span class="src-sym">{</span></div></li>
60
<li><div class="src-line"><a name="a47"></a> <span class="src-doc">/**</span></div></li>
61
<li><div class="src-line"><a name="a48"></a><span class="src-doc"> * Instance of self</span></div></li>
62
<li><div class="src-line"><a name="a49"></a><span class="src-doc"> * </span></div></li>
63
<li><div class="src-line"><a name="a50"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">object </span><span class="src-doc-type">PhpThumb </span></div></li>
64
<li><div class="src-line"><a name="a51"></a><span class="src-doc"> */</span></div></li>
65
<li><div class="src-line"><a name="a52"></a> <span class="src-key">protected </span><span class="src-key">static </span><span class="src-var">$_instance</span><span class="src-sym">;</span></div></li>
66
<li><div class="src-line"><a name="a53"></a> <span class="src-doc">/**</span></div></li>
67
<li><div class="src-line"><a name="a54"></a><span class="src-doc"> * The plugin registry</span></div></li>
68
<li><div class="src-line"><a name="a55"></a><span class="src-doc"> * </span></div></li>
69
<li><div class="src-line"><a name="a56"></a><span class="src-doc"> * This is where all plugins to be loaded are stored. Data about the plugin is</span></div></li>
70
<li><div class="src-line"><a name="a57"></a><span class="src-doc"> * provided, and currently consists of:</span></div></li>
71
<li><div class="src-line"><a name="a58"></a><span class="src-doc"> * - loaded: true/false</span></div></li>
72
<li><div class="src-line"><a name="a59"></a><span class="src-doc"> * - implementation: gd/imagick/both</span></div></li>
73
<li><div class="src-line"><a name="a60"></a><span class="src-doc"> * </span></div></li>
74
<li><div class="src-line"><a name="a61"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">array </span></div></li>
75
<li><div class="src-line"><a name="a62"></a><span class="src-doc"> */</span></div></li>
76
<li><div class="src-line"><a name="a63"></a> <span class="src-key">protected </span><a href="../PhpThumb/Core/PhpThumb.html#var$_registry">$_registry</a><span class="src-sym">;</span></div></li>
77
<li><div class="src-line"><a name="a64"></a> <span class="src-doc">/**</span></div></li>
78
<li><div class="src-line"><a name="a65"></a><span class="src-doc"> * What implementations are available</span></div></li>
79
<li><div class="src-line"><a name="a66"></a><span class="src-doc"> * </span></div></li>
80
<li><div class="src-line"><a name="a67"></a><span class="src-doc"> * This stores what implementations are available based on the loaded</span></div></li>
81
<li><div class="src-line"><a name="a68"></a><span class="src-doc"> * extensions in PHP, NOT whether or not the class files are present.</span></div></li>
82
<li><div class="src-line"><a name="a69"></a><span class="src-doc"> * </span></div></li>
83
<li><div class="src-line"><a name="a70"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">array </span></div></li>
84
<li><div class="src-line"><a name="a71"></a><span class="src-doc"> */</span></div></li>
85
<li><div class="src-line"><a name="a72"></a> <span class="src-key">protected </span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">$_implementations</a><span class="src-sym">;</span></div></li>
86
<li><div class="src-line"><a name="a73"></a> </div></li>
87
<li><div class="src-line"><a name="a74"></a> <span class="src-doc">/**</span></div></li>
88
<li><div class="src-line"><a name="a75"></a><span class="src-doc"> * Returns an instance of self</span></div></li>
89
<li><div class="src-line"><a name="a76"></a><span class="src-doc"> * </span></div></li>
90
<li><div class="src-line"><a name="a77"></a><span class="src-doc"> * This is the usual singleton function that returns / instantiates the object</span></div></li>
91
<li><div class="src-line"><a name="a78"></a><span class="src-doc"> * </span></div></li>
92
<li><div class="src-line"><a name="a79"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">PhpThumb </span></div></li>
93
<li><div class="src-line"><a name="a80"></a><span class="src-doc"> */</span></div></li>
94
<li><div class="src-line"><a name="a81"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PhpThumb/Core/PhpThumb.html#methodgetInstance">getInstance</a> <span class="src-sym">(</span><span class="src-sym">)</span></div></li>
95
<li><div class="src-line"><a name="a82"></a> <span class="src-sym">{</span></div></li>
96
<li><div class="src-line"><a name="a83"></a> <span class="src-key">if</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_instance </span>instanceof <span class="src-id">self</span><span class="src-sym">))</span></div></li>
97
<li><div class="src-line"><a name="a84"></a> <span class="src-sym">{</span></div></li>
98
<li><div class="src-line"><a name="a85"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_instance </span>= <span class="src-key">new </span><span class="src-id">self</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
99
<li><div class="src-line"><a name="a86"></a> <span class="src-sym">}</span></div></li>
100
<li><div class="src-line"><a name="a87"></a> </div></li>
101
<li><div class="src-line"><a name="a88"></a> <span class="src-key">return </span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_instance</span><span class="src-sym">;</span></div></li>
102
<li><div class="src-line"><a name="a89"></a> <span class="src-sym">}</span></div></li>
103
<li><div class="src-line"><a name="a90"></a> </div></li>
104
<li><div class="src-line"><a name="a91"></a> <span class="src-doc">/**</span></div></li>
105
<li><div class="src-line"><a name="a92"></a><span class="src-doc"> * Class constructor</span></div></li>
106
<li><div class="src-line"><a name="a93"></a><span class="src-doc"> * </span></div></li>
107
<li><div class="src-line"><a name="a94"></a><span class="src-doc"> * Initializes all the variables, and does some preliminary validation / checking of stuff</span></div></li>
108
<li><div class="src-line"><a name="a95"></a><span class="src-doc"> * </span></div></li>
109
<li><div class="src-line"><a name="a96"></a><span class="src-doc"> */</span></div></li>
110
<li><div class="src-line"><a name="a97"></a> <span class="src-key">private </span><span class="src-key">function </span><span class="src-id">__construct </span><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
111
<li><div class="src-line"><a name="a98"></a> <span class="src-sym">{</span></div></li>
112
<li><div class="src-line"><a name="a99"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_registry">_registry</a> = <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
113
<li><div class="src-line"><a name="a100"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a> = <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'gd' </span>=> <span class="src-id">false</span><span class="src-sym">, </span><span class="src-str">'imagick' </span>=> <span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
114
<li><div class="src-line"><a name="a101"></a> </div></li>
115
<li><div class="src-line"><a name="a102"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-id">getImplementations</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
116
<li><div class="src-line"><a name="a103"></a> <span class="src-sym">}</span></div></li>
117
<li><div class="src-line"><a name="a104"></a> </div></li>
118
<li><div class="src-line"><a name="a105"></a> <span class="src-doc">/**</span></div></li>
119
<li><div class="src-line"><a name="a106"></a><span class="src-doc"> * Finds out what implementations are available</span></div></li>
120
<li><div class="src-line"><a name="a107"></a><span class="src-doc"> * </span></div></li>
121
<li><div class="src-line"><a name="a108"></a><span class="src-doc"> * This function loops over $this->_implementations and validates that the required extensions are loaded.</span></div></li>
122
<li><div class="src-line"><a name="a109"></a><span class="src-doc"> * </span></div></li>
123
<li><div class="src-line"><a name="a110"></a><span class="src-doc"> * I had planned on attempting to load them dynamically via dl(), but that would provide more overhead than I</span></div></li>
124
<li><div class="src-line"><a name="a111"></a><span class="src-doc"> * was comfortable with (and would probably fail 99% of the time anyway)</span></div></li>
125
<li><div class="src-line"><a name="a112"></a><span class="src-doc"> * </span></div></li>
126
<li><div class="src-line"><a name="a113"></a><span class="src-doc"> */</span></div></li>
127
<li><div class="src-line"><a name="a114"></a> <span class="src-key">private </span><span class="src-key">function </span><span class="src-id">getImplementations </span><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
128
<li><div class="src-line"><a name="a115"></a> <span class="src-sym">{</span></div></li>
129
<li><div class="src-line"><a name="a116"></a> <span class="src-key">foreach</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a> <span class="src-key">as </span><span class="src-var">$extension </span>=> <span class="src-var">$loaded</span><span class="src-sym">)</span></div></li>
130
<li><div class="src-line"><a name="a117"></a> <span class="src-sym">{</span></div></li>
131
<li><div class="src-line"><a name="a118"></a> <span class="src-key">if</span><span class="src-sym">(</span><span class="src-var">$loaded</span><span class="src-sym">)</span></div></li>
132
<li><div class="src-line"><a name="a119"></a> <span class="src-sym">{</span></div></li>
133
<li><div class="src-line"><a name="a120"></a> <span class="src-key">continue</span><span class="src-sym">;</span></div></li>
134
<li><div class="src-line"><a name="a121"></a> <span class="src-sym">}</span></div></li>
135
<li><div class="src-line"><a name="a122"></a> </div></li>
136
<li><div class="src-line"><a name="a123"></a> <span class="src-key">if</span><span class="src-sym">(</span><a href="http://www.php.net/extension_loaded">extension_loaded</a><span class="src-sym">(</span><span class="src-var">$extension</span><span class="src-sym">))</span></div></li>
137
<li><div class="src-line"><a name="a124"></a> <span class="src-sym">{</span></div></li>
138
<li><div class="src-line"><a name="a125"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a><span class="src-sym">[</span><span class="src-var">$extension</span><span class="src-sym">] </span>= <span class="src-id">true</span><span class="src-sym">;</span></div></li>
139
<li><div class="src-line"><a name="a126"></a> <span class="src-sym">}</span></div></li>
140
<li><div class="src-line"><a name="a127"></a> <span class="src-sym">}</span></div></li>
141
<li><div class="src-line"><a name="a128"></a> <span class="src-sym">}</span></div></li>
142
<li><div class="src-line"><a name="a129"></a> </div></li>
143
<li><div class="src-line"><a name="a130"></a> <span class="src-doc">/**</span></div></li>
144
<li><div class="src-line"><a name="a131"></a><span class="src-doc"> * Returns whether or not $implementation is valid (available)</span></div></li>
145
<li><div class="src-line"><a name="a132"></a><span class="src-doc"> * </span></div></li>
146
<li><div class="src-line"><a name="a133"></a><span class="src-doc"> * If 'all' is passed, true is only returned if ALL implementations are available.</span></div></li>
147
<li><div class="src-line"><a name="a134"></a><span class="src-doc"> * </span></div></li>
148
<li><div class="src-line"><a name="a135"></a><span class="src-doc"> * You can also pass 'n/a', which always returns true</span></div></li>
149
<li><div class="src-line"><a name="a136"></a><span class="src-doc"> * </span></div></li>
150
<li><div class="src-line"><a name="a137"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">bool </span></div></li>
151
<li><div class="src-line"><a name="a138"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$implementation </span></div></li>
152
<li><div class="src-line"><a name="a139"></a><span class="src-doc"> */</span></div></li>
153
<li><div class="src-line"><a name="a140"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../PhpThumb/Core/PhpThumb.html#methodisValidImplementation">isValidImplementation</a> <span class="src-sym">(</span><span class="src-var">$implementation</span><span class="src-sym">)</span></div></li>
154
<li><div class="src-line"><a name="a141"></a> <span class="src-sym">{</span></div></li>
155
<li><div class="src-line"><a name="a142"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$implementation </span>== <span class="src-str">'n/a'</span><span class="src-sym">)</span></div></li>
156
<li><div class="src-line"><a name="a143"></a> <span class="src-sym">{</span></div></li>
157
<li><div class="src-line"><a name="a144"></a> <span class="src-key">return </span><span class="src-id">true</span><span class="src-sym">;</span></div></li>
158
<li><div class="src-line"><a name="a145"></a> <span class="src-sym">}</span></div></li>
159
<li><div class="src-line"><a name="a146"></a> </div></li>
160
<li><div class="src-line"><a name="a147"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$implementation </span>== <span class="src-str">'all'</span><span class="src-sym">)</span></div></li>
161
<li><div class="src-line"><a name="a148"></a> <span class="src-sym">{</span></div></li>
162
<li><div class="src-line"><a name="a149"></a> <span class="src-key">foreach </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a> <span class="src-key">as </span><span class="src-var">$imp </span>=> <span class="src-var">$value</span><span class="src-sym">)</span></div></li>
163
<li><div class="src-line"><a name="a150"></a> <span class="src-sym">{</span></div></li>
164
<li><div class="src-line"><a name="a151"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$value </span>== <span class="src-id">false</span><span class="src-sym">)</span></div></li>
165
<li><div class="src-line"><a name="a152"></a> <span class="src-sym">{</span></div></li>
166
<li><div class="src-line"><a name="a153"></a> <span class="src-key">return </span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
167
<li><div class="src-line"><a name="a154"></a> <span class="src-sym">}</span></div></li>
168
<li><div class="src-line"><a name="a155"></a> <span class="src-sym">}</span></div></li>
169
<li><div class="src-line"><a name="a156"></a> </div></li>
170
<li><div class="src-line"><a name="a157"></a> <span class="src-key">return </span><span class="src-id">true</span><span class="src-sym">;</span></div></li>
171
<li><div class="src-line"><a name="a158"></a> <span class="src-sym">}</span></div></li>
172
<li><div class="src-line"><a name="a159"></a> </div></li>
173
<li><div class="src-line"><a name="a160"></a> <span class="src-key">if </span><span class="src-sym">(</span><a href="http://www.php.net/array_key_exists">array_key_exists</a><span class="src-sym">(</span><span class="src-var">$implementation</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a><span class="src-sym">))</span></div></li>
174
<li><div class="src-line"><a name="a161"></a> <span class="src-sym">{</span></div></li>
175
<li><div class="src-line"><a name="a162"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_implementations">_implementations</a><span class="src-sym">[</span><span class="src-var">$implementation</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
176
<li><div class="src-line"><a name="a163"></a> <span class="src-sym">}</span></div></li>
177
<li><div class="src-line"><a name="a164"></a> </div></li>
178
<li><div class="src-line"><a name="a165"></a> <span class="src-key">return </span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
179
<li><div class="src-line"><a name="a166"></a> <span class="src-sym">}</span></div></li>
180
<li><div class="src-line"><a name="a167"></a> </div></li>
181
<li><div class="src-line"><a name="a168"></a> <span class="src-doc">/**</span></div></li>
182
<li><div class="src-line"><a name="a169"></a><span class="src-doc"> * Registers a plugin in the registry</span></div></li>
183
<li><div class="src-line"><a name="a170"></a><span class="src-doc"> * </span></div></li>
184
<li><div class="src-line"><a name="a171"></a><span class="src-doc"> * Adds a plugin to the registry if it isn't already loaded, and if the provided</span></div></li>
185
<li><div class="src-line"><a name="a172"></a><span class="src-doc"> * implementation is valid. Note that you can pass the following special keywords</span></div></li>
186
<li><div class="src-line"><a name="a173"></a><span class="src-doc"> * for implementation:</span></div></li>
187
<li><div class="src-line"><a name="a174"></a><span class="src-doc"> * - all - Requires that all implementations be available</span></div></li>
188
<li><div class="src-line"><a name="a175"></a><span class="src-doc"> * - n/a - Doesn't require any implementation</span></div></li>
189
<li><div class="src-line"><a name="a176"></a><span class="src-doc"> * </span></div></li>
190
<li><div class="src-line"><a name="a177"></a><span class="src-doc"> * When a plugin is added to the registry, it's added as a key on $this->_registry with the value</span></div></li>
191
<li><div class="src-line"><a name="a178"></a><span class="src-doc"> * being an array containing the following keys:</span></div></li>
192
<li><div class="src-line"><a name="a179"></a><span class="src-doc"> * - loaded - whether or not the plugin has been "loaded" into the core class</span></div></li>
193
<li><div class="src-line"><a name="a180"></a><span class="src-doc"> * - implementation - what implementation this plugin is valid for</span></div></li>
194
<li><div class="src-line"><a name="a181"></a><span class="src-doc"> * </span></div></li>
195
<li><div class="src-line"><a name="a182"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">bool </span></div></li>
196
<li><div class="src-line"><a name="a183"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$pluginName </span></div></li>
197
<li><div class="src-line"><a name="a184"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$implementation </span></div></li>
198
<li><div class="src-line"><a name="a185"></a><span class="src-doc"> */</span></div></li>
199
<li><div class="src-line"><a name="a186"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../PhpThumb/Core/PhpThumb.html#methodregisterPlugin">registerPlugin</a> <span class="src-sym">(</span><span class="src-var">$pluginName</span><span class="src-sym">, </span><span class="src-var">$implementation</span><span class="src-sym">)</span></div></li>
200
<li><div class="src-line"><a name="a187"></a> <span class="src-sym">{</span></div></li>
201
<li><div class="src-line"><a name="a188"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><a href="http://www.php.net/array_key_exists">array_key_exists</a><span class="src-sym">(</span><span class="src-var">$pluginName</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_registry">_registry</a><span class="src-sym">) </span>&& <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#methodisValidImplementation">isValidImplementation</a><span class="src-sym">(</span><span class="src-var">$implementation</span><span class="src-sym">))</span></div></li>
202
<li><div class="src-line"><a name="a189"></a> <span class="src-sym">{</span></div></li>
203
<li><div class="src-line"><a name="a190"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_registry">_registry</a><span class="src-sym">[</span><span class="src-var">$pluginName</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'loaded' </span>=> <span class="src-id">false</span><span class="src-sym">, </span><span class="src-str">'implementation' </span>=> <span class="src-var">$implementation</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
204
<li><div class="src-line"><a name="a191"></a> <span class="src-key">return </span><span class="src-id">true</span><span class="src-sym">;</span></div></li>
205
<li><div class="src-line"><a name="a192"></a> <span class="src-sym">}</span></div></li>
206
<li><div class="src-line"><a name="a193"></a> </div></li>
207
<li><div class="src-line"><a name="a194"></a> <span class="src-key">return </span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
208
<li><div class="src-line"><a name="a195"></a> <span class="src-sym">}</span></div></li>
209
<li><div class="src-line"><a name="a196"></a> </div></li>
210
<li><div class="src-line"><a name="a197"></a> <span class="src-doc">/**</span></div></li>
211
<li><div class="src-line"><a name="a198"></a><span class="src-doc"> * Loads all the plugins in $pluginPath</span></div></li>
212
<li><div class="src-line"><a name="a199"></a><span class="src-doc"> * </span></div></li>
213
<li><div class="src-line"><a name="a200"></a><span class="src-doc"> * All this function does is include all files inside the $pluginPath directory. The plugins themselves</span></div></li>
214
<li><div class="src-line"><a name="a201"></a><span class="src-doc"> * will not be added to the registry unless you've properly added the code to do so inside your plugin file.</span></div></li>
215
<li><div class="src-line"><a name="a202"></a><span class="src-doc"> * </span></div></li>
216
<li><div class="src-line"><a name="a203"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$pluginPath </span></div></li>
217
<li><div class="src-line"><a name="a204"></a><span class="src-doc"> */</span></div></li>
218
<li><div class="src-line"><a name="a205"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../PhpThumb/Core/PhpThumb.html#methodloadPlugins">loadPlugins</a> <span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">)</span></div></li>
219
<li><div class="src-line"><a name="a206"></a> <span class="src-sym">{</span></div></li>
220
<li><div class="src-line"><a name="a207"></a> <span class="src-comm">// strip the trailing slash if present</span></div></li>
221
<li><div class="src-line"><a name="a208"></a> <span class="src-key">if </span><span class="src-sym">(</span><a href="http://www.php.net/substr">substr</a><span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">, </span><a href="http://www.php.net/strlen">strlen</a><span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">) </span>- <span class="src-num">1</span><span class="src-sym">, </span><span class="src-num">1</span><span class="src-sym">) </span>== <span class="src-str">'/'</span><span class="src-sym">)</span></div></li>
222
<li><div class="src-line"><a name="a209"></a> <span class="src-sym">{</span></div></li>
223
<li><div class="src-line"><a name="a210"></a> <span class="src-var">$pluginPath </span>= <a href="http://www.php.net/substr">substr</a><span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">, </span><span class="src-num">0</span><span class="src-sym">, </span><a href="http://www.php.net/strlen">strlen</a><span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">) </span>- <span class="src-num">1</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
224
<li><div class="src-line"><a name="a211"></a> <span class="src-sym">}</span></div></li>
225
<li><div class="src-line"><a name="a212"></a> </div></li>
226
<li><div class="src-line"><a name="a213"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$handle </span>= <a href="http://www.php.net/opendir">opendir</a><span class="src-sym">(</span><span class="src-var">$pluginPath</span><span class="src-sym">))</span></div></li>
227
<li><div class="src-line"><a name="a214"></a> <span class="src-sym">{</span></div></li>
228
<li><div class="src-line"><a name="a215"></a> <span class="src-key">while </span><span class="src-sym">(</span><span class="src-id">false </span>!== <span class="src-sym">(</span><span class="src-var">$file </span>= <a href="http://www.php.net/readdir">readdir</a><span class="src-sym">(</span><span class="src-var">$handle</span><span class="src-sym">)))</span></div></li>
229
<li><div class="src-line"><a name="a216"></a> <span class="src-sym">{</span></div></li>
230
<li><div class="src-line"><a name="a217"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$file </span>== <span class="src-str">'.' </span>|| <span class="src-var">$file </span>== <span class="src-str">'..' </span>|| <span class="src-var">$file </span>== <span class="src-str">'.svn'</span><span class="src-sym">)</span></div></li>
231
<li><div class="src-line"><a name="a218"></a> <span class="src-sym">{</span></div></li>
232
<li><div class="src-line"><a name="a219"></a> <span class="src-key">continue</span><span class="src-sym">;</span></div></li>
233
<li><div class="src-line"><a name="a220"></a> <span class="src-sym">}</span></div></li>
234
<li><div class="src-line"><a name="a221"></a> </div></li>
235
<li><div class="src-line"><a name="a222"></a> <span class="src-inc">include_once</span><span class="src-sym">(</span><span class="src-var">$pluginPath </span>. <span class="src-str">'/' </span>. <span class="src-var">$file</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
236
<li><div class="src-line"><a name="a223"></a> <span class="src-sym">}</span></div></li>
237
<li><div class="src-line"><a name="a224"></a> <span class="src-sym">}</span></div></li>
238
<li><div class="src-line"><a name="a225"></a> <span class="src-sym">}</span></div></li>
239
<li><div class="src-line"><a name="a226"></a> </div></li>
240
<li><div class="src-line"><a name="a227"></a> <span class="src-doc">/**</span></div></li>
241
<li><div class="src-line"><a name="a228"></a><span class="src-doc"> * Returns the plugin registry for the supplied implementation</span></div></li>
242
<li><div class="src-line"><a name="a229"></a><span class="src-doc"> * </span></div></li>
243
<li><div class="src-line"><a name="a230"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">array </span></div></li>
244
<li><div class="src-line"><a name="a231"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$implementation </span></div></li>
245
<li><div class="src-line"><a name="a232"></a><span class="src-doc"> */</span></div></li>
246
<li><div class="src-line"><a name="a233"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../PhpThumb/Core/PhpThumb.html#methodgetPluginRegistry">getPluginRegistry</a> <span class="src-sym">(</span><span class="src-var">$implementation</span><span class="src-sym">)</span></div></li>
247
<li><div class="src-line"><a name="a234"></a> <span class="src-sym">{</span></div></li>
248
<li><div class="src-line"><a name="a235"></a> <span class="src-var">$returnArray </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
249
<li><div class="src-line"><a name="a236"></a> </div></li>
250
<li><div class="src-line"><a name="a237"></a> <span class="src-key">foreach </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../PhpThumb/Core/PhpThumb.html#var$_registry">_registry</a> <span class="src-key">as </span><span class="src-var">$plugin </span>=> <span class="src-var">$meta</span><span class="src-sym">)</span></div></li>
251
<li><div class="src-line"><a name="a238"></a> <span class="src-sym">{</span></div></li>
252
<li><div class="src-line"><a name="a239"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$meta</span><span class="src-sym">[</span><span class="src-str">'implementation'</span><span class="src-sym">] </span>== <span class="src-str">'n/a' </span>|| <span class="src-var">$meta</span><span class="src-sym">[</span><span class="src-str">'implementation'</span><span class="src-sym">] </span>== <span class="src-var">$implementation</span><span class="src-sym">)</span></div></li>
253
<li><div class="src-line"><a name="a240"></a> <span class="src-sym">{</span></div></li>
254
<li><div class="src-line"><a name="a241"></a> <span class="src-var">$returnArray</span><span class="src-sym">[</span><span class="src-var">$plugin</span><span class="src-sym">] </span>= <span class="src-var">$meta</span><span class="src-sym">;</span></div></li>
255
<li><div class="src-line"><a name="a242"></a> <span class="src-sym">}</span></div></li>
256
<li><div class="src-line"><a name="a243"></a> <span class="src-sym">}</span></div></li>
257
<li><div class="src-line"><a name="a244"></a> </div></li>
258
<li><div class="src-line"><a name="a245"></a> <span class="src-key">return </span><span class="src-var">$returnArray</span><span class="src-sym">;</span></div></li>
259
<li><div class="src-line"><a name="a246"></a> <span class="src-sym">}</span></div></li>
260
<li><div class="src-line"><a name="a247"></a><span class="src-sym">}</span></div></li>
263
<p class="notes" id="credit">
264
Documentation generated on Tue, 09 Aug 2011 09:05:33 +0200 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
b'\\ No newline at end of file'
added
removed
other/phpdoc/__filesource/fsource_PhpThumb__legacyPhpThumb.inc.php.html
