使用dokuwiki知識庫

由於專案開發正規化和流程化的需要，使用dokuwiki構建團隊的知識庫，用於存放專案管理、開發、運維要點以及一些探索性的技術知識總結。以下是關於如何在centos6.8上安裝dokuwiki的詳細介紹，包括安裝支援php7的apache伺服器，部署dokuwiki以及控制網路訪問安全。

安裝php7環境

yum

已經安裝yum的話，直接跳過。若在安裝php7的過程中，遇到Error: xz compression not available，那麼照此重灌python和yum。

升級yum倉

yum install epel-release
yum update

安裝依賴庫

yum -y install libxml2 libxml2-devel openssl openssl-devel bzip2 bzip2-devel libcurl libcurl-devel libjpeg libjpeg-devel libpng libpng-devel freetype freetype-devel gmp gmp-devel readline readline-devel libxslt libxslt-devel
yum -y install httpd httpd-devel
# 安裝libmcrypt
wget http://www.atomicorp.com/installers/atomic
sh ./atomic
yum install php-mcrypt libmcrypt libmcrypt-devel
 

下載php7安裝包

wget -O php7.tar.gz http://cn2.php.net/get/php-7.1.1.tar.gz/from/this/mirror

安裝

若想使用libphp7.so執行php，須指定–with-apxs2=/path/to/httpd/2.2/bin/apxs進行編譯。
否則，得用Apache提供的其他方式執行，比如:
1.使用mod_fcgid配合php-cgi執行(類似IIS + PHP-CGI)
2.使用mod_proxy_fcgi配合php-fpm執行(類似Nginx + PHP-FPM)

tar -zxvf php7.tar.gz
mv php-7.1.1 php
cd php
./configure --prefix=/usr/local/php --with-config-file-path=/etc --enable-fpm --with-fpm-user=nginx --with-fpm-group=nginx --enable-inline-optimization --disable-debug --disable-rpath --enable-shared --enable-soap --with-apxs2=/usr/sbin/apxs --with-libxml-dir --with-xmlrpc --with-openssl --with-mcrypt --with-mhash --with-pcre-regex --with-sqlite3 --with-zlib --enable-bcmath --with-iconv --with-bz2 --enable-calendar --with-curl --with-cdb --enable-dom --enable-exif --enable-fileinfo --enable-filter --with-pcre-dir --enable-ftp --with-gd --with-openssl-dir --with-jpeg-dir --with-png-dir --with-zlib-dir --with-freetype-dir --enable-gd-native-ttf --enable-gd-jis-conv --with-gettext --with-gmp --with-mhash --enable-json --enable-mbstring --enable-mbregex --enable-mbregex-backtrack --with-libmbfl --with-onig --enable-pdo --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd --with-zlib-dir --with-pdo-sqlite --with-readline --enable-session --enable-shmop --enable-simplexml --enable-sockets --enable-sysvmsg --enable-sysvsem --enable-sysvshm --enable-wddx --with-libxml-dir --with-xsl --enable-zip --enable-mysqlnd-compression-support --with-pear --enable-opcache
 

如果configure丟擲以下錯誤：

Sorry, I cannot run apxs. Possible reasons follow:

1. Perl is not installed
2. apxs was not found. Try to pass the path using --with-apxs2=/path/to/apxs
3. Apache was not built using --enable-so (the apxs usage page is displayed)

The output of /usr/sbin/apxs follows: ./configure: line 6187:
/usr/sbin/apxs: No such file or directory configure: error: Aborting

根據提示資訊，修改–with-apxs2=/path/to/apxs，執行"find / -name apxs"找到apxs的路徑修改即可。

make && make install
vim /etc/profile
>> PATH=$PATH:/usr/local/php/bin
>> export PATH
source /etc/profile

檢視安裝是否成功。

php -v

httpd

httpd是apache(http server 1.0)升級到2.0後換了個新名字，是被廣泛使用的開源web伺服器。以下配置以版本2.2為例。

基礎配置

更改主配置檔案 /etc/httpd/conf/httpd.conf如下：

Listen 80	#監聽本機所有IP的80埠
Listen 127.0.0.1:79	#監聽localhost的79埠
KeepAlive  On	#開啟長連線
DocumentRoot "/var/www/html"	#設定web站點目錄
<Directory "/var/www/html">
	Options None
	AllowOverride None
	Order allow,deny
	Allow from all
</Directory>

配置支援php7

AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps
DirectoryIndex index.html index.php
LoadModule php7_module modules/libphp7.so

在預設的Web站點目錄DocumentRoot /var/www/html下生成探針檔案info.php:

<?php phpinfo(); ?>

service httpd start

在瀏覽器中輸入http://ip:port/info.php，如果出現以下頁面則說明httpd已成功支援php7。

Dokuwiki

下載dokuwiki包

從https://download.dokuwiki.org/下載dokuwiki-stable.tgz壓縮包，解壓到/var/www/html。

cd /var/www/hmlt
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar -zxvf dokuwiki-stable.tgz

安裝

chown -R apache:root /var/www/html/dokuwiki  
chmod -R 755 /var/www/html/dokuwiki/
find /var/www/html/dokuwiki/ -type d -exec chmod 775 {} \; 

設定許可權後，在瀏覽器中輸入http://localhost/dokuwiki/install.php，安裝完成後刪除install.php。

訪問安全

dokuiwiki官網建議以下目錄禁止從網路直接訪問：

• data
• conf
• bin
• inc(儘管可訪問時沒有危險)

要檢查你是否需要調整訪問許可權，你可以試著訪問http://yourserver.com/data/pages/wiki/dokuwiki.txt。你應該無法以這種方法訪問到該檔案（https://www.dokuwiki.org/start?id=zh:security）。

否則，在主控制檔案中新增以下LocationMatch規則，並重啟httpd服務。

 <LocationMatch "/dokuwiki/(data|conf|bin|inc)/">
     order allow,deny
     deny from all
     satisfy all
 </LocationMatch>

解決本地檔名稱中文亂碼問題

找到inc目錄下的pageutils.php，修改兩個函式utf8_encode()和utf8_decode()。

vi inc/pageutils.php
 /function utf8_encode
 註釋以下兩行：
 $file = urlencode($file);
 $file = str_replace('%2F','/',$file);
 /function utf8_decode
 將最後行return urldecode($file);替換成
 return $file;