2002-08-06 Robin Johnson <robbat2@users.sourceforge.net>

* libraries/sqlvalidator.php3, libraries/sqlvalidator.lib.php3: - Renamed libraries/sqlvalidator.php3 to libraries/sqlvalidator.lib.php3
2002-08-07 03:08:43 +00:00
parent 82e5545760
commit c6f8143fe4
2 changed files with 7 additions and 1 deletions
--- a/libraries/sqlvalidator.lib.php3
+++ b/libraries/sqlvalidator.lib.php3
@@ -0,0 +1,99 @@
+<?php
+/* $Id$ */
+
+
+/**
+ * SQL Validator interface for phpMyAdmin
+ *
+ * Copyright 2002 Robin Johnson <robbat2@users.sourceforge.net>
+ * http://www.orbis-terrarum.net/?l=people.robbat2
+ *
+ * This function uses the Mimer SQL Validator service
+ * <http://developer.mimer.com/validator/index.htm> from phpMyAdmin
+ *
+ * Copyright for Server side validator systems:
+ * "All SQL statements are stored anonymously for statistical purposes.
+ * Mimer SQL Validator, Copyright 2002 Upright Database Technology.
+ * All rights reserved."
+ *
+ * All data is transported over HTTP-SOAP
+ * And uses the PEAR SOAP Module
+ *
+ * Install instructions for PEAR SOAP
+ * Make sure you have a really recent PHP with PEAR support
+ * run this: "pear install Mail_Mime Net_DIME SOAP"
+ *
+ * Enable the SQL Validator options in the configuration file
+ * $cfg['SQLQuery']['Validate'] = TRUE;
+ * $cfg['SQLValidator']['use']  = FALSE;
+ *
+ * Also set a username and password if you have a private one
+ */
+
+
+if (!defined('PMA_SQL_VALIDATOR_INCLUDED')) {
+    define('PMA_SQL_VALIDATOR_INCLUDED', 1);
+
+    // We need the PEAR libraries, so do a minimum version check first
+    // I'm not sure if PEAR was available before this point
+    // For now we actually use a configuration flag
+    if ($cfg['SQLValidator']['use'] == TRUE)  {
+        // We cannot check && !defined(PMA_SQL_VALIDATOR_CLASS_INCLUDED))
+        // as it will produce a nasty warning message
+        include('./libraries/sqlvalidator.class.php3');
+    } // if ($cfg['SQLValidator']['use'] == TRUE)
+
+
+    /**
+     * This function utilizes the Mimer SQL Validator service
+     * to validate an SQL query
+     *
+     * <http://developer.mimer.com/validator/index.htm>
+     *
+     * @param   string   SQL query to validate
+     *
+     * @return  string   Validator result string
+     *
+     * @global  array    The PMA configuration array
+     */
+    function PMA_validateSQL($sql)
+    {
+        global $cfg;
+
+        $str = '';
+
+        if ($cfg['SQLValidator']['use'] == TRUE) {
+            // create new class instance
+            $srv = new PMA_SQLValidator();
+
+            // Checks for username settings
+            // The class defaults to anonymous with an empty password
+            // automatically
+            if ($cfg['SQLValidator']['username'] != '') {
+                $srv->setCredentials($cfg['SQLValidator']['username'], $cfg['SQLValidator']['password']);
+            }
+
+            // Identify ourselves to the server properly...
+            $srv->appendCallingProgram('phpMyAdmin', PMA_VERSION);
+
+            // ... and specify what database system we are using
+            $srv->setTargetDbms('MySQL', PMA_MYSQL_STR_VERSION);
+
+            // Log on to service
+            $srv->start();
+
+            // Do service validation
+            $str = $srv->validationString($sql);
+
+        } else {
+            // The service is not available so note that properly
+            $str = $GLOBALS['strValidatorDisabled'];
+        } // end if... else...
+
+        // Gives string back to caller
+        return $str;
+    } // end of the "PMA_validateSQL()" function
+
+} // $__PMA_SQL_VALIDATOR__
+
+?>