Rumah >pangkalan data >tutorial mysql >Elastix1.5.2
接下来介绍Elastix1.5.2-2的主index.php,这里主要是对该文件的源码标注,大家看后应该会对系统的整个框架会有大体上的认识。 ?php /* 包含 misc.lib.php 文件。该文件包含提供了一些基本的函数接口,这些接口的功能有获取系统信息(内存信息、 CPU 信息、硬
接下来介绍Elastix1.5.2-2的主index.php,这里主要是对该文件的源码标注,大家看后应该会对系统的整个框架会有大体上的认识。
/* 包含 misc.lib.php 文件。该文件包含提供了一些基本的函数接口,这些接口的功能有获取系统信息(内存信息、 CPU 信息、硬盘信息)、构建合法的 URL 、转换日期格式(如将 1 Apr 2010 转化为 2010-4-1 )、获取或修改数据表 ettings 的字段值、获取 elastix 版本信息、加载显示的主题、加载用户选择的语言、获取所有菜单、获取语言种类等等。 */
include_once ( "libs/misc.lib.php" );
/* 包含 default.conf.php 文件。该文件中包含了一个全局数组 $arrConf ,数组中存储了系统主目录、系统运行用到的目录、系统的主题属性、系统默认所使用的语言种类等信息。使用该数组时,包含之即可。 */
include_once "configs/default.conf.php" ;
/* 包含文件 paloSantoNavigation.class.php 文件。该文件中定义了一个名为 paloSantoNavigation 的类。该类主要是对一些 menu 操作的封装,包括获取菜单、显示菜单、内容显示、获取服务器名、获取服务器 IP 。其中该类中有一个成员函数名为 showConent(), index.php 文件,若存在此文件则执行该文件中的 _moduleContent() 函数。各个模块的特有内容显示就交由各个模块负责。 */
include_once "libs/paloSantoNavigation.class.php" ;
/* 包含 paloSantoDB.class.php 文件。该文件中定义了一个名为 paloDB 的类。该类封装了一些数据库操作的方法,为用户访问数据提供了接口。该类的方法支持对 sqlite 和 MySQL 两种数据库类型的操作。 */
include_once "libs/paloSantoDB.class.php" ;
/* 包含 paloSantoACL.class.php 文件。该文件中定义了一个名为 paloACL 的类。该类主要对系统用户的访问操作级别进行了划分。默认情况下, elastix 用户被分为四个组( Administrator 、 Operador 、 Extension 及 Tel-manger ),管理员还可以创建新的用户组并为各组指定可以访问的菜单,可以新建用户,删除组,删除用户,给各组划分权限等。 */
include_once ( "libs/paloSantoACL.class.php" ); // Don activate unless you know what you are doing. Too risky!
// 开发人员开发时使用的开关。当 $developerMode=true 时,不需身份认证可以进入系统并显示所有的菜单。
$developerMode = false ;
// 设置当前 session 的名字为 elastixSessin ,用在 session_start() 之前
session_name( "elastixSession" );
//session_start() 有两个作用
//1. 创建一个新的 session;
//2. 恢复当前的 session ,该 session 是由 GET 方法、 POST 请求或 COOKIE 的 session 标识符来确定的
// 另外,在使用基于 cookie 的 session 时,必须把 session_start() 放在向浏览器输出的动作之前。
session_start(); // 只要连接到服务器,就开始 session
// GET 方法得到的是 logout 操作
if ( isset ( $_GET [ 'logout' ]) && $_GET [ 'logout' ]== 'yes' ) {
session_destroy(); // 销毁所有与当前 session 有关的数据
session_name( "elastixSession" ); // 重新设置 session 的名字
session_start(); // 创建新的 session ,回到登录界面,重新开始 session
}
//cargar el archivo de idioma
//$lang=isset($arrConf['language'])?$arrConf['language']:"en";
//include_once("lang/".$lang.".lang");
// 获取系统显示所使用的语言包。该函数定义在 misc.lib.php 文件中。 load_language() 在加载使用的语言时,先检查 settings 数据表中 key 字段为 language 的值,若该值存在,则加载该语言包;若该值为空,则查看全局数组中 $arrConf[‘language’] 是否被设置,若设置了,则调用相应的语言包;若没有设置则使用默认的英语语言包。
load_language();
// 实例化一个 paloDB 对象,设置使用的数据源为 acl.db 。 $arrConf['elastix_dsn']['acl'] 的值
//是 "sqlite3:////var/www/db/acl.db" 。 acl.db 数据包含了 9 个数据表。
$pDB = new paloDB( $arrConf [ 'elastix_dsn' ][ 'acl' ]);
// 若在实例化 paloDB 对象时,数据库产生错误,则输出错误信息
if (! empty ( $pDB ->errMsg)) {
echo
"ERROR DE DB:
$pDB
->errMsg
"
;
}
// 以 $pDB 为参数实例化一个 paloACL 对象 $pACL
$pACL = new paloACL( $pDB );
// 若在实例化 paloACL 过程中产生错误,则输出错误信息
if (! empty ( $pACL ->errMsg)) {
echo
"ERROR DE DB:
$pACL
->errMsg
"
;
}
// Load smarty
require_once ( "libs/smarty/libs/Smarty.class.php" ); // 包含 Smarty 类文件
$smarty = new Smarty(); // 实例化一个 Smarty 类的对象 $smarty
// 给 $smarty 的一些变量赋值。设置模板所在的目录
$smarty ->template_dir = "themes/" . $arrConf [ 'mainTheme' ];
// 若发现系统中任何 tpl 文件有改动,则需要对其进行重新编译,编译后放在 /var/www/html/var/templates_c/ 目录下
$smarty ->compile_dir = "var/templates_c/" ;
// 设置配置文件所在的目录,文件名一般以 .conf.php 结尾,保存一些变量等信息
$smarty ->config_dir = "configs/" ;
// 设置保存缓冲文件的目录
$smarty ->cache_dir = "var/cache/" ;
//$smarty->debugging = true;
//- 1) SUBMIT. Si se hizo submit en el formulario de ingreso
//- autentico al usuario y lo ingreso a la sesion
// 若点击了提交按钮且用户名非空
if ( isset ( $_POST [ 'submit_login' ]) and ! empty ( $_POST [ 'input_user' ])) {
$pass_md5 = md5( $_POST [ 'input_pass' ]); // 把用户输入的密码用 MD5 加密赋值给 $pass_md5
// 若经验证时 elastix 的合法用户且密码正确,则做一些赋值操作
if ( $pACL ->authenticateUser( $_POST [ 'input_user' ], $pass_md5 )) {
// 将用户名赋值给 session 的一个变量中,以便以后用来确定登录的用户
$_SESSION [ 'elastix_user' ] = $_POST [ 'input_user' ];
// 将用户登录使用的密码存储在 session 的变量中
$_SESSION [ 'elastix_pass' ] = $pass_md5 ;
} else {
// 若用户验证没通过, DO NOTHING!!!!! 此处可以不作处理,也可以输出一些提示信息,要求用户重新输入用户名和密码。/因 为只有两种情况下程序才能走到这里:只输入了用户名(不论该用户是否存在)而没有输入密码、输入了错误的用户名和密码。
// Debo hacer algo aqu 铆 ?
}
}
// 实例化一个 paloDB 对象,使用的数据库是 menu.db 。 menu.db 中只有一个数据表 menu ,该表中存储了所有的菜单项
$pDBMenu = new paloDB( $arrConf [ 'elastix_dsn' ][ 'menu' ]);
// 加载菜单表的内容,并把菜单结构赋值给 $arrMenu ,此时 $arrMenu 里保存了所有菜单的结构, cargar_menu() 函数的定义 在 misc.lib.php 文件里,负责把 menu 表中的内容以数组的形式读出来。
$arrMenu = cargar_menu( $pDBMenu ) ;
// 判定是否是正宗的用户,包括验证用户名和密码;或者是否处于开发状态
// 2) Autentico usuario
if ( isset ( $_SESSION [ 'elastix_user' ]) && isset ( $_SESSION [ 'elastix_pass' ]) && $pACL ->authenticateUser( $_SESSION [ 'elastix_user' ], $_SESSION [ 'elastix_pass' ]) or $developerMode == true ) { //$developerMode==true 是开发时用的开关,此时无需身份验证即可登录。
// 搜索登录用户在 acl_user 表中对应的 id ,保存为 $idUser 。 acl_user 表在数据库 acl.db 中。
$idUser = $pACL ->getIdUser( $_SESSION [ 'elastix_user' ]);
// 检查 $_SESSION['elastix_user_permission']) 是否被赋值。如果是全新的登录,则该变量是未被赋值的,该判断为真,进入 if 内部,经过一些操作,将该登录用户可以访问的菜单赋值给该变量。
if (! isset ( $_SESSION [ 'elastix_user_permission' ])){
if ( $developerMode != true ) { // 不是出于开发模式, $developerMode 为真时,开发人员可以访问所有 menu 。
// 声明 $arrMenuFiltered 是数组类型变量,用来存储登录用户能访问的所有 menu
$arrMenuFiltered = array ();
//- TODO : Mejorar el siguiente bloque. Seguro debe de haber una forma mas
//-
eficiente de hacerlo
//
安全必须是一个做更有效的方法
//- Primero me barro todos los submenus 首先,我扫了所有子菜单
$arrSubmenu = array (); // 声明 $arrSubMenu 是数组类型变量,用于暂存登录用户有访问权限的 menu
// 下面是获取所有子菜单
foreach ( $arrMenu as $idMenu => $arrMenuItem ) { // 遍历加载的 menu 数组
if (! empty ( $arrMenuItem [ 'IdParent' ])) { // 如果当前 menu 不是顶级 menu
// 如果登录的用户对当前遍历到的菜单有 access 的权限
if ( $pACL ->isUserAuthorizedById( $idUser , "access" , $idMenu )) {
// 把 $arrMenuItem 数组赋值给 $arrSubmenu[$idMenu] 并赋值给 $arrMenuFiltered[$idMenu] 。第一个赋值是为了后面 子菜单寻找其父菜单用;第二个赋值是将整个 menu 数组存储在 $arrMenuFiltered 数组中,包括父菜单和子菜单。
$arrSubmenu [ $idMenu ] = $arrMenuItem ;
$arrMenuFiltered [ $idMenu ] = $arrMenuItem ;
}
}
}
// 获取顶级菜单
//- Ahora me barro el menu principal 现在我打扫主菜单
foreach ( $arrMenu as $idMenu => $arrMenuItem ) {
if ( empty ( $arrMenuItem [ 'IdParent' ])) { // 父菜单项为空,表明是顶级菜单
// 遍历所有 menu 以便获取各个子 menu 的父 menu 是谁
foreach ( $arrSubmenu as $idSubMenu => $arrSubMenuItem ) {
// 找出各个父 menu 拥有的子 menu ,将子 menu 归类到父 menu
if ( $arrSubMenuItem [ 'IdParent' ]== $idMenu ) {
$arrMenuFiltered [ $idMenu ] = $arrMenuItem ;
}
}
}
}
} else { // 若是开发模式,则把所有的菜单赋值给筛选用的变量
$arrMenuFiltered = $arrMenu ;
}
//Guardo en la session los menus q tiene con permisos el usuario logoneado, esto se implement 贸 para mejorar
//el proceso del httpd ya que consumia mucho recurso.
Reportado por Ana Vivar
//Una vez q exista en la session solo se lo sacara de ahi y no se vovera a consultar a la base.
// 将筛选后的菜单赋值给全局变量 $_SESSION[‘elastix_user_permission’] ,在整个 session 期间可以直接使
//用该变量
$_SESSION [ 'elastix_user_permission' ]= $arrMenuFiltered ;
}
// 若 $_SESSION[‘elastix_user_permission’] 不为空,则将其赋值给 $arrMenuFiltered 数组。此处应加
// else ,当用户 第一次登录时,此赋值多余
$arrMenuFiltered = $_SESSION [ 'elastix_user_permission' ];
//traducir el menu al idioma correspondiente
// 按照本地语言配置,将当前用户可见的菜单名称翻译为用户选择的本地语言
foreach ( $arrMenuFiltered as $idMenu => $arrMenuItem ) {
$arrMenuFiltered [ $idMenu ][ 'Name' ]= isset ( $arrLang [ $arrMenuItem [ 'Name' ]])? $arrLang [ $arrMenuItem [ 'Name' ]]: $arrMenuItem [ 'Name' ];
//$arrLang 在 default.conf.php 有定义。 $arrLang 数组定义了使用到的数据源、 elastix 主目录、显示主题、默认显示语 言、系统备份目录等信息。
}
// 实例化一个 paloSantoNavigation 对象 $oPn, 把准备好的变量作为参数。其中, $arrConf 定义在 default.conf.php 文件 中; $arrMenuFiltered 存储的是登陆用户有访问权限的 menu 数组; $smarty 是 Smart 类的一个对象,通过其成员函数 assign() 给一些 smarty 变量赋值。
$oPn = new paloSantoNavigation( $arrConf , $arrMenuFiltered , $smarty );
// 通过 smarty 的 assign 函数对 tpl 模板文件用到的基本变量赋值; THEMENAME 是用户登录后显示主题的变量; ABOUT_ELASTIX , ABOUT_ELASTIX_CONTENT , LOGOUT 等都会以相应的翻译后的值。 $arrLang 是 global 变量。 该变量在用户选择的语言包(如 cn.lang )里面定义的,每个 .lang 文件都有定义。
$smarty ->assign( "THEMENAME" , $arrConf [ 'mainTheme' ]);
$smarty ->assign( "ABOUT_ELASTIX" , $arrLang [ 'About Elastix' ]. " " . $arrConf [ 'elastix_version' ]);
$smarty ->assign( "ABOUT_ELASTIX_CONTENT" , $arrLang [ 'About Elastix Content' ]);
$smarty ->assign( "ABOUT_CLOSED" , $arrLang [ 'About Elastix Closed' ]);
$smarty ->assign( "LOGOUT" , $arrLang [ 'Logout' ]);
//$menu= (isset($_GET['menu']))?$_GET['menu']:'';
if ( isset ( $_GET [ 'menu' ])) $menu = $_GET [ 'menu' ]; // 获取 URL 的 menu 参数值
elseif ( empty ( $menu ) and ! empty ( $_SESSION [ 'menu' ])) $menu = $_SESSION [ 'menu' ];
else $menu = '' ;
// 把菜单存储到 $_SESSION[‘menu’] 中,在 session 中保持该值
$_SESSION [ 'menu' ]= $menu ;
// 若得到可访问的菜单,则把 menu 赋值给 MENU ,将来会通过 smarty 模板显示 $MENU
if (count( $arrMenuFiltered )> 0 )
$smarty ->assign( "MENU" , $oPn ->showMenu( $menu ));
else // 若没有可以显示的菜单,则会输出 ”No modules”
$smarty ->assign( "MENU" , "No modules" );
// rawmode es un modo de operacion que pasa directamente a la pantalla la salida
// del modulo. Esto es util en ciertos casos.
//rawmode 是一种显示模式,该模式下的显示已经去除了背景、样式、以及其他 MENU 等信息,直接显示子 MENU 的内容。 在页面上没有与其对应的按钮或链接,但是可以在进入菜单后通过手工修改浏览器地址栏的 URL 来查看; 形式如: http://192.168.1.183/?rawmode=yes ;猜测:通常用于带宽不够的情况下。 所以,在这种情况下直接 showContent 而不是采用 smart 模板;否则采用 smarty 模板
if ( isset ( $_GET [ 'rawmode' ]) && $_GET [ 'rawmode' ]== 'yes' ) {
// Autorizacion
if ( $pACL ->isUserAuthorizedById( $idUser , "access" , $oPn ->currSubMenu) or $developerMode == true ) {
echo $oPn ->showContent();
}
} else {
// Autorizacion // 如果登录的用户对子目录有访问权限,则将子目录的内容赋值给 CONTENT
if ( $pACL ->isUserAuthorizedById( $idUser , "access" , $oPn ->currSubMenu) or $developerMode == true ) {
$smarty ->assign( "CONTENT" , $oPn ->showContent());
}
// 用 smarty 的 display 函数显示 index.tpl 的内容, $MENU 和 $CONTENT 已经有值
$smarty ->display( "_common/index.tpl" );
}
// 若登录不成功,则要求重新登录
} else {
$smarty ->assign( "PAGE_NAME" , $arrLang [ 'Login page' ]);
$smarty ->assign( "WELCOME" , $arrLang [ 'Welcome to Elastix' ]);
$smarty ->assign( "ENTER_USER_PASSWORD" , $arrLang [ 'Please enter your username and password' ]);
$smarty ->assign( "USERNAME" , $arrLang [ 'Username' ]);
$smarty ->assign( "PASSWORD" , $arrLang [ 'Password' ]);
$smarty ->assign( "SUBMIT" , $arrLang [ 'Submit' ]);
// 赋值完成后,通过 login.tpl 模板显示出来
$smarty ->display( "_common/login.tpl" );
}
?>