<input name="allbox" type="checkbox" onClick="TA();" title="选中或清除选中所有的项目" tabindex="105">选中或清除选中所有的项目

<br/>
<span class="X">
<input type="checkbox" name="ABC" class="A" onClick="TTA(this);">清明时节</span>
<br/>
<span class="X">
<input type="checkbox" name="DEF" class="A" onClick="TTA(this);">长江水啊</span>
<br/>
<span class="X">
<input type="checkbox" name="GHL" class="A" onClick="TTA(this);">嘿嘿测试</span>
<br/>
</form>

<script language="javascript">
var frm = document.Form1;
</script>

<script language="JavaScript">

function TA(isO,noHL){
 var trk = 0;
 
 
 for(var i=0;i<frm.elements.length;i++){
  var e=frm.elements[i];

  if((e.name !='allbox') && (e.type == 'checkbox')){
    e.checked = frm.allbox.checked;
   if (frm.allbox.checked){
    //e.parentElement.className = "H"; //.parentElement不兼容firefox浏览器 
    e.parentNode.className = "H";//调用设置父节点元素class改变背景色
   
   }else{
    e.parentNode.className = "X";//调用设置父节点元素class改变背景色
   }
  }
 }
}

function TTA(CB,noHL){
 if (CB.checked){
  CB.parentNode.className = "H";
 }else{
  CB.parentNode.className = "X";
 }

 var TB=TO=0;
 for (var i=0;i<frm.elements.length;i++){
  var e=frm.elements[i];
  if ((e.name != 'allbox') && (e.type=='checkbox')){
   TB++;
  if (e.checked)
   TO++;
  }
 }
 frm.allbox.checked=(TO==TB)?true:false;
 //如果不是所有项被选中则allbox设定未被选中
}

</script>

<style>
.H{
 background: #ADD8E6
}
.X{
 background: #FFFFFF
}

</style>

</body></html>

