<html>
<head>
<title>Coverage for Doctrine_Export</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</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: Export.php 3149 2007-11-13 22:28:37Z 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.org>.
</td></tr>
<tr><td>20</td>
<td class="normal"> */
</td></tr>
<tr><td>21</td>
<td class="covered">Doctrine::autoload('Doctrine_Connection_Module');
</td></tr>
<tr><td>22</td>
<td class="normal">/**
</td></tr>
<tr><td>23</td>
<td class="normal"> * Doctrine_Export
</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"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL
</td></tr>
<tr><td>30</td>
<td class="normal"> * @link www.phpdoctrine.org
</td></tr>
<tr><td>31</td>
<td class="normal"> * @since 1.0
</td></tr>
<tr><td>32</td>
<td class="normal"> * @version $Revision: 3149 $
</td></tr>
<tr><td>33</td>
<td class="normal"> */
</td></tr>
<tr><td>34</td>
<td class="covered">class Doctrine_Export extends Doctrine_Connection_Module
</td></tr>
<tr><td>35</td>
<td class="normal">{
</td></tr>
<tr><td>36</td>
<td class="normal"> protected $valid_default_values = array(
</td></tr>
<tr><td>37</td>
<td class="normal"> 'text' => '',
</td></tr>
<tr><td>38</td>
<td class="normal"> 'boolean' => true,
</td></tr>
<tr><td>39</td>
<td class="normal"> 'integer' => 0,
</td></tr>
<tr><td>40</td>
<td class="normal"> 'decimal' => 0.0,
</td></tr>
<tr><td>41</td>
<td class="normal"> 'float' => 0.0,
</td></tr>
<tr><td>42</td>
<td class="normal"> 'timestamp' => '1970-01-01 00:00:00',
</td></tr>
<tr><td>43</td>
<td class="normal"> 'time' => '00:00:00',
</td></tr>
<tr><td>44</td>
<td class="normal"> 'date' => '1970-01-01',
</td></tr>
<tr><td>45</td>
<td class="normal"> 'clob' => '',
</td></tr>
<tr><td>46</td>
<td class="normal"> 'blob' => '',
</td></tr>
<tr><td>47</td>
<td class="normal"> 'string' => ''
</td></tr>
<tr><td>48</td>
<td class="normal"> );
</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"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>53</td>
<td class="normal"> *
</td></tr>
<tr><td>54</td>
<td class="normal"> * @param string $name name of the database that should be dropped
</td></tr>
<tr><td>55</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>56</td>
<td class="normal"> */
</td></tr>
<tr><td>57</td>
<td class="normal"> public function dropDatabase($database)
</td></tr>
<tr><td>58</td>
<td class="normal"> {
</td></tr>
<tr><td>59</td>
<td class="covered"> $this->conn->execute($this->dropDatabaseSql($database));
</td></tr>
<tr><td>60</td>
<td class="covered"> }
</td></tr>
<tr><td>61</td>
<td class="normal">
</td></tr>
<tr><td>62</td>
<td class="normal"> /**
</td></tr>
<tr><td>63</td>
<td class="normal"> * drop an existing database
</td></tr>
<tr><td>64</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>65</td>
<td class="normal"> *
</td></tr>
<tr><td>66</td>
<td class="normal"> * @param string $name name of the database that should be dropped
</td></tr>
<tr><td>67</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>68</td>
<td class="normal"> */
</td></tr>
<tr><td>69</td>
<td class="normal"> public function dropDatabaseSql($database)
</td></tr>
<tr><td>70</td>
<td class="normal"> {
</td></tr>
<tr><td>71</td>
<td class="red"> throw new Doctrine_Export_Exception('Drop database not supported by this driver.');
</td></tr>
<tr><td>72</td>
<td class="orange"> }
</td></tr>
<tr><td>73</td>
<td class="normal">
</td></tr>
<tr><td>74</td>
<td class="normal"> /**
</td></tr>
<tr><td>75</td>
<td class="normal"> * dropTableSql
</td></tr>
<tr><td>76</td>
<td class="normal"> * drop an existing table
</td></tr>
<tr><td>77</td>
<td class="normal"> *
</td></tr>
<tr><td>78</td>
<td class="normal"> * @param string $table name of table that should be dropped from the database
</td></tr>
<tr><td>79</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>80</td>
<td class="normal"> */
</td></tr>
<tr><td>81</td>
<td class="normal"> public function dropTableSql($table)
</td></tr>
<tr><td>82</td>
<td class="normal"> {
</td></tr>
<tr><td>83</td>
<td class="covered"> return 'DROP TABLE ' . $this->conn->quoteIdentifier($table);
</td></tr>
<tr><td>84</td>
<td class="orange"> }
</td></tr>
<tr><td>85</td>
<td class="normal">
</td></tr>
<tr><td>86</td>
<td class="normal"> /**
</td></tr>
<tr><td>87</td>
<td class="normal"> * dropTable
</td></tr>
<tr><td>88</td>
<td class="normal"> * drop an existing table
</td></tr>
<tr><td>89</td>
<td class="normal"> *
</td></tr>
<tr><td>90</td>
<td class="normal"> * @param string $table name of table that should be dropped from the database
</td></tr>
<tr><td>91</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>92</td>
<td class="normal"> */
</td></tr>
<tr><td>93</td>
<td class="normal"> public function dropTable($table)
</td></tr>
<tr><td>94</td>
<td class="normal"> {
</td></tr>
<tr><td>95</td>
<td class="covered"> $this->conn->execute($this->dropTableSql($table));
</td></tr>
<tr><td>96</td>
<td class="covered"> }
</td></tr>
<tr><td>97</td>
<td class="normal">
</td></tr>
<tr><td>98</td>
<td class="normal"> /**
</td></tr>
<tr><td>99</td>
<td class="normal"> * drop existing index
</td></tr>
<tr><td>100</td>
<td class="normal"> *
</td></tr>
<tr><td>101</td>
<td class="normal"> * @param string $table name of table that should be used in method
</td></tr>
<tr><td>102</td>
<td class="normal"> * @param string $name name of the index to be dropped
</td></tr>
<tr><td>103</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>104</td>
<td class="normal"> */
</td></tr>
<tr><td>105</td>
<td class="normal"> public function dropIndex($table, $name)
</td></tr>
<tr><td>106</td>
<td class="normal"> {
</td></tr>
<tr><td>107</td>
<td class="covered"> return $this->conn->exec($this->dropIndexSql($table, $name));
</td></tr>
<tr><td>108</td>
<td class="orange"> }
</td></tr>
<tr><td>109</td>
<td class="normal">
</td></tr>
<tr><td>110</td>
<td class="normal"> /**
</td></tr>
<tr><td>111</td>
<td class="normal"> * dropIndexSql
</td></tr>
<tr><td>112</td>
<td class="normal"> *
</td></tr>
<tr><td>113</td>
<td class="normal"> * @param string $table name of table that should be used in method
</td></tr>
<tr><td>114</td>
<td class="normal"> * @param string $name name of the index to be dropped
</td></tr>
<tr><td>115</td>
<td class="normal"> * @return string SQL that is used for dropping an index
</td></tr>
<tr><td>116</td>
<td class="normal"> */
</td></tr>
<tr><td>117</td>
<td class="normal"> public function dropIndexSql($table, $name)
</td></tr>
<tr><td>118</td>
<td class="normal"> {
</td></tr>
<tr><td>119</td>
<td class="covered"> $name = $this->conn->quoteIdentifier($this->conn->formatter->getIndexName($name));
</td></tr>
<tr><td>120</td>
<td class="normal">
</td></tr>
<tr><td>121</td>
<td class="covered"> return 'DROP INDEX ' . $name;
</td></tr>
<tr><td>122</td>
<td class="orange"> }
</td></tr>
<tr><td>123</td>
<td class="normal">
</td></tr>
<tr><td>124</td>
<td class="normal"> /**
</td></tr>
<tr><td>125</td>
<td class="normal"> * drop existing constraint
</td></tr>
<tr><td>126</td>
<td class="normal"> *
</td></tr>
<tr><td>127</td>
<td class="normal"> * @param string $table name of table that should be used in method
</td></tr>
<tr><td>128</td>
<td class="normal"> * @param string $name name of the constraint to be dropped
</td></tr>
<tr><td>129</td>
<td class="normal"> * @param string $primary hint if the constraint is primary
</td></tr>
<tr><td>130</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>131</td>
<td class="normal"> */
</td></tr>
<tr><td>132</td>
<td class="normal"> public function dropConstraint($table, $name, $primary = false)
</td></tr>
<tr><td>133</td>
<td class="normal"> {
</td></tr>
<tr><td>134</td>
<td class="covered"> $table = $this->conn->quoteIdentifier($table);
</td></tr>
<tr><td>135</td>
<td class="covered"> $name = $this->conn->quoteIdentifier($name);
</td></tr>
<tr><td>136</td>
<td class="normal">
</td></tr>
<tr><td>137</td>
<td class="covered"> return $this->conn->exec('ALTER TABLE ' . $table . ' DROP CONSTRAINT ' . $name);
</td></tr>
<tr><td>138</td>
<td class="orange"> }
</td></tr>
<tr><td>139</td>
<td class="normal">
</td></tr>
<tr><td>140</td>
<td class="normal"> /**
</td></tr>
<tr><td>141</td>
<td class="normal"> * drop existing foreign key
</td></tr>
<tr><td>142</td>
<td class="normal"> *
</td></tr>
<tr><td>143</td>
<td class="normal"> * @param string $table name of table that should be used in method
</td></tr>
<tr><td>144</td>
<td class="normal"> * @param string $name name of the foreign key to be dropped
</td></tr>
<tr><td>145</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>146</td>
<td class="normal"> */
</td></tr>
<tr><td>147</td>
<td class="normal"> public function dropForeignKey($table, $name)
</td></tr>
<tr><td>148</td>
<td class="normal"> {
</td></tr>
<tr><td>149</td>
<td class="red"> return $this->dropConstraint($table, $name);
</td></tr>
<tr><td>150</td>
<td class="orange"> }
</td></tr>
<tr><td>151</td>
<td class="normal">
</td></tr>
<tr><td>152</td>
<td class="normal"> /**
</td></tr>
<tr><td>153</td>
<td class="normal"> * dropSequenceSql
</td></tr>
<tr><td>154</td>
<td class="normal"> * drop existing sequence
</td></tr>
<tr><td>155</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>156</td>
<td class="normal"> *
</td></tr>
<tr><td>157</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if something fails at database level
</td></tr>
<tr><td>158</td>
<td class="normal"> * @param string $sequenceName name of the sequence to be dropped
</td></tr>
<tr><td>159</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>160</td>
<td class="normal"> */
</td></tr>
<tr><td>161</td>
<td class="normal"> public function dropSequence($sequenceName)
</td></tr>
<tr><td>162</td>
<td class="normal"> {
</td></tr>
<tr><td>163</td>
<td class="covered"> $this->conn->exec($this->dropSequenceSql($sequenceName));
</td></tr>
<tr><td>164</td>
<td class="covered"> }
</td></tr>
<tr><td>165</td>
<td class="normal">
</td></tr>
<tr><td>166</td>
<td class="normal"> /**
</td></tr>
<tr><td>167</td>
<td class="normal"> * dropSequenceSql
</td></tr>
<tr><td>168</td>
<td class="normal"> * drop existing sequence
</td></tr>
<tr><td>169</td>
<td class="normal"> *
</td></tr>
<tr><td>170</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if something fails at database level
</td></tr>
<tr><td>171</td>
<td class="normal"> * @param string $sequenceName name of the sequence to be dropped
</td></tr>
<tr><td>172</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>173</td>
<td class="normal"> */
</td></tr>
<tr><td>174</td>
<td class="normal"> public function dropSequenceSql($sequenceName)
</td></tr>
<tr><td>175</td>
<td class="normal"> {
</td></tr>
<tr><td>176</td>
<td class="red"> throw new Doctrine_Export_Exception('Drop sequence not supported by this driver.');
</td></tr>
<tr><td>177</td>
<td class="orange"> }
</td></tr>
<tr><td>178</td>
<td class="normal">
</td></tr>
<tr><td>179</td>
<td class="normal"> /**
</td></tr>
<tr><td>180</td>
<td class="normal"> * create a new database
</td></tr>
<tr><td>181</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>182</td>
<td class="normal"> *
</td></tr>
<tr><td>183</td>
<td class="normal"> * @param string $name name of the database that should be created
</td></tr>
<tr><td>184</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>185</td>
<td class="normal"> */
</td></tr>
<tr><td>186</td>
<td class="normal"> public function createDatabase($database)
</td></tr>
<tr><td>187</td>
<td class="normal"> {
</td></tr>
<tr><td>188</td>
<td class="covered"> $this->conn->execute($this->createDatabaseSql($database));
</td></tr>
<tr><td>189</td>
<td class="covered"> }
</td></tr>
<tr><td>190</td>
<td class="normal">
</td></tr>
<tr><td>191</td>
<td class="normal"> /**
</td></tr>
<tr><td>192</td>
<td class="normal"> * create a new database
</td></tr>
<tr><td>193</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>194</td>
<td class="normal"> *
</td></tr>
<tr><td>195</td>
<td class="normal"> * @param string $name name of the database that should be created
</td></tr>
<tr><td>196</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>197</td>
<td class="normal"> */
</td></tr>
<tr><td>198</td>
<td class="normal"> public function createDatabaseSql($database)
</td></tr>
<tr><td>199</td>
<td class="normal"> {
</td></tr>
<tr><td>200</td>
<td class="covered"> throw new Doctrine_Export_Exception('Create database not supported by this driver.');
</td></tr>
<tr><td>201</td>
<td class="orange"> }
</td></tr>
<tr><td>202</td>
<td class="normal">
</td></tr>
<tr><td>203</td>
<td class="normal"> /**
</td></tr>
<tr><td>204</td>
<td class="normal"> * create a new table
</td></tr>
<tr><td>205</td>
<td class="normal"> *
</td></tr>
<tr><td>206</td>
<td class="normal"> * @param string $name Name of the database that should be created
</td></tr>
<tr><td>207</td>
<td class="normal"> * @param array $fields Associative array that contains the definition of each field of the new table
</td></tr>
<tr><td>208</td>
<td class="normal"> * The indexes of the array entries are the names of the fields of the table an
</td></tr>
<tr><td>209</td>
<td class="normal"> * the array entry values are associative arrays like those that are meant to be
</td></tr>
<tr><td>210</td>
<td class="normal"> * passed with the field definitions to get[Type]Declaration() functions.
</td></tr>
<tr><td>211</td>
<td class="normal"> * array(
</td></tr>
<tr><td>212</td>
<td class="normal"> * 'id' => array(
</td></tr>
<tr><td>213</td>
<td class="normal"> * 'type' => 'integer',
</td></tr>
<tr><td>214</td>
<td class="normal"> * 'unsigned' => 1
</td></tr>
<tr><td>215</td>
<td class="normal"> * 'notnull' => 1
</td></tr>
<tr><td>216</td>
<td class="normal"> * 'default' => 0
</td></tr>
<tr><td>217</td>
<td class="normal"> * ),
</td></tr>
<tr><td>218</td>
<td class="normal"> * 'name' => array(
</td></tr>
<tr><td>219</td>
<td class="normal"> * 'type' => 'text',
</td></tr>
<tr><td>220</td>
<td class="normal"> * 'length' => 12
</td></tr>
<tr><td>221</td>
<td class="normal"> * ),
</td></tr>
<tr><td>222</td>
<td class="normal"> * 'password' => array(
</td></tr>
<tr><td>223</td>
<td class="normal"> * 'type' => 'text',
</td></tr>
<tr><td>224</td>
<td class="normal"> * 'length' => 12
</td></tr>
<tr><td>225</td>
<td class="normal"> * )
</td></tr>
<tr><td>226</td>
<td class="normal"> * );
</td></tr>
<tr><td>227</td>
<td class="normal"> * @param array $options An associative array of table options:
</td></tr>
<tr><td>228</td>
<td class="normal"> *
</td></tr>
<tr><td>229</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>230</td>
<td class="normal"> */
</td></tr>
<tr><td>231</td>
<td class="normal"> public function createTableSql($name, array $fields, array $options = array())
</td></tr>
<tr><td>232</td>
<td class="normal"> {
</td></tr>
<tr><td>233</td>
<td class="covered"> if ( ! $name) {
</td></tr>
<tr><td>234</td>
<td class="red"> throw new Doctrine_Export_Exception('no valid table name specified');
</td></tr>
<tr><td>235</td>
<td class="orange"> }
</td></tr>
<tr><td>236</td>
<td class="normal">
</td></tr>
<tr><td>237</td>
<td class="covered"> if (empty($fields)) {
</td></tr>
<tr><td>238</td>
<td class="red"> throw new Doctrine_Export_Exception('no fields specified for table ' . $name);
</td></tr>
<tr><td>239</td>
<td class="orange"> }
</td></tr>
<tr><td>240</td>
<td class="normal">
</td></tr>
<tr><td>241</td>
<td class="covered"> $queryFields = $this->getFieldDeclarationList($fields);
</td></tr>
<tr><td>242</td>
<td class="normal">
</td></tr>
<tr><td>243</td>
<td class="normal">
</td></tr>
<tr><td>244</td>
<td class="covered"> if (isset($options['primary']) && ! empty($options['primary'])) {
</td></tr>
<tr><td>245</td>
<td class="covered"> $queryFields .= ', PRIMARY KEY(' . implode(', ', array_values($options['primary'])) . ')';
</td></tr>
<tr><td>246</td>
<td class="covered"> }
</td></tr>
<tr><td>247</td>
<td class="normal">
</td></tr>
<tr><td>248</td>
<td class="covered"> if (isset($options['indexes']) && ! empty($options['indexes'])) {
</td></tr>
<tr><td>249</td>
<td class="covered"> foreach($options['indexes'] as $index => $definition) {
</td></tr>
<tr><td>250</td>
<td class="covered"> $queryFields .= ', ' . $this->getIndexDeclaration($index, $definition);
</td></tr>
<tr><td>251</td>
<td class="covered"> }
</td></tr>
<tr><td>252</td>
<td class="covered"> }
</td></tr>
<tr><td>253</td>
<td class="normal">
</td></tr>
<tr><td>254</td>
<td class="covered"> $query = 'CREATE TABLE ' . $this->conn->quoteIdentifier($name, true) . ' (' . $queryFields;
</td></tr>
<tr><td>255</td>
<td class="normal">
</td></tr>
<tr><td>256</td>
<td class="covered"> $check = $this->getCheckDeclaration($fields);
</td></tr>
<tr><td>257</td>
<td class="normal">
</td></tr>
<tr><td>258</td>
<td class="covered"> if ( ! empty($check)) {
</td></tr>
<tr><td>259</td>
<td class="red"> $query .= ', ' . $check;
</td></tr>
<tr><td>260</td>
<td class="red"> }
</td></tr>
<tr><td>261</td>
<td class="normal">
</td></tr>
<tr><td>262</td>
<td class="covered"> $query .= ')';
</td></tr>
<tr><td>263</td>
<td class="normal">
</td></tr>
<tr><td>264</td>
<td class="normal">
</td></tr>
<tr><td>265</td>
<td class="normal">
</td></tr>
<tr><td>266</td>
<td class="covered"> $sql[] = $query;
</td></tr>
<tr><td>267</td>
<td class="normal">
</td></tr>
<tr><td>268</td>
<td class="covered"> if (isset($options['foreignKeys'])) {
</td></tr>
<tr><td>269</td>
<td class="normal">
</td></tr>
<tr><td>270</td>
<td class="covered"> foreach ((array) $options['foreignKeys'] as $k => $definition) {
</td></tr>
<tr><td>271</td>
<td class="red"> if (is_array($definition)) {
</td></tr>
<tr><td>272</td>
<td class="red"> $sql[] = $this->createForeignKeySql($name, $definition);
</td></tr>
<tr><td>273</td>
<td class="red"> }
</td></tr>
<tr><td>274</td>
<td class="red"> }
</td></tr>
<tr><td>275</td>
<td class="covered"> }
</td></tr>
<tr><td>276</td>
<td class="covered"> return $sql;
</td></tr>
<tr><td>277</td>
<td class="orange"> }
</td></tr>
<tr><td>278</td>
<td class="normal">
</td></tr>
<tr><td>279</td>
<td class="normal"> /**
</td></tr>
<tr><td>280</td>
<td class="normal"> * create a new table
</td></tr>
<tr><td>281</td>
<td class="normal"> *
</td></tr>
<tr><td>282</td>
<td class="normal"> * @param string $name Name of the database that should be created
</td></tr>
<tr><td>283</td>
<td class="normal"> * @param array $fields Associative array that contains the definition of each field of the new table
</td></tr>
<tr><td>284</td>
<td class="normal"> * @param array $options An associative array of table options:
</td></tr>
<tr><td>285</td>
<td class="normal"> * @see Doctrine_Export::createTableSql()
</td></tr>
<tr><td>286</td>
<td class="normal"> *
</td></tr>
<tr><td>287</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>288</td>
<td class="normal"> */
</td></tr>
<tr><td>289</td>
<td class="normal"> public function createTable($name, array $fields, array $options = array())
</td></tr>
<tr><td>290</td>
<td class="normal"> {
</td></tr>
<tr><td>291</td>
<td class="covered"> $sql = (array) $this->createTableSql($name, $fields, $options);
</td></tr>
<tr><td>292</td>
<td class="normal">
</td></tr>
<tr><td>293</td>
<td class="covered"> foreach ($sql as $query) {
</td></tr>
<tr><td>294</td>
<td class="covered"> $this->conn->execute($query);
</td></tr>
<tr><td>295</td>
<td class="covered"> }
</td></tr>
<tr><td>296</td>
<td class="covered"> }
</td></tr>
<tr><td>297</td>
<td class="normal">
</td></tr>
<tr><td>298</td>
<td class="normal"> /**
</td></tr>
<tr><td>299</td>
<td class="normal"> * create sequence
</td></tr>
<tr><td>300</td>
<td class="normal"> *
</td></tr>
<tr><td>301</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if something fails at database level
</td></tr>
<tr><td>302</td>
<td class="normal"> * @param string $seqName name of the sequence to be created
</td></tr>
<tr><td>303</td>
<td class="normal"> * @param string $start start value of the sequence; default is 1
</td></tr>
<tr><td>304</td>
<td class="normal"> * @param array $options An associative array of table options:
</td></tr>
<tr><td>305</td>
<td class="normal"> * array(
</td></tr>
<tr><td>306</td>
<td class="normal"> * 'comment' => 'Foo',
</td></tr>
<tr><td>307</td>
<td class="normal"> * 'charset' => 'utf8',
</td></tr>
<tr><td>308</td>
<td class="normal"> * 'collate' => 'utf8_unicode_ci',
</td></tr>
<tr><td>309</td>
<td class="normal"> * );
</td></tr>
<tr><td>310</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>311</td>
<td class="normal"> */
</td></tr>
<tr><td>312</td>
<td class="normal"> public function createSequence($seqName, $start = 1, array $options = array())
</td></tr>
<tr><td>313</td>
<td class="normal"> {
</td></tr>
<tr><td>314</td>
<td class="covered"> return $this->conn->execute($this->createSequenceSql($seqName, $start = 1, $options));
</td></tr>
<tr><td>315</td>
<td class="orange"> }
</td></tr>
<tr><td>316</td>
<td class="normal">
</td></tr>
<tr><td>317</td>
<td class="normal"> /**
</td></tr>
<tr><td>318</td>
<td class="normal"> * return RDBMS specific create sequence statement
</td></tr>
<tr><td>319</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>320</td>
<td class="normal"> *
</td></tr>
<tr><td>321</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if something fails at database level
</td></tr>
<tr><td>322</td>
<td class="normal"> * @param string $seqName name of the sequence to be created
</td></tr>
<tr><td>323</td>
<td class="normal"> * @param string $start start value of the sequence; default is 1
</td></tr>
<tr><td>324</td>
<td class="normal"> * @param array $options An associative array of table options:
</td></tr>
<tr><td>325</td>
<td class="normal"> * array(
</td></tr>
<tr><td>326</td>
<td class="normal"> * 'comment' => 'Foo',
</td></tr>
<tr><td>327</td>
<td class="normal"> * 'charset' => 'utf8',
</td></tr>
<tr><td>328</td>
<td class="normal"> * 'collate' => 'utf8_unicode_ci',
</td></tr>
<tr><td>329</td>
<td class="normal"> * );
</td></tr>
<tr><td>330</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>331</td>
<td class="normal"> */
</td></tr>
<tr><td>332</td>
<td class="normal"> public function createSequenceSql($seqName, $start = 1, array $options = array())
</td></tr>
<tr><td>333</td>
<td class="normal"> {
</td></tr>
<tr><td>334</td>
<td class="red"> throw new Doctrine_Export_Exception('Create sequence not supported by this driver.');
</td></tr>
<tr><td>335</td>
<td class="orange"> }
</td></tr>
<tr><td>336</td>
<td class="normal">
</td></tr>
<tr><td>337</td>
<td class="normal"> /**
</td></tr>
<tr><td>338</td>
<td class="normal"> * create a constraint on a table
</td></tr>
<tr><td>339</td>
<td class="normal"> *
</td></tr>
<tr><td>340</td>
<td class="normal"> * @param string $table name of the table on which the constraint is to be created
</td></tr>
<tr><td>341</td>
<td class="normal"> * @param string $name name of the constraint to be created
</td></tr>
<tr><td>342</td>
<td class="normal"> * @param array $definition associative array that defines properties of the constraint to be created.
</td></tr>
<tr><td>343</td>
<td class="normal"> * Currently, only one property named FIELDS is supported. This property
</td></tr>
<tr><td>344</td>
<td class="normal"> * is also an associative with the names of the constraint fields as array
</td></tr>
<tr><td>345</td>
<td class="normal"> * constraints. Each entry of this array is set to another type of associative
</td></tr>
<tr><td>346</td>
<td class="normal"> * array that specifies properties of the constraint that are specific to
</td></tr>
<tr><td>347</td>
<td class="normal"> * each field.
</td></tr>
<tr><td>348</td>
<td class="normal"> *
</td></tr>
<tr><td>349</td>
<td class="normal"> * Example
</td></tr>
<tr><td>350</td>
<td class="normal"> * array(
</td></tr>
<tr><td>351</td>
<td class="normal"> * 'fields' => array(
</td></tr>
<tr><td>352</td>
<td class="normal"> * 'user_name' => array(),
</td></tr>
<tr><td>353</td>
<td class="normal"> * 'last_login' => array()
</td></tr>
<tr><td>354</td>
<td class="normal"> * )
</td></tr>
<tr><td>355</td>
<td class="normal"> * )
</td></tr>
<tr><td>356</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>357</td>
<td class="normal"> */
</td></tr>
<tr><td>358</td>
<td class="normal"> public function createConstraint($table, $name, $definition)
</td></tr>
<tr><td>359</td>
<td class="normal"> {
</td></tr>
<tr><td>360</td>
<td class="red"> $sql = $this->createConstraintSql($table, $name, $definition);
</td></tr>
<tr><td>361</td>
<td class="normal">
</td></tr>
<tr><td>362</td>
<td class="red"> return $this->conn->exec($sql);
</td></tr>
<tr><td>363</td>
<td class="orange"> }
</td></tr>
<tr><td>364</td>
<td class="normal">
</td></tr>
<tr><td>365</td>
<td class="normal"> /**
</td></tr>
<tr><td>366</td>
<td class="normal"> * create a constraint on a table
</td></tr>
<tr><td>367</td>
<td class="normal"> *
</td></tr>
<tr><td>368</td>
<td class="normal"> * @param string $table name of the table on which the constraint is to be created
</td></tr>
<tr><td>369</td>
<td class="normal"> * @param string $name name of the constraint to be created
</td></tr>
<tr><td>370</td>
<td class="normal"> * @param array $definition associative array that defines properties of the constraint to be created.
</td></tr>
<tr><td>371</td>
<td class="normal"> * Currently, only one property named FIELDS is supported. This property
</td></tr>
<tr><td>372</td>
<td class="normal"> * is also an associative with the names of the constraint fields as array
</td></tr>
<tr><td>373</td>
<td class="normal"> * constraints. Each entry of this array is set to another type of associative
</td></tr>
<tr><td>374</td>
<td class="normal"> * array that specifies properties of the constraint that are specific to
</td></tr>
<tr><td>375</td>
<td class="normal"> * each field.
</td></tr>
<tr><td>376</td>
<td class="normal"> *
</td></tr>
<tr><td>377</td>
<td class="normal"> * Example
</td></tr>
<tr><td>378</td>
<td class="normal"> * array(
</td></tr>
<tr><td>379</td>
<td class="normal"> * 'fields' => array(
</td></tr>
<tr><td>380</td>
<td class="normal"> * 'user_name' => array(),
</td></tr>
<tr><td>381</td>
<td class="normal"> * 'last_login' => array()
</td></tr>
<tr><td>382</td>
<td class="normal"> * )
</td></tr>
<tr><td>383</td>
<td class="normal"> * )
</td></tr>
<tr><td>384</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>385</td>
<td class="normal"> */
</td></tr>
<tr><td>386</td>
<td class="normal"> public function createConstraintSql($table, $name, $definition)
</td></tr>
<tr><td>387</td>
<td class="normal"> {
</td></tr>
<tr><td>388</td>
<td class="covered"> $table = $this->conn->quoteIdentifier($table);
</td></tr>
<tr><td>389</td>
<td class="covered"> $name = $this->conn->quoteIdentifier($this->conn->formatter->getIndexName($name));
</td></tr>
<tr><td>390</td>
<td class="covered"> $query = 'ALTER TABLE ' . $table . ' ADD CONSTRAINT ' . $name;
</td></tr>
<tr><td>391</td>
<td class="normal">
</td></tr>
<tr><td>392</td>
<td class="covered"> if (isset($definition['primary']) && $definition['primary']) {
</td></tr>
<tr><td>393</td>
<td class="covered"> $query .= ' PRIMARY KEY';
</td></tr>
<tr><td>394</td>
<td class="covered"> } elseif (isset($definition['unique']) && $definition['unique']) {
</td></tr>
<tr><td>395</td>
<td class="red"> $query .= ' UNIQUE';
</td></tr>
<tr><td>396</td>
<td class="red"> }
</td></tr>
<tr><td>397</td>
<td class="normal">
</td></tr>
<tr><td>398</td>
<td class="covered"> $fields = array();
</td></tr>
<tr><td>399</td>
<td class="covered"> foreach (array_keys($definition['fields']) as $field) {
</td></tr>
<tr><td>400</td>
<td class="covered"> $fields[] = $this->conn->quoteIdentifier($field, true);
</td></tr>
<tr><td>401</td>
<td class="covered"> }
</td></tr>
<tr><td>402</td>
<td class="covered"> $query .= ' ('. implode(', ', $fields) . ')';
</td></tr>
<tr><td>403</td>
<td class="normal">
</td></tr>
<tr><td>404</td>
<td class="covered"> return $query;
</td></tr>
<tr><td>405</td>
<td class="orange"> }
</td></tr>
<tr><td>406</td>
<td class="normal">
</td></tr>
<tr><td>407</td>
<td class="normal"> /**
</td></tr>
<tr><td>408</td>
<td class="normal"> * Get the stucture of a field into an array
</td></tr>
<tr><td>409</td>
<td class="normal"> *
</td></tr>
<tr><td>410</td>
<td class="normal"> * @param string $table name of the table on which the index is to be created
</td></tr>
<tr><td>411</td>
<td class="normal"> * @param string $name name of the index to be created
</td></tr>
<tr><td>412</td>
<td class="normal"> * @param array $definition associative array that defines properties of the index to be created.
</td></tr>
<tr><td>413</td>
<td class="normal"> * Currently, only one property named FIELDS is supported. This property
</td></tr>
<tr><td>414</td>
<td class="normal"> * is also an associative with the names of the index fields as array
</td></tr>
<tr><td>415</td>
<td class="normal"> * indexes. Each entry of this array is set to another type of associative
</td></tr>
<tr><td>416</td>
<td class="normal"> * array that specifies properties of the index that are specific to
</td></tr>
<tr><td>417</td>
<td class="normal"> * each field.
</td></tr>
<tr><td>418</td>
<td class="normal"> *
</td></tr>
<tr><td>419</td>
<td class="normal"> * Currently, only the sorting property is supported. It should be used
</td></tr>
<tr><td>420</td>
<td class="normal"> * to define the sorting direction of the index. It may be set to either
</td></tr>
<tr><td>421</td>
<td class="normal"> * ascending or descending.
</td></tr>
<tr><td>422</td>
<td class="normal"> *
</td></tr>
<tr><td>423</td>
<td class="normal"> * Not all DBMS support index sorting direction configuration. The DBMS
</td></tr>
<tr><td>424</td>
<td class="normal"> * drivers of those that do not support it ignore this property. Use the
</td></tr>
<tr><td>425</td>
<td class="normal"> * function supports() to determine whether the DBMS driver can manage indexes.
</td></tr>
<tr><td>426</td>
<td class="normal"> *
</td></tr>
<tr><td>427</td>
<td class="normal"> * Example
</td></tr>
<tr><td>428</td>
<td class="normal"> * array(
</td></tr>
<tr><td>429</td>
<td class="normal"> * 'fields' => array(
</td></tr>
<tr><td>430</td>
<td class="normal"> * 'user_name' => array(
</td></tr>
<tr><td>431</td>
<td class="normal"> * 'sorting' => 'ascending'
</td></tr>
<tr><td>432</td>
<td class="normal"> * ),
</td></tr>
<tr><td>433</td>
<td class="normal"> * 'last_login' => array()
</td></tr>
<tr><td>434</td>
<td class="normal"> * )
</td></tr>
<tr><td>435</td>
<td class="normal"> * )
</td></tr>
<tr><td>436</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>437</td>
<td class="normal"> */
</td></tr>
<tr><td>438</td>
<td class="normal"> public function createIndex($table, $name, array $definition)
</td></tr>
<tr><td>439</td>
<td class="normal"> {
</td></tr>
<tr><td>440</td>
<td class="covered"> return $this->conn->execute($this->createIndexSql($table, $name, $definition));
</td></tr>
<tr><td>441</td>
<td class="orange"> }
</td></tr>
<tr><td>442</td>
<td class="normal">
</td></tr>
<tr><td>443</td>
<td class="normal"> /**
</td></tr>
<tr><td>444</td>
<td class="normal"> * Get the stucture of a field into an array
</td></tr>
<tr><td>445</td>
<td class="normal"> *
</td></tr>
<tr><td>446</td>
<td class="normal"> * @param string $table name of the table on which the index is to be created
</td></tr>
<tr><td>447</td>
<td class="normal"> * @param string $name name of the index to be created
</td></tr>
<tr><td>448</td>
<td class="normal"> * @param array $definition associative array that defines properties of the index to be created.
</td></tr>
<tr><td>449</td>
<td class="normal"> * @see Doctrine_Export::createIndex()
</td></tr>
<tr><td>450</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>451</td>
<td class="normal"> */
</td></tr>
<tr><td>452</td>
<td class="normal"> public function createIndexSql($table, $name, array $definition)
</td></tr>
<tr><td>453</td>
<td class="normal"> {
</td></tr>
<tr><td>454</td>
<td class="red"> $table = $this->conn->quoteIdentifier($table);
</td></tr>
<tr><td>455</td>
<td class="red"> $name = $this->conn->quoteIdentifier($name);
</td></tr>
<tr><td>456</td>
<td class="red"> $type = '';
</td></tr>
<tr><td>457</td>
<td class="normal">
</td></tr>
<tr><td>458</td>
<td class="red"> if (isset($definition['type'])) {
</td></tr>
<tr><td>459</td>
<td class="red"> switch (strtolower($definition['type'])) {
</td></tr>
<tr><td>460</td>
<td class="red"> case 'unique':
</td></tr>
<tr><td>461</td>
<td class="red"> $type = strtoupper($definition['type']) . ' ';
</td></tr>
<tr><td>462</td>
<td class="red"> break;
</td></tr>
<tr><td>463</td>
<td class="red"> default:
</td></tr>
<tr><td>464</td>
<td class="red"> throw new Doctrine_Export_Exception('Unknown index type ' . $definition['type']);
</td></tr>
<tr><td>465</td>
<td class="red"> }
</td></tr>
<tr><td>466</td>
<td class="red"> }
</td></tr>
<tr><td>467</td>
<td class="normal">
</td></tr>
<tr><td>468</td>
<td class="red"> $query = 'CREATE ' . $type . 'INDEX ' . $name . ' ON ' . $table;
</td></tr>
<tr><td>469</td>
<td class="normal">
</td></tr>
<tr><td>470</td>
<td class="red"> $fields = array();
</td></tr>
<tr><td>471</td>
<td class="red"> foreach ($definition['fields'] as $field) {
</td></tr>
<tr><td>472</td>
<td class="red"> $fields[] = $this->conn->quoteIdentifier($field);
</td></tr>
<tr><td>473</td>
<td class="red"> }
</td></tr>
<tr><td>474</td>
<td class="red"> $query .= ' (' . implode(', ', $fields) . ')';
</td></tr>
<tr><td>475</td>
<td class="normal">
</td></tr>
<tr><td>476</td>
<td class="red"> return $query;
</td></tr>
<tr><td>477</td>
<td class="orange"> }
</td></tr>
<tr><td>478</td>
<td class="normal"> /**
</td></tr>
<tr><td>479</td>
<td class="normal"> * createForeignKeySql
</td></tr>
<tr><td>480</td>
<td class="normal"> *
</td></tr>
<tr><td>481</td>
<td class="normal"> * @param string $table name of the table on which the foreign key is to be created
</td></tr>
<tr><td>482</td>
<td class="normal"> * @param array $definition associative array that defines properties of the foreign key to be created.
</td></tr>
<tr><td>483</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>484</td>
<td class="normal"> */
</td></tr>
<tr><td>485</td>
<td class="normal"> public function createForeignKeySql($table, array $definition)
</td></tr>
<tr><td>486</td>
<td class="normal"> {
</td></tr>
<tr><td>487</td>
<td class="covered"> $table = $this->conn->quoteIdentifier($table);
</td></tr>
<tr><td>488</td>
<td class="normal">
</td></tr>
<tr><td>489</td>
<td class="covered"> $query = 'ALTER TABLE ' . $table . ' ADD ' . $this->getForeignKeyDeclaration($definition);
</td></tr>
<tr><td>490</td>
<td class="normal">
</td></tr>
<tr><td>491</td>
<td class="covered"> return $query;
</td></tr>
<tr><td>492</td>
<td class="orange"> }
</td></tr>
<tr><td>493</td>
<td class="normal">
</td></tr>
<tr><td>494</td>
<td class="normal"> /**
</td></tr>
<tr><td>495</td>
<td class="normal"> * createForeignKey
</td></tr>
<tr><td>496</td>
<td class="normal"> *
</td></tr>
<tr><td>497</td>
<td class="normal"> * @param string $table name of the table on which the foreign key is to be created
</td></tr>
<tr><td>498</td>
<td class="normal"> * @param array $definition associative array that defines properties of the foreign key to be created.
</td></tr>
<tr><td>499</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>500</td>
<td class="normal"> */
</td></tr>
<tr><td>501</td>
<td class="normal"> public function createForeignKey($table, array $definition)
</td></tr>
<tr><td>502</td>
<td class="normal"> {
</td></tr>
<tr><td>503</td>
<td class="red"> $sql = $this->createForeignKeySql($table, $definition);
</td></tr>
<tr><td>504</td>
<td class="normal">
</td></tr>
<tr><td>505</td>
<td class="red"> return $this->conn->execute($sql);
</td></tr>
<tr><td>506</td>
<td class="orange"> }
</td></tr>
<tr><td>507</td>
<td class="normal">
</td></tr>
<tr><td>508</td>
<td class="normal"> /**
</td></tr>
<tr><td>509</td>
<td class="normal"> * alter an existing table
</td></tr>
<tr><td>510</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>511</td>
<td class="normal"> *
</td></tr>
<tr><td>512</td>
<td class="normal"> * @param string $name name of the table that is intended to be changed.
</td></tr>
<tr><td>513</td>
<td class="normal"> * @param array $changes associative array that contains the details of each type
</td></tr>
<tr><td>514</td>
<td class="normal"> * of change that is intended to be performed. The types of
</td></tr>
<tr><td>515</td>
<td class="normal"> * changes that are currently supported are defined as follows:
</td></tr>
<tr><td>516</td>
<td class="normal"> *
</td></tr>
<tr><td>517</td>
<td class="normal"> * name
</td></tr>
<tr><td>518</td>
<td class="normal"> *
</td></tr>
<tr><td>519</td>
<td class="normal"> * New name for the table.
</td></tr>
<tr><td>520</td>
<td class="normal"> *
</td></tr>
<tr><td>521</td>
<td class="normal"> * add
</td></tr>
<tr><td>522</td>
<td class="normal"> *
</td></tr>
<tr><td>523</td>
<td class="normal"> * Associative array with the names of fields to be added as
</td></tr>
<tr><td>524</td>
<td class="normal"> * indexes of the array. The value of each entry of the array
</td></tr>
<tr><td>525</td>
<td class="normal"> * should be set to another associative array with the properties
</td></tr>
<tr><td>526</td>
<td class="normal"> * of the fields to be added. The properties of the fields should
</td></tr>
<tr><td>527</td>
<td class="normal"> * be the same as defined by the MDB2 parser.
</td></tr>
<tr><td>528</td>
<td class="normal"> *
</td></tr>
<tr><td>529</td>
<td class="normal"> *
</td></tr>
<tr><td>530</td>
<td class="normal"> * remove
</td></tr>
<tr><td>531</td>
<td class="normal"> *
</td></tr>
<tr><td>532</td>
<td class="normal"> * Associative array with the names of fields to be removed as indexes
</td></tr>
<tr><td>533</td>
<td class="normal"> * of the array. Currently the values assigned to each entry are ignored.
</td></tr>
<tr><td>534</td>
<td class="normal"> * An empty array should be used for future compatibility.
</td></tr>
<tr><td>535</td>
<td class="normal"> *
</td></tr>
<tr><td>536</td>
<td class="normal"> * rename
</td></tr>
<tr><td>537</td>
<td class="normal"> *
</td></tr>
<tr><td>538</td>
<td class="normal"> * Associative array with the names of fields to be renamed as indexes
</td></tr>
<tr><td>539</td>
<td class="normal"> * of the array. The value of each entry of the array should be set to
</td></tr>
<tr><td>540</td>
<td class="normal"> * another associative array with the entry named name with the new
</td></tr>
<tr><td>541</td>
<td class="normal"> * field name and the entry named Declaration that is expected to contain
</td></tr>
<tr><td>542</td>
<td class="normal"> * the portion of the field declaration already in DBMS specific SQL code
</td></tr>
<tr><td>543</td>
<td class="normal"> * as it is used in the CREATE TABLE statement.
</td></tr>
<tr><td>544</td>
<td class="normal"> *
</td></tr>
<tr><td>545</td>
<td class="normal"> * change
</td></tr>
<tr><td>546</td>
<td class="normal"> *
</td></tr>
<tr><td>547</td>
<td class="normal"> * Associative array with the names of the fields to be changed as indexes
</td></tr>
<tr><td>548</td>
<td class="normal"> * of the array. Keep in mind that if it is intended to change either the
</td></tr>
<tr><td>549</td>
<td class="normal"> * name of a field and any other properties, the change array entries
</td></tr>
<tr><td>550</td>
<td class="normal"> * should have the new names of the fields as array indexes.
</td></tr>
<tr><td>551</td>
<td class="normal"> *
</td></tr>
<tr><td>552</td>
<td class="normal"> * The value of each entry of the array should be set to another associative
</td></tr>
<tr><td>553</td>
<td class="normal"> * array with the properties of the fields to that are meant to be changed as
</td></tr>
<tr><td>554</td>
<td class="normal"> * array entries. These entries should be assigned to the new values of the
</td></tr>
<tr><td>555</td>
<td class="normal"> * respective properties. The properties of the fields should be the same
</td></tr>
<tr><td>556</td>
<td class="normal"> * as defined by the MDB2 parser.
</td></tr>
<tr><td>557</td>
<td class="normal"> *
</td></tr>
<tr><td>558</td>
<td class="normal"> * Example
</td></tr>
<tr><td>559</td>
<td class="normal"> * array(
</td></tr>
<tr><td>560</td>
<td class="normal"> * 'name' => 'userlist',
</td></tr>
<tr><td>561</td>
<td class="normal"> * 'add' => array(
</td></tr>
<tr><td>562</td>
<td class="normal"> * 'quota' => array(
</td></tr>
<tr><td>563</td>
<td class="normal"> * 'type' => 'integer',
</td></tr>
<tr><td>564</td>
<td class="normal"> * 'unsigned' => 1
</td></tr>
<tr><td>565</td>
<td class="normal"> * )
</td></tr>
<tr><td>566</td>
<td class="normal"> * ),
</td></tr>
<tr><td>567</td>
<td class="normal"> * 'remove' => array(
</td></tr>
<tr><td>568</td>
<td class="normal"> * 'file_limit' => array(),
</td></tr>
<tr><td>569</td>
<td class="normal"> * 'time_limit' => array()
</td></tr>
<tr><td>570</td>
<td class="normal"> * ),
</td></tr>
<tr><td>571</td>
<td class="normal"> * 'change' => array(
</td></tr>
<tr><td>572</td>
<td class="normal"> * 'name' => array(
</td></tr>
<tr><td>573</td>
<td class="normal"> * 'length' => '20',
</td></tr>
<tr><td>574</td>
<td class="normal"> * 'definition' => array(
</td></tr>
<tr><td>575</td>
<td class="normal"> * 'type' => 'text',
</td></tr>
<tr><td>576</td>
<td class="normal"> * 'length' => 20,
</td></tr>
<tr><td>577</td>
<td class="normal"> * ),
</td></tr>
<tr><td>578</td>
<td class="normal"> * )
</td></tr>
<tr><td>579</td>
<td class="normal"> * ),
</td></tr>
<tr><td>580</td>
<td class="normal"> * 'rename' => array(
</td></tr>
<tr><td>581</td>
<td class="normal"> * 'sex' => array(
</td></tr>
<tr><td>582</td>
<td class="normal"> * 'name' => 'gender',
</td></tr>
<tr><td>583</td>
<td class="normal"> * 'definition' => array(
</td></tr>
<tr><td>584</td>
<td class="normal"> * 'type' => 'text',
</td></tr>
<tr><td>585</td>
<td class="normal"> * 'length' => 1,
</td></tr>
<tr><td>586</td>
<td class="normal"> * 'default' => 'M',
</td></tr>
<tr><td>587</td>
<td class="normal"> * ),
</td></tr>
<tr><td>588</td>
<td class="normal"> * )
</td></tr>
<tr><td>589</td>
<td class="normal"> * )
</td></tr>
<tr><td>590</td>
<td class="normal"> * )
</td></tr>
<tr><td>591</td>
<td class="normal"> *
</td></tr>
<tr><td>592</td>
<td class="normal"> * @param boolean $check indicates whether the function should just check if the DBMS driver
</td></tr>
<tr><td>593</td>
<td class="normal"> * can perform the requested table alterations if the value is true or
</td></tr>
<tr><td>594</td>
<td class="normal"> * actually perform them otherwise.
</td></tr>
<tr><td>595</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>596</td>
<td class="normal"> */
</td></tr>
<tr><td>597</td>
<td class="normal"> public function alterTable($name, array $changes, $check = false)
</td></tr>
<tr><td>598</td>
<td class="normal"> {
</td></tr>
<tr><td>599</td>
<td class="covered"> $sql = $this->alterTableSql($name, $changes, $check);
</td></tr>
<tr><td>600</td>
<td class="normal">
</td></tr>
<tr><td>601</td>
<td class="covered"> if (is_string($sql) && $sql) {
</td></tr>
<tr><td>602</td>
<td class="covered"> $this->conn->execute($sql);
</td></tr>
<tr><td>603</td>
<td class="covered"> }
</td></tr>
<tr><td>604</td>
<td class="covered"> }
</td></tr>
<tr><td>605</td>
<td class="normal">
</td></tr>
<tr><td>606</td>
<td class="normal"> /**
</td></tr>
<tr><td>607</td>
<td class="normal"> * generates the sql for altering an existing table
</td></tr>
<tr><td>608</td>
<td class="normal"> * (this method is implemented by the drivers)
</td></tr>
<tr><td>609</td>
<td class="normal"> *
</td></tr>
<tr><td>610</td>
<td class="normal"> * @param string $name name of the table that is intended to be changed.
</td></tr>
<tr><td>611</td>
<td class="normal"> * @param array $changes associative array that contains the details of each type *
</td></tr>
<tr><td>612</td>
<td class="normal"> * @param boolean $check indicates whether the function should just check if the DBMS driver
</td></tr>
<tr><td>613</td>
<td class="normal"> * can perform the requested table alterations if the value is true or
</td></tr>
<tr><td>614</td>
<td class="normal"> * actually perform them otherwise.
</td></tr>
<tr><td>615</td>
<td class="normal"> * @see Doctrine_Export::alterTable()
</td></tr>
<tr><td>616</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>617</td>
<td class="normal"> */
</td></tr>
<tr><td>618</td>
<td class="normal"> public function alterTableSql($name, array $changes, $check = false)
</td></tr>
<tr><td>619</td>
<td class="normal"> {
</td></tr>
<tr><td>620</td>
<td class="red"> throw new Doctrine_Export_Exception('Alter table not supported by this driver.');
</td></tr>
<tr><td>621</td>
<td class="orange"> }
</td></tr>
<tr><td>622</td>
<td class="normal">
</td></tr>
<tr><td>623</td>
<td class="normal"> /**
</td></tr>
<tr><td>624</td>
<td class="normal"> * Get declaration of a number of field in bulk
</td></tr>
<tr><td>625</td>
<td class="normal"> *
</td></tr>
<tr><td>626</td>
<td class="normal"> * @param array $fields a multidimensional associative array.
</td></tr>
<tr><td>627</td>
<td class="normal"> * The first dimension determines the field name, while the second
</td></tr>
<tr><td>628</td>
<td class="normal"> * dimension is keyed with the name of the properties
</td></tr>
<tr><td>629</td>
<td class="normal"> * of the field being declared as array indexes. Currently, the types
</td></tr>
<tr><td>630</td>
<td class="normal"> * of supported field properties are as follows:
</td></tr>
<tr><td>631</td>
<td class="normal"> *
</td></tr>
<tr><td>632</td>
<td class="normal"> * length
</td></tr>
<tr><td>633</td>
<td class="normal"> * Integer value that determines the maximum length of the text
</td></tr>
<tr><td>634</td>
<td class="normal"> * field. If this argument is missing the field should be
</td></tr>
<tr><td>635</td>
<td class="normal"> * declared to have the longest length allowed by the DBMS.
</td></tr>
<tr><td>636</td>
<td class="normal"> *
</td></tr>
<tr><td>637</td>
<td class="normal"> * default
</td></tr>
<tr><td>638</td>
<td class="normal"> * Text value to be used as default for this field.
</td></tr>
<tr><td>639</td>
<td class="normal"> *
</td></tr>
<tr><td>640</td>
<td class="normal"> * notnull
</td></tr>
<tr><td>641</td>
<td class="normal"> * Boolean flag that indicates whether this field is constrained
</td></tr>
<tr><td>642</td>
<td class="normal"> * to not be set to null.
</td></tr>
<tr><td>643</td>
<td class="normal"> * charset
</td></tr>
<tr><td>644</td>
<td class="normal"> * Text value with the default CHARACTER SET for this field.
</td></tr>
<tr><td>645</td>
<td class="normal"> * collation
</td></tr>
<tr><td>646</td>
<td class="normal"> * Text value with the default COLLATION for this field.
</td></tr>
<tr><td>647</td>
<td class="normal"> * unique
</td></tr>
<tr><td>648</td>
<td class="normal"> * unique constraint
</td></tr>
<tr><td>649</td>
<td class="normal"> *
</td></tr>
<tr><td>650</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>651</td>
<td class="normal"> */
</td></tr>
<tr><td>652</td>
<td class="normal"> public function getFieldDeclarationList(array $fields)
</td></tr>
<tr><td>653</td>
<td class="normal"> {
</td></tr>
<tr><td>654</td>
<td class="covered"> foreach ($fields as $fieldName => $field) {
</td></tr>
<tr><td>655</td>
<td class="covered"> $query = $this->getDeclaration($fieldName, $field);
</td></tr>
<tr><td>656</td>
<td class="normal">
</td></tr>
<tr><td>657</td>
<td class="covered"> $queryFields[] = $query;
</td></tr>
<tr><td>658</td>
<td class="covered"> }
</td></tr>
<tr><td>659</td>
<td class="covered"> return implode(', ', $queryFields);
</td></tr>
<tr><td>660</td>
<td class="orange"> }
</td></tr>
<tr><td>661</td>
<td class="normal">
</td></tr>
<tr><td>662</td>
<td class="normal"> /**
</td></tr>
<tr><td>663</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to declare a generic type
</td></tr>
<tr><td>664</td>
<td class="normal"> * field to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>665</td>
<td class="normal"> *
</td></tr>
<tr><td>666</td>
<td class="normal"> * @param string $name name the field to be declared.
</td></tr>
<tr><td>667</td>
<td class="normal"> * @param array $field associative array with the name of the properties
</td></tr>
<tr><td>668</td>
<td class="normal"> * of the field being declared as array indexes. Currently, the types
</td></tr>
<tr><td>669</td>
<td class="normal"> * of supported field properties are as follows:
</td></tr>
<tr><td>670</td>
<td class="normal"> *
</td></tr>
<tr><td>671</td>
<td class="normal"> * length
</td></tr>
<tr><td>672</td>
<td class="normal"> * Integer value that determines the maximum length of the text
</td></tr>
<tr><td>673</td>
<td class="normal"> * field. If this argument is missing the field should be
</td></tr>
<tr><td>674</td>
<td class="normal"> * declared to have the longest length allowed by the DBMS.
</td></tr>
<tr><td>675</td>
<td class="normal"> *
</td></tr>
<tr><td>676</td>
<td class="normal"> * default
</td></tr>
<tr><td>677</td>
<td class="normal"> * Text value to be used as default for this field.
</td></tr>
<tr><td>678</td>
<td class="normal"> *
</td></tr>
<tr><td>679</td>
<td class="normal"> * notnull
</td></tr>
<tr><td>680</td>
<td class="normal"> * Boolean flag that indicates whether this field is constrained
</td></tr>
<tr><td>681</td>
<td class="normal"> * to not be set to null.
</td></tr>
<tr><td>682</td>
<td class="normal"> * charset
</td></tr>
<tr><td>683</td>
<td class="normal"> * Text value with the default CHARACTER SET for this field.
</td></tr>
<tr><td>684</td>
<td class="normal"> * collation
</td></tr>
<tr><td>685</td>
<td class="normal"> * Text value with the default COLLATION for this field.
</td></tr>
<tr><td>686</td>
<td class="normal"> * unique
</td></tr>
<tr><td>687</td>
<td class="normal"> * unique constraint
</td></tr>
<tr><td>688</td>
<td class="normal"> * check
</td></tr>
<tr><td>689</td>
<td class="normal"> * column check constraint
</td></tr>
<tr><td>690</td>
<td class="normal"> *
</td></tr>
<tr><td>691</td>
<td class="normal"> * @return string DBMS specific SQL code portion that should be used to
</td></tr>
<tr><td>692</td>
<td class="normal"> * declare the specified field.
</td></tr>
<tr><td>693</td>
<td class="normal"> */
</td></tr>
<tr><td>694</td>
<td class="normal"> public function getDeclaration($name, array $field)
</td></tr>
<tr><td>695</td>
<td class="normal"> {
</td></tr>
<tr><td>696</td>
<td class="normal">
</td></tr>
<tr><td>697</td>
<td class="covered"> $default = $this->getDefaultFieldDeclaration($field);
</td></tr>
<tr><td>698</td>
<td class="normal">
</td></tr>
<tr><td>699</td>
<td class="covered"> $charset = (isset($field['charset']) && $field['charset']) ?
</td></tr>
<tr><td>700</td>
<td class="covered"> ' ' . $this->getCharsetFieldDeclaration($field['charset']) : '';
</td></tr>
<tr><td>701</td>
<td class="normal">
</td></tr>
<tr><td>702</td>
<td class="covered"> $collation = (isset($field['collation']) && $field['collation']) ?
</td></tr>
<tr><td>703</td>
<td class="covered"> ' ' . $this->getCollationFieldDeclaration($field['collation']) : '';
</td></tr>
<tr><td>704</td>
<td class="normal">
</td></tr>
<tr><td>705</td>
<td class="covered"> $notnull = (isset($field['notnull']) && $field['notnull']) ? ' NOT NULL' : '';
</td></tr>
<tr><td>706</td>
<td class="normal">
</td></tr>
<tr><td>707</td>
<td class="covered"> $unique = (isset($field['unique']) && $field['unique']) ?
</td></tr>
<tr><td>708</td>
<td class="covered"> ' ' . $this->getUniqueFieldDeclaration() : '';
</td></tr>
<tr><td>709</td>
<td class="normal">
</td></tr>
<tr><td>710</td>
<td class="covered"> $check = (isset($field['check']) && $field['check']) ?
</td></tr>
<tr><td>711</td>
<td class="covered"> ' ' . $field['check'] : '';
</td></tr>
<tr><td>712</td>
<td class="normal">
</td></tr>
<tr><td>713</td>
<td class="covered"> $method = 'get' . $field['type'] . 'Declaration';
</td></tr>
<tr><td>714</td>
<td class="normal">
</td></tr>
<tr><td>715</td>
<td class="covered"> if (method_exists($this->conn->dataDict, $method)) {
</td></tr>
<tr><td>716</td>
<td class="covered"> return $this->conn->dataDict->$method($name, $field);
</td></tr>
<tr><td>717</td>
<td class="orange"> } else {
</td></tr>
<tr><td>718</td>
<td class="covered"> $dec = $this->conn->dataDict->getNativeDeclaration($field);
</td></tr>
<tr><td>719</td>
<td class="normal"> }
</td></tr>
<tr><td>720</td>
<td class="covered"> return $this->conn->quoteIdentifier($name, true) . ' ' . $dec . $charset . $default . $notnull . $unique . $check . $collation;
</td></tr>
<tr><td>721</td>
<td class="orange"> }
</td></tr>
<tr><td>722</td>
<td class="normal">
</td></tr>
<tr><td>723</td>
<td class="normal"> /**
</td></tr>
<tr><td>724</td>
<td class="normal"> * getDefaultDeclaration
</td></tr>
<tr><td>725</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set a default value
</td></tr>
<tr><td>726</td>
<td class="normal"> * declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>727</td>
<td class="normal"> *
</td></tr>
<tr><td>728</td>
<td class="normal"> * @param array $field field definition array
</td></tr>
<tr><td>729</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set a default value
</td></tr>
<tr><td>730</td>
<td class="normal"> */
</td></tr>
<tr><td>731</td>
<td class="normal"> public function getDefaultFieldDeclaration($field)
</td></tr>
<tr><td>732</td>
<td class="normal"> {
</td></tr>
<tr><td>733</td>
<td class="covered"> $default = '';
</td></tr>
<tr><td>734</td>
<td class="covered"> if (isset($field['default'])) {
</td></tr>
<tr><td>735</td>
<td class="covered"> if ($field['default'] === '') {
</td></tr>
<tr><td>736</td>
<td class="red"> $field['default'] = empty($field['notnull'])
</td></tr>
<tr><td>737</td>
<td class="red"> ? null : $this->valid_default_values[$field['type']];
</td></tr>
<tr><td>738</td>
<td class="normal">
</td></tr>
<tr><td>739</td>
<td class="red"> if ($field['default'] === '' &&
</td></tr>
<tr><td>740</td>
<td class="red"> ($this->conn->getAttribute(Doctrine::ATTR_PORTABILITY) & Doctrine::PORTABILITY_EMPTY_TO_NULL)) {
</td></tr>
<tr><td>741</td>
<td class="red"> $field['default'] = null;
</td></tr>
<tr><td>742</td>
<td class="red"> }
</td></tr>
<tr><td>743</td>
<td class="red"> }
</td></tr>
<tr><td>744</td>
<td class="normal">
</td></tr>
<tr><td>745</td>
<td class="covered"> if ($field['type'] === 'boolean') {
</td></tr>
<tr><td>746</td>
<td class="covered"> $fields['default'] = $this->conn->convertBooleans($field['default']);
</td></tr>
<tr><td>747</td>
<td class="covered"> }
</td></tr>
<tr><td>748</td>
<td class="covered"> $default = ' DEFAULT ' . $this->conn->quote($field['default'], $field['type']);
</td></tr>
<tr><td>749</td>
<td class="covered"> }
</td></tr>
<tr><td>750</td>
<td class="covered"> return $default;
</td></tr>
<tr><td>751</td>
<td class="orange"> }
</td></tr>
<tr><td>752</td>
<td class="normal">
</td></tr>
<tr><td>753</td>
<td class="normal"> /**
</td></tr>
<tr><td>754</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set a CHECK constraint
</td></tr>
<tr><td>755</td>
<td class="normal"> * declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>756</td>
<td class="normal"> *
</td></tr>
<tr><td>757</td>
<td class="normal"> * @param array $definition check definition
</td></tr>
<tr><td>758</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set a CHECK constraint
</td></tr>
<tr><td>759</td>
<td class="normal"> */
</td></tr>
<tr><td>760</td>
<td class="normal"> public function getCheckDeclaration(array $definition)
</td></tr>
<tr><td>761</td>
<td class="normal"> {
</td></tr>
<tr><td>762</td>
<td class="covered"> $constraints = array();
</td></tr>
<tr><td>763</td>
<td class="covered"> foreach ($definition as $field => $def) {
</td></tr>
<tr><td>764</td>
<td class="covered"> if (is_string($def)) {
</td></tr>
<tr><td>765</td>
<td class="red"> $constraints[] = 'CHECK (' . $def . ')';
</td></tr>
<tr><td>766</td>
<td class="red"> } else {
</td></tr>
<tr><td>767</td>
<td class="covered"> if (isset($def['min'])) {
</td></tr>
<tr><td>768</td>
<td class="red"> $constraints[] = 'CHECK (' . $field . ' >= ' . $def['min'] . ')';
</td></tr>
<tr><td>769</td>
<td class="red"> }
</td></tr>
<tr><td>770</td>
<td class="normal">
</td></tr>
<tr><td>771</td>
<td class="covered"> if (isset($def['max'])) {
</td></tr>
<tr><td>772</td>
<td class="red"> $constraints[] = 'CHECK (' . $field . ' <= ' . $def['max'] . ')';
</td></tr>
<tr><td>773</td>
<td class="red"> }
</td></tr>
<tr><td>774</td>
<td class="normal"> }
</td></tr>
<tr><td>775</td>
<td class="covered"> }
</td></tr>
<tr><td>776</td>
<td class="normal">
</td></tr>
<tr><td>777</td>
<td class="covered"> return implode(', ', $constraints);
</td></tr>
<tr><td>778</td>
<td class="orange"> }
</td></tr>
<tr><td>779</td>
<td class="normal">
</td></tr>
<tr><td>780</td>
<td class="normal"> /**
</td></tr>
<tr><td>781</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set an index
</td></tr>
<tr><td>782</td>
<td class="normal"> * declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>783</td>
<td class="normal"> *
</td></tr>
<tr><td>784</td>
<td class="normal"> * @param string $name name of the index
</td></tr>
<tr><td>785</td>
<td class="normal"> * @param array $definition index definition
</td></tr>
<tr><td>786</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set an index
</td></tr>
<tr><td>787</td>
<td class="normal"> */
</td></tr>
<tr><td>788</td>
<td class="normal"> public function getIndexDeclaration($name, array $definition)
</td></tr>
<tr><td>789</td>
<td class="normal"> {
</td></tr>
<tr><td>790</td>
<td class="covered"> $name = $this->conn->quoteIdentifier($name);
</td></tr>
<tr><td>791</td>
<td class="covered"> $type = '';
</td></tr>
<tr><td>792</td>
<td class="normal">
</td></tr>
<tr><td>793</td>
<td class="covered"> if (isset($definition['type'])) {
</td></tr>
<tr><td>794</td>
<td class="red"> if (strtolower($definition['type']) == 'unique') {
</td></tr>
<tr><td>795</td>
<td class="red"> $type = strtoupper($definition['type']) . ' ';
</td></tr>
<tr><td>796</td>
<td class="red"> } else {
</td></tr>
<tr><td>797</td>
<td class="red"> throw new Doctrine_Export_Exception('Unknown index type ' . $definition['type']);
</td></tr>
<tr><td>798</td>
<td class="normal"> }
</td></tr>
<tr><td>799</td>
<td class="red"> }
</td></tr>
<tr><td>800</td>
<td class="normal">
</td></tr>
<tr><td>801</td>
<td class="covered"> if ( ! isset($definition['fields']) || ! is_array($definition['fields'])) {
</td></tr>
<tr><td>802</td>
<td class="red"> throw new Doctrine_Export_Exception('No index columns given.');
</td></tr>
<tr><td>803</td>
<td class="orange"> }
</td></tr>
<tr><td>804</td>
<td class="normal">
</td></tr>
<tr><td>805</td>
<td class="covered"> $query = $type . 'INDEX ' . $name;
</td></tr>
<tr><td>806</td>
<td class="normal">
</td></tr>
<tr><td>807</td>
<td class="covered"> $query .= ' (' . $this->getIndexFieldDeclarationList($definition['fields']) . ')';
</td></tr>
<tr><td>808</td>
<td class="normal">
</td></tr>
<tr><td>809</td>
<td class="covered"> return $query;
</td></tr>
<tr><td>810</td>
<td class="orange"> }
</td></tr>
<tr><td>811</td>
<td class="normal">
</td></tr>
<tr><td>812</td>
<td class="normal"> /**
</td></tr>
<tr><td>813</td>
<td class="normal"> * getIndexFieldDeclarationList
</td></tr>
<tr><td>814</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set an index
</td></tr>
<tr><td>815</td>
<td class="normal"> * declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>816</td>
<td class="normal"> *
</td></tr>
<tr><td>817</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>818</td>
<td class="normal"> */
</td></tr>
<tr><td>819</td>
<td class="normal"> public function getIndexFieldDeclarationList(array $fields)
</td></tr>
<tr><td>820</td>
<td class="normal"> {
</td></tr>
<tr><td>821</td>
<td class="covered"> $ret = array();
</td></tr>
<tr><td>822</td>
<td class="covered"> foreach ($fields as $field => $definition) {
</td></tr>
<tr><td>823</td>
<td class="covered"> if (is_array($definition)) {
</td></tr>
<tr><td>824</td>
<td class="red"> $ret[] = $this->conn->quoteIdentifier($field);
</td></tr>
<tr><td>825</td>
<td class="red"> } else {
</td></tr>
<tr><td>826</td>
<td class="covered"> $ret[] = $this->conn->quoteIdentifier($definition);
</td></tr>
<tr><td>827</td>
<td class="normal"> }
</td></tr>
<tr><td>828</td>
<td class="covered"> }
</td></tr>
<tr><td>829</td>
<td class="covered"> return implode(', ', $ret);
</td></tr>
<tr><td>830</td>
<td class="orange"> }
</td></tr>
<tr><td>831</td>
<td class="normal">
</td></tr>
<tr><td>832</td>
<td class="normal"> /**
</td></tr>
<tr><td>833</td>
<td class="normal"> * A method to return the required SQL string that fits between CREATE ... TABLE
</td></tr>
<tr><td>834</td>
<td class="normal"> * to create the table as a temporary table.
</td></tr>
<tr><td>835</td>
<td class="normal"> *
</td></tr>
<tr><td>836</td>
<td class="normal"> * Should be overridden in driver classes to return the correct string for the
</td></tr>
<tr><td>837</td>
<td class="normal"> * specific database type.
</td></tr>
<tr><td>838</td>
<td class="normal"> *
</td></tr>
<tr><td>839</td>
<td class="normal"> * The default is to return the string "TEMPORARY" - this will result in a
</td></tr>
<tr><td>840</td>
<td class="normal"> * SQL error for any database that does not support temporary tables, or that
</td></tr>
<tr><td>841</td>
<td class="normal"> * requires a different SQL command from "CREATE TEMPORARY TABLE".
</td></tr>
<tr><td>842</td>
<td class="normal"> *
</td></tr>
<tr><td>843</td>
<td class="normal"> * @return string The string required to be placed between "CREATE" and "TABLE"
</td></tr>
<tr><td>844</td>
<td class="normal"> * to generate a temporary table, if possible.
</td></tr>
<tr><td>845</td>
<td class="normal"> */
</td></tr>
<tr><td>846</td>
<td class="normal"> public function getTemporaryTableQuery()
</td></tr>
<tr><td>847</td>
<td class="normal"> {
</td></tr>
<tr><td>848</td>
<td class="red"> return 'TEMPORARY';
</td></tr>
<tr><td>849</td>
<td class="orange"> }
</td></tr>
<tr><td>850</td>
<td class="normal">
</td></tr>
<tr><td>851</td>
<td class="normal"> /**
</td></tr>
<tr><td>852</td>
<td class="normal"> * getForeignKeyDeclaration
</td></tr>
<tr><td>853</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
</td></tr>
<tr><td>854</td>
<td class="normal"> * of a field declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>855</td>
<td class="normal"> *
</td></tr>
<tr><td>856</td>
<td class="normal"> * @param array $definition an associative array with the following structure:
</td></tr>
<tr><td>857</td>
<td class="normal"> * name optional constraint name
</td></tr>
<tr><td>858</td>
<td class="normal"> *
</td></tr>
<tr><td>859</td>
<td class="normal"> * local the local field(s)
</td></tr>
<tr><td>860</td>
<td class="normal"> *
</td></tr>
<tr><td>861</td>
<td class="normal"> * foreign the foreign reference field(s)
</td></tr>
<tr><td>862</td>
<td class="normal"> *
</td></tr>
<tr><td>863</td>
<td class="normal"> * foreignTable the name of the foreign table
</td></tr>
<tr><td>864</td>
<td class="normal"> *
</td></tr>
<tr><td>865</td>
<td class="normal"> * onDelete referential delete action
</td></tr>
<tr><td>866</td>
<td class="normal"> *
</td></tr>
<tr><td>867</td>
<td class="normal"> * onUpdate referential update action
</td></tr>
<tr><td>868</td>
<td class="normal"> *
</td></tr>
<tr><td>869</td>
<td class="normal"> * deferred deferred constraint checking
</td></tr>
<tr><td>870</td>
<td class="normal"> *
</td></tr>
<tr><td>871</td>
<td class="normal"> * The onDelete and onUpdate keys accept the following values:
</td></tr>
<tr><td>872</td>
<td class="normal"> *
</td></tr>
<tr><td>873</td>
<td class="normal"> * CASCADE: Delete or update the row from the parent table and automatically delete or
</td></tr>
<tr><td>874</td>
<td class="normal"> * update the matching rows in the child table. Both ON DELETE CASCADE and ON UPDATE CASCADE are supported.
</td></tr>
<tr><td>875</td>
<td class="normal"> * Between two tables, you should not define several ON UPDATE CASCADE clauses that act on the same column
</td></tr>
<tr><td>876</td>
<td class="normal"> * in the parent table or in the child table.
</td></tr>
<tr><td>877</td>
<td class="normal"> *
</td></tr>
<tr><td>878</td>
<td class="normal"> * SET NULL: Delete or update the row from the parent table and set the foreign key column or columns in the
</td></tr>
<tr><td>879</td>
<td class="normal"> * child table to NULL. This is valid only if the foreign key columns do not have the NOT NULL qualifier
</td></tr>
<tr><td>880</td>
<td class="normal"> * specified. Both ON DELETE SET NULL and ON UPDATE SET NULL clauses are supported.
</td></tr>
<tr><td>881</td>
<td class="normal"> *
</td></tr>
<tr><td>882</td>
<td class="normal"> * NO ACTION: In standard SQL, NO ACTION means no action in the sense that an attempt to delete or update a primary
</td></tr>
<tr><td>883</td>
<td class="normal"> * key value is not allowed to proceed if there is a related foreign key value in the referenced table.
</td></tr>
<tr><td>884</td>
<td class="normal"> *
</td></tr>
<tr><td>885</td>
<td class="normal"> * RESTRICT: Rejects the delete or update operation for the parent table. NO ACTION and RESTRICT are the same as
</td></tr>
<tr><td>886</td>
<td class="normal"> * omitting the ON DELETE or ON UPDATE clause.
</td></tr>
<tr><td>887</td>
<td class="normal"> *
</td></tr>
<tr><td>888</td>
<td class="normal"> * SET DEFAULT
</td></tr>
<tr><td>889</td>
<td class="normal"> *
</td></tr>
<tr><td>890</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
</td></tr>
<tr><td>891</td>
<td class="normal"> * of a field declaration.
</td></tr>
<tr><td>892</td>
<td class="normal"> */
</td></tr>
<tr><td>893</td>
<td class="normal"> public function getForeignKeyDeclaration(array $definition)
</td></tr>
<tr><td>894</td>
<td class="normal"> {
</td></tr>
<tr><td>895</td>
<td class="covered"> $sql = $this->getForeignKeyBaseDeclaration($definition);
</td></tr>
<tr><td>896</td>
<td class="covered"> $sql .= $this->getAdvancedForeignKeyOptions($definition);
</td></tr>
<tr><td>897</td>
<td class="normal">
</td></tr>
<tr><td>898</td>
<td class="covered"> return $sql;
</td></tr>
<tr><td>899</td>
<td class="orange"> }
</td></tr>
<tr><td>900</td>
<td class="normal">
</td></tr>
<tr><td>901</td>
<td class="normal"> /**
</td></tr>
<tr><td>902</td>
<td class="normal"> * getAdvancedForeignKeyOptions
</td></tr>
<tr><td>903</td>
<td class="normal"> * Return the FOREIGN KEY query section dealing with non-standard options
</td></tr>
<tr><td>904</td>
<td class="normal"> * as MATCH, INITIALLY DEFERRED, ON UPDATE, ...
</td></tr>
<tr><td>905</td>
<td class="normal"> *
</td></tr>
<tr><td>906</td>
<td class="normal"> * @param array $definition foreign key definition
</td></tr>
<tr><td>907</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>908</td>
<td class="normal"> */
</td></tr>
<tr><td>909</td>
<td class="normal"> public function getAdvancedForeignKeyOptions(array $definition)
</td></tr>
<tr><td>910</td>
<td class="normal"> {
</td></tr>
<tr><td>911</td>
<td class="red"> $query = '';
</td></tr>
<tr><td>912</td>
<td class="red"> if ( ! empty($definition['onUpdate'])) {
</td></tr>
<tr><td>913</td>
<td class="red"> $query .= ' ON UPDATE ' . $this->getForeignKeyRefentialAction($definition['onUpdate']);
</td></tr>
<tr><td>914</td>
<td class="red"> }
</td></tr>
<tr><td>915</td>
<td class="red"> if ( ! empty($definition['onDelete'])) {
</td></tr>
<tr><td>916</td>
<td class="red"> $query .= ' ON DELETE ' . $this->getForeignKeyRefentialAction($definition['onDelete']);
</td></tr>
<tr><td>917</td>
<td class="red"> }
</td></tr>
<tr><td>918</td>
<td class="red"> return $query;
</td></tr>
<tr><td>919</td>
<td class="orange"> }
</td></tr>
<tr><td>920</td>
<td class="normal">
</td></tr>
<tr><td>921</td>
<td class="normal"> /**
</td></tr>
<tr><td>922</td>
<td class="normal"> * getForeignKeyReferentialAction
</td></tr>
<tr><td>923</td>
<td class="normal"> *
</td></tr>
<tr><td>924</td>
<td class="normal"> * returns given referential action in uppercase if valid, otherwise throws
</td></tr>
<tr><td>925</td>
<td class="normal"> * an exception
</td></tr>
<tr><td>926</td>
<td class="normal"> *
</td></tr>
<tr><td>927</td>
<td class="normal"> * @throws Doctrine_Exception_Exception if unknown referential action given
</td></tr>
<tr><td>928</td>
<td class="normal"> * @param string $action foreign key referential action
</td></tr>
<tr><td>929</td>
<td class="normal"> * @param string foreign key referential action in uppercase
</td></tr>
<tr><td>930</td>
<td class="normal"> */
</td></tr>
<tr><td>931</td>
<td class="normal"> public function getForeignKeyReferentialAction($action)
</td></tr>
<tr><td>932</td>
<td class="normal"> {
</td></tr>
<tr><td>933</td>
<td class="covered"> $upper = strtoupper($action);
</td></tr>
<tr><td>934</td>
<td class="normal"> switch ($upper) {
</td></tr>
<tr><td>935</td>
<td class="covered"> case 'CASCADE':
</td></tr>
<tr><td>936</td>
<td class="covered"> case 'SET NULL':
</td></tr>
<tr><td>937</td>
<td class="covered"> case 'NO ACTION':
</td></tr>
<tr><td>938</td>
<td class="covered"> case 'RESTRICT':
</td></tr>
<tr><td>939</td>
<td class="covered"> case 'SET DEFAULT':
</td></tr>
<tr><td>940</td>
<td class="covered"> return $upper;
</td></tr>
<tr><td>941</td>
<td class="orange"> break;
</td></tr>
<tr><td>942</td>
<td class="red"> default:
</td></tr>
<tr><td>943</td>
<td class="red"> throw new Doctrine_Export_Exception('Unknown foreign key referential action \'' . $upper . '\' given.');
</td></tr>
<tr><td>944</td>
<td class="red"> }
</td></tr>
<tr><td>945</td>
<td class="orange"> }
</td></tr>
<tr><td>946</td>
<td class="normal">
</td></tr>
<tr><td>947</td>
<td class="normal"> /**
</td></tr>
<tr><td>948</td>
<td class="normal"> * getForeignKeyBaseDeclaration
</td></tr>
<tr><td>949</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set the FOREIGN KEY constraint
</td></tr>
<tr><td>950</td>
<td class="normal"> * of a field declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>951</td>
<td class="normal"> *
</td></tr>
<tr><td>952</td>
<td class="normal"> * @param array $definition
</td></tr>
<tr><td>953</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>954</td>
<td class="normal"> */
</td></tr>
<tr><td>955</td>
<td class="normal"> public function getForeignKeyBaseDeclaration(array $definition)
</td></tr>
<tr><td>956</td>
<td class="normal"> {
</td></tr>
<tr><td>957</td>
<td class="covered"> $sql = '';
</td></tr>
<tr><td>958</td>
<td class="covered"> if (isset($definition['name'])) {
</td></tr>
<tr><td>959</td>
<td class="red"> $sql .= ' CONSTRAINT ' . $this->conn->quoteIdentifier($definition['name']) . ' ';
</td></tr>
<tr><td>960</td>
<td class="red"> }
</td></tr>
<tr><td>961</td>
<td class="covered"> $sql .= 'FOREIGN KEY (';
</td></tr>
<tr><td>962</td>
<td class="normal">
</td></tr>
<tr><td>963</td>
<td class="covered"> if ( ! isset($definition['local'])) {
</td></tr>
<tr><td>964</td>
<td class="red"> throw new Doctrine_Export_Exception('Local reference field missing from definition.');
</td></tr>
<tr><td>965</td>
<td class="orange"> }
</td></tr>
<tr><td>966</td>
<td class="covered"> if ( ! isset($definition['foreign'])) {
</td></tr>
<tr><td>967</td>
<td class="red"> throw new Doctrine_Export_Exception('Foreign reference field missing from definition.');
</td></tr>
<tr><td>968</td>
<td class="orange"> }
</td></tr>
<tr><td>969</td>
<td class="covered"> if ( ! isset($definition['foreignTable'])) {
</td></tr>
<tr><td>970</td>
<td class="red"> throw new Doctrine_Export_Exception('Foreign reference table missing from definition.');
</td></tr>
<tr><td>971</td>
<td class="orange"> }
</td></tr>
<tr><td>972</td>
<td class="normal">
</td></tr>
<tr><td>973</td>
<td class="covered"> if ( ! is_array($definition['local'])) {
</td></tr>
<tr><td>974</td>
<td class="covered"> $definition['local'] = array($definition['local']);
</td></tr>
<tr><td>975</td>
<td class="covered"> }
</td></tr>
<tr><td>976</td>
<td class="covered"> if ( ! is_array($definition['foreign'])) {
</td></tr>
<tr><td>977</td>
<td class="covered"> $definition['foreign'] = array($definition['foreign']);
</td></tr>
<tr><td>978</td>
<td class="covered"> }
</td></tr>
<tr><td>979</td>
<td class="normal">
</td></tr>
<tr><td>980</td>
<td class="covered"> $sql .= implode(', ', array_map(array($this->conn, 'quoteIdentifier'), $definition['local']))
</td></tr>
<tr><td>981</td>
<td class="normal"> . ') REFERENCES '
</td></tr>
<tr><td>982</td>
<td class="covered"> . $this->conn->quoteIdentifier($definition['foreignTable']) . '('
</td></tr>
<tr><td>983</td>
<td class="covered"> . implode(', ', array_map(array($this->conn, 'quoteIdentifier'), $definition['foreign'])) . ')';
</td></tr>
<tr><td>984</td>
<td class="normal">
</td></tr>
<tr><td>985</td>
<td class="covered"> return $sql;
</td></tr>
<tr><td>986</td>
<td class="orange"> }
</td></tr>
<tr><td>987</td>
<td class="normal">
</td></tr>
<tr><td>988</td>
<td class="normal"> /**
</td></tr>
<tr><td>989</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set the UNIQUE constraint
</td></tr>
<tr><td>990</td>
<td class="normal"> * of a field declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>991</td>
<td class="normal"> *
</td></tr>
<tr><td>992</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set the UNIQUE constraint
</td></tr>
<tr><td>993</td>
<td class="normal"> * of a field declaration.
</td></tr>
<tr><td>994</td>
<td class="normal"> */
</td></tr>
<tr><td>995</td>
<td class="normal"> public function getUniqueFieldDeclaration()
</td></tr>
<tr><td>996</td>
<td class="normal"> {
</td></tr>
<tr><td>997</td>
<td class="covered"> return 'UNIQUE';
</td></tr>
<tr><td>998</td>
<td class="orange"> }
</td></tr>
<tr><td>999</td>
<td class="normal">
</td></tr>
<tr><td>1000</td>
<td class="normal"> /**
</td></tr>
<tr><td>1001</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set the CHARACTER SET
</td></tr>
<tr><td>1002</td>
<td class="normal"> * of a field declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>1003</td>
<td class="normal"> *
</td></tr>
<tr><td>1004</td>
<td class="normal"> * @param string $charset name of the charset
</td></tr>
<tr><td>1005</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set the CHARACTER SET
</td></tr>
<tr><td>1006</td>
<td class="normal"> * of a field declaration.
</td></tr>
<tr><td>1007</td>
<td class="normal"> */
</td></tr>
<tr><td>1008</td>
<td class="normal"> public function getCharsetFieldDeclaration($charset)
</td></tr>
<tr><td>1009</td>
<td class="normal"> {
</td></tr>
<tr><td>1010</td>
<td class="red"> return '';
</td></tr>
<tr><td>1011</td>
<td class="orange"> }
</td></tr>
<tr><td>1012</td>
<td class="normal">
</td></tr>
<tr><td>1013</td>
<td class="normal"> /**
</td></tr>
<tr><td>1014</td>
<td class="normal"> * Obtain DBMS specific SQL code portion needed to set the COLLATION
</td></tr>
<tr><td>1015</td>
<td class="normal"> * of a field declaration to be used in statements like CREATE TABLE.
</td></tr>
<tr><td>1016</td>
<td class="normal"> *
</td></tr>
<tr><td>1017</td>
<td class="normal"> * @param string $collation name of the collation
</td></tr>
<tr><td>1018</td>
<td class="normal"> * @return string DBMS specific SQL code portion needed to set the COLLATION
</td></tr>
<tr><td>1019</td>
<td class="normal"> * of a field declaration.
</td></tr>
<tr><td>1020</td>
<td class="normal"> */
</td></tr>
<tr><td>1021</td>
<td class="normal"> public function getCollationFieldDeclaration($collation)
</td></tr>
<tr><td>1022</td>
<td class="normal"> {
</td></tr>
<tr><td>1023</td>
<td class="red"> return '';
</td></tr>
<tr><td>1024</td>
<td class="orange"> }
</td></tr>
<tr><td>1025</td>
<td class="normal">
</td></tr>
<tr><td>1026</td>
<td class="normal"> /**
</td></tr>
<tr><td>1027</td>
<td class="normal"> * exportSchema
</td></tr>
<tr><td>1028</td>
<td class="normal"> * method for exporting Doctrine_Record classes to a schema
</td></tr>
<tr><td>1029</td>
<td class="normal"> *
</td></tr>
<tr><td>1030</td>
<td class="normal"> * if the directory parameter is given this method first iterates
</td></tr>
<tr><td>1031</td>
<td class="normal"> * recursively trhough the given directory in order to find any model classes
</td></tr>
<tr><td>1032</td>
<td class="normal"> *
</td></tr>
<tr><td>1033</td>
<td class="normal"> * Then it iterates through all declared classes and creates tables for the ones
</td></tr>
<tr><td>1034</td>
<td class="normal"> * that extend Doctrine_Record and are not abstract classes
</td></tr>
<tr><td>1035</td>
<td class="normal"> *
</td></tr>
<tr><td>1036</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS
</td></tr>
<tr><td>1037</td>
<td class="normal"> * occurred during the create table operation
</td></tr>
<tr><td>1038</td>
<td class="normal"> * @param string $directory optional directory parameter
</td></tr>
<tr><td>1039</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1040</td>
<td class="normal"> */
</td></tr>
<tr><td>1041</td>
<td class="normal"> public function exportSchema($directory = null)
</td></tr>
<tr><td>1042</td>
<td class="normal"> {
</td></tr>
<tr><td>1043</td>
<td class="covered"> if ($directory !== null) {
</td></tr>
<tr><td>1044</td>
<td class="covered"> $models = Doctrine::loadModels($directory);
</td></tr>
<tr><td>1045</td>
<td class="covered"> } else {
</td></tr>
<tr><td>1046</td>
<td class="red"> $models = Doctrine::getLoadedModels();
</td></tr>
<tr><td>1047</td>
<td class="normal"> }
</td></tr>
<tr><td>1048</td>
<td class="normal">
</td></tr>
<tr><td>1049</td>
<td class="covered"> $this->exportClasses($models);
</td></tr>
<tr><td>1050</td>
<td class="covered"> }
</td></tr>
<tr><td>1051</td>
<td class="normal">
</td></tr>
<tr><td>1052</td>
<td class="normal"> /**
</td></tr>
<tr><td>1053</td>
<td class="normal"> * exportClasses
</td></tr>
<tr><td>1054</td>
<td class="normal"> * method for exporting Doctrine_Record classes to a schema
</td></tr>
<tr><td>1055</td>
<td class="normal"> *
</td></tr>
<tr><td>1056</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS
</td></tr>
<tr><td>1057</td>
<td class="normal"> * occurred during the create table operation
</td></tr>
<tr><td>1058</td>
<td class="normal"> * @param array $classes
</td></tr>
<tr><td>1059</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1060</td>
<td class="normal"> */
</td></tr>
<tr><td>1061</td>
<td class="normal"> public function exportClasses(array $classes)
</td></tr>
<tr><td>1062</td>
<td class="normal"> {
</td></tr>
<tr><td>1063</td>
<td class="covered"> $connections = array();
</td></tr>
<tr><td>1064</td>
<td class="covered"> foreach ($classes as $class) {
</td></tr>
<tr><td>1065</td>
<td class="covered"> $record = new $class();
</td></tr>
<tr><td>1066</td>
<td class="covered"> $connection = $record->getTable()->getConnection();
</td></tr>
<tr><td>1067</td>
<td class="covered"> $connectionName = Doctrine_Manager::getInstance()->getConnectionName($connection);
</td></tr>
<tr><td>1068</td>
<td class="normal">
</td></tr>
<tr><td>1069</td>
<td class="covered"> if ( ! isset($connections[$connectionName])) {
</td></tr>
<tr><td>1070</td>
<td class="covered"> $connections[$connectionName] = array();
</td></tr>
<tr><td>1071</td>
<td class="covered"> $connections[$connectionName]['creates'] = array();
</td></tr>
<tr><td>1072</td>
<td class="covered"> $connections[$connectionName]['alters'] = array();
</td></tr>
<tr><td>1073</td>
<td class="covered"> }
</td></tr>
<tr><td>1074</td>
<td class="normal">
</td></tr>
<tr><td>1075</td>
<td class="covered"> $sql = $this->exportClassesSql(array($class));
</td></tr>
<tr><td>1076</td>
<td class="normal"> // Build array of all the creates
</td></tr>
<tr><td>1077</td>
<td class="normal"> // We need these to happen first
</td></tr>
<tr><td>1078</td>
<td class="covered"> foreach ($sql as $key => $query) {
</td></tr>
<tr><td>1079</td>
<td class="covered"> if (strstr($query, 'CREATE')) {
</td></tr>
<tr><td>1080</td>
<td class="covered"> $connections[$connectionName]['creates'][] = $query;
</td></tr>
<tr><td>1081</td>
<td class="normal"> // Unset the create from sql so we can have an array of everything else but creates
</td></tr>
<tr><td>1082</td>
<td class="covered"> unset($sql[$key]);
</td></tr>
<tr><td>1083</td>
<td class="covered"> }
</td></tr>
<tr><td>1084</td>
<td class="covered"> }
</td></tr>
<tr><td>1085</td>
<td class="normal">
</td></tr>
<tr><td>1086</td>
<td class="covered"> $connections[$connectionName]['alters'] = array_merge($connections[$connectionName]['alters'], $sql);
</td></tr>
<tr><td>1087</td>
<td class="covered"> }
</td></tr>
<tr><td>1088</td>
<td class="normal">
</td></tr>
<tr><td>1089</td>
<td class="normal"> // Loop over all the sql again to merge the creates and alters in to the same array, but so that the alters are at the bottom
</td></tr>
<tr><td>1090</td>
<td class="covered"> $build = array();
</td></tr>
<tr><td>1091</td>
<td class="covered"> foreach ($connections as $connectionName => $sql) {
</td></tr>
<tr><td>1092</td>
<td class="covered"> $build[$connectionName] = array_merge($sql['creates'], $sql['alters']);
</td></tr>
<tr><td>1093</td>
<td class="covered"> }
</td></tr>
<tr><td>1094</td>
<td class="normal">
</td></tr>
<tr><td>1095</td>
<td class="covered"> foreach ($build as $connectionName => $sql) {
</td></tr>
<tr><td>1096</td>
<td class="covered"> $connection = Doctrine_Manager::getInstance()->getConnection($connectionName);
</td></tr>
<tr><td>1097</td>
<td class="normal">
</td></tr>
<tr><td>1098</td>
<td class="covered"> $connection->beginTransaction();
</td></tr>
<tr><td>1099</td>
<td class="normal">
</td></tr>
<tr><td>1100</td>
<td class="covered"> foreach ($sql as $query) {
</td></tr>
<tr><td>1101</td>
<td class="normal"> try {
</td></tr>
<tr><td>1102</td>
<td class="covered"> $connection->exec($query);
</td></tr>
<tr><td>1103</td>
<td class="covered"> } catch (Doctrine_Connection_Exception $e) {
</td></tr>
<tr><td>1104</td>
<td class="normal"> // we only want to silence table already exists errors
</td></tr>
<tr><td>1105</td>
<td class="covered"> if ($e->getPortableCode() !== Doctrine::ERR_ALREADY_EXISTS) {
</td></tr>
<tr><td>1106</td>
<td class="orange"> $connection->rollback();
</td></tr>
<tr><td>1107</td>
<td class="orange"> throw new Doctrine_Export_Exception($e->getMessage() . '. Failing Query: ' . $query);
</td></tr>
<tr><td>1108</td>
<td class="orange"> }
</td></tr>
<tr><td>1109</td>
<td class="normal"> }
</td></tr>
<tr><td>1110</td>
<td class="covered"> }
</td></tr>
<tr><td>1111</td>
<td class="normal">
</td></tr>
<tr><td>1112</td>
<td class="covered"> $connection->commit();
</td></tr>
<tr><td>1113</td>
<td class="covered"> }
</td></tr>
<tr><td>1114</td>
<td class="covered"> }
</td></tr>
<tr><td>1115</td>
<td class="normal">
</td></tr>
<tr><td>1116</td>
<td class="normal"> /**
</td></tr>
<tr><td>1117</td>
<td class="normal"> * exportClassesSql
</td></tr>
<tr><td>1118</td>
<td class="normal"> * method for exporting Doctrine_Record classes to a schema
</td></tr>
<tr><td>1119</td>
<td class="normal"> *
</td></tr>
<tr><td>1120</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS
</td></tr>
<tr><td>1121</td>
<td class="normal"> * occurred during the create table operation
</td></tr>
<tr><td>1122</td>
<td class="normal"> * @param array $classes
</td></tr>
<tr><td>1123</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1124</td>
<td class="normal"> */
</td></tr>
<tr><td>1125</td>
<td class="normal"> public function exportClassesSql(array $classes)
</td></tr>
<tr><td>1126</td>
<td class="normal"> {
</td></tr>
<tr><td>1127</td>
<td class="covered"> $models = Doctrine::getLoadedModels($classes);
</td></tr>
<tr><td>1128</td>
<td class="normal">
</td></tr>
<tr><td>1129</td>
<td class="covered"> $sql = array();
</td></tr>
<tr><td>1130</td>
<td class="normal">
</td></tr>
<tr><td>1131</td>
<td class="covered"> foreach ($models as $name) {
</td></tr>
<tr><td>1132</td>
<td class="covered"> $record = new $name();
</td></tr>
<tr><td>1133</td>
<td class="covered"> $table = $record->getTable();
</td></tr>
<tr><td>1134</td>
<td class="normal">
</td></tr>
<tr><td>1135</td>
<td class="covered"> $parents = $table->getOption('joinedParents');
</td></tr>
<tr><td>1136</td>
<td class="normal">
</td></tr>
<tr><td>1137</td>
<td class="covered"> foreach ($parents as $parent) {
</td></tr>
<tr><td>1138</td>
<td class="covered"> $data = $table->getConnection()->getTable($parent)->getExportableFormat();
</td></tr>
<tr><td>1139</td>
<td class="normal">
</td></tr>
<tr><td>1140</td>
<td class="covered"> $query = $this->conn->export->createTableSql($data['tableName'], $data['columns'], $data['options']);
</td></tr>
<tr><td>1141</td>
<td class="normal">
</td></tr>
<tr><td>1142</td>
<td class="covered"> $sql = array_merge($sql, (array) $query);
</td></tr>
<tr><td>1143</td>
<td class="covered"> }
</td></tr>
<tr><td>1144</td>
<td class="normal">
</td></tr>
<tr><td>1145</td>
<td class="covered"> $data = $table->getExportableFormat();
</td></tr>
<tr><td>1146</td>
<td class="normal">
</td></tr>
<tr><td>1147</td>
<td class="covered"> $query = $this->conn->export->createTableSql($data['tableName'], $data['columns'], $data['options']);
</td></tr>
<tr><td>1148</td>
<td class="normal">
</td></tr>
<tr><td>1149</td>
<td class="covered"> if (is_array($query)) {
</td></tr>
<tr><td>1150</td>
<td class="covered"> $sql = array_merge($sql, $query);
</td></tr>
<tr><td>1151</td>
<td class="covered"> } else {
</td></tr>
<tr><td>1152</td>
<td class="red"> $sql[] = $query;
</td></tr>
<tr><td>1153</td>
<td class="normal"> }
</td></tr>
<tr><td>1154</td>
<td class="normal">
</td></tr>
<tr><td>1155</td>
<td class="covered"> if ($table->getAttribute(Doctrine::ATTR_EXPORT) & Doctrine::EXPORT_PLUGINS) {
</td></tr>
<tr><td>1156</td>
<td class="covered"> $sql = array_merge($sql, $this->exportPluginsSql($table));
</td></tr>
<tr><td>1157</td>
<td class="covered"> }
</td></tr>
<tr><td>1158</td>
<td class="covered"> }
</td></tr>
<tr><td>1159</td>
<td class="normal">
</td></tr>
<tr><td>1160</td>
<td class="covered"> $sql = array_unique($sql);
</td></tr>
<tr><td>1161</td>
<td class="normal">
</td></tr>
<tr><td>1162</td>
<td class="covered"> rsort($sql);
</td></tr>
<tr><td>1163</td>
<td class="normal">
</td></tr>
<tr><td>1164</td>
<td class="covered"> return $sql;
</td></tr>
<tr><td>1165</td>
<td class="orange"> }
</td></tr>
<tr><td>1166</td>
<td class="normal">
</td></tr>
<tr><td>1167</td>
<td class="normal"> /**
</td></tr>
<tr><td>1168</td>
<td class="normal"> * fetches all plugins recursively for given table
</td></tr>
<tr><td>1169</td>
<td class="normal"> *
</td></tr>
<tr><td>1170</td>
<td class="normal"> * @param Doctrine_Table $table table object to retrieve the plugins from
</td></tr>
<tr><td>1171</td>
<td class="normal"> * @return array an array of Doctrine_Plugin objects
</td></tr>
<tr><td>1172</td>
<td class="normal"> */
</td></tr>
<tr><td>1173</td>
<td class="normal"> public function getAllPlugins(Doctrine_Table $table)
</td></tr>
<tr><td>1174</td>
<td class="normal"> {
</td></tr>
<tr><td>1175</td>
<td class="covered"> $plugins = array();
</td></tr>
<tr><td>1176</td>
<td class="normal">
</td></tr>
<tr><td>1177</td>
<td class="covered"> foreach ($table->getTemplates() as $name => $template) {
</td></tr>
<tr><td>1178</td>
<td class="covered"> $plugin = $template->getPlugin();
</td></tr>
<tr><td>1179</td>
<td class="normal">
</td></tr>
<tr><td>1180</td>
<td class="covered"> if ($plugin === null) {
</td></tr>
<tr><td>1181</td>
<td class="covered"> continue;
</td></tr>
<tr><td>1182</td>
<td class="orange"> }
</td></tr>
<tr><td>1183</td>
<td class="normal">
</td></tr>
<tr><td>1184</td>
<td class="covered"> $plugins[] = $plugin;
</td></tr>
<tr><td>1185</td>
<td class="normal">
</td></tr>
<tr><td>1186</td>
<td class="covered"> $pluginTable = $plugin->getOption('pluginTable');
</td></tr>
<tr><td>1187</td>
<td class="normal">
</td></tr>
<tr><td>1188</td>
<td class="covered"> if ($pluginTable instanceof Doctrine_Table) {
</td></tr>
<tr><td>1189</td>
<td class="covered"> $plugins = array_merge($plugins, $this->getAllPlugins($pluginTable));
</td></tr>
<tr><td>1190</td>
<td class="covered"> }
</td></tr>
<tr><td>1191</td>
<td class="covered"> }
</td></tr>
<tr><td>1192</td>
<td class="normal">
</td></tr>
<tr><td>1193</td>
<td class="covered"> return $plugins;
</td></tr>
<tr><td>1194</td>
<td class="orange"> }
</td></tr>
<tr><td>1195</td>
<td class="normal">
</td></tr>
<tr><td>1196</td>
<td class="normal"> /**
</td></tr>
<tr><td>1197</td>
<td class="normal"> * exportPluginsSql
</td></tr>
<tr><td>1198</td>
<td class="normal"> * exports plugin tables for given table
</td></tr>
<tr><td>1199</td>
<td class="normal"> *
</td></tr>
<tr><td>1200</td>
<td class="normal"> * @param Doctrine_Table $table the table in which the plugins belong to
</td></tr>
<tr><td>1201</td>
<td class="normal"> * @return array an array of sql strings
</td></tr>
<tr><td>1202</td>
<td class="normal"> */
</td></tr>
<tr><td>1203</td>
<td class="normal"> public function exportPluginsSql(Doctrine_Table $table)
</td></tr>
<tr><td>1204</td>
<td class="normal"> {
</td></tr>
<tr><td>1205</td>
<td class="covered"> $sql = array();
</td></tr>
<tr><td>1206</td>
<td class="normal">
</td></tr>
<tr><td>1207</td>
<td class="covered"> foreach ($this->getAllPlugins($table) as $name => $plugin) {
</td></tr>
<tr><td>1208</td>
<td class="covered"> $table = $plugin->getOption('pluginTable');
</td></tr>
<tr><td>1209</td>
<td class="normal">
</td></tr>
<tr><td>1210</td>
<td class="normal"> // Make sure plugin has a valid table
</td></tr>
<tr><td>1211</td>
<td class="covered"> if ($table instanceof Doctrine_Table) {
</td></tr>
<tr><td>1212</td>
<td class="covered"> $data = $table->getExportableFormat();
</td></tr>
<tr><td>1213</td>
<td class="normal">
</td></tr>
<tr><td>1214</td>
<td class="covered"> $query = $this->conn->export->createTableSql($data['tableName'], $data['columns'], $data['options']);
</td></tr>
<tr><td>1215</td>
<td class="normal">
</td></tr>
<tr><td>1216</td>
<td class="covered"> $sql = array_merge($sql, (array) $query);
</td></tr>
<tr><td>1217</td>
<td class="covered"> }
</td></tr>
<tr><td>1218</td>
<td class="covered"> }
</td></tr>
<tr><td>1219</td>
<td class="normal">
</td></tr>
<tr><td>1220</td>
<td class="covered"> return $sql;
</td></tr>
<tr><td>1221</td>
<td class="orange"> }
</td></tr>
<tr><td>1222</td>
<td class="normal">
</td></tr>
<tr><td>1223</td>
<td class="normal"> /**
</td></tr>
<tr><td>1224</td>
<td class="normal"> * exportSql
</td></tr>
<tr><td>1225</td>
<td class="normal"> * returns the sql for exporting Doctrine_Record classes to a schema
</td></tr>
<tr><td>1226</td>
<td class="normal"> *
</td></tr>
<tr><td>1227</td>
<td class="normal"> * if the directory parameter is given this method first iterates
</td></tr>
<tr><td>1228</td>
<td class="normal"> * recursively trhough the given directory in order to find any model classes
</td></tr>
<tr><td>1229</td>
<td class="normal"> *
</td></tr>
<tr><td>1230</td>
<td class="normal"> * Then it iterates through all declared classes and creates tables for the ones
</td></tr>
<tr><td>1231</td>
<td class="normal"> * that extend Doctrine_Record and are not abstract classes
</td></tr>
<tr><td>1232</td>
<td class="normal"> *
</td></tr>
<tr><td>1233</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS
</td></tr>
<tr><td>1234</td>
<td class="normal"> * occurred during the create table operation
</td></tr>
<tr><td>1235</td>
<td class="normal"> * @param string $directory optional directory parameter
</td></tr>
<tr><td>1236</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1237</td>
<td class="normal"> */
</td></tr>
<tr><td>1238</td>
<td class="normal"> public function exportSql($directory = null)
</td></tr>
<tr><td>1239</td>
<td class="normal"> {
</td></tr>
<tr><td>1240</td>
<td class="red"> if ($directory !== null) {
</td></tr>
<tr><td>1241</td>
<td class="red"> $models = Doctrine::loadModels($directory);
</td></tr>
<tr><td>1242</td>
<td class="red"> } else {
</td></tr>
<tr><td>1243</td>
<td class="red"> $models = Doctrine::getLoadedModels();
</td></tr>
<tr><td>1244</td>
<td class="normal"> }
</td></tr>
<tr><td>1245</td>
<td class="normal">
</td></tr>
<tr><td>1246</td>
<td class="red"> return $this->exportClassesSql($models);
</td></tr>
<tr><td>1247</td>
<td class="orange"> }
</td></tr>
<tr><td>1248</td>
<td class="normal">
</td></tr>
<tr><td>1249</td>
<td class="normal"> /**
</td></tr>
<tr><td>1250</td>
<td class="normal"> * exportTable
</td></tr>
<tr><td>1251</td>
<td class="normal"> * exports given table into database based on column and option definitions
</td></tr>
<tr><td>1252</td>
<td class="normal"> *
</td></tr>
<tr><td>1253</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS
</td></tr>
<tr><td>1254</td>
<td class="normal"> * occurred during the create table operation
</td></tr>
<tr><td>1255</td>
<td class="normal"> * @return boolean whether or not the export operation was successful
</td></tr>
<tr><td>1256</td>
<td class="normal"> * false if table already existed in the database
</td></tr>
<tr><td>1257</td>
<td class="normal"> */
</td></tr>
<tr><td>1258</td>
<td class="normal"> public function exportTable(Doctrine_Table $table)
</td></tr>
<tr><td>1259</td>
<td class="normal"> {
</td></tr>
<tr><td>1260</td>
<td class="normal"> /**
</td></tr>
<tr><td>1261</td>
<td class="normal"> TODO: maybe there should be portability option for the following check
</td></tr>
<tr><td>1262</td>
<td class="normal"> if ( ! Doctrine::isValidClassname($table->getOption('declaringClass')->getName())) {
</td></tr>
<tr><td>1263</td>
<td class="normal"> throw new Doctrine_Export_Exception('Class name not valid.');
</td></tr>
<tr><td>1264</td>
<td class="normal"> }
</td></tr>
<tr><td>1265</td>
<td class="normal"> */
</td></tr>
<tr><td>1266</td>
<td class="normal">
</td></tr>
<tr><td>1267</td>
<td class="normal"> try {
</td></tr>
<tr><td>1268</td>
<td class="red"> $data = $table->getExportableFormat();
</td></tr>
<tr><td>1269</td>
<td class="normal">
</td></tr>
<tr><td>1270</td>
<td class="red"> $this->conn->export->createTable($data['tableName'], $data['columns'], $data['options']);
</td></tr>
<tr><td>1271</td>
<td class="red"> } catch(Doctrine_Connection_Exception $e) {
</td></tr>
<tr><td>1272</td>
<td class="normal"> // we only want to silence table already exists errors
</td></tr>
<tr><td>1273</td>
<td class="orange"> if ($e->getPortableCode() !== Doctrine::ERR_ALREADY_EXISTS) {
</td></tr>
<tr><td>1274</td>
<td class="orange"> throw $e;
</td></tr>
<tr><td>1275</td>
<td class="orange"> }
</td></tr>
<tr><td>1276</td>
<td class="normal"> }
</td></tr>
<tr><td>1277</td>
<td class="red"> }
</td></tr>
<tr><td>1278</td>
<td class="normal">}
</td></tr>
</table></body></html>