<html> <head> <title>Coverage for Doctrine_Export_Firebird</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Export_Firebird</h1><p><a href="index.php">Back to coverage report</a></p><table> <tr><td>1</td> <td class="normal"><?php </td></tr> <tr><td>2</td> <td class="normal">/* </td></tr> <tr><td>3</td> <td class="normal"> * $Id: Firebird.php 3034 2007-10-29 22:57:32Z zYne $ </td></tr> <tr><td>4</td> <td class="normal"> * </td></tr> <tr><td>5</td> <td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS </td></tr> <tr><td>6</td> <td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT </td></tr> <tr><td>7</td> <td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR </td></tr> <tr><td>8</td> <td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT </td></tr> <tr><td>9</td> <td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, </td></tr> <tr><td>10</td> <td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT </td></tr> <tr><td>11</td> <td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, </td></tr> <tr><td>12</td> <td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY </td></tr> <tr><td>13</td> <td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT </td></tr> <tr><td>14</td> <td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE </td></tr> <tr><td>15</td> <td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </td></tr> <tr><td>16</td> <td class="normal"> * </td></tr> <tr><td>17</td> <td class="normal"> * This software consists of voluntary contributions made by many individuals </td></tr> <tr><td>18</td> <td class="normal"> * and is licensed under the LGPL. For more information, see </td></tr> <tr><td>19</td> <td class="normal"> * <http://www.phpdoctrine.com>. </td></tr> <tr><td>20</td> <td class="normal"> */ </td></tr> <tr><td>21</td> <td class="covered">Doctrine::autoload('Doctrine_Export'); </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Export_Sqlite </td></tr> <tr><td>24</td> <td class="normal"> * </td></tr> <tr><td>25</td> <td class="normal"> * @package Doctrine </td></tr> <tr><td>26</td> <td class="normal"> * @subpackage Export </td></tr> <tr><td>27</td> <td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>28</td> <td class="normal"> * @author Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library) </td></tr> <tr><td>29</td> <td class="normal"> * @author Lorenzo Alberton <l.alberton@quipo.it> (PEAR MDB2 Interbase driver) </td></tr> <tr><td>30</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>31</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>32</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>33</td> <td class="normal"> * @version $Revision: 3034 $ </td></tr> <tr><td>34</td> <td class="normal"> */ </td></tr> <tr><td>35</td> <td class="covered">class Doctrine_Export_Firebird extends Doctrine_Export </td></tr> <tr><td>36</td> <td class="normal">{ </td></tr> <tr><td>37</td> <td class="normal"> /** </td></tr> <tr><td>38</td> <td class="normal"> * create a new database </td></tr> <tr><td>39</td> <td class="normal"> * </td></tr> <tr><td>40</td> <td class="normal"> * @param string $name name of the database that should be created </td></tr> <tr><td>41</td> <td class="normal"> * @return void </td></tr> <tr><td>42</td> <td class="normal"> */ </td></tr> <tr><td>43</td> <td class="normal"> public function createDatabase($name) </td></tr> <tr><td>44</td> <td class="normal"> { </td></tr> <tr><td>45</td> <td class="covered"> throw new Doctrine_Export_Exception( </td></tr> <tr><td>46</td> <td class="normal"> 'PHP Interbase API does not support direct queries. You have to ' . </td></tr> <tr><td>47</td> <td class="covered"> 'create the db manually by using isql command or a similar program'); </td></tr> <tr><td>48</td> <td class="orange"> } </td></tr> <tr><td>49</td> <td class="normal"> </td></tr> <tr><td>50</td> <td class="normal"> /** </td></tr> <tr><td>51</td> <td class="normal"> * drop an existing database </td></tr> <tr><td>52</td> <td class="normal"> * </td></tr> <tr><td>53</td> <td class="normal"> * @param string $name name of the database that should be dropped </td></tr> <tr><td>54</td> <td class="normal"> * @return void </td></tr> <tr><td>55</td> <td class="normal"> */ </td></tr> <tr><td>56</td> <td class="normal"> public function dropDatabase($name) </td></tr> <tr><td>57</td> <td class="normal"> { </td></tr> <tr><td>58</td> <td class="covered"> throw new Doctrine_Export_Exception( </td></tr> <tr><td>59</td> <td class="normal"> 'PHP Interbase API does not support direct queries. You have ' . </td></tr> <tr><td>60</td> <td class="covered"> 'to drop the db manually by using isql command or a similar program'); </td></tr> <tr><td>61</td> <td class="orange"> } </td></tr> <tr><td>62</td> <td class="normal"> </td></tr> <tr><td>63</td> <td class="normal"> /** </td></tr> <tr><td>64</td> <td class="normal"> * add an autoincrement sequence + trigger </td></tr> <tr><td>65</td> <td class="normal"> * </td></tr> <tr><td>66</td> <td class="normal"> * @param string $name name of the PK field </td></tr> <tr><td>67</td> <td class="normal"> * @param string $table name of the table </td></tr> <tr><td>68</td> <td class="normal"> * @param string $start start value for the sequence </td></tr> <tr><td>69</td> <td class="normal"> * @return void </td></tr> <tr><td>70</td> <td class="normal"> */ </td></tr> <tr><td>71</td> <td class="normal"> public function _makeAutoincrement($name, $table, $start = null) </td></tr> <tr><td>72</td> <td class="normal"> { </td></tr> <tr><td>73</td> <td class="covered"> if (is_null($start)) { </td></tr> <tr><td>74</td> <td class="red"> $this->conn->beginTransaction(); </td></tr> <tr><td>75</td> <td class="red"> $query = 'SELECT MAX(' . $this->conn->quoteIdentifier($name, true) . ') FROM ' . $this->conn->quoteIdentifier($table, true); </td></tr> <tr><td>76</td> <td class="red"> $start = $this->conn->fetchOne($query, 'integer'); </td></tr> <tr><td>77</td> <td class="normal"> </td></tr> <tr><td>78</td> <td class="red"> ++$start; </td></tr> <tr><td>79</td> <td class="red"> $result = $this->createSequence($table, $start); </td></tr> <tr><td>80</td> <td class="red"> $this->conn->commit(); </td></tr> <tr><td>81</td> <td class="red"> } else { </td></tr> <tr><td>82</td> <td class="covered"> $result = $this->createSequence($table, $start); </td></tr> <tr><td>83</td> <td class="normal"> } </td></tr> <tr><td>84</td> <td class="normal"> </td></tr> <tr><td>85</td> <td class="covered"> $sequence_name = $this->conn->formatter->getSequenceName($table); </td></tr> <tr><td>86</td> <td class="covered"> $trigger_name = $this->conn->quoteIdentifier($table . '_AUTOINCREMENT_PK', true); </td></tr> <tr><td>87</td> <td class="normal"> </td></tr> <tr><td>88</td> <td class="covered"> $table = $this->conn->quoteIdentifier($table, true); </td></tr> <tr><td>89</td> <td class="covered"> $name = $this->conn->quoteIdentifier($name, true); </td></tr> <tr><td>90</td> <td class="normal"> </td></tr> <tr><td>91</td> <td class="covered"> $triggerSql = 'CREATE TRIGGER ' . $trigger_name . ' FOR ' . $table </td></tr> <tr><td>92</td> <td class="covered"> . ' ACTIVE BEFORE INSERT POSITION 0 AS' </td></tr> <tr><td>93</td> <td class="covered"> . ' BEGIN' </td></tr> <tr><td>94</td> <td class="covered"> . ' IF (NEW.' . $name . ' IS NULL OR NEW.' . $name . ' = 0) THEN' </td></tr> <tr><td>95</td> <td class="covered"> . ' NEW.' . $name . ' = GEN_ID('.$sequence_name.', 1)' </td></tr> <tr><td>96</td> <td class="covered"> . ' END'; </td></tr> <tr><td>97</td> <td class="covered"> $result = $this->conn->exec($triggerSql); </td></tr> <tr><td>98</td> <td class="normal"> </td></tr> <tr><td>99</td> <td class="normal"> // TODO ? $this->_silentCommit(); </td></tr> <tr><td>100</td> <td class="normal"> </td></tr> <tr><td>101</td> <td class="covered"> return $result; </td></tr> <tr><td>102</td> <td class="orange"> } </td></tr> <tr><td>103</td> <td class="normal"> </td></tr> <tr><td>104</td> <td class="normal"> /** </td></tr> <tr><td>105</td> <td class="normal"> * drop an existing autoincrement sequence + trigger </td></tr> <tr><td>106</td> <td class="normal"> * </td></tr> <tr><td>107</td> <td class="normal"> * @param string $table name of the table </td></tr> <tr><td>108</td> <td class="normal"> * @return void </td></tr> <tr><td>109</td> <td class="normal"> */ </td></tr> <tr><td>110</td> <td class="normal"> public function _dropAutoincrement($table) </td></tr> <tr><td>111</td> <td class="normal"> { </td></tr> <tr><td>112</td> <td class="normal"> </td></tr> <tr><td>113</td> <td class="red"> $result = $this->dropSequence($table); </td></tr> <tr><td>114</td> <td class="normal"> </td></tr> <tr><td>115</td> <td class="normal"> //remove autoincrement trigger associated with the table </td></tr> <tr><td>116</td> <td class="red"> $table = $this->conn->quote(strtoupper($table)); </td></tr> <tr><td>117</td> <td class="red"> $triggerName = $this->conn->quote(strtoupper($table) . '_AUTOINCREMENT_PK'); </td></tr> <tr><td>118</td> <td class="normal"> </td></tr> <tr><td>119</td> <td class="red"> return $this->conn->exec("DELETE FROM RDB\$TRIGGERS WHERE UPPER(RDB\$RELATION_NAME)=" . $table . " AND UPPER(RDB\$TRIGGER_NAME)=" . $triggerName); </td></tr> <tr><td>120</td> <td class="orange"> } </td></tr> <tr><td>121</td> <td class="normal"> </td></tr> <tr><td>122</td> <td class="normal"> /** </td></tr> <tr><td>123</td> <td class="normal"> * create a new table </td></tr> <tr><td>124</td> <td class="normal"> * </td></tr> <tr><td>125</td> <td class="normal"> * @param string $name Name of the database that should be created </td></tr> <tr><td>126</td> <td class="normal"> * @param array $fields Associative array that contains the definition of each field of the new table </td></tr> <tr><td>127</td> <td class="normal"> * The indexes of the array entries are the names of the fields of the table an </td></tr> <tr><td>128</td> <td class="normal"> * the array entry values are associative arrays like those that are meant to be </td></tr> <tr><td>129</td> <td class="normal"> * passed with the field definitions to get[Type]Declaration() functions. </td></tr> <tr><td>130</td> <td class="normal"> * </td></tr> <tr><td>131</td> <td class="normal"> * Example </td></tr> <tr><td>132</td> <td class="normal"> * array( </td></tr> <tr><td>133</td> <td class="normal"> * </td></tr> <tr><td>134</td> <td class="normal"> * 'id' => array( </td></tr> <tr><td>135</td> <td class="normal"> * 'type' => 'integer', </td></tr> <tr><td>136</td> <td class="normal"> * 'unsigned' => 1, </td></tr> <tr><td>137</td> <td class="normal"> * 'notnull' => 1, </td></tr> <tr><td>138</td> <td class="normal"> * 'default' => 0, </td></tr> <tr><td>139</td> <td class="normal"> * ), </td></tr> <tr><td>140</td> <td class="normal"> * 'name' => array( </td></tr> <tr><td>141</td> <td class="normal"> * 'type' => 'text', </td></tr> <tr><td>142</td> <td class="normal"> * 'length' => 12, </td></tr> <tr><td>143</td> <td class="normal"> * ), </td></tr> <tr><td>144</td> <td class="normal"> * 'description' => array( </td></tr> <tr><td>145</td> <td class="normal"> * 'type' => 'text', </td></tr> <tr><td>146</td> <td class="normal"> * 'length' => 12, </td></tr> <tr><td>147</td> <td class="normal"> * ) </td></tr> <tr><td>148</td> <td class="normal"> * ); </td></tr> <tr><td>149</td> <td class="normal"> * @param array $options An associative array of table options: </td></tr> <tr><td>150</td> <td class="normal"> * </td></tr> <tr><td>151</td> <td class="normal"> * @return void </td></tr> <tr><td>152</td> <td class="normal"> */ </td></tr> <tr><td>153</td> <td class="normal"> public function createTable($name, array $fields, array $options = array()) { </td></tr> <tr><td>154</td> <td class="covered"> parent::createTable($name, $fields, $options); </td></tr> <tr><td>155</td> <td class="normal"> </td></tr> <tr><td>156</td> <td class="normal"> // TODO ? $this->_silentCommit(); </td></tr> <tr><td>157</td> <td class="covered"> foreach ($fields as $field_name => $field) { </td></tr> <tr><td>158</td> <td class="covered"> if ( ! empty($field['autoincrement'])) { </td></tr> <tr><td>159</td> <td class="normal"> //create PK constraint </td></tr> <tr><td>160</td> <td class="normal"> $pk_definition = array( </td></tr> <tr><td>161</td> <td class="covered"> 'fields' => array($field_name => array()), </td></tr> <tr><td>162</td> <td class="covered"> 'primary' => true, </td></tr> <tr><td>163</td> <td class="covered"> ); </td></tr> <tr><td>164</td> <td class="normal"> //$pk_name = $name.'_PK'; </td></tr> <tr><td>165</td> <td class="covered"> $pk_name = null; </td></tr> <tr><td>166</td> <td class="covered"> $result = $this->createConstraint($name, $pk_name, $pk_definition); </td></tr> <tr><td>167</td> <td class="normal"> </td></tr> <tr><td>168</td> <td class="normal"> //create autoincrement sequence + trigger </td></tr> <tr><td>169</td> <td class="covered"> return $this->_makeAutoincrement($field_name, $name, 1); </td></tr> <tr><td>170</td> <td class="orange"> } </td></tr> <tr><td>171</td> <td class="covered"> } </td></tr> <tr><td>172</td> <td class="covered"> } </td></tr> <tr><td>173</td> <td class="normal"> </td></tr> <tr><td>174</td> <td class="normal"> /** </td></tr> <tr><td>175</td> <td class="normal"> * Check if planned changes are supported </td></tr> <tr><td>176</td> <td class="normal"> * </td></tr> <tr><td>177</td> <td class="normal"> * @param string $name name of the database that should be dropped </td></tr> <tr><td>178</td> <td class="normal"> * @return void </td></tr> <tr><td>179</td> <td class="normal"> */ </td></tr> <tr><td>180</td> <td class="normal"> public function checkSupportedChanges(&$changes) </td></tr> <tr><td>181</td> <td class="normal"> { </td></tr> <tr><td>182</td> <td class="red"> foreach ($changes as $change_name => $change) { </td></tr> <tr><td>183</td> <td class="normal"> switch ($change_name) { </td></tr> <tr><td>184</td> <td class="red"> case 'notnull': </td></tr> <tr><td>185</td> <td class="red"> throw new Doctrine_DataDict_Exception('it is not supported changes to field not null constraint'); </td></tr> <tr><td>186</td> <td class="red"> case 'default': </td></tr> <tr><td>187</td> <td class="red"> throw new Doctrine_DataDict_Exception('it is not supported changes to field default value'); </td></tr> <tr><td>188</td> <td class="red"> case 'length': </td></tr> <tr><td>189</td> <td class="normal"> /* </td></tr> <tr><td>190</td> <td class="normal"> return throw new Doctrine_DataDict_Firebird_Exception('it is not supported changes to field default length'); </td></tr> <tr><td>191</td> <td class="normal"> */ </td></tr> <tr><td>192</td> <td class="red"> case 'unsigned': </td></tr> <tr><td>193</td> <td class="red"> case 'type': </td></tr> <tr><td>194</td> <td class="red"> case 'declaration': </td></tr> <tr><td>195</td> <td class="red"> case 'definition': </td></tr> <tr><td>196</td> <td class="red"> break; </td></tr> <tr><td>197</td> <td class="red"> default: </td></tr> <tr><td>198</td> <td class="red"> throw new Doctrine_DataDict_Exception('it is not supported change of type' . $change_name); </td></tr> <tr><td>199</td> <td class="red"> } </td></tr> <tr><td>200</td> <td class="red"> } </td></tr> <tr><td>201</td> <td class="red"> return true; </td></tr> <tr><td>202</td> <td class="orange"> } </td></tr> <tr><td>203</td> <td class="normal"> </td></tr> <tr><td>204</td> <td class="normal"> /** </td></tr> <tr><td>205</td> <td class="normal"> * drop an existing table </td></tr> <tr><td>206</td> <td class="normal"> * </td></tr> <tr><td>207</td> <td class="normal"> * @param string $name name of the table that should be dropped </td></tr> <tr><td>208</td> <td class="normal"> * @return mixed MDB2_OK on success, a MDB2 error on failure </td></tr> <tr><td>209</td> <td class="normal"> * @access public </td></tr> <tr><td>210</td> <td class="normal"> */ </td></tr> <tr><td>211</td> <td class="normal"> public function dropTable($name) </td></tr> <tr><td>212</td> <td class="normal"> { </td></tr> <tr><td>213</td> <td class="red"> $result = $this->_dropAutoincrement($name); </td></tr> <tr><td>214</td> <td class="red"> $result = parent::dropTable($name); </td></tr> <tr><td>215</td> <td class="normal"> </td></tr> <tr><td>216</td> <td class="normal"> //$this->_silentCommit(); </td></tr> <tr><td>217</td> <td class="normal"> </td></tr> <tr><td>218</td> <td class="red"> return $result; </td></tr> <tr><td>219</td> <td class="orange"> } </td></tr> <tr><td>220</td> <td class="normal"> </td></tr> <tr><td>221</td> <td class="normal"> /** </td></tr> <tr><td>222</td> <td class="normal"> * alter an existing table </td></tr> <tr><td>223</td> <td class="normal"> * </td></tr> <tr><td>224</td> <td class="normal"> * @param string $name name of the table that is intended to be changed. </td></tr> <tr><td>225</td> <td class="normal"> * @param array $changes associative array that contains the details of each type </td></tr> <tr><td>226</td> <td class="normal"> * of change that is intended to be performed. The types of </td></tr> <tr><td>227</td> <td class="normal"> * changes that are currently supported are defined as follows: </td></tr> <tr><td>228</td> <td class="normal"> * </td></tr> <tr><td>229</td> <td class="normal"> * name </td></tr> <tr><td>230</td> <td class="normal"> * </td></tr> <tr><td>231</td> <td class="normal"> * New name for the table. </td></tr> <tr><td>232</td> <td class="normal"> * </td></tr> <tr><td>233</td> <td class="normal"> * add </td></tr> <tr><td>234</td> <td class="normal"> * </td></tr> <tr><td>235</td> <td class="normal"> * Associative array with the names of fields to be added as </td></tr> <tr><td>236</td> <td class="normal"> * indexes of the array. The value of each entry of the array </td></tr> <tr><td>237</td> <td class="normal"> * should be set to another associative array with the properties </td></tr> <tr><td>238</td> <td class="normal"> * of the fields to be added. The properties of the fields should </td></tr> <tr><td>239</td> <td class="normal"> * be the same as defined by the Metabase parser. </td></tr> <tr><td>240</td> <td class="normal"> * </td></tr> <tr><td>241</td> <td class="normal"> * </td></tr> <tr><td>242</td> <td class="normal"> * remove </td></tr> <tr><td>243</td> <td class="normal"> * </td></tr> <tr><td>244</td> <td class="normal"> * Associative array with the names of fields to be removed as indexes </td></tr> <tr><td>245</td> <td class="normal"> * of the array. Currently the values assigned to each entry are ignored. </td></tr> <tr><td>246</td> <td class="normal"> * An empty array should be used for future compatibility. </td></tr> <tr><td>247</td> <td class="normal"> * </td></tr> <tr><td>248</td> <td class="normal"> * rename </td></tr> <tr><td>249</td> <td class="normal"> * </td></tr> <tr><td>250</td> <td class="normal"> * Associative array with the names of fields to be renamed as indexes </td></tr> <tr><td>251</td> <td class="normal"> * of the array. The value of each entry of the array should be set to </td></tr> <tr><td>252</td> <td class="normal"> * another associative array with the entry named name with the new </td></tr> <tr><td>253</td> <td class="normal"> * field name and the entry named Declaration that is expected to contain </td></tr> <tr><td>254</td> <td class="normal"> * the portion of the field declaration already in DBMS specific SQL code </td></tr> <tr><td>255</td> <td class="normal"> * as it is used in the CREATE TABLE statement. </td></tr> <tr><td>256</td> <td class="normal"> * </td></tr> <tr><td>257</td> <td class="normal"> * change </td></tr> <tr><td>258</td> <td class="normal"> * </td></tr> <tr><td>259</td> <td class="normal"> * Associative array with the names of the fields to be changed as indexes </td></tr> <tr><td>260</td> <td class="normal"> * of the array. Keep in mind that if it is intended to change either the </td></tr> <tr><td>261</td> <td class="normal"> * name of a field and any other properties, the change array entries </td></tr> <tr><td>262</td> <td class="normal"> * should have the new names of the fields as array indexes. </td></tr> <tr><td>263</td> <td class="normal"> * </td></tr> <tr><td>264</td> <td class="normal"> * The value of each entry of the array should be set to another associative </td></tr> <tr><td>265</td> <td class="normal"> * array with the properties of the fields to that are meant to be changed as </td></tr> <tr><td>266</td> <td class="normal"> * array entries. These entries should be assigned to the new values of the </td></tr> <tr><td>267</td> <td class="normal"> * respective properties. The properties of the fields should be the same </td></tr> <tr><td>268</td> <td class="normal"> * as defined by the Metabase parser. </td></tr> <tr><td>269</td> <td class="normal"> * </td></tr> <tr><td>270</td> <td class="normal"> * Example </td></tr> <tr><td>271</td> <td class="normal"> * array( </td></tr> <tr><td>272</td> <td class="normal"> * 'name' => 'userlist', </td></tr> <tr><td>273</td> <td class="normal"> * 'add' => array( </td></tr> <tr><td>274</td> <td class="normal"> * 'quota' => array( </td></tr> <tr><td>275</td> <td class="normal"> * 'type' => 'integer', </td></tr> <tr><td>276</td> <td class="normal"> * 'unsigned' => 1 </td></tr> <tr><td>277</td> <td class="normal"> * ) </td></tr> <tr><td>278</td> <td class="normal"> * ), </td></tr> <tr><td>279</td> <td class="normal"> * 'remove' => array( </td></tr> <tr><td>280</td> <td class="normal"> * 'file_limit' => array(), </td></tr> <tr><td>281</td> <td class="normal"> * 'time_limit' => array() </td></tr> <tr><td>282</td> <td class="normal"> * ), </td></tr> <tr><td>283</td> <td class="normal"> * 'change' => array( </td></tr> <tr><td>284</td> <td class="normal"> * 'name' => array( </td></tr> <tr><td>285</td> <td class="normal"> * 'length' => '20', </td></tr> <tr><td>286</td> <td class="normal"> * 'definition' => array( </td></tr> <tr><td>287</td> <td class="normal"> * 'type' => 'text', </td></tr> <tr><td>288</td> <td class="normal"> * 'length' => 20, </td></tr> <tr><td>289</td> <td class="normal"> * ), </td></tr> <tr><td>290</td> <td class="normal"> * ) </td></tr> <tr><td>291</td> <td class="normal"> * ), </td></tr> <tr><td>292</td> <td class="normal"> * 'rename' => array( </td></tr> <tr><td>293</td> <td class="normal"> * 'sex' => array( </td></tr> <tr><td>294</td> <td class="normal"> * 'name' => 'gender', </td></tr> <tr><td>295</td> <td class="normal"> * 'definition' => array( </td></tr> <tr><td>296</td> <td class="normal"> * 'type' => 'text', </td></tr> <tr><td>297</td> <td class="normal"> * 'length' => 1, </td></tr> <tr><td>298</td> <td class="normal"> * 'default' => 'M', </td></tr> <tr><td>299</td> <td class="normal"> * ), </td></tr> <tr><td>300</td> <td class="normal"> * ) </td></tr> <tr><td>301</td> <td class="normal"> * ) </td></tr> <tr><td>302</td> <td class="normal"> * ) </td></tr> <tr><td>303</td> <td class="normal"> * </td></tr> <tr><td>304</td> <td class="normal"> * @param boolean $check indicates whether the function should just check if the DBMS driver </td></tr> <tr><td>305</td> <td class="normal"> * can perform the requested table alterations if the value is true or </td></tr> <tr><td>306</td> <td class="normal"> * actually perform them otherwise. </td></tr> <tr><td>307</td> <td class="normal"> * @return void </td></tr> <tr><td>308</td> <td class="normal"> */ </td></tr> <tr><td>309</td> <td class="normal"> public function alterTable($name, array $changes, $check = false) </td></tr> <tr><td>310</td> <td class="normal"> { </td></tr> <tr><td>311</td> <td class="red"> foreach ($changes as $changeName => $change) { </td></tr> <tr><td>312</td> <td class="normal"> switch ($changeName) { </td></tr> <tr><td>313</td> <td class="red"> case 'add': </td></tr> <tr><td>314</td> <td class="red"> case 'remove': </td></tr> <tr><td>315</td> <td class="red"> case 'rename': </td></tr> <tr><td>316</td> <td class="red"> break; </td></tr> <tr><td>317</td> <td class="red"> case 'change': </td></tr> <tr><td>318</td> <td class="red"> foreach ($changes['change'] as $field) { </td></tr> <tr><td>319</td> <td class="red"> $this->checkSupportedChanges($field); </td></tr> <tr><td>320</td> <td class="red"> } </td></tr> <tr><td>321</td> <td class="red"> break; </td></tr> <tr><td>322</td> <td class="red"> default: </td></tr> <tr><td>323</td> <td class="red"> throw new Doctrine_DataDict_Exception('change type ' . $changeName . ' not yet supported'); </td></tr> <tr><td>324</td> <td class="red"> } </td></tr> <tr><td>325</td> <td class="red"> } </td></tr> <tr><td>326</td> <td class="red"> if ($check) { </td></tr> <tr><td>327</td> <td class="red"> return true; </td></tr> <tr><td>328</td> <td class="orange"> } </td></tr> <tr><td>329</td> <td class="red"> $query = ''; </td></tr> <tr><td>330</td> <td class="red"> if ( ! empty($changes['add']) && is_array($changes['add'])) { </td></tr> <tr><td>331</td> <td class="red"> foreach ($changes['add'] as $fieldName => $field) { </td></tr> <tr><td>332</td> <td class="red"> if ($query) { </td></tr> <tr><td>333</td> <td class="red"> $query.= ', '; </td></tr> <tr><td>334</td> <td class="red"> } </td></tr> <tr><td>335</td> <td class="red"> $query.= 'ADD ' . $this->getDeclaration($fieldName, $field); </td></tr> <tr><td>336</td> <td class="red"> } </td></tr> <tr><td>337</td> <td class="red"> } </td></tr> <tr><td>338</td> <td class="normal"> </td></tr> <tr><td>339</td> <td class="red"> if ( ! empty($changes['remove']) && is_array($changes['remove'])) { </td></tr> <tr><td>340</td> <td class="red"> foreach ($changes['remove'] as $field_name => $field) { </td></tr> <tr><td>341</td> <td class="red"> if ($query) { </td></tr> <tr><td>342</td> <td class="red"> $query.= ', '; </td></tr> <tr><td>343</td> <td class="red"> } </td></tr> <tr><td>344</td> <td class="red"> $field_name = $this->conn->quoteIdentifier($field_name, true); </td></tr> <tr><td>345</td> <td class="red"> $query.= 'DROP ' . $field_name; </td></tr> <tr><td>346</td> <td class="red"> } </td></tr> <tr><td>347</td> <td class="red"> } </td></tr> <tr><td>348</td> <td class="normal"> </td></tr> <tr><td>349</td> <td class="red"> if ( ! empty($changes['rename']) && is_array($changes['rename'])) { </td></tr> <tr><td>350</td> <td class="red"> foreach ($changes['rename'] as $field_name => $field) { </td></tr> <tr><td>351</td> <td class="red"> if ($query) { </td></tr> <tr><td>352</td> <td class="red"> $query.= ', '; </td></tr> <tr><td>353</td> <td class="red"> } </td></tr> <tr><td>354</td> <td class="red"> $field_name = $this->conn->quoteIdentifier($field_name, true); </td></tr> <tr><td>355</td> <td class="red"> $query.= 'ALTER ' . $field_name . ' TO ' . $this->conn->quoteIdentifier($field['name'], true); </td></tr> <tr><td>356</td> <td class="red"> } </td></tr> <tr><td>357</td> <td class="red"> } </td></tr> <tr><td>358</td> <td class="normal"> </td></tr> <tr><td>359</td> <td class="red"> if ( ! empty($changes['change']) && is_array($changes['change'])) { </td></tr> <tr><td>360</td> <td class="normal"> // missing support to change DEFAULT and NULLability </td></tr> <tr><td>361</td> <td class="red"> foreach ($changes['change'] as $fieldName => $field) { </td></tr> <tr><td>362</td> <td class="red"> $this->checkSupportedChanges($field); </td></tr> <tr><td>363</td> <td class="red"> if ($query) { </td></tr> <tr><td>364</td> <td class="red"> $query.= ', '; </td></tr> <tr><td>365</td> <td class="red"> } </td></tr> <tr><td>366</td> <td class="red"> $this->conn->loadModule('Datatype', null, true); </td></tr> <tr><td>367</td> <td class="red"> $field_name = $this->conn->quoteIdentifier($fieldName, true); </td></tr> <tr><td>368</td> <td class="red"> $query.= 'ALTER ' . $field_name.' TYPE ' . $this->getTypeDeclaration($field['definition']); </td></tr> <tr><td>369</td> <td class="red"> } </td></tr> <tr><td>370</td> <td class="red"> } </td></tr> <tr><td>371</td> <td class="normal"> </td></tr> <tr><td>372</td> <td class="red"> if ( ! strlen($query)) { </td></tr> <tr><td>373</td> <td class="red"> return false; </td></tr> <tr><td>374</td> <td class="orange"> } </td></tr> <tr><td>375</td> <td class="normal"> </td></tr> <tr><td>376</td> <td class="red"> $name = $this->conn->quoteIdentifier($name, true); </td></tr> <tr><td>377</td> <td class="red"> $result = $this->conn->exec('ALTER TABLE ' . $name . ' ' . $query); </td></tr> <tr><td>378</td> <td class="red"> $this->_silentCommit(); </td></tr> <tr><td>379</td> <td class="red"> return $result; </td></tr> <tr><td>380</td> <td class="orange"> } </td></tr> <tr><td>381</td> <td class="normal"> </td></tr> <tr><td>382</td> <td class="normal"> /** </td></tr> <tr><td>383</td> <td class="normal"> * Get the stucture of a field into an array </td></tr> <tr><td>384</td> <td class="normal"> * </td></tr> <tr><td>385</td> <td class="normal"> * @param string $table name of the table on which the index is to be created </td></tr> <tr><td>386</td> <td class="normal"> * @param string $name name of the index to be created </td></tr> <tr><td>387</td> <td class="normal"> * @param array $definition associative array that defines properties of the index to be created. </td></tr> <tr><td>388</td> <td class="normal"> * Currently, only one property named FIELDS is supported. This property </td></tr> <tr><td>389</td> <td class="normal"> * is also an associative with the names of the index fields as array </td></tr> <tr><td>390</td> <td class="normal"> * indexes. Each entry of this array is set to another type of associative </td></tr> <tr><td>391</td> <td class="normal"> * array that specifies properties of the index that are specific to </td></tr> <tr><td>392</td> <td class="normal"> * each field. </td></tr> <tr><td>393</td> <td class="normal"> * </td></tr> <tr><td>394</td> <td class="normal"> * Currently, only the sorting property is supported. It should be used </td></tr> <tr><td>395</td> <td class="normal"> * to define the sorting direction of the index. It may be set to either </td></tr> <tr><td>396</td> <td class="normal"> * ascending or descending. </td></tr> <tr><td>397</td> <td class="normal"> * </td></tr> <tr><td>398</td> <td class="normal"> * Not all DBMS support index sorting direction configuration. The DBMS </td></tr> <tr><td>399</td> <td class="normal"> * drivers of those that do not support it ignore this property. Use the </td></tr> <tr><td>400</td> <td class="normal"> * function support() to determine whether the DBMS driver can manage indexes. </td></tr> <tr><td>401</td> <td class="normal"> </td></tr> <tr><td>402</td> <td class="normal"> * Example </td></tr> <tr><td>403</td> <td class="normal"> * array( </td></tr> <tr><td>404</td> <td class="normal"> * 'fields' => array( </td></tr> <tr><td>405</td> <td class="normal"> * 'user_name' => array( </td></tr> <tr><td>406</td> <td class="normal"> * 'sorting' => 'ascending' </td></tr> <tr><td>407</td> <td class="normal"> * ), </td></tr> <tr><td>408</td> <td class="normal"> * 'last_login' => array() </td></tr> <tr><td>409</td> <td class="normal"> * ) </td></tr> <tr><td>410</td> <td class="normal"> * ) </td></tr> <tr><td>411</td> <td class="normal"> * @return void </td></tr> <tr><td>412</td> <td class="normal"> */ </td></tr> <tr><td>413</td> <td class="normal"> public function createIndexSql($table, $name, array $definition) </td></tr> <tr><td>414</td> <td class="normal"> { </td></tr> <tr><td>415</td> <td class="red"> $query = 'CREATE'; </td></tr> <tr><td>416</td> <td class="normal"> </td></tr> <tr><td>417</td> <td class="red"> $query_sort = ''; </td></tr> <tr><td>418</td> <td class="red"> foreach ($definition['fields'] as $field) { </td></tr> <tr><td>419</td> <td class="red"> if ( ! strcmp($query_sort, '') && isset($field['sorting'])) { </td></tr> <tr><td>420</td> <td class="red"> switch ($field['sorting']) { </td></tr> <tr><td>421</td> <td class="red"> case 'ascending': </td></tr> <tr><td>422</td> <td class="red"> $query_sort = ' ASC'; </td></tr> <tr><td>423</td> <td class="red"> break; </td></tr> <tr><td>424</td> <td class="red"> case 'descending': </td></tr> <tr><td>425</td> <td class="red"> $query_sort = ' DESC'; </td></tr> <tr><td>426</td> <td class="red"> break; </td></tr> <tr><td>427</td> <td class="red"> } </td></tr> <tr><td>428</td> <td class="red"> } </td></tr> <tr><td>429</td> <td class="red"> } </td></tr> <tr><td>430</td> <td class="red"> $table = $this->conn->quoteIdentifier($table, true); </td></tr> <tr><td>431</td> <td class="red"> $name = $this->conn->quoteIdentifier($this->conn->formatter->getIndexName($name), true); </td></tr> <tr><td>432</td> <td class="red"> $query .= $query_sort. ' INDEX ' . $name . ' ON ' . $table; </td></tr> <tr><td>433</td> <td class="red"> $fields = array(); </td></tr> <tr><td>434</td> <td class="red"> foreach (array_keys($definition['fields']) as $field) { </td></tr> <tr><td>435</td> <td class="red"> $fields[] = $this->conn->quoteIdentifier($field, true); </td></tr> <tr><td>436</td> <td class="red"> } </td></tr> <tr><td>437</td> <td class="red"> $query .= ' ('.implode(', ', $fields) . ')'; </td></tr> <tr><td>438</td> <td class="normal"> </td></tr> <tr><td>439</td> <td class="red"> return $query; </td></tr> <tr><td>440</td> <td class="orange"> } </td></tr> <tr><td>441</td> <td class="normal"> </td></tr> <tr><td>442</td> <td class="normal"> /** </td></tr> <tr><td>443</td> <td class="normal"> * create a constraint on a table </td></tr> <tr><td>444</td> <td class="normal"> * </td></tr> <tr><td>445</td> <td class="normal"> * @param string $table name of the table on which the constraint is to be created </td></tr> <tr><td>446</td> <td class="normal"> * @param string $name name of the constraint to be created </td></tr> <tr><td>447</td> <td class="normal"> * @param array $definition associative array that defines properties of the constraint to be created. </td></tr> <tr><td>448</td> <td class="normal"> * Currently, only one property named FIELDS is supported. This property </td></tr> <tr><td>449</td> <td class="normal"> * is also an associative with the names of the constraint fields as array </td></tr> <tr><td>450</td> <td class="normal"> * constraints. Each entry of this array is set to another type of associative </td></tr> <tr><td>451</td> <td class="normal"> * array that specifies properties of the constraint that are specific to </td></tr> <tr><td>452</td> <td class="normal"> * each field. </td></tr> <tr><td>453</td> <td class="normal"> * </td></tr> <tr><td>454</td> <td class="normal"> * Example </td></tr> <tr><td>455</td> <td class="normal"> * array( </td></tr> <tr><td>456</td> <td class="normal"> * 'fields' => array( </td></tr> <tr><td>457</td> <td class="normal"> * 'user_name' => array(), </td></tr> <tr><td>458</td> <td class="normal"> * 'last_login' => array(), </td></tr> <tr><td>459</td> <td class="normal"> * ) </td></tr> <tr><td>460</td> <td class="normal"> * ) </td></tr> <tr><td>461</td> <td class="normal"> * @return void </td></tr> <tr><td>462</td> <td class="normal"> */ </td></tr> <tr><td>463</td> <td class="normal"> public function createConstraint($table, $name, $definition) </td></tr> <tr><td>464</td> <td class="normal"> { </td></tr> <tr><td>465</td> <td class="covered"> $table = $this->conn->quoteIdentifier($table, true); </td></tr> <tr><td>466</td> <td class="normal"> </td></tr> <tr><td>467</td> <td class="covered"> if ( ! empty($name)) { </td></tr> <tr><td>468</td> <td class="red"> $name = $this->conn->quoteIdentifier($this->conn->formatter->getIndexName($name), true); </td></tr> <tr><td>469</td> <td class="red"> } </td></tr> <tr><td>470</td> <td class="covered"> $query = "ALTER TABLE $table ADD"; </td></tr> <tr><td>471</td> <td class="covered"> if ( ! empty($definition['primary'])) { </td></tr> <tr><td>472</td> <td class="covered"> if ( ! empty($name)) { </td></tr> <tr><td>473</td> <td class="red"> $query.= ' CONSTRAINT '.$name; </td></tr> <tr><td>474</td> <td class="red"> } </td></tr> <tr><td>475</td> <td class="covered"> $query.= ' PRIMARY KEY'; </td></tr> <tr><td>476</td> <td class="covered"> } else { </td></tr> <tr><td>477</td> <td class="red"> $query.= ' CONSTRAINT '. $name; </td></tr> <tr><td>478</td> <td class="red"> if ( ! empty($definition['unique'])) { </td></tr> <tr><td>479</td> <td class="red"> $query.= ' UNIQUE'; </td></tr> <tr><td>480</td> <td class="red"> } </td></tr> <tr><td>481</td> <td class="normal"> } </td></tr> <tr><td>482</td> <td class="covered"> $fields = array(); </td></tr> <tr><td>483</td> <td class="covered"> foreach (array_keys($definition['fields']) as $field) { </td></tr> <tr><td>484</td> <td class="covered"> $fields[] = $this->conn->quoteIdentifier($field, true); </td></tr> <tr><td>485</td> <td class="covered"> } </td></tr> <tr><td>486</td> <td class="covered"> $query .= ' ('. implode(', ', $fields) . ')'; </td></tr> <tr><td>487</td> <td class="covered"> $result = $this->conn->exec($query); </td></tr> <tr><td>488</td> <td class="normal"> // TODO ? $this->_silentCommit(); </td></tr> <tr><td>489</td> <td class="covered"> return $result; </td></tr> <tr><td>490</td> <td class="orange"> } </td></tr> <tr><td>491</td> <td class="normal"> </td></tr> <tr><td>492</td> <td class="normal"> /** </td></tr> <tr><td>493</td> <td class="normal"> * A method to return the required SQL string that fits between CREATE ... TABLE </td></tr> <tr><td>494</td> <td class="normal"> * to create the table as a temporary table. </td></tr> <tr><td>495</td> <td class="normal"> * </td></tr> <tr><td>496</td> <td class="normal"> * @return string The string required to be placed between "CREATE" and "TABLE" </td></tr> <tr><td>497</td> <td class="normal"> * to generate a temporary table, if possible. </td></tr> <tr><td>498</td> <td class="normal"> */ </td></tr> <tr><td>499</td> <td class="normal"> public function getTemporaryTableQuery() </td></tr> <tr><td>500</td> <td class="normal"> { </td></tr> <tr><td>501</td> <td class="red"> return 'GLOBAL TEMPORARY'; </td></tr> <tr><td>502</td> <td class="orange"> } </td></tr> <tr><td>503</td> <td class="normal"> </td></tr> <tr><td>504</td> <td class="normal"> /** </td></tr> <tr><td>505</td> <td class="normal"> * create sequence </td></tr> <tr><td>506</td> <td class="normal"> * </td></tr> <tr><td>507</td> <td class="normal"> * @param string $seqName name of the sequence to be created </td></tr> <tr><td>508</td> <td class="normal"> * @param string $start start value of the sequence; default is 1 </td></tr> <tr><td>509</td> <td class="normal"> * @param array $options An associative array of table options: </td></tr> <tr><td>510</td> <td class="normal"> * array( </td></tr> <tr><td>511</td> <td class="normal"> * 'comment' => 'Foo', </td></tr> <tr><td>512</td> <td class="normal"> * 'charset' => 'utf8', </td></tr> <tr><td>513</td> <td class="normal"> * 'collate' => 'utf8_unicode_ci', </td></tr> <tr><td>514</td> <td class="normal"> * ); </td></tr> <tr><td>515</td> <td class="normal"> * @return boolean </td></tr> <tr><td>516</td> <td class="normal"> */ </td></tr> <tr><td>517</td> <td class="normal"> public function createSequence($seqName, $start = 1, array $options = array()) </td></tr> <tr><td>518</td> <td class="normal"> { </td></tr> <tr><td>519</td> <td class="covered"> $sequenceName = $this->conn->formatter->getSequenceName($seqName); </td></tr> <tr><td>520</td> <td class="normal"> </td></tr> <tr><td>521</td> <td class="covered"> $this->conn->exec('CREATE GENERATOR ' . $sequenceName); </td></tr> <tr><td>522</td> <td class="normal"> </td></tr> <tr><td>523</td> <td class="normal"> try { </td></tr> <tr><td>524</td> <td class="covered"> $this->conn->exec('SET GENERATOR ' . $sequenceName . ' TO ' . ($start-1)); </td></tr> <tr><td>525</td> <td class="normal"> </td></tr> <tr><td>526</td> <td class="covered"> return true; </td></tr> <tr><td>527</td> <td class="orange"> } catch (Doctrine_Connection_Exception $e) { </td></tr> <tr><td>528</td> <td class="normal"> try { </td></tr> <tr><td>529</td> <td class="orange"> $this->dropSequence($seqName); </td></tr> <tr><td>530</td> <td class="orange"> } catch(Doctrine_Connection_Exception $e) { </td></tr> <tr><td>531</td> <td class="orange"> throw new Doctrine_Export_Exception('Could not drop inconsistent sequence table'); </td></tr> <tr><td>532</td> <td class="normal"> } </td></tr> <tr><td>533</td> <td class="normal"> } </td></tr> <tr><td>534</td> <td class="orange"> throw new Doctrine_Export_Exception('could not create sequence table'); </td></tr> <tr><td>535</td> <td class="orange"> } </td></tr> <tr><td>536</td> <td class="normal"> </td></tr> <tr><td>537</td> <td class="normal"> /** </td></tr> <tr><td>538</td> <td class="normal"> * drop existing sequence </td></tr> <tr><td>539</td> <td class="normal"> * </td></tr> <tr><td>540</td> <td class="normal"> * @param string $seqName name of the sequence to be dropped </td></tr> <tr><td>541</td> <td class="normal"> * @return void </td></tr> <tr><td>542</td> <td class="normal"> */ </td></tr> <tr><td>543</td> <td class="normal"> public function dropSequenceSql($seqName) </td></tr> <tr><td>544</td> <td class="normal"> { </td></tr> <tr><td>545</td> <td class="red"> $sequenceName = $this->conn->formatter->getSequenceName($seqName); </td></tr> <tr><td>546</td> <td class="red"> $sequenceName = $this->conn->quote($sequenceName); </td></tr> <tr><td>547</td> <td class="red"> $query = "DELETE FROM RDB\$GENERATORS WHERE UPPER(RDB\$GENERATOR_NAME)=" . $sequenceName; </td></tr> <tr><td>548</td> <td class="normal"> </td></tr> <tr><td>549</td> <td class="red"> return $query; </td></tr> <tr><td>550</td> <td class="orange"> } </td></tr> <tr><td>551</td> <td class="normal">} </td></tr> </table></body></html>