input, select {
 font-size: 14px;
 color: #333333;
 padding-left:3px;
 background:#f6f6f6;
 border: #CCCCCC 1px solid;}
</style>
<?php
require_once dirname(__FILE__) ."/headers.php";

$i = 0;
  

function category($category_parent_timestamp){
   global $db;
   global $i;
   $result = $db->get("{category_parent_timestamp} == " . $category_parent_timestamp,null,"categories",false,"category_time","desc");
   sort($result);
  
   for($index=0;$index<count($result);$index++){          
     echo "<option>";
     for($x=0;$x<$i;$x++){
       echo "--";
      }      
     echo $result[$index]['category_title'];
     echo "&nbsp;";  
     $sub = $db->get("{category_parent_timestamp} == " .$result[$index]['category_timestamp'],null,"categories",false,"category_time","desc");
     if(count($sub)!=0){
       $i++;
       category($result[$index]['category_timestamp']);//迭代      
       $i--;
     }
     echo "</option>";
   }
   
}    
 
echo "<select>";
category("0"); 
echo"</select>";
?>

txtSQL

• txtSQLAdmin
• 帮助文档
• 测试报告

1. 速度快（有四个主要的文本数据库速度比较）
2. 基本上模拟了SQL的所有语法
3. 强大的错误处理
4. 完善的帮助文档
5. 免费使用

txtdb

国人开发的一个小型文本数据库系统。

Myupb的TextDB

txt db api

Flat-File SQL

TextDB

http://blog.csdn.net/hahawen/archive/2004/09/13/102557.aspx

/*************************/
/* author:大龄青年
/* email :wenadmin@sina.com
/* from: http://blog.csdn.net/hahawen
/*************************/

原代码下载: http://club.phpe.net/index.php?s=&act=Attach&type=post&id=29432

（近来帮许多网友改程序，发现一个问题，就是大家用php开发设计模式的非常的混乱，所以写下这篇文章，希望对大家都有帮助）

php作为“最简单”的Web脚本语言, 在国内的市场越来越大，phper越来越多，但是感觉大多数人好像没有考虑到模式问题，什么样的设计模式才是最优的，才是最适合自己目前工作的，毕竟效率是最重要的（用省下的时间打游戏，多美啊...）。MVC应该是首选，www.sourceforge.net 上有好多优秀的基于MVC的开源项目，大家可以冲过去研究研究。

前几天给自己公司网站改版，主要还是文章发布系统，老板说后台我想怎么设计就怎么设计，唯一的前提就是快。于是自己搭建了一个简单的发布系统的框架。如果单纯从文章发布系统上讲，基本上可以满足“中小型”企业网站的文章发布系统的要求，后台的总共的php代码不超过800行，而且支持任意扩充和plugin功能。

废话不再说了，下面把我的架构讲一下，希望对您能有所帮助。

注意：在开始前，需要您下载一个模板处理工具类：“smarttemplate”，并了解一些模板的简单的使用。

我的测试环境：windows2k/apache2/php4.3.2/smarttemplate类库

先讲一下整个web站点的文件的分布，在后面的章节中将陆续创建并填充下面的目录和文件
我的服务器的web的根目录是 “C:/Apache2/htdocs/”
我在下面建立了一个文件夹“cmstest”作为我的网站的主文件夹
文件夹“cmstest”下面的子文件结构是：

/config.inc.php
/list1.php
/list2.php
/new.php
/add.php
/view.php
/page.js
/src/MysqlUtil.php
/src/ArticleUtil.php
/src/CoreUtil.php
/src/ParseTpl.php
/src/lib/smarttemplate/*.* 这个目录用来存放smarttemplate的类库的
/smart/template/list1.htm
/smart/template/list2.htm
/smart/template/new.htm
/smart/template/add.htm
/smart/template/view.htm
/smart/cache/
/smart/temp/

设计步骤：
1、考虑自己公司的网站的特点和已经设计的模板的结构，总结要实现的功能，列出清单。

2、分析功能清单，把功能分类。每一类的功能都是有共同点的，可以通过相同的方法实现的。

3、根据功能，设计数据库的表结构

4、设计一个配置文件config.inc.php, 用来记录网站的一些基本的信息,包括数据库名........

5、为每一类功能设计数据库查询的接口函数，这样以后相似的操作只要调用这个接口就可以了。这样避免了以后可能发生的大量的代码重复的操作，也就达到了代码复用的目的。

6、定义自己对模板工具的包装函数，以后调用的时候就不用管模板工具的使用问题了，只有往自己的包装函数里面塞数就可以了。

7、基础函数已经ok了，开始轻松的页面实现和模板的处理了。

我们现在就开始设计一个简单的系统，看看我是怎么一步一步地实现一个“最简单的文章的发布系统”的，当然只是我模拟的一个简单的项目，实际中一个项目可能比这要复杂的多。

一、分析我的案例：

呵呵，这个客户项目好简单的啊，幸福ing..........

list1.php：有三个文章列表和一个按钮，“php开发文章列表”“php开发热点文章列表”“asp开发最新文章”“添加新文章”
list2.php：有2个文章列表“asp开发文章列表”“asp开发热点文章列表”
new.php: 一个添加文章的表单的页面
add.php: 处理new.php的表单的页面
view.php: 文章察看的页面

二、分析功能

“php开发文章列表”“asp开发文章列表”-------按文章的发布顺序，倒序排列显示，每页显示5篇文章
“php开发热点文章列表”“asp开发热点文章列表”-------按文章的点击察看次数排序显示文章，显示3篇文章
“asp开发最新文章”按文章的发布顺序，倒序排列显示，显示3篇文章
“添加新文章”------一个文章的发布功能, 包括文章标题/作者/内容
“文章察看”---------显示某篇文章内容

综合的看一下,对功能进行分类包括:
1、文章列表：正常的分页列表、按点击数列表、按发布顺序的列表
2、文章发布：一个表单的输入和处理
3、文章察看：读取显示文章内容

呵呵，功能的确是太简单了些。

三、设计数据库：

数据库名：cmstest

数据表：

CREATE TABLE `article` (
`id` INT NOT NULL AUTO_INCREMENT,
`title` VARCHAR( 100 ) NOT NULL ,
`content` TEXT NOT NULL ,
`datetime` DATETIME NOT NULL ,
`clicks` INT( 11 ) ,
`pid` TINYINT( 2 ) NOT NULL ,
PRIMARY KEY ( `id` )
);

CREATE TABLE `cat` (
`cid` TINYINT( 2 ) NOT NULL ,
`cname` VARCHAR( 20 ) NOT NULL ,
PRIMARY KEY ( `cid` )
);

------------------------------
article表是文章内容表，
----------------------------
`id` 文章编号
`title` 文章标题
`content` 文章内容
`datetime` 发布时间
`clicks` 点击数
`pid` 分类表号
------------------------------
cat表是文章的类别表
----------------------------
`cid` 分类表号
`cname` 分类名称
----------------------------

上面是表的数据库结构，光有了这些还不够，还要有数据
INSERT INTO `cat` VALUES(1, "php开发"),(2, "asp开发");
INSERT INTO `article` VALUES(1, "php开发1", "php开发1内容", "2004-8-1 1:1:1", 0, 1);
INSERT INTO `article` VALUES(2, "php开发2", "php开发2内容", "2004-8-2 1:1:1", 0, 1);
INSERT INTO `article` VALUES(3, "php开发3", "php开发3内容", "2004-8-3 1:1:1", 4, 1);
INSERT INTO `article` VALUES(4, "php开发4", "php开发4内容", "2004-8-4 1:1:1", 3, 1);
INSERT INTO `article` VALUES(5, "php开发5", "php开发5内容", "2004-8-5 1:1:1", 2, 1);
INSERT INTO `article` VALUES(6, "php开发6", "php开发6内容", "2004-8-6 1:1:1", 1, 1);
INSERT INTO `article` VALUES(7, "php开发7", "php开发7内容", "2004-8-7 1:1:1", 0, 1);
INSERT INTO `article` VALUES(8, "jsp开发1", "jsp开发1内容", "2004-8-1 1:1:1", 0, 2);
INSERT INTO `article` VALUES(9, "jsp开发2", "jsp开发2内容", "2004-8-2 1:1:1", 0, 2);
INSERT INTO `article` VALUES(10, "jsp开发3", "jsp开发3内容", "2004-8-3 1:1:1", 4, 2);
INSERT INTO `article` VALUES(11, "jsp开发4", "jsp开发4内容", "2004-8-4 1:1:1", 3, 2);
INSERT INTO `article` VALUES(12, "jsp开发5", "jsp开发5内容", "2004-8-5 1:1:1", 2, 2);
INSERT INTO `article` VALUES(13, "jsp开发6", "jsp开发6内容", "2004-8-6 1:1:1", 1, 2);
INSERT INTO `article` VALUES(14, "jsp开发7", "jsp开发7内容", "2004-8-7 1:1:1", 0, 2);

这样我们的数据库就设计完了。接下来就开始涉及到具体的实现了。

四、设计config.inc.php文件

这个文件用来设置一些web上通用的数据信息和一些参数，其他的具体的实现页面都通过这个页面获取需要的数据，下面是配置的清单

//数据库设置
define('DB_USERNAME', 'root');
define('DB_PASSWORD', '');
define('DB_HOST', 'localhost');
define('DB_NAME', 'cmstest');
define('DB_PCONNECT', true);

// web的基本路经设置
define('CMS_ROOT', 'C:/Apache2/htdocs/cmstest/');
define('CMS_SRCPATH', CMS_ROOT.'src/');

//smarttemplate 模板解析工具的设置
define('SMART_REUSE_CODE', false);
define('SMART_TEMPLATE_DIR', CMS_ROOT.'smart/template/');
define('SMART_TEMP_DIR', CMS_ROOT.'smart/temp/');
define('SMART_CACHE_DIR', CMS_ROOT.'smart/cache/');
define('SMART_CACHE_LIFETIME', 100);
require_once(CMS_SRCPATH.'lib/smarttemplate/class.smarttemplate.php');

//要包含的基础文件,里面都是一些基本的函数
require_once CMS_SRCPATH.'MysqlUtil.php';
require_once CMS_SRCPATH.'ArticleUtil.php';
require_once CMS_SRCPATH.'CoreUtil.php';
require_once CMS_SRCPATH.'ParseTpl.php';

//session 控制
session_cache_limiter('private_no_expire');
session_start();

?>

其中的define('CMS_ROOT', 'C:/Apache2/htdocs/cmstest/');路经根据自己apach的web路经来改（参照最开始介绍文件夹结构的地方改）。

五、制作功能接口（1）

首先对mysql数据库函数进行包装，简化对数据库操作，网上有很多这样的开源的类。但是这里我个人根据自己的需求和习惯，自己对mysql的函数进行了包装，写得好坏就先不管了。这个地方简单的看一下就可以了，不同的包装的类操作是不同的，而且这里的主要目的是理解这套“架构”，不用太扣代码。

-------MysqlUtil.php--------

function dbConnect(){
global $cnn;
$cnn = (DB_PCONNECT? mysql_pconnect(DB_HOST, DB_NAME, DB_PASSWORD):
mysql_connect(DB_HOST, DB_NAME, DB_PASSWORD)) or
die('数据库连接错误');
mysql_select_db(DB_NAME, $cnn) or die('数据库选择错误');
mysql_query("SET AUTOCOMMIT=1");
}

function &dbQuery($sql){
global $cnn;
$rs = &mysql_query($sql, $cnn);
while($item=mysql_fetch_assoc($rs)){
$data[] = $item;
}
return $data;
}

function &dbGetRow($sql){
global $cnn;
$rs = mysql_query($sql) or die('sql语句执行错误');
if(mysql_num_rows($rs)>0)
return mysql_fetch_assoc($rs);
else
return null;
}

function dbGetOne($sql, $fildName){
$rs = dbGetRow($sql);
return sizeof($rs)==null? null: (isset($rs[$fildName])? $rs[$fildName]: null);
}

function &dbPageQuery($sql, $page=1, $pageSize=20){
if($page===null) return dbQuery($sql);
$countSql = preg_replace('|SELECT.*FROM|i','SELECT COUNT(*) count FROM', $sql);
$n = (int)dbGetOne($countSql, 'count');
$data['pageSize'] = (int)$pageSize<1? 20: (int)$pageSize;
$data['recordCount'] = $n;
$data['pageCount'] = ceil($data['recordCount']/$data['pageSize']);
$data['page'] = $data['pageCount']==0? 0: ((int)$page<1? 1: (int)$page);
$data['page'] = $data['page']>$data['pageCount']? $data['pageCount']:$data['page'];
$data['isFirst'] = $data['page']>1? false: true;
$data['isLast'] = $data['page']<$data['pageCount']? false: true;
$data['start'] = ($data['page']==0)? 0: ($data['page']-1)*$data['pageSize']+1;
$data['end'] = ($data['start']+$data['pageSize']-1);
$data['end'] = $data['end']>$data['recordCount']? $data['recordCount']: $data['end'];
$data['sql'] = $sql.' LIMIT '.($data['start']-1).','.$data['pageSize'];
$data['data'] = &dbQuery($data['sql']);
return $data;
}

function dbExecute($sql){
global $cnn;
mysql_query($sql, $cnn) or die('sql语句执行错误');
return mysql_affected_rows($cnn);
}

function dbDisconnect(){
global $cnn;
mysql_close($cnn);
}

function sqlGetOneById($table, $field, $id){
return "SELECT * FROM $table WHERE $field=$id";
}

function sqlMakeInsert($table, $data){
$t1 = $t2 = array();
foreach($data as $key=>$value){
$t1[] = $key;
$t2[] = "'".addslashes($value)."'";
}
return "INSERT INTO $table (".implode(",",$t1).") VALUES(".implode(",",$t2).")";
}

function sqlMakeUpdateById($table, $field, $id, $data){
$t1 = array();
foreach($data as $key=>$value){
$t1[] = "$key='".addslashes($value)."'";
}
return "UPDATE $table SET ".implode(",", $t1)." WHERE $field=$id";
}

function sqlMakeDelById($table, $field, $id){
return "DELETE FROM $table WHERE $field=$id";
}

?>

五、制作功能接口（2）

下面来正式的看看，我们共要实现的功能进行的包装

------------ArticleUtil.php----------------
//显示文章列表的函数
//getArticleList(文章类别, 排序方法, 当前显示第几页, 每页显示几条)
function getArticleList($catId, $order, $page, $pageSize){
$sql = "SELECT * FROM article WHERE pid=$catId ORDER BY $order";
return dbPageQuery($sql, $page, $pageSize);
}
//查询某个文章的内容
//getArticle(文章编号)
function getArticle($id){
$sqlUpdate = "UPDATE article SET clicks=clicks+1 WHERE id=$id";
dbExecute($sqlUpdate);
$sql = "SELECT * FROM article WHERE art_id=$id";
return dbGetRow($sql);
}
//添加文章
//addArticle(文章内容数组)
function addArticle($data){
$sql = sqlMakeInsert('article', $data);
return dbExecute($sql);
}
?>

这段代码是不是就简单多了啊？这就是自己对mysql函数进行包装的好处！
下面来研究一下他们是怎么实现我们的功能的呢。
“php开发文章列表”--------getArticleList(1, "id DESC", $page, 5)
“asp开发文章列表”--------getArticleList(2, "id DESC", $page, 5)
“php开发热点文章列表”----getArticleList(1, "clicks DESC, id DESC", 1, 3)
“asp开发热点文章列表”----getArticleList(2, "clicks DESC, id DESC", 1, 3)
“asp开发最新文章”--------getArticleList(2, "id DESC", 1, 3)
“添加新文章”-------------addArticle($data)
“察看文章”---------------getArticle($id)

六、对smarttemplate类进行包装（革命尚未成功，同志仍须努力）

具体的smarttemplate的使用这里就不讲了，不然口水讲没了，都讲不完。下面这个是具体的对包装函数

-------------ParseTpl.php----------------

function renderTpl($viewFile, $data){
$page = new SmartTemplate($viewFile);
foreach($data as $key=>$value){
if(isset($value[data])){
$page->assign($key, $value[data]);
unset($value[data]);
$page->assign($key."_page", $value);
} else {
$page->assign($key, $value);
}
}
$page->output();
}

?>

七：文章列表察看页面实现和模板处理（万里长征的最后一步）

先来看看页面list1的实现,在list1里面分页用了一个page.js文件，这个文件是自己给自己写的一个js分页的函数，挺好用的
---------------page.js---------------
//--------共 20 条记录，当前 86/99 页 [1]... [82] [83] [84] [85] [86] [87] [88] [89] [90] ...[99] GO-------------------
//recordCount = 20;
//show = 20
//pageShow = 11;
//pageCount = 100;
//pageNow = 86;
//pageStr = "?page=_page_";
//document.write(showListPage(recordCount, show, pageCount, pageNow, pageStr));
function showListPage(recordCount, show, pageShow, pageCount, pageNow, pageStr){
if(pageCount<1) pageCount =0;
if(pageNow<1) pageNow = 0;
str = '共 '+recordCount+' 条记录，当前 '+pageNow+'/'+pageCount+' 页 ';

if(pageCount<=pageShow){
startHave = false;
endHave = false;
startNum = 1;
endNum = pageCount;
} else if(pageNow-1 <= pageShow/2){
startHave = false;
endHave = true;
startNum = 1;
endNum = pageShow-1;
} else if(pageCount-pageNow <= pageShow/2){
startHave = true;
endHave = false;
startNum = pageCount - pageShow + 2;
endNum = pageCount;
} else {
startHave = true;
endHave = true;
startNum = pageNow - Math.floor((pageShow-2)/2);
endNum = startNum + pageShow - 3;
}

if(startHave){
startStr = " [1]... ";
str += startStr;
}

for(i=startNum; i<=endNum; i++){
if(pageNow==i)
str += "[" + i + "]";
else
str += " [" + i + "] ";
}

if(endHave){
endStr = " ...[" + pageCount + "] ";
str += endStr;
}
return str;
}

--------------list1.htm----------------
添加新文章

--------------------------------------------------------------------------------

 php开发文章

 {id}--{title}

--------------------------------------------------------------------------------

 php开发热点文章

 {id}--{title}

 
--------------------------------------------------------------------------------

 asp开发最新文章

 {id}--{title}

--------------list1.php----------------

require_once "config.inc.php";

dbConnect();
$data = array();
$data[phplist] = getArticleList(1, "id DESC", (int)$_GET[page], 5);
$data[phphotlist] = getArticleList(1, "clicks DESC, id DESC", 1, 3);
$data[aspnewlist] = getArticleList(2, "id DESC", 1, 3);
dbDisconnect();

renderTpl('list1.htm', $data);

?>

运行的效果怎么样，是不是实现了要求的功能呢。现在我们再做一下改动，在里面加上“asp开发热点文章列表”，实现代码如下

--------------list1.htm----------------
添加新文章

--------------------------------------------------------------------------------

 php开发文章

 {id}--{title}

--------------------------------------------------------------------------------

 php开发热点文章

 {id}--{title}

 
--------------------------------------------------------------------------------

 asp开发最新文章

 {id}--{title}

 asp热点文章

 {id}--{title}

--------------list1.php----------------

require_once "config.inc.php";

dbConnect();
$data = array();
$data[phplist] = getArticleList(1, "id DESC", (int)$_GET[page], 5);
$data[phphotlist] = getArticleList(1, "clicks DESC, id DESC", 1, 3);
$data[aspnewlist] = getArticleList(2, "id DESC", 1, 3);
$data[asphotlist] = getArticleList(2, "clicks DESC, id DESC", 1, 3);
dbDisconnect();

renderTpl('list1.htm', $data);

?>

仔细观察一下前后的区别，list1.php里面只是简单的加入了一行的代码，就实现这个改动，感觉怎么样啊？是不是超级简单。

其实这种设计模式的好处还不只是这点：
1、可以把程序的核心代码隔离开管理，便于以后程序的管理维护
2、对于程序的可扩展性也很好，假设list1.php中要加入产品列表，我是不是也可以这么做呢？把对产品的管理也写成统一的数据库操作接口，然后简单的修改模板文件加入产品列表部分，最后在list1.php中加入一行函数调用的代码，就可以实现。
3、代码复用，如果您是做中小型企业网站的，那这么做对您的好处是最大的，因为这种类型的网站的设计结构几乎是一样的，您可能只需要更改一下模板的样式，就可以赚到钞票了。

这么看来这种模式是不是给您带来了很多的好处呢？

-----------lsit2.htm---------------
添加新文章

原文：http://pear.php.net/manual/en/standards.php

翻译：廖宇雷

最后更新日期：2003/05/06

内容列表

• 缩进
• 控制结构
• 函数调用
• 函数定义
• 注释
• 包含代码
• PHP 代码标记
• 头注释块
• 使用 CVS
• 例子 URLs
• 命名约定

缩进

缩进使用4个空格，而不是 tab。如果你使用 Emacs 编辑 PEAR 代码，你应该设置 indent-tabs-mode 为 nil。下面是一个 mode hook 的示例，用于设置 Emacs 符合缩进标准（你必须确保在编辑 PHP 文件时，这些设置发生作用）：

  (defun php-mode-hook ()
  (setq tab-width 4
        c-basic-offset 4
        c-hanging-comment-ender-p nil
        indent-tabs-mode
        (not
         (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name))
              (string-match "\.php$" (buffer-file-name))))))

这里是同等效果的 vim 规则：

  set expandtab
  set shiftwidth=4
  set softtabstop=4
  set tabstop=4

控制结构

控制结构包含 if、for、while、switch 等。这里有一个 if 语句的示例和一个 switch 语句的示例：

if 语句的示例：

<?php
if ((condition1) || (condition2)) {
    action1;
} elseif ((condition3) && (condition4)) {
    action2;
} else {
    defaultaction;
}
?>

switch 语句的示例：

<?php
switch (condition) {
case 1:
    action1;
    break;
case 2:
    action2;
    break;
default:
    defaultaction;
    break;
}
?>

控制语句应该在控制关键词和开始的圆括号之间应该有一个空格，以此和函数调用进行区别。

强烈建议你总是使用花括号将控制结构各部分标识出来。即使是在技术上可以不使用花括号的地方。这可以增加代码的可读性，同时避免在结构部分增加新行后引入逻辑上的错误。

原始代码：

if (condition)
    return true;
else
    return false;

修改后的代码：

if (condition)
    do something; // 出现逻辑错误
    return true;
else
    return false;

正确的做法：

if (condition) {
    do something;
    return true;
} else {
    return false;
}

函数调用

调用函数时，函数名和开始的括号之间不应该有空白字符。参数和开始及结束的括号之间不应有空格。而除第一个参数外，其他参数都应该用一个空格分隔。这里有一个示例：

<?php
$var = foo($bar, $baz, $quux);
?>

像上面的示例代码，赋值运算等号两边都应该使用一个空格。如果是相关的赋值运算，应该采用下面的形式以提供更好的可读性：

<?php
$short = foo($bar);
$long_variable = foo($baz);
?>

函数定义

按照“one true brace”约定声明函数：

<?php
function fooFunction($arg1, $arg2 = '')
{
    if (condition) {
        statement;
    }
    return $val;
}
?>

“one true brace”约定就是开始的花括号单独占一行，而不是跟在其他语句后面。

具有默认值的参数应该位于参数列表的后面（事实上 PHP 语言定义也要求如此）。如果适合，函数应该总是返回一个有意义的值。这里有一个稍微长一点的示例：

<?php
function connect(&$dsn, $persistent = false)
{
    if (is_array($dsn)) {
        $dsninfo = &$dsn;
    } else {
        $dsninfo = DB::parseDSN($dsn);
    }

    if (!$dsninfo || !$dsninfo['phptype']) {
        return $this->raiseError();
    }
    return true;
}
?>

注释

类型（class）的联机文档应该符合 PHPDoc（类似于 JavaDoc）的约定。更多关于 PHPDoc 的信息可以访问 http://www.phpdoc.de/ 获得。

此外，强烈鼓励使用非文档注释。一般性规则是对于那些容易忘记作用的代码添加简短的介绍性注释。

推荐使用 C 样式的注释（/* */）和标准 C++ 注释（//)，而不应该使用 Perl/shell 样式的注释（#）。

包含代码

无论在什么地方无条件包含一个类型文件，应该使用 require_once()。如果有条件的包含一个类型文件（例如使用工厂方法），应该使用 include_once()。使用两者中的任何一个都能够确保类型文件只包含一次。它们共享一个文件列表，因此你不需要担心混淆他们 —— 一个文件使用 require_once() 包含后不会在 include_once() 中再一次被包含。

备注：include_once() 和 require_once() 是一个声明，而不是函数。你不需要使用圆括号将文件名扩起来（不过使用括号也不会出现错误）。

PHP 代码标记

总是使用 <?php ?> 来界定 PHP 代码，而不要使用 <? ?> 速记方式。这是为了符合 PEAR 一致性所必须的，同时也是在不同操作系统和不同安装设置环境下移植 PHP 代码所要求的。

头注释块

PEAR 发布的所有源代码文件头部都应该包含下面的注释块：

<?php
/* vim: set expandtab tabstop=4 softtabstop=4 shiftwidth=4: */
// +----------------------------------------------------------------------+
// | PHP version 4                                                        |
// +----------------------------------------------------------------------+
// | Copyright (c) 1997-2002 The PHP Group                                |
// +----------------------------------------------------------------------+
// | This source file is subject to version 2.0 of the PHP license,       |
// | that is bundled with this package in the file LICENSE, and is        |
// | available at through the world-wide-web at                           |
// | http://www.php.net/license/2_02.txt.                                 |
// | If you did not receive a copy of the PHP license and are unable to   |
// | obtain it through the world-wide-web, please send a note to          |
// | license@php.net so we can mail you a copy immediately.               |
// +----------------------------------------------------------------------+
// | Authors: Original Author <author@example.com>                        |
// | Your Name <you@example.com>                                          |
// +----------------------------------------------------------------------+
//
// $ Id $
?>

这里没有硬性规定要将一个代码贡献者的名字添加到文件注释的作者列表中。一般情况下，他们的更改属于“substantial”目录（意味大约10%到20%的代码被改写）。有一个例外就是代码贡献者重写了函数或者贡献了新的程序逻辑。

简单的代码重组和 bug 修复不应该增加新作者，这是不恰当的。

不在核心 PEAR 仓库中的文件应该有一个类似的注释块来说明版权、许可协议和作者。所有文件应该包含一个模式行（modeline，用于 vim 和 emacs）以确保一致性。

使用 CVS

这个小节的内容仅仅适用于 cvs.php.net 上使用 CVS 的包。

在每一个文件中包含 $Id $（两个 $ 符号之间的关键字不能够有空格，但由于此文档也是用 CVS 管理，因此只好加个空格，避免被 CVS 替换掉） CVS 关键字，以便查看文件当前状态和最后修改时间等信息。如果已经存在“Last Modified:”这样的信息，则替换为 $Id $ 标记。

这个小节的其他内容假定你有关于 CVS 标记和分支（branches）的基本知识。

CVS 标记用于标识你包中的文件释放之前所作的修订。下面的列表是必需使用和建议使用的 CVS 标记：

RELEASE_n_n

（必需的）用于标记一个释放版本。如果你没有使用这个标记，别人就没有办法在你发布一个释放版本时从 CVS 服务器获取你的包。

QA_n_n

（分支，可选）如果你觉得在发布释放版本之前要提供一个候选释放版本，那么一个好主意就是增加一个分支。这个分支可以让你将释放版本隔离出来，并在正式发布释放版本之前可以为这些分支单独应用更新。期间，正常的开发工作可以在主干上继续进行。

MAINT_n_n

（分支，可选）如果你需要创建一个较小修改的释放版本（例如在 1.2 之后发布 1.2.1）。那么你可以创建一个分支来达到目的。

仅有 RELEASE 标记是必须的，其他标记为了方便推荐你使用。

下面是一个如何为 "Money_Fast" 包 1.2 释放版本增加标记的示例：

$ cd pear/Money_Fast
$ cvs tag RELEASE_1_2
T Fast.php
T README
T package.xml

经过上面的操作，就可以在 PEAR Web 网站上获取你的一系列释放版本了。

这里是一个如何建立 QA 分支的示例：

$ cvs tag QA_2_0_BP
...
$ cvs rtag -b -r QA_2_0_BP QA_2_0
$ cvs update -r QA_2_0
$ cvs tag RELEASE_2_0RC1
...and then the actual release, from the same branch:
$ cvs tag RELEASE_2_0

"QA_2_0_BP" 标记是一个 "branch point" 标记，用于标记分支的开始。总是用这样的标记来标明分支的开始是一个好主意。MAINT 分支可以使用 RELEASE 标记作为它的分支起点。

示例中的 URL

所有示例中用到的 URL 地址都应该是 "example.com"、"example.org"、"example.net"。

命名约定

一般而言，class、函数和变量的名字应该总是能够描述让代码阅读者能够容易的知道这些代码的作用。

Classes

class 应该具有一个描述性的名字。可能时应该避免使用缩写。class 名字应该总是用一个大写字母开始。从 class 名字中也能够反映出 PEAR class 的层次。层次中的每个级别都用下划线进行分隔。好的 class 名字示例如下：

Log
Net_Finger
HTML_Upload_Error

函数和方法

函数和方法应该使用 "studly caps" 样式命名。函数应该将所在包的名字作为前缀，以避免与其他包的函数发生名字冲突。名字的受字母（前缀之后）应该是小写，每一个新单词应该以大写字母开头。下面是一些示例：

connect()
getData()
buildSomeWidget()
XML_RPC_serializeData()

私有 class 成员和属性（意味着 class 成员和属性只应该由同一个 class 中声明的成员使用。不过 PHP 并不支持强制性的私有命名空间）应该用一个下划线开头。示例：

_sort()
_initTree()
$this->_status

常数

常数应该总是全部使用大写字母命名，用下划线来分隔单词。常数名字的前缀应该使用大写的 class/包 名字。例如：DB:: 包使用的所有常数都已 DB_ 开头。

全局变量

如果你的包需要定义全局变量，那么应该用下划线跟上包的名字和另一个下划线作为开头。例如，PEAR 包使用一个全局变量名为 $_PEAR_destructor_object_list。

预定义的值 true、false 和 null

PHP 的内建值 true、false 和 null 必须全部用小写字母书写。

尝试安装phpwiki，下边的是我的步骤。



修改config/config.ini，可以以config-default.ini为蓝本，以config-dist.ini里的注释作为参考。

设置DEBUG=1，可以在页面下方显示xhtml和css的标示以及页面加载时间；

设置WIKI_NAME=CrisperWiki，之后，可以将自己的logo和signature命名为CrisperWikiLogo.png和CrisperWikiSignature.png，放到theme/default/images下。参见lib/interwiki.map的例子来进行命名；

设置ADMIN_USER和ADMIN_PASSWD，可以用passencrypt.php来加密密码，如果加密了密码，那么一定要设置ENCRYPTED_PASSWD = true；

如果不想生成访问日志，那就设置ACCESS_LOG = ""；


设置DATABASE_TYPE = SQL，如果想使用PEAR DB lib来访问某种SQL数据库；

设置DATABASE_PREFIX = phpwiki_；

如果使用mysql数据库，那么将这一行：mysql://user:password@host/databasename设置好，替换这一行中的对应部分：DATABASE_DSN = "mysql://guest@unix(/var/lib/mysql/mysql.sock)/test"；

如果使用SQL数据库，那就将这两行注释掉：DATABASE_DIRECTORY = /tmp和DATABASE_DBA_HANDLER = gdbm；


如果不想让任何一个人查看wiki页面，将ALLOW_ANON_USER，ALLOW_ANON_EDIT和ALLOW_BOGO_LOGIN设置成false，设置ALLOW_USER_PASSWORDS = true；

设置USER_AUTH_ORDER = "Db"将使用数据库来进行用户认证；

设置PASSWORD_LENGTH_MINIMUM = 4来保证密码至少四位长；

由于设置USER_AUTH_POLICY = old将使用所有可能的方法来进行用户认证，会比较慢，所以设置USER_AUTH_POLICY = first-only来确保只使用第一种方法，也就是数据库的方法；

由于不使用其他认证（LDAP，IMAP，POP3，File，），所以将所有其他的认证的选项全部注释掉；

设置AUTH_SESS_USER = userid，这是已认证用户的sessionid；设置AUTH_SESS_LEVEL = 2，保证使用带密码的认证方式；

设置GROUP_METHOD = DB，将从数据库中读取用户组信息；

将DBAUTH_AUTH_CHECK，DBAUTH_AUTH_CRYPT_METHOD和DBAUTH_AUTH_USER_EXISTS设置好，我都是直接用的default值，用plain的密码；同时把DBAUTH_AUTH_UPDATE也设置好；

将DBAUTH_PREF_SELECT设置为使用pref表，这样就能从专门的表中取得用户的preference；同时把DBAUTH_PREF_UPDATE也设置好；

设置group和user的对应关系，我用的是1:n的关系，去掉only one group per user (1:n)后面三行的注释；



设置完成之后，试图运行，却发现无论如何用SQL方式的数据库就是无法连接，暂时不知道原因，最后用dbm的方式，使wiki运行起来了（配置文件的相应地方要做修改）。但是却发现对中文的支持很差……于是放弃。

引用页 http://prdownloads.sourceforge.net/phpwiki/