ZF-1726: Make the "where" clause parameters more consistent

Issue Type: Improvement Created: 2007-07-16T12:15:02.000+0000 Last Updated: 2009-03-18T14:19:22.000+0000 Status: Resolved Fix version(s): - 1.8.0 (30/Apr/09)

Reporter: Marc Richards (talawahdotnet) Assignee: Wil Sinclair (wil) Tags: - Zend_Db_Table

Related issues: - ZF-1905

Attachments: - ZF-1726.patch


Old summary: Normalize the "where" clause parameters that are accepted by Zend_Db_Table's fetchAll/fetchRow and update/delete methods.

I noticed that the where parameter for update and delete methods for Zend_Db_Table work a little differently than those for the fetchAll and fetchRow methods. Looking at the code, this seems to be based on the fact that update/delete proxy their corresponding methods in Zend_Db whereas fetchAll/fetchRow use Zend_Db_Select to build their queries. As it is now, all four of the methods accept the where clause either as a string or as an indexed array of strings (though this method is undocumented for fetchAll/fetchRow). The strings from the array are ANDed together without being quoted. e.g.

<pre class="highlight">
$where = $table->getAdapter()->quoteInto('bug_id = ?', 1234);


<pre class="highlight">
$where[] = "reported_by = 'goofy'";
$where[] = "bug_status = 'OPEN'";

However fetchAll/fetchRow also accept another undocumented format for the "where" parameter which automatically does the quoting for you. It takes an associative array where the keys are the condition with a placeholder and the values are the values to be replaced. Values are automatically quoted and terms are joined together using ANDs. e.g.

<pre class="highlight">
$where = array('bug_status = ?' => 'NEW', 'reported_by = ?' => 'talawahdotnet');
$rows = $table->fetchAll($where);

It would be nice if theses interfaces where unified and documented so that they accepted all three formats.


Posted by Bill Karwin (bkarwin) on 2007-07-16T12:30:59.000+0000

Updated summary, formatted code in description, assigned to Bill Karwin.

Posted by Adrian Hope-Bailie (adrianhopebailie) on 2007-08-27T04:56:40.000+0000

By modfying the _whereExpr function on Zend_Db_Adapter_Abstract the where clause for the Zend_Db_Table_Abstract::update/delete functions is structured in the same way as the where clause for the fetchRow/fetchAll fucntions.

$where can be:

  1. An instance of a Zend_Db_Expr 2)A string 3)An array of strings (each one a where condition) 4)An array of where clauses where the array key is a where clause of the form " ?" and the value will be quoted into the key to replace the question mark. Eg: array('id = ?' => 123, 'created_date > ?' => '2007-08-27 09:34:08' )

The new function would be:

<pre class="highlight">    
     * Convert an array, string, or Zend_Db_Expr object
     * into a string to put in a WHERE clause.
     * @param mixed $where
     * @return string
    protected function _whereExpr($where)
        if (empty($where)) {
            return $where;
        if (!is_array($where)) {
            $where = array($where);
        foreach ($where as $cond => &$term) {
            // is $cond an int? (i.e. Not a condition)
            if (is_int($cond)) {
                // $term is the full condition
                if ($term instanceof Zend_Db_Expr) {
                    $term = $term->__toString();
            } else {
                // $cond is the condition with placeholder,
                // and $term is quoted into the condition
                $term = $this->quoteInto($cond, $term);
            $term = '(' . $term . ')';

        $where = implode(' AND ', $where);
        return $where;

Posted by Adrian Hope-Bailie (adrianhopebailie) on 2007-09-14T12:07:30.000+0000

Patch modifies Zend_Db_Adapter_Abstract such that all where clauses use consistent arguments.

Posted by Adrian Hope-Bailie (adrianhopebailie) on 2007-09-14T12:07:54.000+0000

Resolved with attached patch

Posted by Darby Felton (darby) on 2007-09-18T12:30:32.000+0000

Reopening because it appears that the patch has not been applied to SVN; reassigning to [~bkarwin].

Posted by Wil Sinclair (wil) on 2008-03-25T20:43:59.000+0000

Please categorize/fix as needed.

Posted by Darby Felton (darby) on 2008-04-02T13:37:00.000+0000

Past due date

Posted by Wil Sinclair (wil) on 2008-04-18T13:12:06.000+0000

This doesn't appear to have been fixed in 1.5.0. Please update if this is not correct.

Posted by Wil Sinclair (wil) on 2008-12-08T16:40:12.000+0000

Ralph, can you please look in to this and get some closure when you have a little time?

Posted by Ralph Schindler (ralph) on 2009-01-09T13:57:39.000+0000

Will evaluate in 2 weeks

Posted by Wil Sinclair (wil) on 2009-03-17T17:03:47.000+0000

Fixed with the patch provided at r14358

Posted by Mickael Perraud (mikaelkael) on 2009-03-18T13:43:54.000+0000

Wil, I reopen it because it fails with Zend_Db_Adapter_Oracle and testAdapterUpdateWhereArrayWithVariable (only this adapter extends the update method). I will correct it in the next days.

It also fail for the 2 asssociated tests with Db2, Oracle and Pdo_Oci but just for a mistake in tests.

Posted by Mickael Perraud (mikaelkael) on 2009-03-18T14:19:22.000+0000

Fixed with SVN14365 & SVN14366

Have you found an issue?

See the Overview section for more details.


© 2006-2016 by Zend, a Rogue Wave Company. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.