Skip to content
Browse files

Added DB::fetchOne()

Added examples to README.md
  • Loading branch information...
1 parent fcaf68c commit 7169b8cacadec9ecee71cca9ddbb542b7364b712 @jasny committed Oct 20, 2012
Showing with 322 additions and 155 deletions.
  1. +18 −1 README.md
  2. +4 −0 composer.json
  3. +60 −8 docs/class-DB.html
  4. +169 −145 docs/source-class-DB.html
  5. +1 −1 phpunit.xml.dist
  6. +26 −0 src/DB.php
  7. +44 −0 tests/DBTest.php
View
19 README.md
@@ -8,4 +8,21 @@ A simple DB layer in PHP for using MySQL, featuring
* Quoting tables/fields and values
* Fetch all rows, column, key/value pair and single value
* Simple saving by passing associated arrays
-* Query exceptions (instead of returning false)
+* Query exceptions (instead of returning false)
+
+## Example ##
+
+ <?php
+ new DB($host, $user, $pwd, $dbname);
+ $result = DB::conn()->query("SELECT * FROM foo");
+ $result = DB::conn()->query("SELECT * FROM foo WHERE type = ?", $type);
+ $result = DB::conn()->query("SELECT * FROM foo WHERE type = ? AND cat IN ?", $type, array(1, 7));
+
+ $items = DB::conn()->fetchAll("SELECT id, name, description FROM foo WHERE type = ?", MYSQLI_FETCH_ASSOC, $type);
+ $item = DB::conn()->fetchOne("SELECT * FROM foo WHERE id = ?", MYSQLI_FETCH_ASSOC, $id);
+ $names = DB::conn()->fetchColumn("SELECT name FROM foo WHERE type = ?", $type);
+ $list = DB::conn()->fetchPairs("SELECT id, name FROM foo WHERE type = ?", $type);
+ $name = DB::conn()->fetchValue("SELECT name FROM foo WHERE id = ?", $id);
+
+ DB::conn()->save('foo', $values);
+ DB::conn()->save('foo', array($values1, $values2, $values3));
View
4 composer.json
@@ -18,6 +18,10 @@
"require": {
"php": ">=5.3.0"
},
+ "suggest" : {
+ "jasny/config": "Configure your DB and make it work out of the box",
+ "jasny/dbquery-mysql": "Supports building, parsing and modifying MySQL queries"
+ },
"autoload": {
"psr-0": {
"DB": "src/"
View
68 docs/class-DB.html
@@ -123,7 +123,7 @@
<br />
new DB($host, $user, $pwd, $dbname);<br />
$result = DB::conn()-&gt;query("SELECT * FROM foo WHERE id = ?", $id);<br />
- <b>Located at</b> <a href="source-class-DB.html#11-293" title="Go to source code">DB.php</a><br />
+ <b>Located at</b> <a href="source-class-DB.html#11-317" title="Go to source code">DB.php</a><br />
</div>
@@ -320,6 +320,58 @@
</div>
</div></td>
</tr>
+ <tr data-order="fetchOne" id="_fetchOne">
+
+ <td class="attributes"><code>
+ public
+ array
+
+ </code>
+ </td>
+
+ <td class="name"><div>
+ <a class="anchor" href="#_fetchOne">#</a>
+ <code><a href="source-class-DB.html#131-153" title="Go to source code">fetchOne</a>( <span>string|mysqli_result <var>$query</var></span>, <span>integer <var>$resulttype</var> = MYSQLI_ASSOC</span> )</code>
+
+ <div class="description short">
+
+<p>Query and fetch all result rows as an associative array, a numeric array, or
+both.</p>
+
+ </div>
+
+ <div class="description detailed hidden">
+
+<p>Query and fetch all result rows as an associative array, a numeric array, or
+both.</p>
+
+
+
+ <h4>Parameters</h4>
+ <div class="list"><dl>
+ <dt><var>$query</var></dt>
+ <dd><code>string|mysqli_result</code><br>$query SQL Query or DB result</dd>
+ <dt><var>$resulttype</var></dt>
+ <dd><code>integer</code><br>$resulttype MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH</dd>
+ </dl></div>
+
+ <h4>Returns</h4>
+ <div class="list">
+ <code>array</code><br />
+ </div>
+
+
+ <h4>Example</h4>
+ <div class="list">
+ DB::conn()-&gt;fetchOne("SELECT * FROM mytable");<br />
+ DB::conn()-&gt;fetchOne("SELECT * FROM mytable", MYSQLI_NUM);<br />
+ DB::conn()-&gt;fetchOne("SELECT * FROM mytable WHERE id=?", MYSQLI_ASSOC, $id);<br />
+ </div>
+
+
+ </div>
+ </div></td>
+ </tr>
<tr data-order="fetchColumn" id="_fetchColumn">
<td class="attributes"><code>
@@ -331,7 +383,7 @@
<td class="name"><div>
<a class="anchor" href="#_fetchColumn">#</a>
- <code><a href="source-class-DB.html#131-153" title="Go to source code">fetchColumn</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
+ <code><a href="source-class-DB.html#155-177" title="Go to source code">fetchColumn</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
<div class="description short">
@@ -378,7 +430,7 @@
<td class="name"><div>
<a class="anchor" href="#_fetchPairs">#</a>
- <code><a href="source-class-DB.html#155-176" title="Go to source code">fetchPairs</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
+ <code><a href="source-class-DB.html#179-200" title="Go to source code">fetchPairs</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
<div class="description short">
@@ -427,7 +479,7 @@
<td class="name"><div>
<a class="anchor" href="#_fetchValue">#</a>
- <code><a href="source-class-DB.html#178-196" title="Go to source code">fetchValue</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
+ <code><a href="source-class-DB.html#202-220" title="Go to source code">fetchValue</a>( <span>string|mysqli_result <var>$query</var></span> )</code>
<div class="description short">
@@ -474,7 +526,7 @@
<td class="name"><div>
<a class="anchor" href="#_save">#</a>
- <code><a href="source-class-DB.html#199-239" title="Go to source code">save</a>( <span>string <var>$table</var></span>, <span>array <var>$values</var> = <span class="php-keyword1">array</span>()</span>, <span>boolean <var>$update</var> = <span class="php-keyword1">true</span></span> )</code>
+ <code><a href="source-class-DB.html#223-263" title="Go to source code">save</a>( <span>string <var>$table</var></span>, <span>array <var>$values</var> = <span class="php-keyword1">array</span>()</span>, <span>boolean <var>$update</var> = <span class="php-keyword1">true</span></span> )</code>
<div class="description short">
@@ -528,7 +580,7 @@
<td class="name"><div>
<a class="anchor" href="#_quote">#</a>
- <code><a href="source-class-DB.html#242-257" title="Go to source code">quote</a>( <span>mixed <var>$value</var></span>, <span>string <var>$empty</var> = <span class="php-quote">'NULL'</span></span> )</code>
+ <code><a href="source-class-DB.html#266-281" title="Go to source code">quote</a>( <span>mixed <var>$value</var></span>, <span>string <var>$empty</var> = <span class="php-quote">'NULL'</span></span> )</code>
<div class="description short">
@@ -572,7 +624,7 @@
<td class="name"><div>
<a class="anchor" href="#_backquote">#</a>
- <code><a href="source-class-DB.html#259-268" title="Go to source code">backquote</a>( <span>string <var>$field</var></span> )</code>
+ <code><a href="source-class-DB.html#283-292" title="Go to source code">backquote</a>( <span>string <var>$field</var></span> )</code>
<div class="description short">
@@ -614,7 +666,7 @@
<td class="name"><div>
<a class="anchor" href="#_bind">#</a>
- <code><a href="source-class-DB.html#270-292" title="Go to source code">bind</a>( <span>string <var>$query</var></span>, <span>mixed <var>$params</var> = <span class="php-keyword1">array</span>()</span> )</code>
+ <code><a href="source-class-DB.html#294-316" title="Go to source code">bind</a>( <span>string <var>$query</var></span>, <span>mixed <var>$params</var> = <span class="php-keyword1">array</span>()</span> )</code>
<div class="description short">
View
314 docs/source-class-DB.html
@@ -211,169 +211,193 @@
</span><span id="129" class="l"><a class="l" href="#129">129: </a> }
</span><span id="130" class="l"><a class="l" href="#130">130: </a>
</span><span id="131" class="l"><a class="l" href="#131">131: </a> <span class="php-comment">/**
-</span></span><span id="132" class="l"><a class="l" href="#132">132: </a><span class="php-comment"> * Query and fetch a single column from all result rows.
+</span></span><span id="132" class="l"><a class="l" href="#132">132: </a><span class="php-comment"> * Query and fetch all result rows as an associative array, a numeric array, or both.
</span></span><span id="133" class="l"><a class="l" href="#133">133: </a><span class="php-comment"> *
-</span></span><span id="134" class="l"><a class="l" href="#134">134: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchColumn(&quot;SELECT name FROM mytable&quot;);
-</span></span><span id="135" class="l"><a class="l" href="#135">135: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchColumn(&quot;SELECT name FROM mytable WHERE group=?&quot;, $group);
-</span></span><span id="136" class="l"><a class="l" href="#136">136: </a><span class="php-comment"> *
-</span></span><span id="137" class="l"><a class="l" href="#137">137: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
-</span></span><span id="138" class="l"><a class="l" href="#138">138: </a><span class="php-comment"> * @param string $field The field position or name to fetch
-</span></span><span id="139" class="l"><a class="l" href="#139">139: </a><span class="php-comment"> * @return array
-</span></span><span id="140" class="l"><a class="l" href="#140">140: </a><span class="php-comment"> */</span>
-</span><span id="141" class="l"><a class="l" href="#141">141: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchColumn" href="#_fetchColumn">fetchColumn</a>(<span class="php-var">$query</span>)
-</span><span id="142" class="l"><a class="l" href="#142">142: </a> {
-</span><span id="143" class="l"><a class="l" href="#143">143: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">1</span>) <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">func_get_args</span>());
-</span><span id="144" class="l"><a class="l" href="#144">144: </a>
-</span><span id="145" class="l"><a class="l" href="#145">145: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
-</span><span id="146" class="l"><a class="l" href="#146">146: </a>
-</span><span id="147" class="l"><a class="l" href="#147">147: </a> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>();
-</span><span id="148" class="l"><a class="l" href="#148">148: </a> <span class="php-keyword1">while</span> (<span class="php-keyword1">list</span>(<span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row()) {
-</span><span id="149" class="l"><a class="l" href="#149">149: </a> <span class="php-var">$values</span>[] = <span class="php-var">$value</span>;
-</span><span id="150" class="l"><a class="l" href="#150">150: </a> }
+</span></span><span id="134" class="l"><a class="l" href="#134">134: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchOne(&quot;SELECT * FROM mytable&quot;);
+</span></span><span id="135" class="l"><a class="l" href="#135">135: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchOne(&quot;SELECT * FROM mytable&quot;, MYSQLI_NUM);
+</span></span><span id="136" class="l"><a class="l" href="#136">136: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchOne(&quot;SELECT * FROM mytable WHERE id=?&quot;, MYSQLI_ASSOC, $id);
+</span></span><span id="137" class="l"><a class="l" href="#137">137: </a><span class="php-comment"> *
+</span></span><span id="138" class="l"><a class="l" href="#138">138: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
+</span></span><span id="139" class="l"><a class="l" href="#139">139: </a><span class="php-comment"> * @param int $resulttype MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH
+</span></span><span id="140" class="l"><a class="l" href="#140">140: </a><span class="php-comment"> * @return array
+</span></span><span id="141" class="l"><a class="l" href="#141">141: </a><span class="php-comment"> */</span>
+</span><span id="142" class="l"><a class="l" href="#142">142: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchOne" href="#_fetchOne">fetchOne</a>(<span class="php-var">$query</span>, <span class="php-var">$resulttype</span> = MYSQLI_ASSOC)
+</span><span id="143" class="l"><a class="l" href="#143">143: </a> {
+</span><span id="144" class="l"><a class="l" href="#144">144: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">2</span>) {
+</span><span id="145" class="l"><a class="l" href="#145">145: </a> <span class="php-var">$args</span> = <span class="php-keyword2">func_get_args</span>();
+</span><span id="146" class="l"><a class="l" href="#146">146: </a> <span class="php-keyword1">unset</span>(<span class="php-var">$args</span>[<span class="php-num">1</span>]);
+</span><span id="147" class="l"><a class="l" href="#147">147: </a> <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">array_values</span>(<span class="php-var">$args</span>));
+</span><span id="148" class="l"><a class="l" href="#148">148: </a> }
+</span><span id="149" class="l"><a class="l" href="#149">149: </a>
+</span><span id="150" class="l"><a class="l" href="#150">150: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
</span><span id="151" class="l"><a class="l" href="#151">151: </a>
-</span><span id="152" class="l"><a class="l" href="#152">152: </a> <span class="php-keyword1">return</span> <span class="php-var">$values</span>;
+</span><span id="152" class="l"><a class="l" href="#152">152: </a> <span class="php-keyword1">return</span> <span class="php-var">$result</span>-&gt;fetch_array(<span class="php-var">$resulttype</span>);
</span><span id="153" class="l"><a class="l" href="#153">153: </a> }
</span><span id="154" class="l"><a class="l" href="#154">154: </a>
</span><span id="155" class="l"><a class="l" href="#155">155: </a> <span class="php-comment">/**
-</span></span><span id="156" class="l"><a class="l" href="#156">156: </a><span class="php-comment"> * Fetches all result rows and creates an associated array with the first column as key and the second as value.
+</span></span><span id="156" class="l"><a class="l" href="#156">156: </a><span class="php-comment"> * Query and fetch a single column from all result rows.
</span></span><span id="157" class="l"><a class="l" href="#157">157: </a><span class="php-comment"> *
-</span></span><span id="158" class="l"><a class="l" href="#158">158: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchPairs(&quot;SELECT id, name FROM mytable&quot;);
-</span></span><span id="159" class="l"><a class="l" href="#159">159: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchPairs(&quot;SELECT id, name FROM mytable WHERE group=?&quot;, $group);
+</span></span><span id="158" class="l"><a class="l" href="#158">158: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchColumn(&quot;SELECT name FROM mytable&quot;);
+</span></span><span id="159" class="l"><a class="l" href="#159">159: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchColumn(&quot;SELECT name FROM mytable WHERE group=?&quot;, $group);
</span></span><span id="160" class="l"><a class="l" href="#160">160: </a><span class="php-comment"> *
</span></span><span id="161" class="l"><a class="l" href="#161">161: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
-</span></span><span id="162" class="l"><a class="l" href="#162">162: </a><span class="php-comment"> * @return array
-</span></span><span id="163" class="l"><a class="l" href="#163">163: </a><span class="php-comment"> */</span>
-</span><span id="164" class="l"><a class="l" href="#164">164: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchPairs" href="#_fetchPairs">fetchPairs</a>(<span class="php-var">$query</span>)
-</span><span id="165" class="l"><a class="l" href="#165">165: </a> {
-</span><span id="166" class="l"><a class="l" href="#166">166: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">1</span>) <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">func_get_args</span>());
-</span><span id="167" class="l"><a class="l" href="#167">167: </a>
-</span><span id="168" class="l"><a class="l" href="#168">168: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
-</span><span id="169" class="l"><a class="l" href="#169">169: </a>
-</span><span id="170" class="l"><a class="l" href="#170">170: </a> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>();
-</span><span id="171" class="l"><a class="l" href="#171">171: </a> <span class="php-keyword1">while</span> (<span class="php-keyword1">list</span>(<span class="php-var">$key</span>, <span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row()) {
-</span><span id="172" class="l"><a class="l" href="#172">172: </a> <span class="php-var">$values</span>[<span class="php-var">$key</span>] = <span class="php-var">$value</span>;
-</span><span id="173" class="l"><a class="l" href="#173">173: </a> }
-</span><span id="174" class="l"><a class="l" href="#174">174: </a>
-</span><span id="175" class="l"><a class="l" href="#175">175: </a> <span class="php-keyword1">return</span> <span class="php-var">$values</span>;
-</span><span id="176" class="l"><a class="l" href="#176">176: </a> }
-</span><span id="177" class="l"><a class="l" href="#177">177: </a>
-</span><span id="178" class="l"><a class="l" href="#178">178: </a> <span class="php-comment">/**
-</span></span><span id="179" class="l"><a class="l" href="#179">179: </a><span class="php-comment"> * Query and fetch a single value.
-</span></span><span id="180" class="l"><a class="l" href="#180">180: </a><span class="php-comment"> *
-</span></span><span id="181" class="l"><a class="l" href="#181">181: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchValue(&quot;SELECT SUM(foo) FROM mytable&quot;);
-</span></span><span id="182" class="l"><a class="l" href="#182">182: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchValue(&quot;SELECT name FROM mytable WHERE id=?&quot;, $id);
-</span></span><span id="183" class="l"><a class="l" href="#183">183: </a><span class="php-comment"> *
-</span></span><span id="184" class="l"><a class="l" href="#184">184: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
-</span></span><span id="185" class="l"><a class="l" href="#185">185: </a><span class="php-comment"> * @param string $field The field position or name to fetch
+</span></span><span id="162" class="l"><a class="l" href="#162">162: </a><span class="php-comment"> * @param string $field The field position or name to fetch
+</span></span><span id="163" class="l"><a class="l" href="#163">163: </a><span class="php-comment"> * @return array
+</span></span><span id="164" class="l"><a class="l" href="#164">164: </a><span class="php-comment"> */</span>
+</span><span id="165" class="l"><a class="l" href="#165">165: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchColumn" href="#_fetchColumn">fetchColumn</a>(<span class="php-var">$query</span>)
+</span><span id="166" class="l"><a class="l" href="#166">166: </a> {
+</span><span id="167" class="l"><a class="l" href="#167">167: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">1</span>) <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">func_get_args</span>());
+</span><span id="168" class="l"><a class="l" href="#168">168: </a>
+</span><span id="169" class="l"><a class="l" href="#169">169: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
+</span><span id="170" class="l"><a class="l" href="#170">170: </a>
+</span><span id="171" class="l"><a class="l" href="#171">171: </a> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>();
+</span><span id="172" class="l"><a class="l" href="#172">172: </a> <span class="php-keyword1">while</span> (<span class="php-keyword1">list</span>(<span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row()) {
+</span><span id="173" class="l"><a class="l" href="#173">173: </a> <span class="php-var">$values</span>[] = <span class="php-var">$value</span>;
+</span><span id="174" class="l"><a class="l" href="#174">174: </a> }
+</span><span id="175" class="l"><a class="l" href="#175">175: </a>
+</span><span id="176" class="l"><a class="l" href="#176">176: </a> <span class="php-keyword1">return</span> <span class="php-var">$values</span>;
+</span><span id="177" class="l"><a class="l" href="#177">177: </a> }
+</span><span id="178" class="l"><a class="l" href="#178">178: </a>
+</span><span id="179" class="l"><a class="l" href="#179">179: </a> <span class="php-comment">/**
+</span></span><span id="180" class="l"><a class="l" href="#180">180: </a><span class="php-comment"> * Fetches all result rows and creates an associated array with the first column as key and the second as value.
+</span></span><span id="181" class="l"><a class="l" href="#181">181: </a><span class="php-comment"> *
+</span></span><span id="182" class="l"><a class="l" href="#182">182: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchPairs(&quot;SELECT id, name FROM mytable&quot;);
+</span></span><span id="183" class="l"><a class="l" href="#183">183: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchPairs(&quot;SELECT id, name FROM mytable WHERE group=?&quot;, $group);
+</span></span><span id="184" class="l"><a class="l" href="#184">184: </a><span class="php-comment"> *
+</span></span><span id="185" class="l"><a class="l" href="#185">185: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
</span></span><span id="186" class="l"><a class="l" href="#186">186: </a><span class="php-comment"> * @return array
</span></span><span id="187" class="l"><a class="l" href="#187">187: </a><span class="php-comment"> */</span>
-</span><span id="188" class="l"><a class="l" href="#188">188: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchValue" href="#_fetchValue">fetchValue</a>(<span class="php-var">$query</span>)
+</span><span id="188" class="l"><a class="l" href="#188">188: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchPairs" href="#_fetchPairs">fetchPairs</a>(<span class="php-var">$query</span>)
</span><span id="189" class="l"><a class="l" href="#189">189: </a> {
</span><span id="190" class="l"><a class="l" href="#190">190: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">1</span>) <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">func_get_args</span>());
</span><span id="191" class="l"><a class="l" href="#191">191: </a>
</span><span id="192" class="l"><a class="l" href="#192">192: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
-</span><span id="193" class="l"><a class="l" href="#193">193: </a> <span class="php-keyword1">list</span>(<span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row();
-</span><span id="194" class="l"><a class="l" href="#194">194: </a>
-</span><span id="195" class="l"><a class="l" href="#195">195: </a> <span class="php-keyword1">return</span> <span class="php-var">$value</span>;
-</span><span id="196" class="l"><a class="l" href="#196">196: </a> }
-</span><span id="197" class="l"><a class="l" href="#197">197: </a>
-</span><span id="198" class="l"><a class="l" href="#198">198: </a>
-</span><span id="199" class="l"><a class="l" href="#199">199: </a> <span class="php-comment">/**
-</span></span><span id="200" class="l"><a class="l" href="#200">200: </a><span class="php-comment"> * Insert or update a record.
-</span></span><span id="201" class="l"><a class="l" href="#201">201: </a><span class="php-comment"> * All rows should have the same keys in the same order.
-</span></span><span id="202" class="l"><a class="l" href="#202">202: </a><span class="php-comment"> *
-</span></span><span id="203" class="l"><a class="l" href="#203">203: </a><span class="php-comment"> * @example $db-&gt;save('mytable', $row)
-</span></span><span id="204" class="l"><a class="l" href="#204">204: </a><span class="php-comment"> * @example $db-&gt;save('mytable', array($row1, $row2, $row3))
-</span></span><span id="205" class="l"><a class="l" href="#205">205: </a><span class="php-comment"> * @example $db-&gt;save('mytable', array($row1, $row2, $row3), DB::SKIP_EXISTING)
-</span></span><span id="206" class="l"><a class="l" href="#206">206: </a><span class="php-comment"> *
-</span></span><span id="207" class="l"><a class="l" href="#207">207: </a><span class="php-comment"> * @param string $table
-</span></span><span id="208" class="l"><a class="l" href="#208">208: </a><span class="php-comment"> * @param array $values One or multiple rows of values
-</span></span><span id="209" class="l"><a class="l" href="#209">209: </a><span class="php-comment"> * @param boolean $update Update on duplicate key
-</span></span><span id="210" class="l"><a class="l" href="#210">210: </a><span class="php-comment"> * @return int Last insert ID
+</span><span id="193" class="l"><a class="l" href="#193">193: </a>
+</span><span id="194" class="l"><a class="l" href="#194">194: </a> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>();
+</span><span id="195" class="l"><a class="l" href="#195">195: </a> <span class="php-keyword1">while</span> (<span class="php-keyword1">list</span>(<span class="php-var">$key</span>, <span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row()) {
+</span><span id="196" class="l"><a class="l" href="#196">196: </a> <span class="php-var">$values</span>[<span class="php-var">$key</span>] = <span class="php-var">$value</span>;
+</span><span id="197" class="l"><a class="l" href="#197">197: </a> }
+</span><span id="198" class="l"><a class="l" href="#198">198: </a>
+</span><span id="199" class="l"><a class="l" href="#199">199: </a> <span class="php-keyword1">return</span> <span class="php-var">$values</span>;
+</span><span id="200" class="l"><a class="l" href="#200">200: </a> }
+</span><span id="201" class="l"><a class="l" href="#201">201: </a>
+</span><span id="202" class="l"><a class="l" href="#202">202: </a> <span class="php-comment">/**
+</span></span><span id="203" class="l"><a class="l" href="#203">203: </a><span class="php-comment"> * Query and fetch a single value.
+</span></span><span id="204" class="l"><a class="l" href="#204">204: </a><span class="php-comment"> *
+</span></span><span id="205" class="l"><a class="l" href="#205">205: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchValue(&quot;SELECT SUM(foo) FROM mytable&quot;);
+</span></span><span id="206" class="l"><a class="l" href="#206">206: </a><span class="php-comment"> * @example DB::conn()-&gt;fetchValue(&quot;SELECT name FROM mytable WHERE id=?&quot;, $id);
+</span></span><span id="207" class="l"><a class="l" href="#207">207: </a><span class="php-comment"> *
+</span></span><span id="208" class="l"><a class="l" href="#208">208: </a><span class="php-comment"> * @param string|mysqli_result $query SQL Query or DB result
+</span></span><span id="209" class="l"><a class="l" href="#209">209: </a><span class="php-comment"> * @param string $field The field position or name to fetch
+</span></span><span id="210" class="l"><a class="l" href="#210">210: </a><span class="php-comment"> * @return array
</span></span><span id="211" class="l"><a class="l" href="#211">211: </a><span class="php-comment"> */</span>
-</span><span id="212" class="l"><a class="l" href="#212">212: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_save" href="#_save">save</a>(<span class="php-var">$table</span>, <span class="php-keyword1">array</span> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>(), <span class="php-var">$update</span> = <span class="php-keyword1">true</span>)
+</span><span id="212" class="l"><a class="l" href="#212">212: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_fetchValue" href="#_fetchValue">fetchValue</a>(<span class="php-var">$query</span>)
</span><span id="213" class="l"><a class="l" href="#213">213: </a> {
-</span><span id="214" class="l"><a class="l" href="#214">214: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-keyword2">reset</span>(<span class="php-var">$values</span>))) <span class="php-var">$values</span> = <span class="php-keyword1">array</span>(<span class="php-var">$values</span>); <span class="php-comment">// Make sure that $values is a set of rows</span>
+</span><span id="214" class="l"><a class="l" href="#214">214: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">func_num_args</span>() &gt; <span class="php-num">1</span>) <span class="php-var">$query</span> = <span class="php-keyword2">call_user_func_array</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'bind'</span>), <span class="php-keyword2">func_get_args</span>());
</span><span id="215" class="l"><a class="l" href="#215">215: </a>
-</span><span id="216" class="l"><a class="l" href="#216">216: </a> <span class="php-var">$fields</span> = <span class="php-keyword1">array</span>();
-</span><span id="217" class="l"><a class="l" href="#217">217: </a> <span class="php-var">$query_values</span> = <span class="php-keyword1">array</span>();
-</span><span id="218" class="l"><a class="l" href="#218">218: </a> <span class="php-var">$query_update</span> = <span class="php-keyword1">array</span>();
-</span><span id="219" class="l"><a class="l" href="#219">219: </a>
-</span><span id="220" class="l"><a class="l" href="#220">220: </a> <span class="php-keyword1">foreach</span> (<span class="php-keyword2">array_keys</span>(<span class="php-keyword2">reset</span>(<span class="php-var">$values</span>)) <span class="php-keyword1">as</span> <span class="php-var">$key</span>) {
-</span><span id="221" class="l"><a class="l" href="#221">221: </a> <span class="php-var">$field</span> = self::backquote(<span class="php-var">$key</span>);
-</span><span id="222" class="l"><a class="l" href="#222">222: </a> <span class="php-var">$fields</span>[<span class="php-var">$key</span>] = <span class="php-var">$field</span>;
-</span><span id="223" class="l"><a class="l" href="#223">223: </a> <span class="php-var">$query_update</span>[<span class="php-var">$key</span>] = <span class="php-quote">&quot;</span><span class="php-var">$field</span><span class="php-quote">=VALUES(</span><span class="php-var">$field</span><span class="php-quote">)&quot;</span>;
-</span><span id="224" class="l"><a class="l" href="#224">224: </a> }
-</span><span id="225" class="l"><a class="l" href="#225">225: </a>
-</span><span id="226" class="l"><a class="l" href="#226">226: </a> <span class="php-keyword1">foreach</span> (<span class="php-var">$values</span> <span class="php-keyword1">as</span> &amp;<span class="php-var">$row</span>) {
-</span><span id="227" class="l"><a class="l" href="#227">227: </a> <span class="php-var">$vals</span> = <span class="php-keyword1">array</span>();
-</span><span id="228" class="l"><a class="l" href="#228">228: </a> <span class="php-keyword1">foreach</span> (<span class="php-keyword2">array_keys</span>(<span class="php-var">$fields</span>) <span class="php-keyword1">as</span> <span class="php-var">$key</span>) {
-</span><span id="229" class="l"><a class="l" href="#229">229: </a> <span class="php-var">$vals</span>[<span class="php-var">$key</span>] = self::quote(<span class="php-var">$row</span>[<span class="php-var">$key</span>], <span class="php-quote">'DEFAULT'</span>);
-</span><span id="230" class="l"><a class="l" href="#230">230: </a> }
-</span><span id="231" class="l"><a class="l" href="#231">231: </a> <span class="php-var">$query_values</span>[] = <span class="php-quote">'('</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$vals</span>) . <span class="php-quote">')'</span>;
-</span><span id="232" class="l"><a class="l" href="#232">232: </a> }
-</span><span id="233" class="l"><a class="l" href="#233">233: </a>
-</span><span id="234" class="l"><a class="l" href="#234">234: </a> <span class="php-var">$query</span> = <span class="php-quote">&quot;INSERT&quot;</span> . (<span class="php-var">$update</span> ? <span class="php-quote">''</span> : <span class="php-quote">&quot; IGNORE&quot;</span>) . <span class="php-quote">&quot; INTO `&quot;</span> . <span class="php-keyword2">str_replace</span>(<span class="php-quote">'`'</span>, <span class="php-quote">''</span>, <span class="php-var">$table</span>) . <span class="php-quote">&quot;` (&quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$fields</span>) . <span class="php-quote">&quot;) VALUES &quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$query_values</span>) .
-</span><span id="235" class="l"><a class="l" href="#235">235: </a> (<span class="php-var">$update</span> ? <span class="php-quote">&quot; ON DUPLICATE KEY UPDATE &quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$query_update</span>) : <span class="php-quote">''</span>);
-</span><span id="236" class="l"><a class="l" href="#236">236: </a>
-</span><span id="237" class="l"><a class="l" href="#237">237: </a> <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
-</span><span id="238" class="l"><a class="l" href="#238">238: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;insert_id;
-</span><span id="239" class="l"><a class="l" href="#239">239: </a> }
-</span><span id="240" class="l"><a class="l" href="#240">240: </a>
-</span><span id="241" class="l"><a class="l" href="#241">241: </a>
-</span><span id="242" class="l"><a class="l" href="#242">242: </a> <span class="php-comment">/**
-</span></span><span id="243" class="l"><a class="l" href="#243">243: </a><span class="php-comment"> * Quote a value so it can be savely used in a query.
-</span></span><span id="244" class="l"><a class="l" href="#244">244: </a><span class="php-comment"> *
-</span></span><span id="245" class="l"><a class="l" href="#245">245: </a><span class="php-comment"> * @param mixed $value
-</span></span><span id="246" class="l"><a class="l" href="#246">246: </a><span class="php-comment"> * @param string $empty Return $empty if $value is null
-</span></span><span id="247" class="l"><a class="l" href="#247">247: </a><span class="php-comment"> * @return string
-</span></span><span id="248" class="l"><a class="l" href="#248">248: </a><span class="php-comment"> */</span>
-</span><span id="249" class="l"><a class="l" href="#249">249: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_quote" href="#_quote">quote</a>(<span class="php-var">$value</span>, <span class="php-var">$empty</span> = <span class="php-quote">'NULL'</span>)
-</span><span id="250" class="l"><a class="l" href="#250">250: </a> {
-</span><span id="251" class="l"><a class="l" href="#251">251: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_array</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-quote">'('</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-keyword2">array_map</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'quote'</span>), <span class="php-var">$value</span>)) . <span class="php-quote">')'</span>;
-</span><span id="252" class="l"><a class="l" href="#252">252: </a>
-</span><span id="253" class="l"><a class="l" href="#253">253: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_null</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-var">$empty</span>;
-</span><span id="254" class="l"><a class="l" href="#254">254: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_bool</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-var">$value</span> ? <span class="php-quote">'TRUE'</span> : <span class="php-quote">'FALSE'</span>;
-</span><span id="255" class="l"><a class="l" href="#255">255: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_int</span>(<span class="php-var">$value</span>) || <span class="php-keyword2">is_float</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> (string)<span class="php-var">$value</span>;
-</span><span id="256" class="l"><a class="l" href="#256">256: </a> <span class="php-keyword1">return</span> <span class="php-quote">'&quot;'</span> . <span class="php-keyword2">strtr</span>((string)<span class="php-var">$value</span>, <span class="php-keyword1">array</span>(<span class="php-quote">'\\'</span> =&gt; <span class="php-quote">'\\\\'</span>, <span class="php-quote">&quot;\0&quot;</span> =&gt; <span class="php-quote">'\\0'</span>, <span class="php-quote">&quot;\r&quot;</span> =&gt; <span class="php-quote">'\\r'</span>, <span class="php-quote">&quot;\n&quot;</span> =&gt; <span class="php-quote">'\\n'</span>, <span class="php-quote">'&quot;'</span> =&gt; <span class="php-quote">'\\&quot;'</span>)) . <span class="php-quote">'&quot;'</span>;
-</span><span id="257" class="l"><a class="l" href="#257">257: </a> }
-</span><span id="258" class="l"><a class="l" href="#258">258: </a>
-</span><span id="259" class="l"><a class="l" href="#259">259: </a> <span class="php-comment">/**
-</span></span><span id="260" class="l"><a class="l" href="#260">260: </a><span class="php-comment"> * Quote a field, table or dbname so it can be savely used in a query.
-</span></span><span id="261" class="l"><a class="l" href="#261">261: </a><span class="php-comment"> *
-</span></span><span id="262" class="l"><a class="l" href="#262">262: </a><span class="php-comment"> * @param string $field
-</span></span><span id="263" class="l"><a class="l" href="#263">263: </a><span class="php-comment"> * @return string
-</span></span><span id="264" class="l"><a class="l" href="#264">264: </a><span class="php-comment"> */</span>
-</span><span id="265" class="l"><a class="l" href="#265">265: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_backquote" href="#_backquote">backquote</a>(<span class="php-var">$field</span>)
-</span><span id="266" class="l"><a class="l" href="#266">266: </a> {
-</span><span id="267" class="l"><a class="l" href="#267">267: </a> <span class="php-keyword1">return</span> <span class="php-quote">'`'</span> . <span class="php-keyword2">str_replace</span>(<span class="php-quote">'`'</span>, <span class="php-quote">''</span>, <span class="php-var">$field</span>) . <span class="php-quote">'`'</span>;
-</span><span id="268" class="l"><a class="l" href="#268">268: </a> }
-</span><span id="269" class="l"><a class="l" href="#269">269: </a>
-</span><span id="270" class="l"><a class="l" href="#270">270: </a> <span class="php-comment">/**
-</span></span><span id="271" class="l"><a class="l" href="#271">271: </a><span class="php-comment"> * Insert parameters into SQL query.
-</span></span><span id="272" class="l"><a class="l" href="#272">272: </a><span class="php-comment"> * Don't mix both types ('?' and ':key') of placeholders.
-</span></span><span id="273" class="l"><a class="l" href="#273">273: </a><span class="php-comment"> *
-</span></span><span id="274" class="l"><a class="l" href="#274">274: </a><span class="php-comment"> * @example DB::bind(&quot;SELECT * FROM mytable WHERE id=?&quot;, $id);
-</span></span><span id="275" class="l"><a class="l" href="#275">275: </a><span class="php-comment"> * @example DB::bind(&quot;SELECT * FROM mytable WHERE name=:name AND age&gt;:age AND status='A'&quot;, array('id'=&gt;$id, 'age'=&gt;$age));
-</span></span><span id="276" class="l"><a class="l" href="#276">276: </a><span class="php-comment"> *
-</span></span><span id="277" class="l"><a class="l" href="#277">277: </a><span class="php-comment"> * @param string $query
-</span></span><span id="278" class="l"><a class="l" href="#278">278: </a><span class="php-comment"> * @param mixed $params Parameters can be passed as indifidual arguments or as array
-</span></span><span id="279" class="l"><a class="l" href="#279">279: </a><span class="php-comment"> * @return string
-</span></span><span id="280" class="l"><a class="l" href="#280">280: </a><span class="php-comment"> */</span>
-</span><span id="281" class="l"><a class="l" href="#281">281: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_bind" href="#_bind">bind</a>(<span class="php-var">$query</span>, <span class="php-var">$params</span> = <span class="php-keyword1">array</span>())
-</span><span id="282" class="l"><a class="l" href="#282">282: </a> {
-</span><span id="283" class="l"><a class="l" href="#283">283: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-var">$params</span>) || <span class="php-keyword2">is_int</span>(<span class="php-keyword2">key</span>(<span class="php-var">$params</span>))) <span class="php-var">$params</span> = <span class="php-keyword2">array_splice</span>(<span class="php-keyword2">func_get_args</span>(), <span class="php-num">1</span>);
-</span><span id="284" class="l"><a class="l" href="#284">284: </a>
-</span><span id="285" class="l"><a class="l" href="#285">285: </a> <span class="php-var">$fn</span> = <span class="php-keyword1">function</span> (<span class="php-var">$match</span>) <span class="php-keyword1">use</span> (&amp;<span class="php-var">$params</span>) {
-</span><span id="286" class="l"><a class="l" href="#286">286: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword1">empty</span>(<span class="php-var">$match</span>[<span class="php-num">1</span>]) &amp;&amp; !<span class="php-keyword1">empty</span>(<span class="php-var">$params</span>)) <span class="php-keyword1">return</span> DB::quote(<span class="php-keyword2">array_shift</span>(<span class="php-var">$params</span>));
-</span><span id="287" class="l"><a class="l" href="#287">287: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword1">empty</span>(<span class="php-var">$match</span>[<span class="php-num">2</span>]) &amp;&amp; <span class="php-keyword2">array_key_exists</span>(<span class="php-var">$match</span>[<span class="php-num">2</span>], <span class="php-var">$params</span>)) <span class="php-keyword1">return</span> DB::quote(<span class="php-var">$params</span>[<span class="php-var">$match</span>[<span class="php-num">2</span>]]);
-</span><span id="288" class="l"><a class="l" href="#288">288: </a> <span class="php-keyword1">return</span> <span class="php-var">$match</span>[<span class="php-num">0</span>];
-</span><span id="289" class="l"><a class="l" href="#289">289: </a> };
-</span><span id="290" class="l"><a class="l" href="#290">290: </a>
-</span><span id="291" class="l"><a class="l" href="#291">291: </a> <span class="php-keyword1">return</span> <span class="php-keyword2">preg_replace_callback</span>(<span class="php-quote">'/`[^`]*+`|&quot;(?:[^&quot;\\\\]++|\\\\.)*+&quot;|\'(?:[^\'\\\\]++|\\\\.)*+\'|(\?)|:(\w++)/'</span>, <span class="php-var">$fn</span>, <span class="php-var">$query</span>);
+</span><span id="216" class="l"><a class="l" href="#216">216: </a> <span class="php-var">$result</span> = <span class="php-var">$query</span> <span class="php-keyword1">instanceof</span> mysqli_result ? <span class="php-var">$query</span> : <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
+</span><span id="217" class="l"><a class="l" href="#217">217: </a> <span class="php-keyword1">list</span>(<span class="php-var">$value</span>) = <span class="php-var">$result</span>-&gt;fetch_row();
+</span><span id="218" class="l"><a class="l" href="#218">218: </a>
+</span><span id="219" class="l"><a class="l" href="#219">219: </a> <span class="php-keyword1">return</span> <span class="php-var">$value</span>;
+</span><span id="220" class="l"><a class="l" href="#220">220: </a> }
+</span><span id="221" class="l"><a class="l" href="#221">221: </a>
+</span><span id="222" class="l"><a class="l" href="#222">222: </a>
+</span><span id="223" class="l"><a class="l" href="#223">223: </a> <span class="php-comment">/**
+</span></span><span id="224" class="l"><a class="l" href="#224">224: </a><span class="php-comment"> * Insert or update a record.
+</span></span><span id="225" class="l"><a class="l" href="#225">225: </a><span class="php-comment"> * All rows should have the same keys in the same order.
+</span></span><span id="226" class="l"><a class="l" href="#226">226: </a><span class="php-comment"> *
+</span></span><span id="227" class="l"><a class="l" href="#227">227: </a><span class="php-comment"> * @example $db-&gt;save('mytable', $row)
+</span></span><span id="228" class="l"><a class="l" href="#228">228: </a><span class="php-comment"> * @example $db-&gt;save('mytable', array($row1, $row2, $row3))
+</span></span><span id="229" class="l"><a class="l" href="#229">229: </a><span class="php-comment"> * @example $db-&gt;save('mytable', array($row1, $row2, $row3), DB::SKIP_EXISTING)
+</span></span><span id="230" class="l"><a class="l" href="#230">230: </a><span class="php-comment"> *
+</span></span><span id="231" class="l"><a class="l" href="#231">231: </a><span class="php-comment"> * @param string $table
+</span></span><span id="232" class="l"><a class="l" href="#232">232: </a><span class="php-comment"> * @param array $values One or multiple rows of values
+</span></span><span id="233" class="l"><a class="l" href="#233">233: </a><span class="php-comment"> * @param boolean $update Update on duplicate key
+</span></span><span id="234" class="l"><a class="l" href="#234">234: </a><span class="php-comment"> * @return int Last insert ID
+</span></span><span id="235" class="l"><a class="l" href="#235">235: </a><span class="php-comment"> */</span>
+</span><span id="236" class="l"><a class="l" href="#236">236: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_save" href="#_save">save</a>(<span class="php-var">$table</span>, <span class="php-keyword1">array</span> <span class="php-var">$values</span> = <span class="php-keyword1">array</span>(), <span class="php-var">$update</span> = <span class="php-keyword1">true</span>)
+</span><span id="237" class="l"><a class="l" href="#237">237: </a> {
+</span><span id="238" class="l"><a class="l" href="#238">238: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-keyword2">reset</span>(<span class="php-var">$values</span>))) <span class="php-var">$values</span> = <span class="php-keyword1">array</span>(<span class="php-var">$values</span>); <span class="php-comment">// Make sure that $values is a set of rows</span>
+</span><span id="239" class="l"><a class="l" href="#239">239: </a>
+</span><span id="240" class="l"><a class="l" href="#240">240: </a> <span class="php-var">$fields</span> = <span class="php-keyword1">array</span>();
+</span><span id="241" class="l"><a class="l" href="#241">241: </a> <span class="php-var">$query_values</span> = <span class="php-keyword1">array</span>();
+</span><span id="242" class="l"><a class="l" href="#242">242: </a> <span class="php-var">$query_update</span> = <span class="php-keyword1">array</span>();
+</span><span id="243" class="l"><a class="l" href="#243">243: </a>
+</span><span id="244" class="l"><a class="l" href="#244">244: </a> <span class="php-keyword1">foreach</span> (<span class="php-keyword2">array_keys</span>(<span class="php-keyword2">reset</span>(<span class="php-var">$values</span>)) <span class="php-keyword1">as</span> <span class="php-var">$key</span>) {
+</span><span id="245" class="l"><a class="l" href="#245">245: </a> <span class="php-var">$field</span> = self::backquote(<span class="php-var">$key</span>);
+</span><span id="246" class="l"><a class="l" href="#246">246: </a> <span class="php-var">$fields</span>[<span class="php-var">$key</span>] = <span class="php-var">$field</span>;
+</span><span id="247" class="l"><a class="l" href="#247">247: </a> <span class="php-var">$query_update</span>[<span class="php-var">$key</span>] = <span class="php-quote">&quot;</span><span class="php-var">$field</span><span class="php-quote">=VALUES(</span><span class="php-var">$field</span><span class="php-quote">)&quot;</span>;
+</span><span id="248" class="l"><a class="l" href="#248">248: </a> }
+</span><span id="249" class="l"><a class="l" href="#249">249: </a>
+</span><span id="250" class="l"><a class="l" href="#250">250: </a> <span class="php-keyword1">foreach</span> (<span class="php-var">$values</span> <span class="php-keyword1">as</span> &amp;<span class="php-var">$row</span>) {
+</span><span id="251" class="l"><a class="l" href="#251">251: </a> <span class="php-var">$vals</span> = <span class="php-keyword1">array</span>();
+</span><span id="252" class="l"><a class="l" href="#252">252: </a> <span class="php-keyword1">foreach</span> (<span class="php-keyword2">array_keys</span>(<span class="php-var">$fields</span>) <span class="php-keyword1">as</span> <span class="php-var">$key</span>) {
+</span><span id="253" class="l"><a class="l" href="#253">253: </a> <span class="php-var">$vals</span>[<span class="php-var">$key</span>] = self::quote(<span class="php-var">$row</span>[<span class="php-var">$key</span>], <span class="php-quote">'DEFAULT'</span>);
+</span><span id="254" class="l"><a class="l" href="#254">254: </a> }
+</span><span id="255" class="l"><a class="l" href="#255">255: </a> <span class="php-var">$query_values</span>[] = <span class="php-quote">'('</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$vals</span>) . <span class="php-quote">')'</span>;
+</span><span id="256" class="l"><a class="l" href="#256">256: </a> }
+</span><span id="257" class="l"><a class="l" href="#257">257: </a>
+</span><span id="258" class="l"><a class="l" href="#258">258: </a> <span class="php-var">$query</span> = <span class="php-quote">&quot;INSERT&quot;</span> . (<span class="php-var">$update</span> ? <span class="php-quote">''</span> : <span class="php-quote">&quot; IGNORE&quot;</span>) . <span class="php-quote">&quot; INTO `&quot;</span> . <span class="php-keyword2">str_replace</span>(<span class="php-quote">'`'</span>, <span class="php-quote">''</span>, <span class="php-var">$table</span>) . <span class="php-quote">&quot;` (&quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$fields</span>) . <span class="php-quote">&quot;) VALUES &quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$query_values</span>) .
+</span><span id="259" class="l"><a class="l" href="#259">259: </a> (<span class="php-var">$update</span> ? <span class="php-quote">&quot; ON DUPLICATE KEY UPDATE &quot;</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-var">$query_update</span>) : <span class="php-quote">''</span>);
+</span><span id="260" class="l"><a class="l" href="#260">260: </a>
+</span><span id="261" class="l"><a class="l" href="#261">261: </a> <span class="php-var">$this</span>-&gt;query(<span class="php-var">$query</span>);
+</span><span id="262" class="l"><a class="l" href="#262">262: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;insert_id;
+</span><span id="263" class="l"><a class="l" href="#263">263: </a> }
+</span><span id="264" class="l"><a class="l" href="#264">264: </a>
+</span><span id="265" class="l"><a class="l" href="#265">265: </a>
+</span><span id="266" class="l"><a class="l" href="#266">266: </a> <span class="php-comment">/**
+</span></span><span id="267" class="l"><a class="l" href="#267">267: </a><span class="php-comment"> * Quote a value so it can be savely used in a query.
+</span></span><span id="268" class="l"><a class="l" href="#268">268: </a><span class="php-comment"> *
+</span></span><span id="269" class="l"><a class="l" href="#269">269: </a><span class="php-comment"> * @param mixed $value
+</span></span><span id="270" class="l"><a class="l" href="#270">270: </a><span class="php-comment"> * @param string $empty Return $empty if $value is null
+</span></span><span id="271" class="l"><a class="l" href="#271">271: </a><span class="php-comment"> * @return string
+</span></span><span id="272" class="l"><a class="l" href="#272">272: </a><span class="php-comment"> */</span>
+</span><span id="273" class="l"><a class="l" href="#273">273: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_quote" href="#_quote">quote</a>(<span class="php-var">$value</span>, <span class="php-var">$empty</span> = <span class="php-quote">'NULL'</span>)
+</span><span id="274" class="l"><a class="l" href="#274">274: </a> {
+</span><span id="275" class="l"><a class="l" href="#275">275: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_array</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-quote">'('</span> . <span class="php-keyword2">join</span>(<span class="php-quote">', '</span>, <span class="php-keyword2">array_map</span>(<span class="php-keyword1">array</span>(<span class="php-keyword2">get_class</span>(), <span class="php-quote">'quote'</span>), <span class="php-var">$value</span>)) . <span class="php-quote">')'</span>;
+</span><span id="276" class="l"><a class="l" href="#276">276: </a>
+</span><span id="277" class="l"><a class="l" href="#277">277: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_null</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-var">$empty</span>;
+</span><span id="278" class="l"><a class="l" href="#278">278: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_bool</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> <span class="php-var">$value</span> ? <span class="php-quote">'TRUE'</span> : <span class="php-quote">'FALSE'</span>;
+</span><span id="279" class="l"><a class="l" href="#279">279: </a> <span class="php-keyword1">if</span> (<span class="php-keyword2">is_int</span>(<span class="php-var">$value</span>) || <span class="php-keyword2">is_float</span>(<span class="php-var">$value</span>)) <span class="php-keyword1">return</span> (string)<span class="php-var">$value</span>;
+</span><span id="280" class="l"><a class="l" href="#280">280: </a> <span class="php-keyword1">return</span> <span class="php-quote">'&quot;'</span> . <span class="php-keyword2">strtr</span>((string)<span class="php-var">$value</span>, <span class="php-keyword1">array</span>(<span class="php-quote">'\\'</span> =&gt; <span class="php-quote">'\\\\'</span>, <span class="php-quote">&quot;\0&quot;</span> =&gt; <span class="php-quote">'\\0'</span>, <span class="php-quote">&quot;\r&quot;</span> =&gt; <span class="php-quote">'\\r'</span>, <span class="php-quote">&quot;\n&quot;</span> =&gt; <span class="php-quote">'\\n'</span>, <span class="php-quote">'&quot;'</span> =&gt; <span class="php-quote">'\\&quot;'</span>)) . <span class="php-quote">'&quot;'</span>;
+</span><span id="281" class="l"><a class="l" href="#281">281: </a> }
+</span><span id="282" class="l"><a class="l" href="#282">282: </a>
+</span><span id="283" class="l"><a class="l" href="#283">283: </a> <span class="php-comment">/**
+</span></span><span id="284" class="l"><a class="l" href="#284">284: </a><span class="php-comment"> * Quote a field, table or dbname so it can be savely used in a query.
+</span></span><span id="285" class="l"><a class="l" href="#285">285: </a><span class="php-comment"> *
+</span></span><span id="286" class="l"><a class="l" href="#286">286: </a><span class="php-comment"> * @param string $field
+</span></span><span id="287" class="l"><a class="l" href="#287">287: </a><span class="php-comment"> * @return string
+</span></span><span id="288" class="l"><a class="l" href="#288">288: </a><span class="php-comment"> */</span>
+</span><span id="289" class="l"><a class="l" href="#289">289: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_backquote" href="#_backquote">backquote</a>(<span class="php-var">$field</span>)
+</span><span id="290" class="l"><a class="l" href="#290">290: </a> {
+</span><span id="291" class="l"><a class="l" href="#291">291: </a> <span class="php-keyword1">return</span> <span class="php-quote">'`'</span> . <span class="php-keyword2">str_replace</span>(<span class="php-quote">'`'</span>, <span class="php-quote">''</span>, <span class="php-var">$field</span>) . <span class="php-quote">'`'</span>;
</span><span id="292" class="l"><a class="l" href="#292">292: </a> }
-</span><span id="293" class="l"><a class="l" href="#293">293: </a>}
-</span><span id="294" class="l"><a class="l" href="#294">294: </a></span></code></pre>
+</span><span id="293" class="l"><a class="l" href="#293">293: </a>
+</span><span id="294" class="l"><a class="l" href="#294">294: </a> <span class="php-comment">/**
+</span></span><span id="295" class="l"><a class="l" href="#295">295: </a><span class="php-comment"> * Insert parameters into SQL query.
+</span></span><span id="296" class="l"><a class="l" href="#296">296: </a><span class="php-comment"> * Don't mix both types ('?' and ':key') of placeholders.
+</span></span><span id="297" class="l"><a class="l" href="#297">297: </a><span class="php-comment"> *
+</span></span><span id="298" class="l"><a class="l" href="#298">298: </a><span class="php-comment"> * @example DB::bind(&quot;SELECT * FROM mytable WHERE id=?&quot;, $id);
+</span></span><span id="299" class="l"><a class="l" href="#299">299: </a><span class="php-comment"> * @example DB::bind(&quot;SELECT * FROM mytable WHERE name=:name AND age&gt;:age AND status='A'&quot;, array('id'=&gt;$id, 'age'=&gt;$age));
+</span></span><span id="300" class="l"><a class="l" href="#300">300: </a><span class="php-comment"> *
+</span></span><span id="301" class="l"><a class="l" href="#301">301: </a><span class="php-comment"> * @param string $query
+</span></span><span id="302" class="l"><a class="l" href="#302">302: </a><span class="php-comment"> * @param mixed $params Parameters can be passed as indifidual arguments or as array
+</span></span><span id="303" class="l"><a class="l" href="#303">303: </a><span class="php-comment"> * @return string
+</span></span><span id="304" class="l"><a class="l" href="#304">304: </a><span class="php-comment"> */</span>
+</span><span id="305" class="l"><a class="l" href="#305">305: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">static</span> <span class="php-keyword1">function</span> <a id="_bind" href="#_bind">bind</a>(<span class="php-var">$query</span>, <span class="php-var">$params</span> = <span class="php-keyword1">array</span>())
+</span><span id="306" class="l"><a class="l" href="#306">306: </a> {
+</span><span id="307" class="l"><a class="l" href="#307">307: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword2">is_array</span>(<span class="php-var">$params</span>) || <span class="php-keyword2">is_int</span>(<span class="php-keyword2">key</span>(<span class="php-var">$params</span>))) <span class="php-var">$params</span> = <span class="php-keyword2">array_splice</span>(<span class="php-keyword2">func_get_args</span>(), <span class="php-num">1</span>);
+</span><span id="308" class="l"><a class="l" href="#308">308: </a>
+</span><span id="309" class="l"><a class="l" href="#309">309: </a> <span class="php-var">$fn</span> = <span class="php-keyword1">function</span> (<span class="php-var">$match</span>) <span class="php-keyword1">use</span> (&amp;<span class="php-var">$params</span>) {
+</span><span id="310" class="l"><a class="l" href="#310">310: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword1">empty</span>(<span class="php-var">$match</span>[<span class="php-num">1</span>]) &amp;&amp; !<span class="php-keyword1">empty</span>(<span class="php-var">$params</span>)) <span class="php-keyword1">return</span> DB::quote(<span class="php-keyword2">array_shift</span>(<span class="php-var">$params</span>));
+</span><span id="311" class="l"><a class="l" href="#311">311: </a> <span class="php-keyword1">if</span> (!<span class="php-keyword1">empty</span>(<span class="php-var">$match</span>[<span class="php-num">2</span>]) &amp;&amp; <span class="php-keyword2">array_key_exists</span>(<span class="php-var">$match</span>[<span class="php-num">2</span>], <span class="php-var">$params</span>)) <span class="php-keyword1">return</span> DB::quote(<span class="php-var">$params</span>[<span class="php-var">$match</span>[<span class="php-num">2</span>]]);
+</span><span id="312" class="l"><a class="l" href="#312">312: </a> <span class="php-keyword1">return</span> <span class="php-var">$match</span>[<span class="php-num">0</span>];
+</span><span id="313" class="l"><a class="l" href="#313">313: </a> };
+</span><span id="314" class="l"><a class="l" href="#314">314: </a>
+</span><span id="315" class="l"><a class="l" href="#315">315: </a> <span class="php-keyword1">return</span> <span class="php-keyword2">preg_replace_callback</span>(<span class="php-quote">'/`[^`]*+`|&quot;(?:[^&quot;\\\\]++|\\\\.)*+&quot;|\'(?:[^\'\\\\]++|\\\\.)*+\'|(\?)|:(\w++)/'</span>, <span class="php-var">$fn</span>, <span class="php-var">$query</span>);
+</span><span id="316" class="l"><a class="l" href="#316">316: </a> }
+</span><span id="317" class="l"><a class="l" href="#317">317: </a>}
+</span><span id="318" class="l"><a class="l" href="#318">318: </a></span></code></pre>
<div id="footer">
API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
View
2 phpunit.xml.dist
@@ -2,7 +2,7 @@
<phpunit colors="true">
<testsuites>
- <testsuite name="DBQuery (for MySQL) Test Suite">
+ <testsuite name="DB (for MySQL) Test Suite">
<directory>tests/</directory>
</testsuite>
</testsuites>
View
26 src/DB.php
@@ -129,6 +129,30 @@ public function fetchAll($query, $resulttype = MYSQLI_ASSOC)
}
/**
+ * Query and fetch all result rows as an associative array, a numeric array, or both.
+ *
+ * @example DB::conn()->fetchOne("SELECT * FROM mytable");
+ * @example DB::conn()->fetchOne("SELECT * FROM mytable", MYSQLI_NUM);
+ * @example DB::conn()->fetchOne("SELECT * FROM mytable WHERE id=?", MYSQLI_ASSOC, $id);
+ *
+ * @param string|mysqli_result $query SQL Query or DB result
+ * @param int $resulttype MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH
+ * @return array
+ */
+ public function fetchOne($query, $resulttype = MYSQLI_ASSOC)
+ {
+ if (func_num_args() > 2) {
+ $args = func_get_args();
+ unset($args[1]);
+ $query = call_user_func_array(array(get_class(), 'bind'), array_values($args));
+ }
+
+ $result = $query instanceof mysqli_result ? $query : $this->query($query);
+
+ return $result->fetch_array($resulttype);
+ }
+
+ /**
* Query and fetch a single column from all result rows.
*
* @example DB::conn()->fetchColumn("SELECT name FROM mytable");
@@ -280,6 +304,8 @@ public static function backquote($field)
*/
public static function bind($query, $params = array())
{
+ if ($query instanceof mysqli_result) trigger_error("Can only bind on a query not on a query result", E_USER_ERROR);
+
if (!is_array($params) || is_int(key($params))) $params = array_splice(func_get_args(), 1);
$fn = function ($match) use (&$params) {
View
44 tests/DBTest.php
@@ -370,6 +370,50 @@ public function testFetchAll_result()
}
/**
+ * Test DB::fetchOne()
+ *
+ * @depends testQuery
+ */
+ public function testFetchOne()
+ {
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id = 4");
+ $this->assertEquals(array('id' => 4, 'name' => 'Man'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo ORDER BY id");
+ $this->assertEquals(array('id' => 1, 'name' => 'Foo'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id = 4", MYSQLI_NUM);
+ $this->assertEquals(array(4, 'Man'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id = 4", MYSQLI_BOTH);
+ $this->assertEquals(array(4, 'Man', 'id' => 4, 'name' => 'Man'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id FROM foo WHERE ext = 'n/a'");
+ $this->assertNull($row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id = ?", MYSQLI_ASSOC, 4);
+ $this->assertEquals(array('id' => 4, 'name' => 'Man'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id > ? AND ext IN ?", MYSQLI_ASSOC, 1, array('tv', 'n/a'));
+ $this->assertEquals(array('id' => 3, 'name' => 'Zoo'), $row);
+
+ $row = DB::conn()->fetchOne("SELECT id, name FROM foo WHERE id = :id", MYSQLI_ASSOC, array('id' => 4));
+ $this->assertEquals(array('id' => 4, 'name' => 'Man'), $row);
+ }
+
+ /**
+ * Test DB::fetchOne() with a result
+ *
+ * @depends testQuery
+ */
+ public function testFetchOne_result()
+ {
+ $result = DB::conn()->query("SELECT id, name FROM foo WHERE id = 4");
+ $row = DB::conn()->fetchOne($result);
+ $this->assertEquals(array('id' => 4, 'name' => 'Man'), $row);
+ }
+
+ /**
* Test DB::fetchColumn()
*
* @depends testQuery

0 comments on commit 7169b8c

Please sign in to comment.
Something went wrong with that request. Please try again.