DokuWiki 的安装环境

安装 DokuWiki 对服务器的要求

  1. 具有 PHP 支持的 Web 服务器
  2. PHP 的要求

可以使用如下 info.php 脚本查看其他 php 运行参数

<?php phpinfo(); ?>

info.php

对客户端浏览器的支持

DokuWiki 的包结构

DokuWiki 的下载地址

  • 当前的稳定版是 dokuwiki-2008-05-05,本指南讲述的就是这个稳定版本。

DokuWiki 的目录结构

dokuwiki
|-- bin
|-- conf                        ---  存放配置文件
|   |-- acl.auth.php.dist         --- acl.auth.php(ACL 控制配置文件)的默认发布 *
|   |-- acronyms.conf             --- 用于定义首字母缩写词,以便当鼠标移动到这些词时显示解释信息
|   |-- dokuwiki.php              --- DokuWiki 的主配置文件 *
|   |-- entities.conf             --- 用于定义实体字符 **
|   |-- interwiki.conf            --- 用于定义 interwiki,以便使用简单的方式书写 URL **
|   |-- local.php.dist            --- local.php(本地配置文件)的默认发布 *
|   |-- mediameta.php             --- 定义用于 media manager 的 meta data 配置 *
|   |-- mime.conf                 --- 定义 mimetypes 的配置文件 *
|   |-- msg                       --- 一个标志文件,用于判断当前版本是否为最新 *
|   |-- mysql.conf.php.example    --- mysql.conf.php(mysql 用户认证的配置文件)的默认发布 *
|   |-- smileys.conf              --- 用于定义“笑脸”的配置文件 *
|   |-- users.auth.php.dist       --- users.auth.php(文本用户认证的配置文件)的默认发布 *
|   |-- wordblock.conf            --- 用于配置不允许书写的 URL **
|   `-- words.aspell.dist         --- words.aspell(拼写检查配置文件)的默认发布 *
|-- data                        ---  存放文档数据
|   |-- attic                     ---  存放版本信息
|   |-- cache                     ---  数据缓存
|   |-- index                     ---  存放内部索引
|   |-- locks                     ---  用于存放编辑页面时的锁定文件
|   |-- media                     ---  存放图片等
|   |-- meta                      ---  存放 meta 以便系统读取这些信息生成页面
|   |-- pages                     ---  存放 wiki 页面
|   `-- tmp                       ---  临时目录
|-- inc                         ---  DokuWiki 的 Include 目录
|   |-- auth                      --- 存放不同方式的用户认证脚本
|   |-- geshi                     --- 使用 geshi 进行代码加亮显示
|   |-- lang                      --- 多语言支持
|   |   |-- en
|   |   |-- fr
|   |   |-- zh
|   |   `-- zh-tw
|   `-- parser                    --- DokuWiki 的核心解析器
`-- lib
    |-- exe
    |-- images
    |-- plugins                   ---  存放插件的目录
    |   |-- acl
    |   |-- config
    |   |-- importoldchangelog
    |   |-- info
    |   |-- plugin
    |   `-- usermanager
    |-- scripts
    |-- styles
    `-- tpl                       ---  存放模版的目录
        `-- default

Dokuwiki 的目录结构

  • 标有“*”的文件一般无需改动
  • 标有“**”的文件可以根据需要进行编辑

对于一般用户而言,如下目录及文件很重要:

  • conf/ 目录下的配置文件,这些文件在安装过程中自动生成
    • acl.auth.php
    • local.php
    • users.auth.php
  • data/ 目录下的文本和图片目录
    • pages/ – 存放 wiki 文本文件
    • media/ – 存放 wiki 中引用的站内图片等
  • lib/ 目录下的模板和插件目录
    • plugins – 可以使用 Dokuwiki 的管理界面安装、更新、删除
    • tpl – 由用户直接上传要使用的模板

DokuWiki 运行时要保证:

  • Web 服务器对 data/data/tmp/ 目录及其子目录可写
  • Web 服务器对 lib/plugins/ 子目录可写以便使用插件管理器
  • Web 服务器对 conf/local.php 文件可写以便使用浏览器安装系统或日后更改配置
  • Web 服务器对 conf/users.auth.phpconf/acl.auth.php 文件可写以便使用浏览器安装系统或日后更改用户的 ACL 配置

如果上传用户不是 Web 服务器进程的用户需要适当调整权限。
参考 wiki:install:permissions

准备 DokuWiki 的安装环境

DokuWiki on Windows

在 Windows 环境下要运行 Dokuwki,您可以:

  • 若您已经在 Windows 上配置了支持 PHP 的 Web 服务器可以直接用于 DokuWiki 的安装
  • 若您还未安装 Web 服务器且不打算运行其他基于数据库的 CMS,建议使用轻量级的 LightyPHP

