<html> <head> <title>Coverage for Doctrine_Connection_Mysql</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Connection_Mysql</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: Mysql.php 3183 2007-11-18 16:06:37Z romanb $ </td></tr> <tr><td>4</td> <td class="normal"> * </td></tr> <tr><td>5</td> <td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS </td></tr> <tr><td>6</td> <td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT </td></tr> <tr><td>7</td> <td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR </td></tr> <tr><td>8</td> <td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT </td></tr> <tr><td>9</td> <td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, </td></tr> <tr><td>10</td> <td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT </td></tr> <tr><td>11</td> <td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, </td></tr> <tr><td>12</td> <td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY </td></tr> <tr><td>13</td> <td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT </td></tr> <tr><td>14</td> <td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE </td></tr> <tr><td>15</td> <td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </td></tr> <tr><td>16</td> <td class="normal"> * </td></tr> <tr><td>17</td> <td class="normal"> * This software consists of voluntary contributions made by many individuals </td></tr> <tr><td>18</td> <td class="normal"> * and is licensed under the LGPL. For more information, see </td></tr> <tr><td>19</td> <td class="normal"> * <http://www.phpdoctrine.com>. </td></tr> <tr><td>20</td> <td class="normal"> */ </td></tr> <tr><td>21</td> <td class="covered">Doctrine::autoload('Doctrine_Connection_Common'); </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Connection_Mysql </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 Connection </td></tr> <tr><td>27</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>28</td> <td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>29</td> <td class="normal"> * @author Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library) </td></tr> <tr><td>30</td> <td class="normal"> * @version $Revision: 3183 $ </td></tr> <tr><td>31</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>32</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>33</td> <td class="normal"> */ </td></tr> <tr><td>34</td> <td class="covered">class Doctrine_Connection_Mysql extends Doctrine_Connection_Common </td></tr> <tr><td>35</td> <td class="normal">{ </td></tr> <tr><td>36</td> <td class="normal"> /** </td></tr> <tr><td>37</td> <td class="normal"> * @var string $driverName the name of this connection driver </td></tr> <tr><td>38</td> <td class="normal"> */ </td></tr> <tr><td>39</td> <td class="normal"> protected $driverName = 'Mysql'; </td></tr> <tr><td>40</td> <td class="normal"> </td></tr> <tr><td>41</td> <td class="normal"> /** </td></tr> <tr><td>42</td> <td class="normal"> * the constructor </td></tr> <tr><td>43</td> <td class="normal"> * </td></tr> <tr><td>44</td> <td class="normal"> * @param Doctrine_Manager $manager </td></tr> <tr><td>45</td> <td class="normal"> * @param PDO|Doctrine_Adapter $adapter database handler </td></tr> <tr><td>46</td> <td class="normal"> */ </td></tr> <tr><td>47</td> <td class="normal"> public function __construct(Doctrine_Manager $manager, $adapter) </td></tr> <tr><td>48</td> <td class="normal"> { </td></tr> <tr><td>49</td> <td class="covered"> $this->setAttribute(PDO::ATTR_EMULATE_PREPARES, true); </td></tr> <tr><td>50</td> <td class="covered"> $this->setAttribute(Doctrine::ATTR_DEFAULT_TABLE_TYPE, 'INNODB'); </td></tr> <tr><td>51</td> <td class="normal"> </td></tr> <tr><td>52</td> <td class="red"> $this->supported = array( </td></tr> <tr><td>53</td> <td class="covered"> 'sequences' => 'emulated', </td></tr> <tr><td>54</td> <td class="covered"> 'indexes' => true, </td></tr> <tr><td>55</td> <td class="covered"> 'affected_rows' => true, </td></tr> <tr><td>56</td> <td class="covered"> 'transactions' => true, </td></tr> <tr><td>57</td> <td class="covered"> 'savepoints' => false, </td></tr> <tr><td>58</td> <td class="covered"> 'summary_functions' => true, </td></tr> <tr><td>59</td> <td class="covered"> 'order_by_text' => true, </td></tr> <tr><td>60</td> <td class="covered"> 'current_id' => 'emulated', </td></tr> <tr><td>61</td> <td class="covered"> 'limit_queries' => true, </td></tr> <tr><td>62</td> <td class="covered"> 'LOBs' => true, </td></tr> <tr><td>63</td> <td class="covered"> 'replace' => true, </td></tr> <tr><td>64</td> <td class="covered"> 'sub_selects' => true, </td></tr> <tr><td>65</td> <td class="covered"> 'auto_increment' => true, </td></tr> <tr><td>66</td> <td class="covered"> 'primary_key' => true, </td></tr> <tr><td>67</td> <td class="covered"> 'result_introspection' => true, </td></tr> <tr><td>68</td> <td class="covered"> 'prepared_statements' => 'emulated', </td></tr> <tr><td>69</td> <td class="covered"> 'identifier_quoting' => true, </td></tr> <tr><td>70</td> <td class="normal"> 'pattern_escaping' => true </td></tr> <tr><td>71</td> <td class="covered"> ); </td></tr> <tr><td>72</td> <td class="normal"> </td></tr> <tr><td>73</td> <td class="covered"> $this->properties['string_quoting'] = array('start' => "'", </td></tr> <tr><td>74</td> <td class="covered"> 'end' => "'", </td></tr> <tr><td>75</td> <td class="covered"> 'escape' => '\\', </td></tr> <tr><td>76</td> <td class="covered"> 'escape_pattern' => '\\'); </td></tr> <tr><td>77</td> <td class="normal"> </td></tr> <tr><td>78</td> <td class="covered"> $this->properties['identifier_quoting'] = array('start' => '`', </td></tr> <tr><td>79</td> <td class="covered"> 'end' => '`', </td></tr> <tr><td>80</td> <td class="covered"> 'escape' => '`'); </td></tr> <tr><td>81</td> <td class="normal"> </td></tr> <tr><td>82</td> <td class="covered"> $this->properties['sql_comments'] = array( </td></tr> <tr><td>83</td> <td class="covered"> array('start' => '-- ', 'end' => "\n", 'escape' => false), </td></tr> <tr><td>84</td> <td class="covered"> array('start' => '#', 'end' => "\n", 'escape' => false), </td></tr> <tr><td>85</td> <td class="covered"> array('start' => '/*', 'end' => '*/', 'escape' => false), </td></tr> <tr><td>86</td> <td class="normal"> ); </td></tr> <tr><td>87</td> <td class="normal"> </td></tr> <tr><td>88</td> <td class="covered"> $this->properties['varchar_max_length'] = 255; </td></tr> <tr><td>89</td> <td class="normal"> </td></tr> <tr><td>90</td> <td class="covered"> parent::__construct($manager, $adapter); </td></tr> <tr><td>91</td> <td class="covered"> } </td></tr> <tr><td>92</td> <td class="normal"> </td></tr> <tr><td>93</td> <td class="normal"> /** </td></tr> <tr><td>94</td> <td class="normal"> * Set the charset on the current connection </td></tr> <tr><td>95</td> <td class="normal"> * </td></tr> <tr><td>96</td> <td class="normal"> * @param string charset </td></tr> <tr><td>97</td> <td class="normal"> */ </td></tr> <tr><td>98</td> <td class="normal"> public function setCharset($charset) </td></tr> <tr><td>99</td> <td class="normal"> { </td></tr> <tr><td>100</td> <td class="red"> $query = 'SET NAMES ' . $this->quote($charset); </td></tr> <tr><td>101</td> <td class="normal"> </td></tr> <tr><td>102</td> <td class="red"> $this->exec($query); </td></tr> <tr><td>103</td> <td class="red"> } </td></tr> <tr><td>104</td> <td class="normal"> </td></tr> <tr><td>105</td> <td class="normal"> /** </td></tr> <tr><td>106</td> <td class="normal"> * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT </td></tr> <tr><td>107</td> <td class="normal"> * query, except that if there is already a row in the table with the same </td></tr> <tr><td>108</td> <td class="normal"> * key field values, the REPLACE query just updates its values instead of </td></tr> <tr><td>109</td> <td class="normal"> * inserting a new row. </td></tr> <tr><td>110</td> <td class="normal"> * </td></tr> <tr><td>111</td> <td class="normal"> * The REPLACE type of query does not make part of the SQL standards. Since </td></tr> <tr><td>112</td> <td class="normal"> * practically only MySQL implements it natively, this type of query is </td></tr> <tr><td>113</td> <td class="normal"> * emulated through this method for other DBMS using standard types of </td></tr> <tr><td>114</td> <td class="normal"> * queries inside a transaction to assure the atomicity of the operation. </td></tr> <tr><td>115</td> <td class="normal"> * </td></tr> <tr><td>116</td> <td class="normal"> * @access public </td></tr> <tr><td>117</td> <td class="normal"> * </td></tr> <tr><td>118</td> <td class="normal"> * @param string $table name of the table on which the REPLACE query will </td></tr> <tr><td>119</td> <td class="normal"> * be executed. </td></tr> <tr><td>120</td> <td class="normal"> * @param array $fields associative array that describes the fields and the </td></tr> <tr><td>121</td> <td class="normal"> * values that will be inserted or updated in the specified table. The </td></tr> <tr><td>122</td> <td class="normal"> * indexes of the array are the names of all the fields of the table. The </td></tr> <tr><td>123</td> <td class="normal"> * values of the array are also associative arrays that describe the </td></tr> <tr><td>124</td> <td class="normal"> * values and other properties of the table fields. </td></tr> <tr><td>125</td> <td class="normal"> * </td></tr> <tr><td>126</td> <td class="normal"> * Here follows a list of field properties that need to be specified: </td></tr> <tr><td>127</td> <td class="normal"> * </td></tr> <tr><td>128</td> <td class="normal"> * value: </td></tr> <tr><td>129</td> <td class="normal"> * Value to be assigned to the specified field. This value may be </td></tr> <tr><td>130</td> <td class="normal"> * of specified in database independent type format as this </td></tr> <tr><td>131</td> <td class="normal"> * function can perform the necessary datatype conversions. </td></tr> <tr><td>132</td> <td class="normal"> * </td></tr> <tr><td>133</td> <td class="normal"> * Default: </td></tr> <tr><td>134</td> <td class="normal"> * this property is required unless the Null property </td></tr> <tr><td>135</td> <td class="normal"> * is set to 1. </td></tr> <tr><td>136</td> <td class="normal"> * </td></tr> <tr><td>137</td> <td class="normal"> * type </td></tr> <tr><td>138</td> <td class="normal"> * Name of the type of the field. Currently, all types Metabase </td></tr> <tr><td>139</td> <td class="normal"> * are supported except for clob and blob. </td></tr> <tr><td>140</td> <td class="normal"> * </td></tr> <tr><td>141</td> <td class="normal"> * Default: no type conversion </td></tr> <tr><td>142</td> <td class="normal"> * </td></tr> <tr><td>143</td> <td class="normal"> * null </td></tr> <tr><td>144</td> <td class="normal"> * Boolean property that indicates that the value for this field </td></tr> <tr><td>145</td> <td class="normal"> * should be set to null. </td></tr> <tr><td>146</td> <td class="normal"> * </td></tr> <tr><td>147</td> <td class="normal"> * The default value for fields missing in INSERT queries may be </td></tr> <tr><td>148</td> <td class="normal"> * specified the definition of a table. Often, the default value </td></tr> <tr><td>149</td> <td class="normal"> * is already null, but since the REPLACE may be emulated using </td></tr> <tr><td>150</td> <td class="normal"> * an UPDATE query, make sure that all fields of the table are </td></tr> <tr><td>151</td> <td class="normal"> * listed in this function argument array. </td></tr> <tr><td>152</td> <td class="normal"> * </td></tr> <tr><td>153</td> <td class="normal"> * Default: 0 </td></tr> <tr><td>154</td> <td class="normal"> * </td></tr> <tr><td>155</td> <td class="normal"> * key </td></tr> <tr><td>156</td> <td class="normal"> * Boolean property that indicates that this field should be </td></tr> <tr><td>157</td> <td class="normal"> * handled as a primary key or at least as part of the compound </td></tr> <tr><td>158</td> <td class="normal"> * unique index of the table that will determine the row that will </td></tr> <tr><td>159</td> <td class="normal"> * updated if it exists or inserted a new row otherwise. </td></tr> <tr><td>160</td> <td class="normal"> * </td></tr> <tr><td>161</td> <td class="normal"> * This function will fail if no key field is specified or if the </td></tr> <tr><td>162</td> <td class="normal"> * value of a key field is set to null because fields that are </td></tr> <tr><td>163</td> <td class="normal"> * part of unique index they may not be null. </td></tr> <tr><td>164</td> <td class="normal"> * </td></tr> <tr><td>165</td> <td class="normal"> * Default: 0 </td></tr> <tr><td>166</td> <td class="normal"> * </td></tr> <tr><td>167</td> <td class="normal"> * @return integer the number of affected rows </td></tr> <tr><td>168</td> <td class="normal"> */ </td></tr> <tr><td>169</td> <td class="normal"> public function replace(Doctrine_Table $table, array $fields, array $keys) </td></tr> <tr><td>170</td> <td class="normal"> { </td></tr> <tr><td>171</td> <td class="red"> $count = count($fields); </td></tr> <tr><td>172</td> <td class="red"> $query = $values = ''; </td></tr> <tr><td>173</td> <td class="red"> $keys = $colnum = 0; </td></tr> <tr><td>174</td> <td class="normal"> </td></tr> <tr><td>175</td> <td class="red"> for (reset($fields); $colnum < $count; next($fields), $colnum++) { </td></tr> <tr><td>176</td> <td class="red"> $name = key($fields); </td></tr> <tr><td>177</td> <td class="normal"> </td></tr> <tr><td>178</td> <td class="red"> if ($colnum > 0) { </td></tr> <tr><td>179</td> <td class="red"> $query .= ','; </td></tr> <tr><td>180</td> <td class="red"> $values.= ','; </td></tr> <tr><td>181</td> <td class="red"> } </td></tr> <tr><td>182</td> <td class="normal"> </td></tr> <tr><td>183</td> <td class="red"> $query .= $table->getColumnName($name); </td></tr> <tr><td>184</td> <td class="normal"> </td></tr> <tr><td>185</td> <td class="red"> if (isset($fields[$name]['null']) && $fields[$name]['null']) { </td></tr> <tr><td>186</td> <td class="red"> $value = 'NULL'; </td></tr> <tr><td>187</td> <td class="red"> } else { </td></tr> <tr><td>188</td> <td class="red"> $type = isset($fields[$name]['type']) ? $fields[$name]['type'] : null; </td></tr> <tr><td>189</td> <td class="red"> $value = $this->quote($fields[$name]['value'], $type); </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="red"> $values .= $value; </td></tr> <tr><td>193</td> <td class="normal"> </td></tr> <tr><td>194</td> <td class="red"> if (isset($fields[$name]['key']) && $fields[$name]['key']) { </td></tr> <tr><td>195</td> <td class="red"> if ($value === 'NULL') { </td></tr> <tr><td>196</td> <td class="red"> throw new Doctrine_Connection_Mysql_Exception('key value '.$name.' may not be NULL'); </td></tr> <tr><td>197</td> <td class="orange"> } </td></tr> <tr><td>198</td> <td class="red"> $keys++; </td></tr> <tr><td>199</td> <td class="red"> } </td></tr> <tr><td>200</td> <td class="red"> } </td></tr> <tr><td>201</td> <td class="normal"> </td></tr> <tr><td>202</td> <td class="red"> if ($keys == 0) { </td></tr> <tr><td>203</td> <td class="red"> throw new Doctrine_Connection_Mysql_Exception('not specified which fields are keys'); </td></tr> <tr><td>204</td> <td class="orange"> } </td></tr> <tr><td>205</td> <td class="red"> $query = 'REPLACE INTO ' . $table->getTableName() . ' (' . $query . ') VALUES (' . $values . ')'; </td></tr> <tr><td>206</td> <td class="normal"> </td></tr> <tr><td>207</td> <td class="red"> return $this->exec($query); </td></tr> <tr><td>208</td> <td class="orange"> } </td></tr> <tr><td>209</td> <td class="normal">} </td></tr> </table></body></html>