zen cart 函数：zen_href_link

  function zen_href_link($page = '', $parameters = '', $connection = 'NONSSL', $add_session_id = true, $search_engine_safe = true, $static = false, $use_dir_ws_catalog = true) {
    global $request_type, $session_started, $http_domain, $https_domain;
    if (!zen_not_null($page)) {
      die('</td></tr></table></td></tr></table><br /><br /><b class="note">Error!<br /><br />Unable to determine the page link!</b><br /><br /><!--' . $page . '<br />' . $parameters . ' -->');
    }
    if ($connection == 'NONSSL') {
      $link = HTTP_SERVER;
    } elseif ($connection == 'SSL') {
      if (ENABLE_SSL == 'true') {
        $link = HTTPS_SERVER ;
      } else {
        $link = HTTP_SERVER;
      }
    } else {
      die('</td></tr></table></td></tr></table><br /><br /><b class="note">Error!<br /><br />Unable to determine connection method on a link!<br /><br />Known methods: NONSSL SSL</b><br /><br />');
    }
    if ($use_dir_ws_catalog) {
      if ($connection == 'SSL' && ENABLE_SSL == 'true') {
        $link .= DIR_WS_HTTPS_CATALOG;
      } else {
        $link .= DIR_WS_CATALOG;
      }
    }
    if (!$static) {
      if (zen_not_null($parameters)) {
        $link .= 'index.php?main_page='. $page . "&" . zen_output_string($parameters);
      } else {
        $link .= 'index.php?main_page=' . $page;
      }
    } else {
      if (zen_not_null($parameters)) {
        $link .= $page . "?" . zen_output_string($parameters);
      } else {
        $link .= $page;
      }
    }
    $separator = '&';
    while ( (substr($link, -1) == '&') || (substr($link, -1) == '?') ) $link = substr($link, 0, -1);
// Add the session ID when moving from different HTTP and HTTPS servers, or when SID is defined
    if ( ($add_session_id == true) && ($session_started == true) && (SESSION_FORCE_COOKIE_USE == 'False') ) {
      if (defined('SID') && zen_not_null(SID)) {
        $sid = SID;
//      } elseif ( ( ($request_type == 'NONSSL') && ($connection == 'SSL') && (ENABLE_SSL_ADMIN == 'true') ) || ( ($request_type == 'SSL') && ($connection == 'NONSSL') ) ) {
      } elseif ( ( ($request_type == 'NONSSL') && ($connection == 'SSL') && (ENABLE_SSL == 'true') ) || ( ($request_type == 'SSL') && ($connection == 'NONSSL') ) ) {
        if ($http_domain != $https_domain) {
          $sid = zen_session_name() . '=' . zen_session_id();
        }
      }
    }
// clean up the link before processing
    while (strstr($link, '&&')) $link = str_replace('&&', '&', $link);
    while (strstr($link, '&&')) $link = str_replace('&&', '&', $link);
    if ( (SEARCH_ENGINE_FRIENDLY_URLS == 'true') && ($search_engine_safe == true) ) {
      while (strstr($link, '&&')) $link = str_replace('&&', '&', $link);
      $link = str_replace('&', '/', $link);
      $link = str_replace('?', '/', $link);
      $link = str_replace('&', '/', $link);
      $link = str_replace('=', '/', $link);
      $separator = '?';
    }
    if (isset($sid)) {
      $link .= $separator . zen_output_string($sid);
    }
// clean up the link after processing
    while (strstr($link, '&&')) $link = str_replace('&&', '&', $link);
    $link = preg_replace('/&/', '&', $link);
    return $link;
  }

zen_href_link 函数位于 /includes/functions/html_output.php 文件中，主要用于输出超级链接。它的参数如下表所示：

$page		这个变量通常由 /includes/filename.php 文件中的常量取得
$parameters
$connection
$add_session_id
$search_engine_safe
$static
$use_dir_ws_catalog

第一行代码，定义了 global 变量：$request_type，$session_started，$http_domain 和 $https_domain。（global 的作用是定义全局变量，但是这个全局变量不是应用于整个网站，而是应用于当前页面，包括 include 或 require 的所有文件。在函数体内定义的 global 变量，函数体外可以使用，在函数体外定义的 global 变量不能在函数体内使用。）

接下来的代码，

if (!zen_not_null($page))

判断传递过来的 $page 变量是否为空。zen_not_null 函数，看名字猜，应该是判断它的参数不为空。前面加了一个逻辑非符号 !，这个条件语句的结果应该是，如果 $page 为空，则执行以下代码：

die('</td></tr></table></td></tr></table><br /><br /><b class="note">Error!<br /><br />Unable to determine the page link!</b><br /><br /><!--' . $page . '<br />' . $parameters . ' -->');

输出 die 后面括号的内容，然后中止程序执行。输出内容的后半部分容易理解，就是发出一条无法判断页面链接的警告。前半部分，只有关闭的 html 标签，table 的前面部分标签，还不知道是在哪里，有待研究。

然后，根据 $connection 参数，来决定是 http:// 链接，还是 https:// 链接。HTTP_SERVER 这个常量可以在 /includes/configure.php 文件中找到，实际就是网站的根目录。然后把 HTTP_SERVER 这个常量值赋值给 $link 这个变量。

如果 $connection 传递过来的，既不是 NONSSL，也不是 SSL，则会输出错误信息，然后中止执行程序。

判断参数 $use_dir_ws_catalog 是否为真，如果不是，则不执行任何代码，如果为真，执行以下代码：

if ($connection == 'SSL' && ENABLE_SSL == 'true') {
        $link .= DIR_WS_HTTPS_CATALOG;
      } else {
        $link .= DIR_WS_CATALOG;
      }

由于 $use_dir_ws_catalog 默认为真，所以将执行以上代码。这个是一个条件语句，如果 $connection 的值为 SSL，并且 ENABLE_SSL 这个常量为真，则把 DIR_WS_HTTPS_CATALOG 这个常量赋值给 $link；否则将把 DIR_WS_CATALOG 这个常量赋值给 $link。ENABLE_SSL，DIR_WS_HTTPS_CATALOG 和 DIR_WS_CATALOG 这三个常量都可以 /includes/configure.php 文件中找到。

下面看一个实例：

	zen_href_link(FILENAME_LOGIN, '', 'SSL');

以上代码，将产生以下的超级链接：

	http://zencart/index.php?main_page=login&zenid=5n4b36fqt06jj9pciqtd1v3fs0

FILENAME_LOGIN 这个常量在 /includes/filenames.php 文件中被定义。

	define('FILENAME_LOGIN', 'login');

接下来将判断 $static 这个变量的真假，如果不为真，则执行以下代码：

    if (!$static) {
      if (zen_not_null($parameters)) {
        $link .= 'index.php?main_page='. $page . "&" . zen_output_string($parameters);
      } else {
        $link .= 'index.php?main_page=' . $page;
      }
    } else {
      if (zen_not_null($parameters)) {
        $link .= $page . "?" . zen_output_string($parameters);
      } else {
        $link .= $page;
      }
    }