在 Windows 下要安装 Dokuwiki ,一般需要如下的准备工作:

  1. 配置支持 PHP 的 Web 服务器
  2. 下载 最新版的 DokuWiki
  3. 将下载文件 dokuwiki-YYYY-MM-DD.tgz 解压
  4. 复制内容到 Web 文档根目录

  • 若您希望以 http://wiki.mytest.net 域名访问 WIKI 站,将 dokuwiki-YYYY-MM-DD 目录里的内容复制到 Web 文档根目录
  • 若您希望以 http://mytest.net/dokuwiki 域名访问 WIKI 站,首先将 dokuwiki-YYYY-MM-DD 目录改名为 dokuwiki ,然后将 dokuwiki 目录复制到 Web 文档根目录

DokuWiki on CentOS/RHEL

例如:在 CentOS 5.1 下要安装 Dokuwiki ,一般需要如下的准备工作:

安装 Apache2+PHP5

# yum install httpd
# yum install php php-common php-cli php-pear
# yum install php-gd php-imap php-mbstring php-mcrypt

配置 Apache

# echo "Include vhost.d/*.conf" >> /etc/httpd/conf/httpd.conf
# mkdir /etc/httpd/vhost.d
# echo "NameVirtualHost *" > /etc/httpd/vhost.d/NameVirtualHost.conf
# vim /etc/httpd/vhost.d/mytest-net.conf
<VirtualHost *>
        ServerAdmin webmaster@localhost
        ServerName www.mytest.net
#       ServerName wiki.mytest.net
        DocumentRoot /www/mytest.net
#       DocumentRoot /www/mytest.net/dokuwiki
        <Directory /www/mytest.net/>
#       <Directory /www/mytest.net/dokuwiki/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
 
        ServerSignature On
</VirtualHost>

/etc/httpd/vhost.d/mytest-net.conf

# service httpd restart

下载 DokuWiki

# mkdir -p /www/mytest.net
# cd /www/mytest.net
# wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache'
# mv 'dokuwiki-2008-05-05.tgz?id=projects:dokuwiki&cache=cache' dokuwiki-2008-05-05.tgz
# tar -xzf dokuwiki-2008-05-05.tgz
# mv dokuwiki-2008-05-05 dokuwiki
# chown -R apache.apache dokuwiki

DokuWiki on Ubuntu/Debian

例如:在 ubuntu 8.04 下要安装 Dokuwiki ,一般需要如下的准备工作:

安装 Apache2+PHP5

$ sudo apt-get update
$ sudo apt-get install apache2 apache2-mpm-prefork
$ sudo apt-get install php5 php-pear php5-cli php5-gd php5-imap php5-common
$ sudo apt-get install php5-mcrypt php5-mhash php5-syck php5-xmlrpc php5-xsl
$ sudo apt-get install libapache2-mod-php5

配置 Apache

$ sudo vim /etc/apache2/sites-available/mytest-net
<VirtualHost *>
        ServerAdmin webmaster@localhost
        ServerName www.mytest.net
#       ServerName wiki.mytest.net
        DocumentRoot /www/mytest.net
#       DocumentRoot /www/mytest.net/dokuwiki
        <Directory />
                Options FollowSymLinks
                AllowOverride None
        </Directory>
        <Directory /www/mytest.net/>
#       <Directory /www/mytest.net/dokuwiki/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
 
        LogLevel warn
        ErrorLog /var/log/apache2/error.log
        CustomLog /var/log/apache2/access.log combined
 
        ServerSignature On
</VirtualHost>

/etc/apache2/sites-available/mytest-net

  $ sudo ln -s /etc/apache2/sites-available/mytest-net /etc/apache2/sites-enabled/010-mytest-net
  $ sudo a2enmod php5 rewrite
  $ sudo /etc/init.d/apache2 restart

下载 DokuWiki

$ sudo mkdir -p /www/mytest.net
$ cd /www/mytest.net
$ sudo wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache'
$ sudo mv 'dokuwiki-2008-05-05.tgz?id=projects:dokuwiki&cache=cache' dokuwiki-2008-05-05.tgz
$ sudo tar -xzf dokuwiki-2008-05-05.tgz
$ sudo mv dokuwiki-2008-05-05 dokuwiki
$ sudo chown -R www-data.www-data dokuwiki

DokuWiki on a hosted server

SSH login

$ cd <站点根目录的上一级目录>
$ wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache'
$ tar -xzf dokuwiki-2008-05-05.tgz
$ mv dokuwiki-2008-05-05 dokuwiki

