[原创]PmWiki安装配置详解

时间：2007-12-26 来源：howie lin

－－－－－－－PmWiki From Scratch

前言

什么是PmWiki呢，官方解释是“PmWiki is a wiki-based system for collaborative creation and maintenance of websites.”。由此可以看出它支持多人共同维护网页，并且使用方法非常简便。这两天安装并配置好了自己的PmWiki，其中涉及到了很多细节，小学班主任曾经说过，好记性比不上烂笔头，所以我就把步骤都记录下来。^_^PmWiki是基于PHP的wiki引擎，非常适合作为个人网站。我看上PmWiki是想让它组织好自己的工作步骤，“工欲善其事,必先利其器”，let's go!

软件环境

    PmWiki的官方网站是http://www.pmwiki.org/     PmWiki要依赖Apache和PHP，而我的Linux里面一个也没有，所以这篇blog又叫"PmWiki From Scratch"。于是上网下载了如下安装包：
    httpd-2.2.2.tar.bz2
    php-5.2.5.tar.gz
    pmwiki-2.1.27.tar

安装

由于我下载的都是源代码，所以要先编译，然后安装 1) Apache

$./configure --enable-layout=FHS --enable-mods-shared=all $make $make install

2) PHP （注意编译PHP之前，最好保证系统已经安装了libxml, 这个包用于解析XML文件。)

$./configure --prefix=/usr \ --sysconfdir=/etc \ --with-apxs2 \ --enable-force-cgi-redirect \ --enable-discard-path \ --with-config-file-path=/etc \ --with-zlib \ --enable-bcmath \ --with-bz2 \ --enable-calendar \ --enable-dba \ --enable-exif \ --enable-ftp \ --with-gettext \ --enable-mbstring \ --with-ncurses \ --with-readline && $make $make install

3)PmWiki
PmWiki是不用安装的，直接将其解压，在后面的步骤进行配置。

确认Apache server工作正常

先确认Apache server已经启动，然后在浏览器上输入server的IP，如果工作正常，在浏览器上会显示“It works.”字样。注意/etc/hosts文件要配置正确。特别是IP地址后面的域名格式要正确。

$cat /etc/hosts 127.0.0.1 localhost 192.168.0.12 YOURS.org in YOURS

Pmwiki跑起来

    假设你的PmWiki放置的路径是$YOURPMDIR，我的路径是 /srv/www/pmwiki。
    1）修改 /etc/apache/httpd.conf
    这是Apache的配置文件，主要的配置项有:

DocumentRoot "$YOURPMDIR" #我的配置是 DocumentRoot "/srv/www/pmwiki" <DIRECTORY "$YOURPMDIR"> #我的配置是 <Directory "$YOURPMDIR">  #我的配置是<Directory "/srv/www/pmwiki">
<IfModule dir_module>

    DirectoryIndex pmwiki.php  #设置成PmWiki的首页
</IfModule>

2) 重启Apache, 用浏览器浏览，发现页面显示PHP文件源码，估计是apache没有把网页交给PHP解析。上网搜索一番，发现只要在/etc/apache/httpd.conf文件中加入如下两行就解决问题。

AddType application/x-httpd-php .php   
AddType application/x-httpd-php-source .phps

功能增强

经过上面的步骤，PmWiki已经完全能够跑起来，我又给我的PmWiki配置一些功能： 1）创建PmWiki的配置文件 PmWiki的配置文件路径是$YOURPMDIR/local/config.php, 先创建一个空的php文件，内容如下：

 <?php if (!defined('PmWiki')) exit();
?>

2）中文支持这时PmWiki，显示中文是乱码，要解决这个问题修改$YOURPMDIR/pmwiki.php，把charset改为“utf-8”就好了。

 #  "Content-type: text/html; charset=ISO-8859-1;"); 这是原始的，注释掉
  "Content-type: text/html; charset=utf-8;");

3）权限控制向config.php 加入如下语句，他们分别代表超级用户、只读用户和编辑用户的密码。

$DefaultPasswords['admin'] = crypt('321123');
$DefaultPasswords['read'] = array(crypt('123321'));
$DefaultPasswords['edit'] = array(crypt('321123'));

4）更换皮肤经常给PmWiki变变脸感觉是很不错的，在它的官网上有很多皮肤可以下载。把下载好的皮肤（文件夹），放到$YOURPMDIR/pub/skins/ 目录，然后配置config.php。比如我下载了一个“abitmodern”的皮肤。就向$YOURPMDIR/local/config.php加入如下语句。

 $Skin = 'abitmodern';

5）上传文件如果需要上传文件到PmWiki，就需要在config.php里面加入：

$EnableUpload = 1;
$UploadDir = "/srv/www/pmwiki/uploads";
$UploadMaxSize = 100000000 ;

经过上述设置后，发现上传的文件大小失踪被限制在2M以内，忙活了一阵，才发现原来是PHP里面做了限制。向PHP的配置文件/etc/php.ini加入：

upload_max_filesize = 20M
file_uploads = On
post_max_size = 20M

6) 在PmWiki的网页里面贴图首先，用上面的方法上传图片文件，然后编辑需要贴图的PmWiki网页，加入如下类似的信息即可：

 http://192.168.0.12/uploads/Concole/i2c.jpg

结束语

500)this.width=500;" border=0> 至此，PmWiki就算安装配置完成了。编辑PmWiki的网页是非常简单的事情，做了那么多，也该它给我们服务了。