215 lines
54 KiB
HTML
215 lines
54 KiB
HTML
|
|
||
|
|
<div id="content">
|
||
|
|
<h1 align="center">Source for file Mysql.php</h1>
|
||
|
|
<p>Documentation is available at <a href="../Doctrine/_Doctrine---Connection---Mysql.php.html">Mysql.php</a></p>
|
||
|
|
<div class="src-code"><span class="php">
|
||
|
|
<ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a2"></a><span class="src-comm">/*</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a3"></a><span class="src-comm"> * $Id: Mysql.php 1773 2007-06-19 23:33:04Z zYne $</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a4"></a><span class="src-comm"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a5"></a><span class="src-comm"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a6"></a><span class="src-comm"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a7"></a><span class="src-comm"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a8"></a><span class="src-comm"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a9"></a><span class="src-comm"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a10"></a><span class="src-comm"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a11"></a><span class="src-comm"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a12"></a><span class="src-comm"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a13"></a><span class="src-comm"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a14"></a><span class="src-comm"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a15"></a><span class="src-comm"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a16"></a><span class="src-comm"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a17"></a><span class="src-comm"> * This software consists of voluntary contributions made by many individuals</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a18"></a><span class="src-comm"> * and is licensed under the LGPL. For more information, see</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a19"></a><span class="src-comm"> * <http://www.phpdoctrine.com>.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a20"></a><span class="src-comm"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a21"></a><span class="src-id"><a href="../Doctrine/Doctrine.html">Doctrine</a></span><span class="src-sym">::</span><a href="../Doctrine/Doctrine.html#methodautoload">autoload</a><span class="src-sym">(</span><span class="src-str">'Doctrine_Connection_Common'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a22"></a><span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a23"></a><span class="src-doc"> * Doctrine_Connection_Mysql</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a25"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> Doctrine</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a26"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.opensource.org/licenses/lgpl-license.php LGPL</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a27"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Konsta Vesterinen <kvesteri@cc.hut.fi></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Revision: 1773 $</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a30"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@category</span><span class="src-doc"> Object Relational Mapping</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a31"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@link</span><span class="src-doc"> www.phpdoctrine.com</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@since</span><span class="src-doc"> 1.0</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a34"></a><span class="src-key">class </span><a href="../Doctrine/Doctrine_Connection_Mysql.html">Doctrine_Connection_Mysql</a> <span class="src-key">extends </span><a href="../Doctrine/Doctrine_Connection_Common.html">Doctrine_Connection_Common</a></div></li>
|
||
|
|
<li><div class="src-line"><a name="a35"></a><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a36"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string </span><span class="src-doc-var">$driverName </span><span class="src-doc"> the name of this connection driver</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a38"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a39"></a> <span class="src-key">protected </span><a href="../Doctrine/Doctrine_Connection_Mysql.html#var$driverName">$driverName</a> = <span class="src-str">'Mysql'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a40"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> * the constructor</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a42"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a43"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">Doctrine_Manager </span><span class="src-doc-var">$manager </span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a44"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">PDO</span><span class="src-doc">|</span><span class="src-doc-type">Doctrine_Adapter</span><span class="src-doc-var">$adapter </span><span class="src-doc"> database handler</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a45"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a46"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Connection_Mysql.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-id">Doctrine_Manager </span><span class="src-var">$manager</span><span class="src-sym">, </span><span class="src-var">$adapter</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a47"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a48"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodsetAttribute">setAttribute</a><span class="src-sym">(</span><span class="src-id">PDO</span><span class="src-sym">::</span><span class="src-id">ATTR_EMULATE_PREPARES</span><span class="src-sym">, </span><span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a49"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodsetAttribute">setAttribute</a><span class="src-sym">(</span><span class="src-id"><a href="../Doctrine/Doctrine.html">Doctrine</a></span><span class="src-sym">::</span><span class="src-id">ATTR_DEFAULT_TABLE_TYPE</span><span class="src-sym">, </span><span class="src-str">'INNODB'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a50"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a51"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$supported">supported</a> = <span class="src-key">array</span><span class="src-sym">(</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a52"></a> <span class="src-str">'sequences' </span>=> <span class="src-str">'emulated'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a53"></a> <span class="src-str">'indexes' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a54"></a> <span class="src-str">'affected_rows' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a55"></a> <span class="src-str">'transactions' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a56"></a> <span class="src-str">'savepoints' </span>=> <span class="src-id">false</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a57"></a> <span class="src-str">'summary_functions' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a58"></a> <span class="src-str">'order_by_text' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a59"></a> <span class="src-str">'current_id' </span>=> <span class="src-str">'emulated'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a60"></a> <span class="src-str">'limit_queries' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a61"></a> <span class="src-str">'LOBs' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a62"></a> <span class="src-str">'replace' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a63"></a> <span class="src-str">'sub_selects' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a64"></a> <span class="src-str">'auto_increment' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a65"></a> <span class="src-str">'primary_key' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a66"></a> <span class="src-str">'result_introspection' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a67"></a> <span class="src-str">'prepared_statements' </span>=> <span class="src-str">'emulated'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a68"></a> <span class="src-str">'identifier_quoting' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a69"></a> <span class="src-str">'pattern_escaping' </span>=> <span class="src-id">true</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a70"></a> <span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a71"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a72"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$properties">properties</a><span class="src-sym">[</span><span class="src-str">'string_quoting'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'start' </span>=> <span class="src-str">"'"</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a73"></a> <span class="src-str">'end' </span>=> <span class="src-str">"'"</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a74"></a> <span class="src-str">'escape' </span>=> <span class="src-str">'\\'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a75"></a> <span class="src-str">'escape_pattern' </span>=> <span class="src-str">'\\'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a76"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a77"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$properties">properties</a><span class="src-sym">[</span><span class="src-str">'identifier_quoting'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'start' </span>=> <span class="src-str">'`'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a78"></a> <span class="src-str">'end' </span>=> <span class="src-str">'`'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a79"></a> <span class="src-str">'escape' </span>=> <span class="src-str">'`'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a80"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a81"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$properties">properties</a><span class="src-sym">[</span><span class="src-str">'sql_comments'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a82"></a> <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'start' </span>=> <span class="src-str">'-- '</span><span class="src-sym">, </span><span class="src-str">'end' </span>=> <span class="src-str">"\n"</span><span class="src-sym">, </span><span class="src-str">'escape' </span>=> <span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a83"></a> <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'start' </span>=> <span class="src-str">'#'</span><span class="src-sym">, </span><span class="src-str">'end' </span>=> <span class="src-str">"\n"</span><span class="src-sym">, </span><span class="src-str">'escape' </span>=> <span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a84"></a> <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'start' </span>=> <span class="src-str">'/*'</span><span class="src-sym">, </span><span class="src-str">'end' </span>=> <span class="src-str">'*/'</span><span class="src-sym">, </span><span class="src-str">'escape' </span>=> <span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a85"></a> <span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a86"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a87"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$properties">properties</a><span class="src-sym">[</span><span class="src-str">'varchar_max_length'</span><span class="src-sym">] </span>= <span class="src-num">255</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a88"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a89"></a> <span class="src-id"><a href="../Doctrine/Doctrine_Configurable.html#var$parent">parent</a></span><span class="src-sym">::</span><span class="src-id">__construct</span><span class="src-sym">(</span><span class="src-var">$manager</span><span class="src-sym">, </span><span class="src-var">$adapter</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a90"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a91"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a92"></a><span class="src-doc"> * Set the charset on the current connection</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a93"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a94"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc"> charset</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a95"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a96"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">void </span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a97"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a98"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Connection_Mysql.html#methodsetCharset">setCharset</a><span class="src-sym">(</span><span class="src-var">$charset</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a99"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a100"></a> <span class="src-var">$query </span>= <span class="src-str">'SET NAMES '</span>.<span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#var$dbh">dbh</a><span class="src-sym">-></span><span class="src-id">quote</span><span class="src-sym">(</span><span class="src-var">$charset</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a101"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodexec">exec</a><span class="src-sym">(</span><span class="src-var">$query</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a102"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a103"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a104"></a><span class="src-doc"> * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a105"></a><span class="src-doc"> * query, except that if there is already a row in the table with the same</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a106"></a><span class="src-doc"> * key field values, the REPLACE query just updates its values instead of</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a107"></a><span class="src-doc"> * inserting a new row.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a108"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a109"></a><span class="src-doc"> * The REPLACE type of query does not make part of the SQL standards. Since</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a110"></a><span class="src-doc"> * practically only MySQL implements it natively, this type of query is</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a111"></a><span class="src-doc"> * emulated through this method for other DBMS using standard types of</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a112"></a><span class="src-doc"> * queries inside a transaction to assure the atomicity of the operation.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a113"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a114"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@access</span><span class="src-doc"> public</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a115"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a116"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$table </span><span class="src-doc">name of the table on which the REPLACE query will</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a117"></a><span class="src-doc"> * be executed.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a118"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">array </span><span class="src-doc-var">$fields </span><span class="src-doc">associative array that describes the fields and the</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a119"></a><span class="src-doc"> * values that will be inserted or updated in the specified table. The</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a120"></a><span class="src-doc"> * indexes of the array are the names of all the fields of the table. The</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a121"></a><span class="src-doc"> * values of the array are also associative arrays that describe the</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a122"></a><span class="src-doc"> * values and other properties of the table fields.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a123"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a124"></a><span class="src-doc"> * Here follows a list of field properties that need to be specified:</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a125"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a126"></a><span class="src-doc"> * value:</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a127"></a><span class="src-doc"> * Value to be assigned to the specified field. This value may be</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a128"></a><span class="src-doc"> * of specified in database independent type format as this</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a129"></a><span class="src-doc"> * function can perform the necessary datatype conversions.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a130"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a131"></a><span class="src-doc"> * Default:</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a132"></a><span class="src-doc"> * this property is required unless the Null property</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a133"></a><span class="src-doc"> * is set to 1.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a134"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a135"></a><span class="src-doc"> * type</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a136"></a><span class="src-doc"> * Name of the type of the field. Currently, all types Metabase</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a137"></a><span class="src-doc"> * are supported except for clob and blob.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a138"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a139"></a><span class="src-doc"> * Default: no type conversion</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a140"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a141"></a><span class="src-doc"> * null</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a142"></a><span class="src-doc"> * Boolean property that indicates that the value for this field</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a143"></a><span class="src-doc"> * should be set to null.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a144"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a145"></a><span class="src-doc"> * The default value for fields missing in INSERT queries may be</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a146"></a><span class="src-doc"> * specified the definition of a table. Often, the default value</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a147"></a><span class="src-doc"> * is already null, but since the REPLACE may be emulated using</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a148"></a><span class="src-doc"> * an UPDATE query, make sure that all fields of the table are</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a149"></a><span class="src-doc"> * listed in this function argument array.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a150"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a151"></a><span class="src-doc"> * Default: 0</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a152"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a153"></a><span class="src-doc"> * key</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a154"></a><span class="src-doc"> * Boolean property that indicates that this field should be</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a155"></a><span class="src-doc"> * handled as a primary key or at least as part of the compound</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a156"></a><span class="src-doc"> * unique index of the table that will determine the row that will</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a157"></a><span class="src-doc"> * updated if it exists or inserted a new row otherwise.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a158"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a159"></a><span class="src-doc"> * This function will fail if no key field is specified or if the</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a160"></a><span class="src-doc"> * value of a key field is set to null because fields that are</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a161"></a><span class="src-doc"> * part of unique index they may not be null.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a162"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a163"></a><span class="src-doc"> * Default: 0</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a164"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a165"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">integer </span><span class="src-doc"> the number of affected rows</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a166"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a167"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Connection_Mysql.html#methodreplace">replace</a><span class="src-sym">(</span><span class="src-var">$table</span><span class="src-sym">, </span><span class="src-key">array </span><span class="src-var">$fields</span><span class="src-sym">, </span><span class="src-key">array </span><span class="src-var">$keys</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a168"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a169"></a> <span class="src-var">$count </span>= <span class="src-id">count</span><span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a170"></a> <span class="src-var">$query </span>= <span class="src-var">$values </span>= <span class="src-str">''</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a171"></a> <span class="src-var">$keys </span>= <span class="src-var">$colnum </span>= <span class="src-num">0</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a172"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a173"></a> <span class="src-key">for </span><span class="src-sym">(</span><span class="src-id">reset</span><span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">)</span><span class="src-sym">; </span><span class="src-var">$colnum </span>< <span class="src-var">$count</span><span class="src-sym">; </span><span class="src-id">next</span><span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$colnum</span>++<span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a174"></a> <span class="src-var">$name </span>= <span class="src-id">key</span><span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a175"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a176"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$colnum </span>> <span class="src-num">0</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a177"></a> <span class="src-var">$query </span>.= <span class="src-str">','</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a178"></a> <span class="src-var">$values</span>.= <span class="src-str">','</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a179"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a180"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a181"></a> <span class="src-var">$query </span>.= <span class="src-var">$name</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a182"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a183"></a> <span class="src-key">if </span><span class="src-sym">(</span>isset<span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'null'</span><span class="src-sym">]</span><span class="src-sym">) </span>&& <span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'null'</span><span class="src-sym">]</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a184"></a> <span class="src-var">$value </span>= <span class="src-str">'NULL'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a185"></a> <span class="src-sym">} </span><span class="src-key">else </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a186"></a> <span class="src-var">$type </span>= isset<span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'type'</span><span class="src-sym">]</span><span class="src-sym">) </span>? <span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'type'</span><span class="src-sym">] </span>: <span class="src-id">null</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a187"></a> <span class="src-var">$value </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodquote">quote</a><span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'value'</span><span class="src-sym">]</span><span class="src-sym">, </span><span class="src-var">$type</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a188"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a189"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a190"></a> <span class="src-var">$values </span>.= <span class="src-var">$value</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a191"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a192"></a> <span class="src-key">if </span><span class="src-sym">(</span>isset<span class="src-sym">(</span><span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'key'</span><span class="src-sym">]</span><span class="src-sym">) </span>&& <span class="src-var">$fields</span><span class="src-sym">[</span><span class="src-var">$name</span><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'key'</span><span class="src-sym">]</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a193"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$value </span>=== <span class="src-str">'NULL'</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a194"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Connection_Mysql_Exception.html">Doctrine_Connection_Mysql_Exception</a></span><span class="src-sym">(</span><span class="src-str">'key value '</span>.<span class="src-var">$name</span>.<span class="src-str">' may not be NULL'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a195"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a196"></a> <span class="src-var">$keys</span>++<span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a197"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a198"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a199"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a200"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$keys </span>== <span class="src-num">0</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a201"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Connection_Mysql_Exception.html">Doctrine_Connection_Mysql_Exception</a></span><span class="src-sym">(</span><span class="src-str">'not specified which fields are keys'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a202"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a203"></a> <span class="src-var">$query </span>= <span class="src-str">'REPLACE INTO ' </span>. <span class="src-var">$table </span>. <span class="src-str">' (' </span>. <span class="src-var">$query </span>. <span class="src-str">') VALUES (' </span>. <span class="src-var">$values </span>. <span class="src-str">')'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a204"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a205"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodexec">exec</a><span class="src-sym">(</span><span class="src-var">$query</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a206"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a207"></a><span class="src-sym">}</span></div></li>
|
||
|
|
</ol>
|
||
|
|
</span></div>
|
||
|
|
</div>
|