ZF-1907 - Issues - Zend Framework

ZF-1907: Fix incorrect Zend_Db_Table_Abstract::fetchRow() docblock

Issue Type:

Docs: Problem

Created:

2007-09-04T14:21:34.000+0000

Last Updated:

2009-04-17T04:27:50.000+0000

Status:

Resolved

Fix version(s):

1.0.3 (30/Nov/07)
1.8.0 (30/Apr/09)

Reporter:

Travis Pew (travisp)

Assignee:

Mickael Perraud (mikaelkael)

Tags:

Zend_Db_Table

Related issues:

ZF-5064

Attachments:

Description

The current docblock for Zend_Db_Table_Abstract::fetchRow() contains:


* Fetches one row in an object of type Zend_Db_Table_Row_Abstract,
* or returns Boolean false if no row matches the specified criteria.

However, fetchRow() was previously changed to return NULL, not false, if no row matches the criteria. The @return parameter correctly states this.

Comments

Posted by Thomas Weidner (thomas) on 2007-09-08T12:00:34.000+0000

Assigned to Bill

Posted by Travis Pew (travisp) on 2008-04-03T16:12:05.000+0000

I realize it's a minor thing, but the issue has not been fully resolved as of the 1.5 release:


    /**
     * Fetches one row in an object of type Zend_Db_Table_Row_Abstract,
     * or returns Boolean false if no row matches the specified criteria.
     *
     * @param string|array|Zend_Db_Table_Select $where  OPTIONAL An SQL WHERE clause or Zend_Db_Table_Select object.
     * @param string|array                      $order  OPTIONAL An SQL ORDER clause.
     * @return Zend_Db_Table_Row_Abstract The row results per the
     *     Zend_Db_Adapter fetch mode, or null if no row found.
     */

Posted by Travis Pew (travisp) on 2008-04-03T16:15:09.000+0000

Updated to reflect the problem's continued existence in the 1.5.0 release

Posted by Benjamin Eberlei (beberlei) on 2009-01-30T14:58:49.000+0000

Reopened per users request for evaluation, this seems not to have been fixed currently

Posted by Snakehit (snakehit) on 2009-04-15T05:40:14.000+0000

I realize this is a minor issue but wouldn't it be nice if this would be fixed. This is still a problem in v1.8.0

Fix: bq. /** * Fetches one row in an object of type Zend_Db_Table_Row_Abstract, * or returns null if no row matches the specified criteria. * * @param string|array|Zend_Db_Table_Select $where OPTIONAL An SQL WHERE clause or Zend_Db_Table_Select object. * @param string|array $order OPTIONAL An SQL ORDER clause. * @return Zend_Db_Table_Row_Abstract The row results per the * Zend_Db_Adapter fetch mode, or null if no row found. */

Posted by Mickael Perraud (mikaelkael) on 2009-04-17T04:26:39.000+0000

Resolved by SVN 12864