差分

このページの2つのバージョン間の差分を表示します。

--- dokuwiki [2016/05/31 13:47] – mumeiyamibito
+++ dokuwiki [2018/11/16 18:59] (現在) – [サーバのインストール (nginx 編)] mumeiyamibito
@@ 行 1: / 行 1: @@
 ====== DokuWiki ======
 ===== インストール方法 =====
+==== サーバのインストール (nginx 編) ====
+  - nginx をインストールする。\\ <code bash>
+$ sudo add-apt-repository ppa:nginx/stable
+$ sudo apt update
+$ sudo apt install nginx php-fpm</code>
+    * [[https://launchpad.net/~nginx/+archive/ubuntu/stable | NGINX Stable : “Nginx” team]]
+  - 自動起動設定する。\\ <code bash>$ sudo systemctl enable nginx</code>
+  - 設定ファイルを編集する。\\ <code bash>$ sudoedit /etc/nginx/sites-available/default</code>''server{...}'' 内を以下に変更する。
+    * 【追記】エラーページで nginx のバージョンを表示しない。\\ <code>server_tokens off;</code>
+      * [[https://dokuwiki.oreda.net/server/nginx.html | 高負荷に耐えられるNginx＋php-fpmでDokuwikiを使う準備 [DokuWikiで情報発信]]]
+    * 【変更】ルートディレクトリを必要に応じて変更する。\\ <code>root /var/www/html;</code>
+    * 【変更】エラーページを dokuwiki のエラーページに変更する\\ <code>
+location / {
+        # First attempt to serve request as file, then
+        # as directory, then fall back to displaying a 404.
+        try_files $uri $uri/ @dokuwiki;
+}</code>
+    * 【追記】URL 書き換えなどの設定を追記する。\\ <code>
+#Remember to comment the below out when you're installing, and uncomment it when done.
+location ~ /(data/|conf/|bin/|inc/|install.php) { deny all; }
+location ~ ^/lib.*\.(js|css|gif|png|ico|jpg|jpeg)$ {
+    expires 365d;
+}
+location @dokuwiki {
+    # rewrites "doku.php/" out of the URLs if you set the userwrite setting to .htaccess in dokuwiki config page
+    rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
+    rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
+    rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
+    rewrite ^/(.*) /doku.php?id=$1&$args last;
+}
+location ~ \.php$ {
+    try_files $uri $uri/ /doku.php;
+    include fastcgi_params;
+    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+    fastcgi_param REDIRECT_STATUS 200;
+    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
+    # fastcgi_pass unix:/var/run/php5-fpm.sock; #old php version
+}</code>
+    * [[https://www.dokuwiki.org/install:nginx | install:nginx [DokuWiki]]]
+  - 以下の内容の dokuwiki のトップディレクトリにて .htaccess を新規作成する (URL の区切り文字をスラッシュにする場合に必要)。\\ <code bash>$ sudoedit .htaccess</code><code>
+<Files ~ "^([\._]ht|README$|VERSION$|COPYING$)">
+    Order allow,deny
+    Deny from all
+</Files>
+RewriteEngine on
+RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
+RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
+RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
+RewriteRule ^$                        doku.php  [L]
+RewriteCond %{REQUEST_FILENAME}       !-f
+RewriteCond %{REQUEST_FILENAME}       !-d
+RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
+RewriteRule ^index.php$               doku.php
+RewriteBase /                 # sub.example.com
+#RewriteBase /test/site       # example.com/test/site/
+#RewriteBase /test/dokuwiki       # example.com/test/dokuwiki/
+</code>
+    * [[https://dokuwiki.oreda.net/htaccess_rewrite.html | Apacheの.htaccessで、DokuWikiのURLを短く単純にする [DokuWikiで情報発信]]]
+  - nginx の再起動をする。\\ <code bash>$ sudo systemctl restart nginx</code>
+    - 場合によっては php7.0 の再起動も必要かもしれない。\\ <code>$ sudo systemctl restart php7.0-fpm</code>
+  * その他トラブルシューティング
+    * ブラウザでアクセスすると php ファイルがダウンロードされる。
+      * 原因: ''/etc/nginx/sites-available/default'' 内の PHP の設定が間違っている。
+        * ログファイルとか見て、修正する。
+      * 原因: 誤った nginx の設定をブラウザがキャッシュしている。
+        * 解決法: ブラウザのキャッシュを消去するか、別のブラウザでどうぞ。
+      * 参考サイト:
+        * [[https://utano.jp/entry/2016/07/nginx-and-php-fpm-download-php-file/ | [Sy] 【解決した】HomebrewでNginx + php-fpmの環境を作ろうとしたらPHPファイルがダウンロードされる | Syntax Error.]]
+        * [[https://qiita.com/puttyo_bubu/items/5bf554ef2790f6435c32 | CentOSにnginx, php-fpm, mysqlの環境を構築する１ - Qiita]]
+==== dokuwiki 本体のインストール ====
   - サーバ環境の確認
     * apache や lighttpd、nginx、Abyss などの web サーバ環境
@@ 行 9: / 行 84: @@
     * 下の「Start Download」ボタンでダウンロード開始
   - 得られたファイルをウェブ表示可能なディレクトリに展開
-  - パーミッションの変更\\ <code bash>
+  - パーミッションの変更\\ 以下のいずれかを行う
+    * 誰でもアクセス可にする\\ <code bash>
 $ chmod -R 777 data
 $ chmod 777 conf
 $ chmod 666 conf/*
+</code>
+    * Web のみからアクセスする\\ <code bash>
+$ chown -R 777 data
+$ chown -R www-data. conf
 </code>
   - ウェブ上から install.php にアクセス (パーミッションが不足しているとここで注意される)
   - 必要事項を入力して、Wiki ライフをスタート
 ===== 既存データの移行 =====
-  * 以下のパーミッション、所有者の変更\\ <code bash>
+インストール方法のパーミッションの変更を行う。
-$ cd wikiディレクトリ
-$ chmod -R 755 data/
-$ chown -R www-data:ユーザ名 data/
-</code>
 ===== ACL初期設定の変更 =====
   * インストール時に Wiki の公開や編集権限の設定ができる
@@ 行 41: / 行 117: @@
 ===== サイドバーの導入 =====
-  * dokuwiki のページの URL の doku.php 以降を、sidebar にして新規ページ (sidebar) を編集すると、その内容が sidebar になる
+  * dokuwiki のページの URL の doku.php の後を、sidebar にして新規ページ (sidebar) を編集すると、その内容が sidebar になる
+    * 例 (デフォルト): \\ ''http://example.com/doku.php'' → ''http://example.com/doku.php?id=sidebar''
+    * 例 (URL にスラッシュを使う設定にした場合): \\ ''http://example.com/doku.php'' → ''http://example.com/doku.php/sidebar''
+  * 参考サイト: [[http://dokuwiki.oreda.net/page/sidebar.html | Dokuwikiにサイドバーを付ける [DokuWikiで研究生活]]]
+===== テンプレート (デザイン) のインストール =====
+  - lib/tpl のパーミッションを有効にする\\ 以下のいずれかを実行
+    * 誰でもアクセス可能にする\\ <code bash>$ chmod 777 lib/tpl</code>
+    * Web でのみのアクセス可能にする\\ <code bash>$ chown -R www-data. lib/tpl</code>
+  - dokuwiki ページの上の「管理」をクリック
+  - 「拡張機能管理」をクリックして、「検索とインストール」「手動インストール」などでインストールする
 ===== プラグインのインストール =====
-  - lib/plugins のパーミッションを有効にする\\ <code bash>$ chmod 777 lib/plugins</code>
+  - lib/plugins のパーミッションを有効にする\\ 以下のいずれかを実行
+    * 誰でもアクセス可能にする\\ <code bash>$ chmod 777 lib/plugins</code>
+    * Web でのみのアクセス可能にする\\ <code bash>$ chown -R www-data. lib/plugins</code>
   - dokuwiki ページの上の「管理」をクリック
   - 「拡張機能管理」をクリックして、「検索とインストール」「手動インストール」などでインストールする
   * 導入したプラグイン
-    * Indexmenu plugin\\ 参考サイト: [[http://blog.starbug1.com/archives/499 | 週記くらい | DokuWikiで導入したプラグイン]]
+    * Indexmenu plugin (サイドバーにある階層ツリーを表示するプラグイン)\\ 参考サイト: [[http://blog.starbug1.com/archives/499 | 週記くらい | DokuWikiで導入したプラグイン]]
+    * Google Analytics Plugin (Dokuwiki に Google analytics を導入するプラグイン)\\ 参考サイト: [[http://www.seirios.org/seirios/dokuwiki/doku.php?id=serviceapp:dokuwiki:plugin:googleanalytics | Google Analytics Plugin [ほほほのほ]]]
+    * tag (ページをタグ付けするプラグイン)\\ 参考サイト: [[http://yakinikunotare.boo.jp/orebase2/dokuwiki/plugin#%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AB%E3%82%BF%E3%82%B0%E3%82%92%E3%81%A4%E3%81%91%E3%82%8B | DokuWiki/プラグイン [俺の基地]]]
+  * Bookmark (任意の場所にアンカーを作るプラグイン)
+    * Anchor というプラグインもあるが、なぜか動かないので、同じ機能をもつこのプラグインを導入した
+    * 公式サイト: [[https://www.dokuwiki.org/plugin:bookmark | plugin:bookmark [DokuWiki]]]
 ===== ロゴや favicon の変更 =====
-  * ''lib/tpl/dokuwiki/images'' 以下に favicon.ico や logo.png があるので、それを置き換える
+  * 使用しているテンプレート (''lib/tpl/テンプレート名/images'') 以下に favicon.ico や logo.png があるので、それを置き換える
   * [[http://dokuwiki.oreda.net/template/dokuwiki.html | Dokuwiki標準テンプレート [DokuWikiで研究生活]]]
@@ 行 59: / 行 151: @@
     * 例: ''<nowiki>%%--%%</nowiki>''
   * [[http://yakinikunotare.boo.jp/orebase2/dokuwiki/input_dashx2_to_display_dashx2 | DokuWiki/連続ハイフンを連続ハイフンとして表示する [俺の基地]]]
+===== Ubuntu 16.04 に移行した際に表示されない =====
+  * /var/log/lighttpd/error.log あたりに ''FastCGI-stderr: PHP Fatal error:  Uncaught Error: Call to undefined function utf8_decode()'' がある場合、php7 側の問題 (utf8_decode() が別パッケージに分離されたのが原因) らしい
+  * 参考サイト: [[http://stackoverflow.com/questions/35701730/utf8-endecode-removed-from-php7 | php - utf8_(en|de)code removed from php7? - Stack Overflow]]
+  * 解決方法\\ <code bash>$ sudo apt-get install php7.0-xml</code>
 ===== マニュアル =====
@@ 行 66: / 行 163: @@
     * [[https://www.dokuwiki.org/install:permissions | install:permissions [DokuWiki]]] パーミッション
   * [[https://havelog.ayumusato.com/computer/software/e151-dokuwiki-install.html | DokuWikiの設置と設定、Markdownを愛す。 ::ハブろぐ]] 設定
+{{tag>アプリケーション}}