Slight rewrite of php_self()
[squirrelmail.git] / functions / global.php
index ebcfb98d7aa4260ea44008f43aea5c2270ddf8b9..5d0c0b831e4bc3c16d24870ad92194cdb840bc21 100644 (file)
@@ -670,49 +670,56 @@ if (!function_exists('session_regenerate_id')) {
 /**
  * php_self
  *
- * Creates an URL for the page calling this function, using either the PHP global
- * REQUEST_URI, or the PHP global PHP_SELF with QUERY_STRING added. Before 1.5.1
- * function was stored in function/strings.php.
+ * Attempts to determine the path and filename and any arguments
+ * for the currently executing script.  This is usually found in
+ * $_SERVER['REQUEST_URI'], but some environments may differ, so 
+ * this function tries to standardize this value.
+ *
+ * Note that before SquirrelMail version 1.5.1, this function was
+ * stored in function/strings.php.
  *
- * @return string the complete url for this page
  * @since 1.2.3
+ * @return string The path, filename and any arguments for the
+ *                current script
  */
-function php_self () {
+function php_self() {
+
+    $request_uri = '';
 
-    if (sqgetGlobalVar('PHP_SELF', $php_self, SQ_SERVER)
-     && !empty($php_self)) {
+    // first try $_SERVER['PHP_SELF'], which seems most reliable
+    // (albeit it usually won't include the query string)
+    //
+    $request_uri = ''; 
+    if (!sqgetGlobalVar('PHP_SELF', $request_uri, SQ_SERVER)
+     || empty($request_uri)) { 
 
-        // need to add query string to end of PHP_SELF to match REQUEST_URI
+        // well, then let's try $_SERVER['REQUEST_URI']
         //
-        if (sqgetGlobalVar('QUERY_STRING', $query_string, SQ_SERVER)
-         && !empty($query_string)) {
-            $php_self .= '?' . $query_string;
+        $request_uri = '';
+        if (!sqgetGlobalVar('REQUEST_URI', $request_uri, SQ_SERVER)
+         || empty($request_uri)) { 
+
+            // TODO: anyone have any other ideas?  maybe $_SERVER['SCRIPT_NAME']???
+            //
+            return '';
         }
 
-        return $php_self;
     }
 
-    // some versions of PHP, perhaps specifically in use with lighttpd,
-    // return a blank string for PHP_SELF, so we use REQUEST_URI as a backup:
-    // 
-    else if (sqgetGlobalVar('REQUEST_URI', $req_uri, SQ_SERVER)
-          && !empty($req_uri)) {
+    // we may or may not have any query arguments, depending on 
+    // which environment variable was used above, and the PHP
+    // version, etc., so let's check for it now
+    //
+    $query_string = '';
+    if (strpos($request_uri, '?') === FALSE
+     && sqgetGlobalVar('QUERY_STRING', $query_string, SQ_SERVER)
+     && !empty($query_string)) {
 
-        // some versions of PHP (such as 4.4.4) don't include the query
-        // string in REQUEST_URI, but most do... here's a fix for the
-        // odd ones out (assuming QUERY_STRING is reliable in those cases)
-        //
-        if (strpos($req_uri, '?') === FALSE
-         && sqgetGlobalVar('QUERY_STRING', $query_string, SQ_SERVER)
-         && !empty($query_string)) {
+        $request_uri .= '?' . $query_string;
+    }   
 
-            $req_uri .= '?' . $query_string;
-        }
-        
-        return $req_uri;
-    }
+    return $request_uri;
 
-    return '';
 }