5 * Copyright © 2004 Brion Vibber <brion@pobox.com>
6 * https://www.mediawiki.org/
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 * http://www.gnu.org/copyleft/gpl.html
28 * Search engine hook base class for Oracle (ConText).
31 class SearchOracle
extends SearchDatabase
{
32 private $reservedWords = array(
62 * Perform a full text search query and return a result set.
64 * @param string $term Raw search term
65 * @return SqlSearchResultSet
67 function searchText( $term ) {
69 return new SqlSearchResultSet( false, '' );
72 $resultSet = $this->db
->resultObject(
73 $this->db
->query( $this->getQuery( $this->filter( $term ), true ) )
76 return new SqlSearchResultSet( $resultSet, $this->searchTerms
);
80 * Perform a title-only search query and return a result set.
82 * @param string $term Raw search term
83 * @return SqlSearchResultSet
85 function searchTitle( $term ) {
87 return new SqlSearchResultSet( false, '' );
90 $resultSet = $this->db
->resultObject(
91 $this->db
->query( $this->getQuery( $this->filter( $term ), false ) )
94 return new SqlSearchResultSet( $resultSet, $this->searchTerms
);
98 * Return a partial WHERE clause to limit the search to the given namespaces
101 function queryNamespaces() {
102 if ( is_null( $this->namespaces
) ) {
105 if ( !count( $this->namespaces
) ) {
108 $namespaces = $this->db
->makeList( $this->namespaces
);
110 return 'AND page_namespace IN (' . $namespaces . ')';
114 * Return a LIMIT clause to limit results on the query.
120 function queryLimit( $sql ) {
121 return $this->db
->limitResult( $sql, $this->limit
, $this->offset
);
125 * Does not do anything for generic search engine
126 * subclasses may define this though
128 * @param string $filteredTerm
129 * @param bool $fulltext
132 function queryRanking( $filteredTerm, $fulltext ) {
133 return ' ORDER BY score(1)';
137 * Construct the full SQL query to do the search.
138 * The guts shoulds be constructed in queryMain()
139 * @param string $filteredTerm
140 * @param bool $fulltext
143 function getQuery( $filteredTerm, $fulltext ) {
144 return $this->queryLimit( $this->queryMain( $filteredTerm, $fulltext ) . ' ' .
145 $this->queryNamespaces() . ' ' .
146 $this->queryRanking( $filteredTerm, $fulltext ) . ' ' );
150 * Picks which field to index on, depending on what type of query.
151 * @param bool $fulltext
154 function getIndexField( $fulltext ) {
155 return $fulltext ?
'si_text' : 'si_title';
159 * Get the base part of the search query.
161 * @param string $filteredTerm
162 * @param bool $fulltext
165 function queryMain( $filteredTerm, $fulltext ) {
166 $match = $this->parseQuery( $filteredTerm, $fulltext );
167 $page = $this->db
->tableName( 'page' );
168 $searchindex = $this->db
->tableName( 'searchindex' );
169 return 'SELECT page_id, page_namespace, page_title ' .
170 "FROM $page,$searchindex " .
171 'WHERE page_id=si_page AND ' . $match;
175 * Parse a user input search string, and return an SQL fragment to be used
176 * as part of a WHERE clause
177 * @param string $filteredText
178 * @param bool $fulltext
181 function parseQuery( $filteredText, $fulltext ) {
183 $lc = $this->legalSearchChars();
184 $this->searchTerms
= array();
186 # @todo FIXME: This doesn't handle parenthetical expressions.
189 if ( preg_match_all( '/([-+<>~]?)(([' . $lc . ']+)(\*?)|"[^"]*")/',
190 $filteredText, $m, PREG_SET_ORDER
) ) {
191 foreach ( $m as $terms ) {
192 // Search terms in all variant forms, only
193 // apply on wiki with LanguageConverter
194 $temp_terms = $wgContLang->autoConvertToAllVariants( $terms[2] );
195 if ( is_array( $temp_terms ) ) {
196 $temp_terms = array_unique( array_values( $temp_terms ) );
197 foreach ( $temp_terms as $t ) {
198 $searchon .= ( $terms[1] == '-' ?
' ~' : ' & ' ) . $this->escapeTerm( $t );
202 $searchon .= ( $terms[1] == '-' ?
' ~' : ' & ' ) . $this->escapeTerm( $terms[2] );
204 if ( !empty( $terms[3] ) ) {
205 $regexp = preg_quote( $terms[3], '/' );
207 $regexp .= "[0-9A-Za-z_]+";
210 $regexp = preg_quote( str_replace( '"', '', $terms[2] ), '/' );
212 $this->searchTerms
[] = $regexp;
216 $searchon = $this->db
->addQuotes( ltrim( $searchon, ' &' ) );
217 $field = $this->getIndexField( $fulltext );
218 return " CONTAINS($field, $searchon, 1) > 0 ";
221 private function escapeTerm( $t ) {
223 $t = $wgContLang->normalizeForSearch( $t );
224 $t = isset( $this->reservedWords
[strtoupper( $t )] ) ?
'{' . $t . '}' : $t;
225 $t = preg_replace( '/^"(.*)"$/', '($1)', $t );
226 $t = preg_replace( '/([-&|])/', '\\\\$1', $t );
231 * Create or update the search index record for the given page.
232 * Title and text should be pre-processed.
235 * @param string $title
236 * @param string $text
238 function update( $id, $title, $text ) {
239 $dbw = wfGetDB( DB_MASTER
);
240 $dbw->replace( 'searchindex',
244 'si_title' => $title,
246 ), 'SearchOracle::update' );
249 // We need to specify the DB name (i.e. user/schema) here so that
250 // it can work from the installer, where
251 // ALTER SESSION SET CURRENT_SCHEMA = ...
253 $dbw->query( "CALL ctx_ddl.sync_index(" .
254 $dbw->addQuotes( $dbw->getDBname() . '.' . $dbw->tableName( 'si_text_idx', 'raw' ) ) . ")" );
255 $dbw->query( "CALL ctx_ddl.sync_index(" .
256 $dbw->addQuotes( $dbw->getDBname() . '.' . $dbw->tableName( 'si_title_idx', 'raw' ) ) . ")" );
260 * Update a search index record's title only.
261 * Title should be pre-processed.
264 * @param string $title
266 function updateTitle( $id, $title ) {
267 $dbw = wfGetDB( DB_MASTER
);
269 $dbw->update( 'searchindex',
270 array( 'si_title' => $title ),
271 array( 'si_page' => $id ),
272 'SearchOracle::updateTitle',
276 public static function legalSearchChars() {
277 return "\"" . parent
::legalSearchChars();