用ActivePHP打造版本管理系统

学习PHP时，我们总是被教导到，PHP是一种服务器端脚本，是不能用来控制客户端的。而伴随着PHP5的发布，这句话就不是那么正确了。因为现在，PHP也可以用来写客户端脚本了。是的，你没有听错，用PHP写客户端脚本。

ActivePHP的安装

下面我们就来演示一下如何使用PHP写客户端脚本。首先，你需要下载PHP5在windows上的安装包，然后解压到一个目录里，比如：C:Program FilesEasyPHP5php，接着呢，进入windows的命令行模式，cd到你解压PHP5的目录，然后键入：
regsvr32 php5activescript.dll

回车以后，你就会看见一个成功提示：
这说明你已经可以使用ActivePHP了。好，下边我们就来写一个简单的脚本来测试下，仍然是全球通用的HelloWorld:P。

<? 代码列表 ?>

<script language="ActivePHP5">
$document->write( 'Hello World!' );
</script>


将上边的代码保存为Hello.htm，然后双击它，你就可以看见下边的结果了。

<? 环境要求 ?>

PHP：5.0.0
OS: Windows
Browser: IE

嗯，效果不错，但是还不够有客户端的特色。让我们来修改下代码：

<? 代码列表 ?>

<script language="ActivePHP5">
$window->alert( 'Hello World!' );
</script>


再运行下看看~
是不是有些感觉了？

我们的版本管理系统

下边我们回过头来说说版本管理系统。我们要做的版本管理系统很简单，就是把开发目录下的文件和数据库的数据表打成一个RAR包，按时间命名并放到一个备份目录下。由于本文的主要目的是演示ActivePHP的使用，我们就不考虑对RAR包的管理和将其解压覆盖原有数据的内容了，不过对于一个版本管理系统来说，这部分是很重要的，建议大家自己完成;） 。

<? 相关知识 ?>

Mysql的数据库是以文件形式存放在mysql/data目录下的，一个库对应着一个目录。


首先我们需要知道PHP调用Windows上其他程序的方法，那就是System命令。这个命令简单得和Echo一样，直接
System('command');

就可以了。

然后我们就需要知道RAR的命令行使用方法了，这种东西应该当然要找帮助文档了，就在RAR的安装目录下。在英文堆里看了好久，终于找到了一个方法：把要压缩的文件写到一个文本文件里，再把文件名作为参数，传给RAR。写成命令行就是:
H1>
(PHP 3, PHP 4 >= 4.0.0)
fseek -- 定位一个文件的指针
描述
 
int fseek (int fp, int offset [, int whence])
 
为这个文件的引用fp设置文件指示器。这个新的位置，是从文件开始以字节为标准由offset指定的，或由 whence指定的位置开始。
　whence的值见下：
 
SEEK_SET - 从文件开始；
SEEK_CUR - 从当前位置；
SEEK_END - 从募 写文档是一项乏味却不得不做的工作，而编写API级的文档更是意味着大量的重复劳动和难以保持的一致性。这里我们要推荐给大家的，是支持PHP5语法分析的文档工具——phpDocumentor。
使用phpDocumentor不仅可以自动从代码中提取出函数和方法定义，还可以自动处理各个class之间的关系，并据此生成class tree。你还可以选择将文档生成html、chm或者pdf。有了phpDocumentor，文档工作变得轻松了很多。

安装phpDocumentor
在pear下安装phpDocumentor是一件极其简单的事情，只需要在cmd窗口中cd 到php安装目录下，然后输入
Pear install phpDocumentor

Pear就会自己下载并完成phpDocumentor的安装。
在phpDocumentor成功安装后，php安装目录下会多出来一个phpdoc.bat。这个文件就是我们用来生成文档的批处理文件了。
<? 相关知识 ?>

phpDocumentor是phpDoc的升级版本，是专门为支持php5语法而重写的文档工具，当你的php版本为5时，运行phpDoc.bat，它会自动去调用phpDocumentor。所以文章中的提到的phpDoc和phpDocumentor实际上是相同的。


在phpdoc.bat所在目录下，输入
Phpdoc H1>
(PHP 3, PHP 4 >= 4.0.0)
fwrite -- 二进制文件写入
描述
 
int fwrite (int fp, string string [, int length])
 
fwrite() 写入字符串string 的内容到由fp指定的文件流中。如果length 给出，将写完length 指定的字节后结束。
注意，如果length 参数给出，那么magic_quotes_runtime 配置选项将被忽略，同时字符串中的“”将不被删除。
注意：在某些系统上将区分二进制和文本文件(i.e. Windows)，这个文件必须使用带有'b'参数的模式的fopen() 来打开。
参见fread(), fopen(), fsockopen(), popen(), 和 fputs().

　　这里可以看到另外一个语句Limit，Limit语句就是用来针对具体的请求方法来设定访问控制的，其中可以使用GET、POST等各种服务器支持的请求方法做Limit的参数，来设定对不同请求方法的访问限制。一般可以打开对GET、POST、 HEAD三种请求方法，而屏蔽其他的请求方法，以增加安全性。Limit语句中，可以用Order 、Allow、Deny，Allow和Deny中可以使用匹配的方法针对域名和IP进行限制，只是对于域名是从后向前匹配，对于IP地址则从前向后匹配。
　

　　DirectoryIndex index.html
　　很多情况下，URL中并没有指定文档的名字，而只是给出了一个目录名。那么Apache服务器就自动返回这个目录下由DirectoryIndex定义的文件，当然可以指定多个文件名字，系统会这个目录下顺序搜索。当所有由DirectoryIndex指定的文件都不存在时，Apache服务器可以根据系统设置，生成这个目录下的所有文件列表，提供用户选择。此时该目录的访问控制选项中的Indexes选项（Options Indexes ）必须打开，以使得服务器能够生成目录列表，否则Apache将拒绝访问。
　

　　AccessFileName .htaccess
　　AccessFileName定义每个目录下的访问控制文件的文件名，缺省为.htaccess，可以通过更改这个文件，来改变不同目录的访问控制限制。
　

Order allow,deny
Deny from all
　　除了可以针对目录进行访问控制之外，还可以根据文件来设置访问控制，这
就是File语句的任务。使用File 语句，不管文件处于哪个目录，只要名字匹配， 就必须接受相应的访问控制。这个语句对于系统安全比较重要，例如上例将屏蔽所有的使用者不能访问.htaccess文件，这样就避免.htaccess中的关键安全信息不至于被客户获取。
　

　　#CacheNegotiatedDocs
　　缺省情况下如果代理服务器和Apache服务器协商是否缓存其网页，Apache给
予否定的回答，不希望自己的网页被代理服务器缓存。然而这样就不能有效的利用代理服务器的优势，因此可以设置CacheNegotiatieDocs 选项， 使得代理服务器可以对网页进行缓存。然而即使不设置这个选项，有的代理服务器（或通过调整设置）也能对网页进行缓存。
　

　　UseCanonicalName On
　　打开这个UseCanonicalName是Web服务器的标准做法，因为客户发送的大部分请求都是对本服务器的引用，这样服务器就能使用ServerName和Port选项的设置内容构建完整的URL，并回应客户，使浏览器能得到规范的URL。如果将这个参数设置为Off，那么Apache将使用从客户请求中获得服务器的名字和端口值（支持HTTP 1.1的客户的请求中将会有这些信息），重新构建URL。