/*
功能:基于TP2.0的無(wú)限分類(lèi)。
用法:
第一種用法,不采用數(shù)據(jù)庫(kù),可以不需要TP，例子如下
?php
require('Category.class.php');//導(dǎo)入Category.class.php類(lèi)
//測(cè)試數(shù)據(jù)
$data[]=array('cat_id'=>1,'pid'=>0,'name'=>'中國(guó)');
$data[]=array('cat_id'=>2,'pid'=>0,'name'=>'美國(guó)');
$data[]=array('cat_id'=>3,'pid'=>0,'name'=>'韓國(guó)');
$data[]=array('cat_id'=>4,'pid'=>1,'name'=>'北京');
$data[]=array('cat_id'=>5,'pid'=>1,'name'=>'上海');
$data[]=array('cat_id'=>6,'pid'=>1,'name'=>'廣西');
$data[]=array('cat_id'=>7,'pid'=>6,'name'=>'桂林');
$data[]=array('cat_id'=>8,'pid'=>6,'name'=>'南寧');
$data[]=array('cat_id'=>9,'pid'=>6,'name'=>'柳州');
$data[]=array('cat_id'=>10,'pid'=>2,'name'=>'紐約');
$data[]=array('cat_id'=>11,'pid'=>2,'name'=>'華盛頓');
$data[]=array('cat_id'=>12,'pid'=>3,'name'=>'首爾');
$cat=new Category('',array('cat_id','pid','name','cname'));
$s=$cat->getTree($data);//獲取分類(lèi)數(shù)據(jù)樹(shù)結(jié)構(gòu)
//$s=$cat->getTree($data,1);獲取pid=1所有子類(lèi)數(shù)據(jù)樹(shù)結(jié)構(gòu)
foreach($s as $vo)
{
echo $vo['cname'].'br>';
}
第二種用法,采用數(shù)據(jù)庫(kù),基于TP,例子如下
數(shù)據(jù)表,前綴_articlec_cat,包含cat_id,pid,title三個(gè)字段
require('Category.class.php');//導(dǎo)入Category.class.php類(lèi)
$cat=new Category('ArticleCat',array('cat_id','pid','title','fulltitle'));
$s=$cat->getList();//獲取分類(lèi)結(jié)構(gòu)
$s=$cat->getList('',1);//獲取pid=1的子分類(lèi)結(jié)構(gòu)
$s=$cat->getList($condition,1);//$condition為查詢(xún)條件，獲取pid=1的子分類(lèi)結(jié)構(gòu)
$s=$cat->getPath(3);//獲取分類(lèi)id=3的路徑
$s=$cat->add($data);//添加分類(lèi)，$data需要包含上級(jí)分類(lèi)pid
$s=$cat->edit($data);//修改分類(lèi),$data需要包含分類(lèi)ID
$s=$cat->del(10);//刪除分類(lèi)id=10的分類(lèi)
詳細(xì)用法：參考代碼說(shuō)明
/**
+------------------------------------------------------------------------------
* 分類(lèi)管理
+------------------------------------------------------------------------------
*/
class Category
{
  //分類(lèi)的數(shù)據(jù)表模型
  private $model;
  //原始的分類(lèi)數(shù)據(jù)
  private $rawList = array();
  //格式化后的分類(lèi)
  private $formatList = array();
  //錯(cuò)誤信息
  private $error = "";
  //格式化的字符
  private $icon = array(' │', ' ├ ', ' └ ');
  //字段映射，分類(lèi)id，上級(jí)分類(lèi)pid,分類(lèi)名稱(chēng)title,格式化后分類(lèi)名稱(chēng)fulltitle
  private $field = array();
  /*
  功能：構(gòu)造函數(shù)，對(duì)象初始化；
  屬性：public;
  參數(shù)：$model,數(shù)組或?qū)ο?，基于TP2.0的數(shù)據(jù)表模型名稱(chēng),若不采用TP2.0，可傳遞空值。
  $field，字段映射，分類(lèi)id，上級(jí)分類(lèi)pid,分類(lèi)名稱(chēng)title,格式化后分類(lèi)名稱(chēng)fulltitle
  依次傳遞,例如在分類(lèi)數(shù)據(jù)表中，分類(lèi)id，字段名為CatID,上級(jí)分類(lèi)pid,字段名稱(chēng)name,希望格式化分類(lèi)后輸出cname,
  則，傳遞參數(shù)為,$field('CatID','pid','name','cname');若為空，則采用默認(rèn)值。
  返回：無(wú)
  備注:用到了TP的D函數(shù)
  */
  public function __construct($model = '', $field = array())
  {
    //判斷參數(shù)類(lèi)型
    if (is_string($model)  (!empty($model))) {
      if (!$this->model = D($model)) //注意這里的D函數(shù)需要TP支持
        $this->error = $model . "模型不存在！";
    }
    if (is_object($model)) {
      $this->model = $model;
    }
    $this->field['id']    = $field['0'] ? $field['0'] : 'id';
    $this->field['pid']    = $field['1'] ? $field['1'] : 'pid';
    $this->field['title']   = $field['2'] ? $field['2'] : 'title';
    $this->field['fulltitle'] = $field['3'] ? $field['3'] : 'fulltitle';
  }
  /*
  功能：獲取分類(lèi)信息數(shù)據(jù)；
  屬性：private;
  參數(shù)：查詢(xún)條件$condition；
  返回：無(wú)；
  備注:需要TP支持
  */
  private function _findAllCat($condition, $orderby = NULL)
  {
    if (empty($orderby)) {
      $this->rawList = $this->model->where($condition)->findAll();
    } else {
      $this->rawList = $this->model->where($condition)->order($orderby)->findAll();
    }
  }
  /*
  功能：返回給定上級(jí)分類(lèi)$pid的所有同一級(jí)子分類(lèi)；
  屬性：public;
  參數(shù)：上級(jí)分類(lèi)$pid；
  返回：子分類(lèi)，二維數(shù)組；
  備注:
  */
  public function getChild($pid)
  {
    $childs = array();
    foreach ($this->rawList as $Category) {
      if ($Category[$this->field['pid']] == $pid)
        $childs[] = $Category;
    }
    return $childs;
  }
  /*
  功能：無(wú)限分類(lèi)核心部分，遞歸格式化分類(lèi)前的字符；
  屬性：private;
  參數(shù)：分類(lèi)id,前導(dǎo)空格；
  返回：無(wú)；
  備注:
  */
  private function _searchList($CatID = 0, $space = "")
  {
    //下級(jí)分類(lèi)的數(shù)組
    $childs = $this->getChild($CatID);
    //如果沒(méi)下級(jí)分類(lèi)，結(jié)束遞歸
    if (!($n = count($childs)))
      return;
    $cnt = 1;
    //循環(huán)所有的下級(jí)分類(lèi)
    for ($i = 0; $i  $n; $i++) {
      $pre = "";
      $pad = "";
      if ($n == $cnt) {
        $pre = $this->icon[2];
      } else {
        $pre = $this->icon[1];
        $pad = $space ? $this->icon[0] : "";
      }
      $childs[$i][$this->field['fulltitle']] = ($space ? $space . $pre : "") . $childs[$i][$this->field['title']];
      $this->formatList[]          = $childs[$i];
      //遞歸下一級(jí)分類(lèi)
      $this->_searchList($childs[$i][$this->field['id']], $space . $pad . " ");
      $cnt++;
    }
  }
  /*
  功能：不采用數(shù)據(jù)模型時(shí)，可以從外部傳遞數(shù)據(jù)，得到遞歸格式化分類(lèi)；
  屬性：public;
  參數(shù)：$condition，數(shù)字或字符串，需要符合TP查詢(xún)條件規(guī)則,起始分類(lèi)id,$CatID=0；
  $orderby 排序參數(shù)
  返回：遞歸格式化分類(lèi)數(shù)組；
  備注:需要TP支持
  */
  public function getList($condition = NULL, $CatID = 0, $orderby = NULL)
  {
    unset($this->rawList);
    unset($this->formatList);
    $this->_findAllCat($condition, $orderby, $orderby);
    $this->_searchList($CatID);
    return $this->formatList;
  }
  /*
  功能：不采用數(shù)據(jù)模型時(shí)，可以從外部傳遞數(shù)據(jù)，得到遞歸格式化分類(lèi)；
  屬性：public;
  參數(shù)：$data，二維數(shù)組，起始分類(lèi)id,默認(rèn)$CatID=0；
  返回：遞歸格式化分類(lèi)數(shù)組；
  備注:
  */
  public function getTree($data, $CatID = 0)
  {
    unset($this->rawList);
    unset($this->formatList);
    $this->rawList = $data;
    $this->_searchList($CatID);
    return $this->formatList;
  }
  /*
  功能：獲取錯(cuò)誤信息；
  屬性：public;
  參數(shù)：無(wú)；
  返回：錯(cuò)誤信息字符串；
  備注:
  */
  public function getError()
  {
    return $this->error;
  }
  /*
  功能：檢查分類(lèi)參數(shù)$CatID,是否為空；
  屬性：private;
  參數(shù)：分類(lèi)參數(shù)$CatID,整型。
  返回：正確，返回true，錯(cuò)誤，返回false；
  備注:
  */
  private function _checkCatID($CatID)
  {
    if (intval($CatID)) {
      return true;
    } else {
      $this->error = "參數(shù)分類(lèi)ID為空或者無(wú)效！";
      return false;
    }
  }
  /*
  功能：查詢(xún)路徑；
  屬性：private;
  參數(shù)：分類(lèi)參數(shù)$CatID,整型。
  返回：出錯(cuò)返回false；
  備注:需要TP支持
  */
  private function _searchPath($CatID)
  {
    //檢查參數(shù)
    if (!$this->_checkCatID($CatID))
      return false;
    //初始化對(duì)象，查找上級(jí)Id；
    $rs = $this->model->find($CatID);
    //保存結(jié)果
    $this->formatList[] = $rs;
    $this->_searchPath($rs[$this->field['pid']]);
  }
  /*
  功能：查詢(xún)給定分類(lèi)id的路徑；
  屬性：public;
  參數(shù)：分類(lèi)參數(shù)$CatID,整型。
  返回：數(shù)組；
  備注:需要TP支持
  */
  public function getPath($CatID)
  {
    unset($this->rawList);
    unset($this->formatList);
    //查詢(xún)分類(lèi)路徑
    $this->_searchPath($CatID);
    return array_reverse($this->formatList);
  }
  /*   * **************************************以下為分類(lèi)添加、修改、刪除*************************************************** */
  /*
  功能：添加分類(lèi)；
  屬性：public;
  參數(shù)：$data,一維數(shù)組，要添加的數(shù)據(jù)，$data需要包含上級(jí)分類(lèi)ID。
  返回：添加成功，返回相應(yīng)的分類(lèi)ID,添加失敗，返回FALSE；
  備注:需要TP支持
  */
  public function add($data)
  {
    if (empty($data))
      return false;
    return $this->model->data($data)->add();
  }
  /*
  功能：修改分類(lèi)；
  屬性：public;
  參數(shù)：$data,一維數(shù)組，傳遞編輯的數(shù)據(jù)，$data需要包含要修改的分類(lèi)ID。
  返回：修改成功，返回相應(yīng)的分類(lèi)ID,修改失敗，返回FALSE；
  備注:需要TP支持
  */
  public function edit($data)
  {
    if (empty($data))
      return false;
    return $this->model->data($data)->save();
  }
  /*
  功能：刪除分類(lèi)；
  屬性：public;
  參數(shù)：分類(lèi)ID
  返回：刪除成功，返回相應(yīng)的分類(lèi)ID,刪除失敗，返回FALSE；
  備注:需要TP支持
  */
  public function del($CatID)
  {
    $CatID = intval($CatID);
    if (empty($CatID))
      return false;
    $conditon[$this->field['id']] = $CatID;
    return $this->model->where($conditon)->delete();
  }
}