在 Control Panel 配置 dokuwiki 的虚拟主机目录时:

  • 若您希望以 http://wiki.mytest.net 域名访问 WIKI 站,则要指定到 dokuwiki 目录,例如:$HOME/mytest.net/dokuwiki
  • 若您希望以 http://mytest.net/dokuwiki 域名访问 WIKI 站,则要指定到 dokuwiki 的上一级目录,例如:$HOME/mytest.net

FTP only

  1. 下载 最新版的 DokuWiki
  2. 将下载文件 dokuwiki-YYYY-MM-DD.tgz 解压到本地目录
  3. 上传文件至服务器的 Web 文档根目录
  4. 参照上述 Dokuwiki 目录结构说明部分修改文件、目录权限

  • 若您希望以 http://wiki.mytest.net 域名访问 WIKI 站,将 dokuwiki-YYYY-MM-DD 目录里的内容上传到 Web 文档根目录
  • 若您希望以 http://mytest.net/dokuwiki 域名访问 WIKI 站,首先将 dokuwiki-YYYY-MM-DD 目录改名为 dokuwiki ,然后将 dokuwiki 目录上传到 Web 文档根目录

  • Bookmark at
  • Bookmark "DokuWiki 的安装环境" at del.icio.us
  • Bookmark "DokuWiki 的安装环境" at Digg
  • Bookmark "DokuWiki 的安装环境" at Furl
  • Bookmark "DokuWiki 的安装环境" at Reddit
  • Bookmark "DokuWiki 的安装环境" at Ask
  • Bookmark "DokuWiki 的安装环境" at BlinkList
  • Bookmark "DokuWiki 的安装环境" at blogmarks
  • Bookmark "DokuWiki 的安装环境" at Blogg-Buzz
  • Bookmark "DokuWiki 的安装环境" at Google
  • Bookmark "DokuWiki 的安装环境" at Ma.gnolia
  • Bookmark "DokuWiki 的安装环境" at Netscape
  • Bookmark "DokuWiki 的安装环境" at ppnow
  • Bookmark "DokuWiki 的安装环境" at Rojo
  • Bookmark "DokuWiki 的安装环境" at Shadows
  • Bookmark "DokuWiki 的安装环境" at Simpy
  • Bookmark "DokuWiki 的安装环境" at Socializer
  • Bookmark "DokuWiki 的安装环境" at Spurl
  • Bookmark "DokuWiki 的安装环境" at StumbleUpon
  • Bookmark "DokuWiki 的安装环境" at Tailrank
  • Bookmark "DokuWiki 的安装环境" at Technorati
  • Bookmark "DokuWiki 的安装环境" at Live Bookmarks
  • Bookmark "DokuWiki 的安装环境" at Wists
  • Bookmark "DokuWiki 的安装环境" at Yahoo! Myweb
  • Bookmark "DokuWiki 的安装环境" at BobrDobr
  • Bookmark "DokuWiki 的安装环境" at Memori
  • Bookmark "DokuWiki 的安装环境" at Faves
  • Bookmark "DokuWiki 的安装环境" at Favorites
  • Bookmark "DokuWiki 的安装环境" at Facebook
  • Bookmark "DokuWiki 的安装环境" at Newsvine
  • Bookmark "DokuWiki 的安装环境" at Yahoo! Bookmarks
  • Bookmark "DokuWiki 的安装环境" at Twitter
  • Bookmark "DokuWiki 的安装环境" at myAOL
  • Bookmark "DokuWiki 的安装环境" at Slashdot
  • Bookmark "DokuWiki 的安装环境" at Fark
  • Bookmark "DokuWiki 的安装环境" at RawSugar
  • Bookmark "DokuWiki 的安装环境" at LinkaGoGo
  • Bookmark "DokuWiki 的安装环境" at Mister Wong
  • Bookmark "DokuWiki 的安装环境" at Wink
  • Bookmark "DokuWiki 的安装环境" at BackFlip
  • Bookmark "DokuWiki 的安装环境" at Diigo
  • Bookmark "DokuWiki 的安装环境" at Segnalo
  • Bookmark "DokuWiki 的安装环境" at Netvouz
  • Bookmark "DokuWiki 的安装环境" at DropJack
  • Bookmark "DokuWiki 的安装环境" at Feed Me Links
  • Bookmark "DokuWiki 的安装环境" at funP
  • Bookmark "DokuWiki 的安装环境" at HEMiDEMi
guide/dokuwiki/dokuwiki_preinstall.txt · 最后更改: 2008/06/18 23:48 (外部编辑)
Recent changes RSS feed Creative Commons License Donate Driven by DokuWiki