4 require_once('lib/ErrorManager.php');
5 require_once('lib/WikiDB/backend/PearDB.php');
7 if (!defined("USE_BYTEA")) // see schemas/psql-initialize.sql
8 define("USE_BYTEA", true);
9 //define("USE_BYTEA", false);
12 Since 1.3.12 changed to use:
18 class WikiDB_backend_PearDB_pgsql
19 extends WikiDB_backend_PearDB
21 function WikiDB_backend_PearDB_pgsql($dbparams) {
22 // The pgsql handler of (at least my version of) the PEAR::DB
23 // library generates three warnings when a database is opened:
25 // Undefined index: options
26 // Undefined index: tty
27 // Undefined index: port
29 // This stuff is all just to catch and ignore these warnings,
30 // so that they don't get reported to the user. (They are
31 // not consequential.)
34 $ErrorManager->pushErrorHandler(new WikiMethodCb($this,'_pgsql_open_error'));
35 $this->WikiDB_backend_PearDB($dbparams);
36 $ErrorManager->popErrorHandler();
39 function _pgsql_open_error($error) {
40 if (preg_match('/^Undefined\s+index:\s+(options|tty|port)/',
42 return true; // Ignore error
48 * NOTE: Only the table owner can do this. Either fix the schema or setup autovacuum.
51 return 0; // if the wikiuser is not the table owner
53 foreach ($this->_table_names as $table) {
54 $this->_dbh->query("VACUUM ANALYZE $table");
61 return pg_escape_bytea($s);
62 if (function_exists('pg_escape_string'))
63 return pg_escape_string($s);
65 return base64_encode($s);
68 function _unquote($s) {
70 return pg_unescape_bytea($s);
71 if (function_exists('pg_escape_string'))
74 return base64_decode($s);
77 // Until the binary escape problems on pear pgsql are solved */
78 function get_cached_html($pagename) {
80 $page_tbl = $this->_table_names['page_tbl'];
81 $data = $dbh->GetOne(sprintf("SELECT cached_html FROM $page_tbl WHERE pagename='%s'",
82 $dbh->escapeSimple($pagename)));
83 if ($data) return $this->_unquote($data);
87 function set_cached_html($pagename, $data) {
89 $page_tbl = $this->_table_names['page_tbl'];
91 $sth = $dbh->query(sprintf("UPDATE $page_tbl"
92 . " SET cached_html='%s'"
93 . " WHERE pagename='%s'",
95 $dbh->escapeSimple($pagename)));
97 $sth = $dbh->query("UPDATE $page_tbl"
98 . " SET cached_html=?"
99 . " WHERE pagename=?",
100 // PearDB does NOT use pg_escape_string()! Oh dear.
101 array($this->_quote($data), $pagename));
105 * Create a new revision of a page.
107 function _todo_set_versiondata($pagename, $version, $data) {
109 $version_tbl = $this->_table_names['version_tbl'];
111 $minor_edit = (int) !empty($data['is_minor_edit']);
112 unset($data['is_minor_edit']);
114 $mtime = (int)$data['mtime'];
115 unset($data['mtime']);
116 assert(!empty($mtime));
118 @$content = (string) $data['%content'];
119 unset($data['%content']);
120 unset($data['%pagedata']);
123 $id = $this->_get_pageid($pagename, true);
124 $dbh->query(sprintf("DELETE FROM version WHERE id=%d AND version=%d", $id, $version));
125 $dbh->query(sprintf("INSERT INTO version (id,version,mtime,minor_edit,content,versiondata)" .
126 " VALUES (%d, %d, %d, %d, '%s', '%s')",
127 $id, $version, $mtime, $minor_edit,
128 $this->_quote($content),
129 $this->_serialize($data)));
130 // TODO: This function does not work yet
131 $dbh->query(sprintf("SELECT update_recent (%d, %d)", $id, $version));
136 * Delete an old revision of a page.
138 function _todo_delete_versiondata($pagename, $version) {
140 // TODO: This function was removed
141 $dbh->query(sprintf("SELECT delete_versiondata (%d, %d)", $id, $version));
145 * Rename page in the database.
147 function _todo_rename_page ($pagename, $to) {
149 extract($this->_table_names);
152 if (($id = $this->_get_pageid($pagename, false)) ) {
153 if ($new = $this->_get_pageid($to, false)) {
155 // This page does not exist (already verified before), but exists in the page table.
156 // So we delete this page in one step.
157 $dbh->query("SELECT prepare_rename_page($id, $new)");
159 $dbh->query(sprintf("UPDATE $page_tbl SET pagename='%s' WHERE id=$id",
160 $dbh->escapeSimple($to)));
167 * Lock all tables we might use.
169 function _lock_tables($write_lock=true) {
170 $this->_dbh->query("BEGIN");
176 function _unlock_tables() {
177 $this->_dbh->query("COMMIT");
183 function _serialize($data) {
186 assert(is_array($data));
187 return $this->_quote(serialize($data));
193 function _unserialize($data) {
196 // Base64 encoded data does not contain colons.
197 // (only alphanumerics and '+' and '/'.)
198 if (substr($data,0,2) == 'a:')
199 return unserialize($data);
200 return unserialize($this->_unquote($data));
206 function text_search($search, $fulltext=false, $sortby='', $limit='',
210 extract($this->_table_names);
211 $orderby = $this->sortby($sortby, 'db');
212 if ($sortby and $orderby) $orderby = ' ORDER BY ' . $orderby;
214 $searchclass = get_class($this)."_search";
215 // no need to define it everywhere and then fallback. memory!
216 if (!class_exists($searchclass))
217 $searchclass = "WikiDB_backend_PearDB_search";
218 $searchobj = new $searchclass($search, $dbh);
220 $table = "$nonempty_tbl, $page_tbl";
221 $join_clause = "$nonempty_tbl.id=$page_tbl.id";
222 $fields = $this->page_tbl_fields;
225 $table .= ", $recent_tbl";
226 $join_clause .= " AND $page_tbl.id=$recent_tbl.id";
228 $table .= ", $version_tbl";
229 $join_clause .= " AND $page_tbl.id=$version_tbl.id AND latestversion=version";
231 $fields .= ", $page_tbl.pagedata as pagedata, " . $this->version_tbl_fields;
232 // TODO: title still ignored, need better rank and subselect
233 $callback = new WikiMethodCb($searchobj, "_fulltext_match_clause");
234 $search_string = $search->makeTsearch2SqlClauseObj($callback);
235 $search_string = str_replace(array("%"," "), array("","&"), $search_string);
236 $search_clause = "idxFTI @@ to_tsquery('$search_string')";
238 $orderby = " ORDER BY rank(idxFTI, to_tsquery('$search_string')) DESC";
240 $callback = new WikiMethodCb($searchobj, "_pagename_match_clause");
241 $search_clause = $search->makeSqlClauseObj($callback);
244 $sql = "SELECT $fields FROM $table"
245 . " WHERE $join_clause"
246 . " AND ($search_clause)"
249 list($from, $count) = $this->limit($limit);
250 $result = $dbh->limitQuery($sql, $from, $count);
252 $result = $dbh->query($sql);
255 $iter = new WikiDB_backend_PearDB_iter($this, $result);
256 $iter->stoplisted = @$searchobj->stoplisted;
262 class WikiDB_backend_PearDB_pgsql_search
263 extends WikiDB_backend_PearDB_search
265 function _pagename_match_clause($node) {
266 $word = $node->sql();
267 if ($node->op == 'REGEX') { // posix regex extensions
268 return ($this->_case_exact
269 ? "pagename ~* '$word'"
270 : "pagename ~ '$word'");
272 return ($this->_case_exact
273 ? "pagename LIKE '$word'"
274 : "pagename ILIKE '$word'");
280 select * from stat('select idxfti from version') order by ndoc desc, nentry desc, word limit 10;
282 -----------------+------+--------
285 phpwikidocument | 62 | 62
296 * use tsearch2. See schemas/psql-tsearch2.sql and /usr/share/postgresql/contrib/tsearch2.sql
297 * TODO: don't parse the words into nodes. rather replace "[ +]" with & and "-" with "!" and " or " with "|"
298 * tsearch2 query language: @@ "word | word", "word & word", ! word
299 * ~* '.*something that does not exist.*'
302 phrase search for "history lesson":
304 SELECT id FROM tab WHERE ts_idx_col @@ to_tsquery('history&lesson')
305 AND text_col ~* '.*history\\s+lesson.*';
307 The full-text index will still be used, and the regex will be used to
308 prune the results afterwards.
310 function _fulltext_match_clause($node) {
311 $word = strtolower($node->word);
312 $word = str_replace(" ", "&", $word); // phrase fix
315 // clause specified above.
316 return $this->_pagename_match_clause($node) . " OR idxFTI @@ to_tsquery('$word')";
320 // (c-file-style: "gnu")
325 // c-hanging-comment-ender-p: nil
326 // indent-tabs-mode: nil