UPDATE 4.4.0.0
[phpmyadmin.git] / libraries / DBQbe.class.php
blob085ae100064b21a31298243721edc141a11ec58a
1 <?php
2 /* vim: set expandtab sw=4 ts=4 sts=4: */
3 /**
4 * Handles DB QBE search
6 * @package PhpMyAdmin
7 */
8 if (! defined('PHPMYADMIN')) {
9 exit;
12 /**
13 * Class to handle database QBE search
15 * @package PhpMyAdmin
17 class PMA_DbQbe
19 /**
20 * Database name
22 * @access private
23 * @var string
25 private $_db;
26 /**
27 * Table Names (selected/non-selected)
29 * @access private
30 * @var array
32 private $_criteriaTables;
33 /**
34 * Column Names
36 * @access private
37 * @var array
39 private $_columnNames;
40 /**
41 * Number of columns
43 * @access private
44 * @var integer
46 private $_criteria_column_count;
47 /**
48 * Number of Rows
50 * @access private
51 * @var integer
53 private $_criteria_row_count;
54 /**
55 * Whether to insert a new column
57 * @access private
58 * @var array
60 private $_criteriaColumnInsert;
61 /**
62 * Whether to delete a column
64 * @access private
65 * @var array
67 private $_criteriaColumnDelete;
68 /**
69 * Whether to insert a new row
71 * @access private
72 * @var array
74 private $_criteriaRowInsert;
75 /**
76 * Whether to delete a row
78 * @access private
79 * @var array
81 private $_criteriaRowDelete;
82 /**
83 * Already set criteria values
85 * @access private
86 * @var array
88 private $_criteria;
89 /**
90 * Previously set criteria values
92 * @access private
93 * @var array
95 private $_prev_criteria;
96 /**
97 * AND/OR relation b/w criteria columns
99 * @access private
100 * @var array
102 private $_criteriaAndOrColumn;
104 * AND/OR relation b/w criteria rows
106 * @access private
107 * @var array
109 private $_criteriaAndOrRow;
111 * Large width of a column
113 * @access private
114 * @var string
116 private $_realwidth;
118 * Minimum width of a column
120 * @access private
121 * @var int
123 private $_form_column_width;
125 * Current criteria field
127 * @access private
128 * @var array
130 private $_curField;
132 * Current criteria Sort options
134 * @access private
135 * @var array
137 private $_curSort;
139 * Current criteria Show options
141 * @access private
142 * @var array
144 private $_curShow;
146 * Current criteria values
148 * @access private
149 * @var array
151 private $_curCriteria;
153 * Current criteria AND/OR column relations
155 * @access private
156 * @var array
158 private $_curAndOrCol;
160 * Current criteria AND/OR row relations
162 * @access private
163 * @var array
165 private $_curAndOrRow;
167 * New column count in case of add/delete
169 * @access private
170 * @var integer
172 private $_new_column_count;
174 * New row count in case of add/delete
176 * @access private
177 * @var integer
179 private $_new_row_count;
181 * List of saved searches
183 * @access private
184 * @var array
186 private $_savedSearchList = null;
188 * Current search
190 * @access private
191 * @var PMA_SavedSearches
193 private $_currentSearch = null;
196 * Initialize criterias
198 * @return static
200 private function _loadCriterias()
202 if (null === $this->_currentSearch
203 || null === $this->_currentSearch->getCriterias()
205 return $this;
208 $criterias = $this->_currentSearch->getCriterias();
209 $_REQUEST = $criterias + $_REQUEST;
211 return $this;
215 * Getter for current search
217 * @return PMA_SavedSearches
219 private function _getCurrentSearch()
221 return $this->_currentSearch;
225 * Public Constructor
227 * @param string $dbname Database name
228 * @param array $savedSearchList List of saved searches
229 * @param PMA_SavedSearches $currentSearch Current search id
231 public function __construct(
232 $dbname, $savedSearchList = array(), $currentSearch = null
234 $this->_db = $dbname;
235 $this->_savedSearchList = $savedSearchList;
236 $this->_currentSearch = $currentSearch;
237 $this->_loadCriterias();
238 // Sets criteria parameters
239 $this->_setSearchParams();
240 $this->_setCriteriaTablesAndColumns();
244 * Sets search parameters
246 * @return void
248 private function _setSearchParams()
250 $criteriaColumnCount = $this->_initializeCriteriasCount();
252 $this->_criteriaColumnInsert = PMA_ifSetOr(
253 $_REQUEST['criteriaColumnInsert'],
254 null,
255 'array'
257 $this->_criteriaColumnDelete = PMA_ifSetOr(
258 $_REQUEST['criteriaColumnDelete'],
259 null,
260 'array'
263 $this->_prev_criteria = isset($_REQUEST['prev_criteria'])
264 ? $_REQUEST['prev_criteria']
265 : array();
266 $this->_criteria = isset($_REQUEST['criteria'])
267 ? $_REQUEST['criteria']
268 : array_fill(0, $criteriaColumnCount, '');
270 $this->_criteriaRowInsert = isset($_REQUEST['criteriaRowInsert'])
271 ? $_REQUEST['criteriaRowInsert']
272 : array_fill(0, $criteriaColumnCount, '');
273 $this->_criteriaRowDelete = isset($_REQUEST['criteriaRowDelete'])
274 ? $_REQUEST['criteriaRowDelete']
275 : array_fill(0, $criteriaColumnCount, '');
276 $this->_criteriaAndOrRow = isset($_REQUEST['criteriaAndOrRow'])
277 ? $_REQUEST['criteriaAndOrRow']
278 : array_fill(0, $criteriaColumnCount, '');
279 $this->_criteriaAndOrColumn = isset($_REQUEST['criteriaAndOrColumn'])
280 ? $_REQUEST['criteriaAndOrColumn']
281 : array_fill(0, $criteriaColumnCount, '');
282 // sets minimum width
283 $this->_form_column_width = 12;
284 $this->_curField = array();
285 $this->_curSort = array();
286 $this->_curShow = array();
287 $this->_curCriteria = array();
288 $this->_curAndOrRow = array();
289 $this->_curAndOrCol = array();
293 * Sets criteria tables and columns
295 * @return void
297 private function _setCriteriaTablesAndColumns()
299 // The tables list sent by a previously submitted form
300 if (PMA_isValid($_REQUEST['TableList'], 'array')) {
301 foreach ($_REQUEST['TableList'] as $each_table) {
302 $this->_criteriaTables[$each_table] = ' selected="selected"';
304 } // end if
305 $all_tables = $GLOBALS['dbi']->query(
306 'SHOW TABLES FROM ' . PMA_Util::backquote($this->_db) . ';',
307 null,
308 PMA_DatabaseInterface::QUERY_STORE
310 $all_tables_count = $GLOBALS['dbi']->numRows($all_tables);
311 if (0 == $all_tables_count) {
312 PMA_Message::error(__('No tables found in database.'))->display();
313 exit;
315 // The tables list gets from MySQL
316 while (list($table) = $GLOBALS['dbi']->fetchRow($all_tables)) {
317 $columns = $GLOBALS['dbi']->getColumns($this->_db, $table);
319 if (empty($this->_criteriaTables[$table])
320 && ! empty($_REQUEST['TableList'])
322 $this->_criteriaTables[$table] = '';
323 } else {
324 $this->_criteriaTables[$table] = ' selected="selected"';
325 } // end if
327 // The fields list per selected tables
328 if ($this->_criteriaTables[$table] == ' selected="selected"') {
329 $each_table = PMA_Util::backquote($table);
330 $this->_columnNames[] = $each_table . '.*';
331 foreach ($columns as $each_column) {
332 $each_column = $each_table . '.'
333 . PMA_Util::backquote($each_column['Field']);
334 $this->_columnNames[] = $each_column;
335 // increase the width if necessary
336 $this->_form_column_width = max(
337 /*overload*/mb_strlen($each_column),
338 $this->_form_column_width
340 } // end foreach
341 } // end if
342 } // end while
343 $GLOBALS['dbi']->freeResult($all_tables);
345 // sets the largest width found
346 $this->_realwidth = $this->_form_column_width . 'ex';
349 * Provides select options list containing column names
351 * @param integer $column_number Column Number (0,1,2) or more
352 * @param string $selected Selected criteria column name
354 * @return string HTML for select options
356 private function _showColumnSelectCell($column_number, $selected = '')
358 $html_output = '';
359 $html_output .= '<td class="center">';
360 $html_output .= '<select name="criteriaColumn[' . $column_number
361 . ']" size="1">';
362 $html_output .= '<option value="">&nbsp;</option>';
363 foreach ($this->_columnNames as $column) {
364 $html_output .= '<option value="' . htmlspecialchars($column) . '"'
365 . (($column === $selected) ? ' selected="selected"' : '') . '>'
366 . str_replace(' ', '&nbsp;', htmlspecialchars($column))
367 . '</option>';
369 $html_output .= '</select>';
370 $html_output .= '</td>';
371 return $html_output;
375 * Provides select options list containing sort options (ASC/DESC)
377 * @param integer $column_number Column Number (0,1,2) or more
378 * @param string $asc_selected Selected criteria 'Ascending'
379 * @param string $desc_selected Selected criteria 'Descending'
381 * @return string HTML for select options
383 private function _getSortSelectCell($column_number, $asc_selected = '',
384 $desc_selected = ''
386 $html_output = '<td class="center">';
387 $html_output .= '<select style="width: ' . $this->_realwidth
388 . '" name="criteriaSort[' . $column_number . ']" size="1">';
389 $html_output .= '<option value="">&nbsp;</option>';
390 $html_output .= '<option value="ASC"' . $asc_selected . '>'
391 . __('Ascending')
392 . '</option>';
393 $html_output .= '<option value="DESC"' . $desc_selected . '>'
394 . __('Descending')
395 . '</option>';
396 $html_output .= '</select>';
397 $html_output .= '</td>';
398 return $html_output;
402 * Provides search form's row containing column select options
404 * @return string HTML for search table's row
406 private function _getColumnNamesRow()
408 $html_output = '<tr class="odd noclick">';
409 $html_output .= '<th>' . __('Column:') . '</th>';
410 $new_column_count = 0;
411 for (
412 $column_index = 0;
413 $column_index < $this->_criteria_column_count;
414 $column_index++
416 if (isset($this->_criteriaColumnInsert[$column_index])
417 && $this->_criteriaColumnInsert[$column_index] == 'on'
419 $html_output .= $this->_showColumnSelectCell(
420 $new_column_count
422 $new_column_count++;
424 if (! empty($this->_criteriaColumnDelete)
425 && isset($this->_criteriaColumnDelete[$column_index])
426 && $this->_criteriaColumnDelete[$column_index] == 'on'
428 continue;
430 $selected = '';
431 if (isset($_REQUEST['criteriaColumn'][$column_index])) {
432 $selected = $_REQUEST['criteriaColumn'][$column_index];
433 $this->_curField[$new_column_count]
434 = $_REQUEST['criteriaColumn'][$column_index];
436 $html_output .= $this->_showColumnSelectCell(
437 $new_column_count,
438 $selected
440 $new_column_count++;
441 } // end for
442 $this->_new_column_count = $new_column_count;
443 $html_output .= '</tr>';
444 return $html_output;
448 * Provides search form's row containing sort(ASC/DESC) select options
450 * @return string HTML for search table's row
452 private function _getSortRow()
454 $html_output = '<tr class="even noclick">';
455 $html_output .= '<th>' . __('Sort:') . '</th>';
456 $new_column_count = 0;
458 for (
459 $colInd = 0;
460 $colInd < $this->_criteria_column_count;
461 $colInd++
463 if (! empty($this->_criteriaColumnInsert)
464 && isset($this->_criteriaColumnInsert[$colInd])
465 && $this->_criteriaColumnInsert[$colInd] == 'on'
467 $html_output .= $this->_getSortSelectCell($new_column_count);
468 $new_column_count++;
469 } // end if
471 if (! empty($this->_criteriaColumnDelete)
472 && isset($this->_criteriaColumnDelete[$colInd])
473 && $this->_criteriaColumnDelete[$colInd] == 'on'
475 continue;
477 // If they have chosen all fields using the * selector,
478 // then sorting is not available, Fix for Bug #570698
479 if (isset($_REQUEST['criteriaSort'][$colInd])
480 && isset($_REQUEST['criteriaColumn'][$colInd])
481 && /*overload*/mb_substr($_REQUEST['criteriaColumn'][$colInd], -2) == '.*'
483 $_REQUEST['criteriaSort'][$colInd] = '';
484 } //end if
485 // Set asc_selected
486 if (isset($_REQUEST['criteriaSort'][$colInd])
487 && $_REQUEST['criteriaSort'][$colInd] == 'ASC'
489 $this->_curSort[$new_column_count]
490 = $_REQUEST['criteriaSort'][$colInd];
491 $asc_selected = ' selected="selected"';
492 } else {
493 $asc_selected = '';
494 } // end if
495 // Set desc selected
496 if (isset($_REQUEST['criteriaSort'][$colInd])
497 && $_REQUEST['criteriaSort'][$colInd] == 'DESC'
499 $this->_curSort[$new_column_count]
500 = $_REQUEST['criteriaSort'][$colInd];
501 $desc_selected = ' selected="selected"';
502 } else {
503 $desc_selected = '';
504 } // end if
505 $html_output .= $this->_getSortSelectCell(
506 $new_column_count, $asc_selected, $desc_selected
508 $new_column_count++;
509 } // end for
510 $html_output .= '</tr>';
511 return $html_output;
515 * Provides search form's row containing SHOW checkboxes
517 * @return string HTML for search table's row
519 private function _getShowRow()
521 $html_output = '<tr class="odd noclick">';
522 $html_output .= '<th>' . __('Show:') . '</th>';
523 $new_column_count = 0;
524 for (
525 $column_index = 0;
526 $column_index < $this->_criteria_column_count;
527 $column_index++
529 if (! empty($this->_criteriaColumnInsert)
530 && isset($this->_criteriaColumnInsert[$column_index])
531 && $this->_criteriaColumnInsert[$column_index] == 'on'
533 $html_output .= '<td class="center">';
534 $html_output .= '<input type="checkbox"'
535 . ' name="criteriaShow[' . $new_column_count . ']" />';
536 $html_output .= '</td>';
537 $new_column_count++;
538 } // end if
539 if (! empty($this->_criteriaColumnDelete)
540 && isset($this->_criteriaColumnDelete[$column_index])
541 && $this->_criteriaColumnDelete[$column_index] == 'on'
543 continue;
545 if (isset($_REQUEST['criteriaShow'][$column_index])) {
546 $checked_options = ' checked="checked"';
547 $this->_curShow[$new_column_count]
548 = $_REQUEST['criteriaShow'][$column_index];
549 } else {
550 $checked_options = '';
552 $html_output .= '<td class="center">';
553 $html_output .= '<input type="checkbox"'
554 . ' name="criteriaShow[' . $new_column_count . ']"'
555 . $checked_options . ' />';
556 $html_output .= '</td>';
557 $new_column_count++;
558 } // end for
559 $html_output .= '</tr>';
560 return $html_output;
564 * Provides search form's row containing criteria Inputboxes
566 * @return string HTML for search table's row
568 private function _getCriteriaInputboxRow()
570 $html_output = '<tr class="even noclick">';
571 $html_output .= '<th>' . __('Criteria:') . '</th>';
572 $new_column_count = 0;
573 for (
574 $column_index = 0;
575 $column_index < $this->_criteria_column_count;
576 $column_index++
578 if (! empty($this->_criteriaColumnInsert)
579 && isset($this->_criteriaColumnInsert[$column_index])
580 && $this->_criteriaColumnInsert[$column_index] == 'on'
582 $html_output .= '<td class="center">';
583 $html_output .= '<input type="text"'
584 . ' name="criteria[' . $new_column_count . ']"'
585 . ' value=""'
586 . ' class="textfield"'
587 . ' style="width: ' . $this->_realwidth . '"'
588 . ' size="20" />';
589 $html_output .= '</td>';
590 $new_column_count++;
591 } // end if
592 if (! empty($this->_criteriaColumnDelete)
593 && isset($this->_criteriaColumnDelete[$column_index])
594 && $this->_criteriaColumnDelete[$column_index] == 'on'
596 continue;
598 if (isset($this->_criteria[$column_index])) {
599 $tmp_criteria = $this->_criteria[$column_index];
601 if ((empty($this->_prev_criteria)
602 || ! isset($this->_prev_criteria[$column_index]))
603 || $this->_prev_criteria[$column_index] != htmlspecialchars($tmp_criteria)
605 $this->_curCriteria[$new_column_count] = $tmp_criteria;
606 } else {
607 $this->_curCriteria[$new_column_count]
608 = $this->_prev_criteria[$column_index];
610 $html_output .= '<td class="center">';
611 $html_output .= '<input type="hidden"'
612 . ' name="prev_criteria[' . $new_column_count . ']"'
613 . ' value="'
614 . htmlspecialchars($this->_curCriteria[$new_column_count])
615 . '" />';
616 $html_output .= '<input type="text"'
617 . ' name="criteria[' . $new_column_count . ']"'
618 . ' value="' . htmlspecialchars($tmp_criteria) . '"'
619 . ' class="textfield"'
620 . ' style="width: ' . $this->_realwidth . '"'
621 . ' size="20" />';
622 $html_output .= '</td>';
623 $new_column_count++;
624 } // end for
625 $html_output .= '</tr>';
626 return $html_output;
630 * Provides footer options for adding/deleting row/columns
632 * @param string $type Whether row or column
634 * @return string HTML for footer options
636 private function _getFootersOptions($type)
638 $html_output = '<div class="floatleft">';
639 $html_output .= (($type == 'row')
640 ? __('Add/Delete criteria rows') : __('Add/Delete columns'));
641 $html_output .= ':<select size="1" name="'
642 . (($type == 'row') ? 'criteriaRowAdd' : 'criteriaColumnAdd') . '">';
643 $html_output .= '<option value="-3">-3</option>';
644 $html_output .= '<option value="-2">-2</option>';
645 $html_output .= '<option value="-1">-1</option>';
646 $html_output .= '<option value="0" selected="selected">0</option>';
647 $html_output .= '<option value="1">1</option>';
648 $html_output .= '<option value="2">2</option>';
649 $html_output .= '<option value="3">3</option>';
650 $html_output .= '</select>';
651 $html_output .= '</div>';
652 return $html_output;
656 * Provides search form table's footer options
658 * @return string HTML for table footer
660 private function _getTableFooters()
662 $html_output = '<fieldset class="tblFooters">';
663 $html_output .= $this->_getFootersOptions("row");
664 $html_output .= $this->_getFootersOptions("column");
665 $html_output .= '<div class="floatleft">';
666 $html_output .= '<input type="submit" name="modify"'
667 . 'value="' . __('Update Query') . '" />';
668 $html_output .= '</div>';
669 $html_output .= '</fieldset>';
670 return $html_output;
674 * Provides a select list of database tables
676 * @return string HTML for table select list
678 private function _getTablesList()
680 $html_output = '<div class="floatleft">';
681 $html_output .= '<fieldset>';
682 $html_output .= '<legend>' . __('Use Tables') . '</legend>';
683 // Build the options list for each table name
684 $options = '';
685 $numTableListOptions = 0;
686 foreach ($this->_criteriaTables as $key => $val) {
687 $options .= '<option value="' . htmlspecialchars($key) . '"' . $val . '>'
688 . (str_replace(' ', '&nbsp;', htmlspecialchars($key))) . '</option>';
689 $numTableListOptions++;
691 $html_output .= '<select name="TableList[]"'
692 . ' multiple="multiple" id="listTable"'
693 . ' size="' . (($numTableListOptions > 30) ? '15' : '7') . '">';
694 $html_output .= $options;
695 $html_output .= '</select>';
696 $html_output .= '</fieldset>';
697 $html_output .= '<fieldset class="tblFooters">';
698 $html_output .= '<input type="submit" name="modify" value="'
699 . __('Update Query') . '" />';
700 $html_output .= '</fieldset>';
701 $html_output .= '</div>';
702 return $html_output;
706 * Provides And/Or modification cell along with Insert/Delete options
707 * (For modifying search form's table columns)
709 * @param integer $column_number Column Number (0,1,2) or more
710 * @param array $selected Selected criteria column name
712 * @return string HTML for modification cell
714 private function _getAndOrColCell($column_number, $selected = null)
716 $html_output = '<td class="center">';
717 $html_output .= '<strong>' . __('Or:') . '</strong>';
718 $html_output .= '<input type="radio"'
719 . ' name="criteriaAndOrColumn[' . $column_number . ']"'
720 . ' value="or"' . $selected['or'] . ' />';
721 $html_output .= '&nbsp;&nbsp;<strong>' . __('And:') . '</strong>';
722 $html_output .= '<input type="radio"'
723 . ' name="criteriaAndOrColumn[' . $column_number . ']"'
724 . ' value="and"' . $selected['and'] . ' />';
725 $html_output .= '<br />' . __('Ins');
726 $html_output .= '<input type="checkbox"'
727 . ' name="criteriaColumnInsert[' . $column_number . ']" />';
728 $html_output .= '&nbsp;&nbsp;' . __('Del');
729 $html_output .= '<input type="checkbox"'
730 . ' name="criteriaColumnDelete[' . $column_number . ']" />';
731 $html_output .= '</td>';
732 return $html_output;
736 * Provides search form's row containing column modifications options
737 * (For modifying search form's table columns)
739 * @return string HTML for search table's row
741 private function _getModifyColumnsRow()
743 $html_output = '<tr class="even noclick">';
744 $html_output .= '<th>' . __('Modify:') . '</th>';
745 $new_column_count = 0;
746 for (
747 $column_index = 0;
748 $column_index < $this->_criteria_column_count;
749 $column_index++
751 if (! empty($this->_criteriaColumnInsert)
752 && isset($this->_criteriaColumnInsert[$column_index])
753 && $this->_criteriaColumnInsert[$column_index] == 'on'
755 $html_output .= $this->_getAndOrColCell($new_column_count);
756 $new_column_count++;
757 } // end if
759 if (! empty($this->_criteriaColumnDelete)
760 && isset($this->_criteriaColumnDelete[$column_index])
761 && $this->_criteriaColumnDelete[$column_index] == 'on'
763 continue;
766 if (isset($this->_criteriaAndOrColumn[$column_index])) {
767 $this->_curAndOrCol[$new_column_count]
768 = $this->_criteriaAndOrColumn[$column_index];
770 $checked_options = array();
771 if (isset($this->_criteriaAndOrColumn[$column_index])
772 && $this->_criteriaAndOrColumn[$column_index] == 'or'
774 $checked_options['or'] = ' checked="checked"';
775 $checked_options['and'] = '';
776 } else {
777 $checked_options['and'] = ' checked="checked"';
778 $checked_options['or'] = '';
780 $html_output .= $this->_getAndOrColCell(
781 $new_column_count,
782 $checked_options
784 $new_column_count++;
785 } // end for
786 $html_output .= '</tr>';
787 return $html_output;
791 * Provides Insert/Delete options for criteria inputbox
792 * with AND/OR relationship modification options
794 * @param integer $row_index Number of criteria row
795 * @param array $checked_options If checked
797 * @return string HTML
799 private function _getInsDelAndOrCell($row_index, $checked_options)
801 $html_output = '<td class="' . $GLOBALS['cell_align_right'] . ' nowrap">';
802 $html_output .= '<!-- Row controls -->';
803 $html_output .= '<table class="nospacing nopadding">';
804 $html_output .= '<tr>';
805 $html_output .= '<td class="' . $GLOBALS['cell_align_right'] . ' nowrap">';
806 $html_output .= '<small>' . __('Ins:') . '</small>';
807 $html_output .= '<input type="checkbox"'
808 . ' name="criteriaRowInsert[' . $row_index . ']" />';
809 $html_output .= '</td>';
810 $html_output .= '<td class="' . $GLOBALS['cell_align_right'] . '">';
811 $html_output .= '<strong>' . __('And:') . '</strong>';
812 $html_output .= '</td>';
813 $html_output .= '<td>';
814 $html_output .= '<input type="radio"'
815 . ' name="criteriaAndOrRow[' . $row_index . ']" value="and"'
816 . $checked_options['and'] . ' />';
817 $html_output .= '</td>';
818 $html_output .= '</tr>';
819 $html_output .= '<tr>';
820 $html_output .= '<td class="' . $GLOBALS['cell_align_right'] . ' nowrap">';
821 $html_output .= '<small>' . __('Del:') . '</small>';
822 $html_output .= '<input type="checkbox"'
823 . ' name="criteriaRowDelete[' . $row_index . ']" />';
824 $html_output .= '</td>';
825 $html_output .= '<td class="' . $GLOBALS['cell_align_right'] . '">';
826 $html_output .= '<strong>' . __('Or:') . '</strong>';
827 $html_output .= '</td>';
828 $html_output .= '<td>';
829 $html_output .= '<input type="radio"'
830 . ' name="criteriaAndOrRow[' . $row_index . ']"'
831 . ' value="or"' . $checked_options['or'] . ' />';
832 $html_output .= '</td>';
833 $html_output .= '</tr>';
834 $html_output .= '</table>';
835 $html_output .= '</td>';
836 return $html_output;
840 * Provides rows for criteria inputbox Insert/Delete options
841 * with AND/OR relationship modification options
843 * @param integer $new_row_index New row index if rows are added/deleted
845 * @return string HTML table rows
847 private function _getInputboxRow($new_row_index)
849 $html_output = '';
850 $new_column_count = 0;
851 for (
852 $column_index = 0;
853 $column_index < $this->_criteria_column_count;
854 $column_index++
856 if (!empty($this->_criteriaColumnInsert)
857 && isset($this->_criteriaColumnInsert[$column_index])
858 && $this->_criteriaColumnInsert[$column_index] == 'on'
860 $orFieldName = 'Or' . $new_row_index . '[' . $new_column_count . ']';
861 $html_output .= '<td class="center">';
862 $html_output .= '<input type="text"'
863 . ' name="Or' . $orFieldName . '" class="textfield"'
864 . ' style="width: ' . $this->_realwidth . '" size="20" />';
865 $html_output .= '</td>';
866 $new_column_count++;
867 } // end if
868 if (!empty($this->_criteriaColumnDelete)
869 && isset($this->_criteriaColumnDelete[$column_index])
870 && $this->_criteriaColumnDelete[$column_index] == 'on'
872 continue;
874 $or = 'Or' . $new_row_index;
875 if (! empty($_REQUEST[$or]) && isset($_REQUEST[$or][$column_index])) {
876 $tmp_or = $_REQUEST[$or][$column_index];
877 } else {
878 $tmp_or = '';
880 $html_output .= '<td class="center">';
881 $html_output .= '<input type="text"'
882 . ' name="Or' . $new_row_index . '[' . $new_column_count . ']' . '"'
883 . ' value="' . htmlspecialchars($tmp_or) . '" class="textfield"'
884 . ' style="width: ' . $this->_realwidth . '" size="20" />';
885 $html_output .= '</td>';
886 if (!empty(${$or}) && isset(${$or}[$column_index])) {
887 $GLOBALS[${'cur' . $or}][$new_column_count]
888 = ${$or}[$column_index];
890 $new_column_count++;
891 } // end for
892 return $html_output;
896 * Provides rows for criteria inputbox Insert/Delete options
897 * with AND/OR relationship modification options
899 * @return string HTML table rows
901 private function _getInsDelAndOrCriteriaRows()
903 $html_output = '';
904 $new_row_count = 0;
905 $odd_row = true;
906 $checked_options = array();
907 for (
908 $row_index = 0;
909 $row_index <= $this->_criteria_row_count;
910 $row_index++
912 if (isset($this->_criteriaRowInsert[$row_index])
913 && $this->_criteriaRowInsert[$row_index] == 'on'
915 $checked_options['or'] = ' checked="checked"';
916 $checked_options['and'] = '';
917 $html_output .= '<tr class="' . ($odd_row ? 'odd' : 'even')
918 . ' noclick">';
919 $html_output .= $this->_getInsDelAndOrCell(
920 $new_row_count, $checked_options
922 $html_output .= $this->_getInputboxRow(
923 $new_row_count
925 $new_row_count++;
926 $html_output .= '</tr>';
927 $odd_row =! $odd_row;
928 } // end if
929 if (isset($this->_criteriaRowDelete[$row_index])
930 && $this->_criteriaRowDelete[$row_index] == 'on'
932 continue;
934 if (isset($this->_criteriaAndOrRow[$row_index])) {
935 $this->_curAndOrRow[$new_row_count]
936 = $this->_criteriaAndOrRow[$row_index];
938 if (isset($this->_criteriaAndOrRow[$row_index])
939 && $this->_criteriaAndOrRow[$row_index] == 'and'
941 $checked_options['and'] = ' checked="checked"';
942 $checked_options['or'] = '';
943 } else {
944 $checked_options['or'] = ' checked="checked"';
945 $checked_options['and'] = '';
947 $html_output .= '<tr class="' . ($odd_row ? 'odd' : 'even')
948 . ' noclick">';
949 $html_output .= $this->_getInsDelAndOrCell(
950 $new_row_count, $checked_options
952 $html_output .= $this->_getInputboxRow(
953 $new_row_count
955 $new_row_count++;
956 $html_output .= '</tr>';
957 $odd_row =! $odd_row;
958 } // end for
959 $this->_new_row_count = $new_row_count;
960 return $html_output;
964 * Provides SELECT clause for building SQL query
966 * @return string Select clause
968 private function _getSelectClause()
970 $select_clause = '';
971 $select_clauses = array();
972 for (
973 $column_index = 0;
974 $column_index < $this->_criteria_column_count;
975 $column_index++
977 if (! empty($this->_curField[$column_index])
978 && isset($this->_curShow[$column_index])
979 && $this->_curShow[$column_index] == 'on'
981 $select_clauses[] = $this->_curField[$column_index];
983 } // end for
984 if ($select_clauses) {
985 $select_clause = 'SELECT '
986 . htmlspecialchars(implode(", ", $select_clauses)) . "\n";
988 return $select_clause;
992 * Provides WHERE clause for building SQL query
994 * @return string Where clause
996 private function _getWhereClause()
998 $where_clause = '';
999 $criteria_cnt = 0;
1000 for (
1001 $column_index = 0;
1002 $column_index < $this->_criteria_column_count;
1003 $column_index++
1005 if (! empty($this->_curField[$column_index])
1006 && ! empty($this->_curCriteria[$column_index])
1007 && $column_index
1008 && isset($last_where)
1009 && isset($this->_curAndOrCol)
1011 $where_clause .= ' '
1012 . /*overload*/mb_strtoupper($this->_curAndOrCol[$last_where])
1013 . ' ';
1015 if (! empty($this->_curField[$column_index])
1016 && ! empty($this->_curCriteria[$column_index])
1018 $where_clause .= '(' . $this->_curField[$column_index] . ' '
1019 . $this->_curCriteria[$column_index] . ')';
1020 $last_where = $column_index;
1021 $criteria_cnt++;
1023 } // end for
1024 if ($criteria_cnt > 1) {
1025 $where_clause = '(' . $where_clause . ')';
1027 // OR rows ${'cur' . $or}[$column_index]
1028 if (! isset($this->_curAndOrRow)) {
1029 $this->_curAndOrRow = array();
1031 for (
1032 $row_index = 0;
1033 $row_index <= $this->_criteria_row_count;
1034 $row_index++
1036 $criteria_cnt = 0;
1037 $qry_orwhere = '';
1038 $last_orwhere = '';
1039 for (
1040 $column_index = 0;
1041 $column_index < $this->_criteria_column_count;
1042 $column_index++
1044 if (! empty($this->_curField[$column_index])
1045 && ! empty($_REQUEST['Or' . $row_index][$column_index])
1046 && $column_index
1048 $qry_orwhere .= ' '
1049 . /*overload*/mb_strtoupper(
1050 $this->_curAndOrCol[$last_orwhere]
1052 . ' ';
1054 if (! empty($this->_curField[$column_index])
1055 && ! empty($_REQUEST['Or' . $row_index][$column_index])
1057 $qry_orwhere .= '(' . $this->_curField[$column_index]
1058 . ' '
1059 . $_REQUEST['Or' . $row_index][$column_index]
1060 . ')';
1061 $last_orwhere = $column_index;
1062 $criteria_cnt++;
1064 } // end for
1065 if ($criteria_cnt > 1) {
1066 $qry_orwhere = '(' . $qry_orwhere . ')';
1068 if (! empty($qry_orwhere)) {
1069 $where_clause .= "\n"
1070 . /*overload*/mb_strtoupper(
1071 isset($this->_curAndOrRow[$row_index])
1072 ? $this->_curAndOrRow[$row_index] . ' '
1073 : ''
1075 . $qry_orwhere;
1076 } // end if
1077 } // end for
1079 if (! empty($where_clause) && $where_clause != '()') {
1080 $where_clause = 'WHERE ' . htmlspecialchars($where_clause) . "\n";
1081 } // end if
1082 return $where_clause;
1086 * Provides ORDER BY clause for building SQL query
1088 * @return string Order By clause
1090 private function _getOrderByClause()
1092 $orderby_clause = '';
1093 $orderby_clauses = array();
1095 for (
1096 $column_index = 0;
1097 $column_index < $this->_criteria_column_count;
1098 $column_index++
1100 // if all columns are chosen with * selector,
1101 // then sorting isn't available
1102 // Fix for Bug #570698
1103 if (empty($this->_curField[$column_index])
1104 && empty($this->_curSort[$column_index])
1106 continue;
1109 if (/*overload*/mb_substr($this->_curField[$column_index], -2) == '.*') {
1110 continue;
1113 if (! empty($this->_curSort[$column_index])) {
1114 $orderby_clauses[] = $this->_curField[$column_index] . ' '
1115 . $this->_curSort[$column_index];
1117 } // end for
1118 if ($orderby_clauses) {
1119 $orderby_clause = 'ORDER BY '
1120 . htmlspecialchars(implode(", ", $orderby_clauses)) . "\n";
1122 return $orderby_clause;
1126 * Provides UNIQUE columns and INDEX columns present in criteria tables
1128 * @param array $all_tables Tables involved in the search
1129 * @param array $all_columns Columns involved in the search
1130 * @param array $where_clause_columns Columns having criteria where clause
1132 * @return array having UNIQUE and INDEX columns
1134 private function _getIndexes($all_tables, $all_columns,
1135 $where_clause_columns
1137 $unique_columns = array();
1138 $index_columns = array();
1140 foreach ($all_tables as $table) {
1141 $indexes = $GLOBALS['dbi']->getTableIndexes($this->_db, $table);
1142 foreach ($indexes as $index) {
1143 $column = $table . '.' . $index['Column_name'];
1144 if (isset($all_columns[$column])) {
1145 if ($index['Non_unique'] == 0) {
1146 if (isset($where_clause_columns[$column])) {
1147 $unique_columns[$column] = 'Y';
1148 } else {
1149 $unique_columns[$column] = 'N';
1151 } else {
1152 if (isset($where_clause_columns[$column])) {
1153 $index_columns[$column] = 'Y';
1154 } else {
1155 $index_columns[$column] = 'N';
1159 } // end while (each index of a table)
1160 } // end while (each table)
1162 return array(
1163 'unique' => $unique_columns,
1164 'index' => $index_columns
1169 * Provides UNIQUE columns and INDEX columns present in criteria tables
1171 * @param array $all_tables Tables involved in the search
1172 * @param array $all_columns Columns involved in the search
1173 * @param array $where_clause_columns Columns having criteria where clause
1175 * @return array having UNIQUE and INDEX columns
1177 private function _getLeftJoinColumnCandidates($all_tables, $all_columns,
1178 $where_clause_columns
1180 $GLOBALS['dbi']->selectDb($this->_db);
1182 // Get unique columns and index columns
1183 $indexes = $this->_getIndexes(
1184 $all_tables, $all_columns, $where_clause_columns
1186 $unique_columns = $indexes['unique'];
1187 $index_columns = $indexes['index'];
1189 list($candidate_columns, $needsort)
1190 = $this->_getLeftJoinColumnCandidatesBest(
1191 $all_tables, $where_clause_columns, $unique_columns, $index_columns
1194 // If we came up with $unique_columns (very good) or $index_columns (still
1195 // good) as $candidate_columns we want to check if we have any 'Y' there
1196 // (that would mean that they were also found in the whereclauses
1197 // which would be great). if yes, we take only those
1198 if ($needsort != 1) {
1199 return $candidate_columns;
1202 $vg = array();
1203 $sg = array();
1204 foreach ($candidate_columns as $column => $is_where) {
1205 $table = explode('.', $column);
1206 $table = $table[0];
1207 if ($is_where == 'Y') {
1208 $vg[$column] = $table;
1209 } else {
1210 $sg[$column] = $table;
1213 if (count($vg) > 0) {
1214 $candidate_columns = $vg;
1215 // Candidates restricted in index+where
1216 } else {
1217 $candidate_columns = $sg;
1218 // None of the candidates where in a where-clause
1221 return $candidate_columns;
1225 * Provides the main table to form the LEFT JOIN clause
1227 * @param array $all_tables Tables involved in the search
1228 * @param array $all_columns Columns involved in the search
1229 * @param array $where_clause_columns Columns having criteria where clause
1230 * @param array $where_clause_tables Tables having criteria where clause
1232 * @return string table name
1234 private function _getMasterTable($all_tables, $all_columns,
1235 $where_clause_columns, $where_clause_tables
1237 if (count($where_clause_tables) == 1) {
1238 // If there is exactly one column that has a decent where-clause
1239 // we will just use this
1240 $master = key($where_clause_tables);
1241 return $master;
1244 // Now let's find out which of the tables has an index
1245 // (When the control user is the same as the normal user
1246 // because he is using one of his databases as pmadb,
1247 // the last db selected is not always the one where we need to work)
1248 $candidate_columns = $this->_getLeftJoinColumnCandidates(
1249 $all_tables, $all_columns, $where_clause_columns
1252 // Generally, we need to display all the rows of foreign (referenced)
1253 // table, whether they have any matching row in child table or not.
1254 // So we select candidate tables which are foreign tables.
1255 $foreign_tables = array();
1256 foreach ($candidate_columns as $one_table) {
1257 $foreigners = PMA_getForeigners($this->_db, $one_table);
1258 foreach ($foreigners as $key => $foreigner) {
1259 if ($key != 'foreign_keys_data') {
1260 if (in_array($foreigner['foreign_table'], $candidate_columns)) {
1261 $foreign_tables[$foreigner['foreign_table']]
1262 = $foreigner['foreign_table'];
1264 continue;
1266 foreach ($foreigner as $one_key) {
1267 if (in_array($one_key['ref_table_name'], $candidate_columns)) {
1268 $foreign_tables[$one_key['ref_table_name']]
1269 = $one_key['ref_table_name'];
1274 if (count($foreign_tables)) {
1275 $candidate_columns = $foreign_tables;
1278 // If our array of candidates has more than one member we'll just
1279 // find the smallest table.
1280 // Of course the actual query would be faster if we check for
1281 // the Criteria which gives the smallest result set in its table,
1282 // but it would take too much time to check this
1283 if (!(count($candidate_columns) > 1)) {
1284 reset($candidate_columns);
1285 $master = current($candidate_columns); // Only one single candidate
1286 return $master;
1289 // Of course we only want to check each table once
1290 $checked_tables = $candidate_columns;
1291 $tsize = array();
1292 $csize = array();
1293 foreach ($candidate_columns as $table) {
1294 if ($checked_tables[$table] != 1) {
1295 $tsize[$table] = PMA_Table::countRecords(
1296 $this->_db,
1297 $table,
1298 false
1300 $checked_tables[$table] = 1;
1302 $csize[$table] = $tsize[$table];
1304 arsort($csize);
1305 reset($csize);
1306 $master = key($csize); // Largest
1308 return $master;
1312 * Provides columns and tables that have valid where clause criteria
1314 * @return array
1316 private function _getWhereClauseTablesAndColumns()
1318 $where_clause_columns = array();
1319 $where_clause_tables = array();
1321 // Now we need all tables that we have in the where clause
1322 for (
1323 $column_index = 0, $nb = count($this->_criteria);
1324 $column_index < $nb;
1325 $column_index++
1327 $current_table = explode('.', $_POST['criteriaColumn'][$column_index]);
1328 if (empty($current_table[0]) || empty($current_table[1])) {
1329 continue;
1330 } // end if
1331 $table = str_replace('`', '', $current_table[0]);
1332 $column = str_replace('`', '', $current_table[1]);
1333 $column = $table . '.' . $column;
1334 // Now we know that our array has the same numbers as $criteria
1335 // we can check which of our columns has a where clause
1336 if (! empty($this->_criteria[$column_index])) {
1337 if (/*overload*/mb_substr($this->_criteria[$column_index], 0, 1) == '='
1338 || /*$pmaString->*/stristr($this->_criteria[$column_index], 'is')
1340 $where_clause_columns[$column] = $column;
1341 $where_clause_tables[$table] = $table;
1343 } // end if
1344 } // end for
1345 return array(
1346 'where_clause_tables' => $where_clause_tables,
1347 'where_clause_columns' => $where_clause_columns
1352 * Provides FROM clause for building SQL query
1354 * @return string FROM clause
1356 private function _getFromClause()
1358 $from_clause = '';
1359 if (isset($_POST['criteriaColumn']) && count($_POST['criteriaColumn']) > 0) {
1360 // Initialize some variables
1361 $all_tables = $all_columns = array();
1363 // We only start this if we have fields, otherwise it would be dumb
1364 foreach ($_POST['criteriaColumn'] as $value) {
1365 $parts = explode('.', $value);
1366 if (! empty($parts[0]) && ! empty($parts[1])) {
1367 $table = str_replace('`', '', $parts[0]);
1368 $all_tables[$table] = $table;
1369 $all_columns[] = $table . '.' . str_replace('`', '', $parts[1]);
1371 } // end while
1373 // Create LEFT JOINS out of Relations
1374 if (count($all_tables) > 0) {
1375 // Get tables and columns with valid where clauses
1376 $valid_where_clauses = $this->_getWhereClauseTablesAndColumns();
1377 $where_clause_tables = $valid_where_clauses['where_clause_tables'];
1378 $where_clause_columns = $valid_where_clauses['where_clause_columns'];
1379 // Get master table
1380 $master = $this->_getMasterTable(
1381 $all_tables, $all_columns,
1382 $where_clause_columns, $where_clause_tables
1384 $from_clause = PMA_Util::backquote($master)
1385 . PMA_getRelatives($all_tables, $master);
1387 } // end if (count($all_tables) > 0)
1388 } // end count($_POST['criteriaColumn']) > 0
1390 // In case relations are not defined, just generate the FROM clause
1391 // from the list of tables, however we don't generate any JOIN
1392 if (empty($from_clause) && isset($all_tables)) {
1393 $from_clause = implode(', ', $all_tables);
1395 return $from_clause;
1399 * Provides the generated SQL query
1401 * @return string SQL query
1403 private function _getSQLQuery()
1405 $sql_query = '';
1406 // get SELECT clause
1407 $sql_query .= $this->_getSelectClause();
1408 // get FROM clause
1409 $from_clause = $this->_getFromClause();
1410 if (! empty($from_clause)) {
1411 $sql_query .= 'FROM ' . htmlspecialchars($from_clause) . "\n";
1413 // get WHERE clause
1414 $sql_query .= $this->_getWhereClause();
1415 // get ORDER BY clause
1416 $sql_query .= $this->_getOrderByClause();
1417 return $sql_query;
1421 * Provides the generated QBE form
1423 * @return string QBE form
1425 public function getSelectionForm()
1427 $html_output = '<form action="db_qbe.php" method="post" id="formQBE">';
1428 $html_output .= '<fieldset>';
1430 if ($GLOBALS['cfgRelation']['savedsearcheswork']) {
1431 $html_output .= $this->_getSavedSearchesField();
1434 $html_output .= '<table class="data" style="width: 100%;">';
1435 // Get table's <tr> elements
1436 $html_output .= $this->_getColumnNamesRow();
1437 $html_output .= $this->_getSortRow();
1438 $html_output .= $this->_getShowRow();
1439 $html_output .= $this->_getCriteriaInputboxRow();
1440 $html_output .= $this->_getInsDelAndOrCriteriaRows();
1441 $html_output .= $this->_getModifyColumnsRow();
1442 $html_output .= '</table>';
1443 $this->_new_row_count--;
1444 $url_params = array();
1445 $url_params['db'] = $this->_db;
1446 $url_params['criteriaColumnCount'] = $this->_new_column_count;
1447 $url_params['rows'] = $this->_new_row_count;
1448 $html_output .= PMA_URL_getHiddenInputs($url_params);
1449 $html_output .= '</fieldset>';
1450 // get footers
1451 $html_output .= $this->_getTableFooters();
1452 // get tables select list
1453 $html_output .= $this->_getTablesList();
1454 $html_output .= '</form>';
1455 $html_output .= '<form action="db_qbe.php" method="post">';
1456 $html_output .= PMA_URL_getHiddenInputs(array('db' => $this->_db));
1457 // get SQL query
1458 $html_output .= '<div class="floatleft">';
1459 $html_output .= '<fieldset>';
1460 $html_output .= '<legend>'
1461 . sprintf(
1462 __('SQL query on database <b>%s</b>:'),
1463 PMA_Util::getDbLink($this->_db)
1465 $html_output .= '</legend>';
1466 $text_dir = 'ltr';
1467 $html_output .= '<textarea cols="80" name="sql_query" id="textSqlquery"'
1468 . ' rows="' . ((count($this->_criteriaTables) > 30) ? '15' : '7') . '"'
1469 . ' dir="' . $text_dir . '">';
1470 $html_output .= $this->_getSQLQuery();
1471 $html_output .= '</textarea>';
1472 $html_output .= '</fieldset>';
1473 // displays form's footers
1474 $html_output .= '<fieldset class="tblFooters">';
1475 $html_output .= '<input type="hidden" name="submit_sql" value="1" />';
1476 $html_output .= '<input type="submit" value="' . __('Submit Query') . '" />';
1477 $html_output .= '</fieldset>';
1478 $html_output .= '</div>';
1479 $html_output .= '</form>';
1480 return $html_output;
1484 * Get fields to display
1486 * @return string
1488 private function _getSavedSearchesField()
1490 $html_output = __('Saved bookmarked search:');
1491 $html_output .= ' <select name="searchId" id="searchId">';
1492 $html_output .= '<option value="">' . __('New bookmark') . '</option>';
1494 $currentSearch = $this->_getCurrentSearch();
1495 $currentSearchId = null;
1496 $currentSearchName = null;
1497 if (null != $currentSearch) {
1498 $currentSearchId = $currentSearch->getId();
1499 $currentSearchName = $currentSearch->getSearchName();
1502 foreach ($this->_savedSearchList as $id => $name) {
1503 $html_output .= '<option value="' . htmlspecialchars($id)
1504 . '" ' . (
1505 $id == $currentSearchId
1506 ? 'selected="selected" '
1507 : ''
1509 . '>'
1510 . htmlspecialchars($name)
1511 . '</option>';
1513 $html_output .= '</select>';
1514 $html_output .= '<input type="text" name="searchName" id="searchName" '
1515 . 'value="' . $currentSearchName . '" />';
1516 $html_output .= '<input type="hidden" name="action" id="action" value="" />';
1517 $html_output .= '<input type="submit" name="saveSearch" id="saveSearch" '
1518 . 'value="' . __('Create bookmark') . '" />';
1519 if (null !== $currentSearchId) {
1520 $html_output .= '<input type="submit" name="updateSearch" '
1521 . 'id="updateSearch" value="' . __('Update bookmark') . '" />';
1522 $html_output .= '<input type="submit" name="deleteSearch" '
1523 . 'id="deleteSearch" value="' . __('Delete bookmark') . '" />';
1526 return $html_output;
1530 * Initialize _criteria_column_count
1532 * @return int Previous number of columns
1534 private function _initializeCriteriasCount()
1536 // sets column count
1537 $criteriaColumnCount = PMA_ifSetOr(
1538 $_REQUEST['criteriaColumnCount'],
1540 'numeric'
1542 $criteriaColumnAdd = PMA_ifSetOr(
1543 $_REQUEST['criteriaColumnAdd'],
1545 'numeric'
1547 $this->_criteria_column_count = max(
1548 $criteriaColumnCount + $criteriaColumnAdd,
1552 // sets row count
1553 $rows = PMA_ifSetOr($_REQUEST['rows'], 0, 'numeric');
1554 $criteriaRowAdd = PMA_ifSetOr($_REQUEST['criteriaRowAdd'], 0, 'numeric');
1555 $this->_criteria_row_count = max($rows + $criteriaRowAdd, 0);
1557 return $criteriaColumnCount;
1561 * Get best
1563 * @param array $all_tables All tables
1564 * @param array $where_clause_columns Columns with where clause
1565 * @param array $unique_columns Unique columns
1566 * @param array $index_columns Indexed columns
1568 * @return array
1570 private function _getLeftJoinColumnCandidatesBest(
1571 $all_tables, $where_clause_columns, $unique_columns, $index_columns
1573 // now we want to find the best.
1574 if (isset($unique_columns) && count($unique_columns) > 0) {
1575 $candidate_columns = $unique_columns;
1576 $needsort = 1;
1577 return array($candidate_columns, $needsort);
1578 } elseif (isset($index_columns) && count($index_columns) > 0) {
1579 $candidate_columns = $index_columns;
1580 $needsort = 1;
1581 return array($candidate_columns, $needsort);
1582 } elseif (isset($where_clause_columns) && count($where_clause_columns) > 0) {
1583 $candidate_columns = $where_clause_columns;
1584 $needsort = 0;
1585 return array($candidate_columns, $needsort);
1586 } else {
1587 $candidate_columns = $all_tables;
1588 $needsort = 0;
1589 return array($candidate_columns, $needsort);