# Copyright (C) 2007 Jason Woofenden
#
-# This file is part of wfpl.
-#
-# wfpl is free software; you can redistribute it and/or modify it under the
-# terms of the GNU Lesser General Public License as published by the Free
-# Software Foundation; either version 2.1 of the License, or (at your option)
-# any later version.
-#
-# wfpl is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
-# more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with wfpl; if not, write to the Free Software Foundation, Inc., 51
-# Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
# This file contains code to use a web-writeable directory full of files as a
# very simple database.
# Keys are truncated to 32 bytes, made lowercase, and all characters that are
-# not alpha/numeric are replaced with underscores.
+# not alpha/numeric are replaced with underscores. Periods and hyphens are only
+# replaced if they are at the begining.
# Data can be either a string or an array.
# fdb_set_dir() passing the path to that directory.
+require_once(__DIR__ . '/file.php');
+require_once(__DIR__ . '/binary.php');
+
# call this to set what directory is used to store the files
function fdb_set_dir($dir) {
$GLOBALS['fdb_dir'] = $dir;
return $GLOBALS['fdb_dir'];
}
-# return a 4 bytes that represent the passed integer as a big-endian binary number
-function to_raw_int($int) {
- return chr($int >> 24) . chr(($int >> 16) & 0xff) . chr(($int >> 8) & 0xff) . chr($int & 0xff);
-}
-
-# return a php number from the string you pass in. The first 4 bytes of the
-# string are read in as a binary value in big-endian format.
-function from_raw_int($quad) {
- return (ord(substr($quad, 0, 1)) << 24) + (ord(substr($quad, 1, 1)) << 16) + (ord(substr($quad, 2, 1)) << 8) + ord(substr($quad, 3, 1));
-}
-
-function int_at($string, $index) {
- return from_raw_int(substr($string, $index * 4, 4));
-}
-# remove the first 4 bytes of the string, and return them as an int
-function pop_int($&string) {
- $int = from_raw_int(substring($string, 0 4));
- $string = substr($string, 4);
- return $int;
+function fdb_fix_key($key) {
+ $key = ereg_replace('[^a-z0-9.-]', '_', strtolower($key));
+ $key = ereg_replace('^[-.]', '_', strtolower($key));
+ return substr($key, 0, 32);
}
-
function fdb_get_raw($key) {
$key = fdb_fix_key($key);
return read_whole_file_or_false(fdb_get_dir() . "/$key");
# like fdb_get() except it returns an array even when there's just one element
function fdb_geta($key) {
$key = fdb_fix_key($key);
- $data = fd_get_raw($key);
+ $data = fdb_get_raw($key);
if($data === false) {
return false;
}
- $header_count = pop_int($data);
- $out = array();
- while($header_count--) {
- $size = int_at($data);
- $out[] = substr($data, 0, $size);
- $data = substr($data, $size);
- }
- return $out;
+ return raw_to_array($data);
}
# returns:
# array in this case too)
function fdb_get($key) {
$ret = fdb_geta($key);
+ if($ret == false) {
+ return false;
+ }
if(count($ret) == 1) {
return $ret[0];
} else {
}
# data can be a string or array
-function fdb_put($key, $data) {
+function fdb_set($key, $data) {
$key = fdb_fix_key($key);
if(!is_array($data)) {
$data = array($data);
}
- $out = to_raw_int(count($data));
- foreach($data as $dat) {
- $out .= to_raw_int(strlen($dat));
- $out .= $dat;
+ fdb_set_raw($key, array_to_raw($data));
+}
+
+function fdb_delete($key) {
+ $key = fdb_fix_key($key);
+ $path = fdb_get_dir() . "/$key";
+ if(file_exists($path)) {
+ return unlink($path);
}
- return $out;
+ return false;
}
?>