【BookStack 安装笔记】在 Windows 安装 BookStack

最后更新:2020/09/09

◎ 到 GitHub 下载 Release 版本。

◎ 解压缩并复制到 apache 的 htdocs 目录底下。

◎ 安装 作曲家

# Composer 為一 php 相依性套件管理工具。

# 安裝時會需要指定 php.exe 的路徑,並新增到 Windows 環境變數,
# 因此日後如果 php 的路徑有改變,可直接去修改環境變數的 path。

# 安裝過程會檢查 php.ini 設定,並協助修正。
# 以我來說,基於安全性的因素,"allow_url_fopen" 平常我會設為【Off】,
# 但這會造成 Composer 無法下載套件,
# 因此安裝過程會將此設定改成【On】,並產生一個 "php.ini~orig" 的原始備份檔。

 

◎ 执行 cmd,切换到 htdocs/bs (bookstack 目录),执行 composer install –无开发。

composer install --no-dev
# 此步驟是讓 composer 透過 bookstack 目錄裡的 composer.json 檔,
# 安裝所需的 php 相關元件。

# 如果出現 "[PDO Exception] Could not find driver" 等錯誤訊息,
# 打開 PHP 的 php.ini,將下列 extension 的註解符號(;)拿掉。
;extension=curl
;extension=gd2

# 如果出現 "Downloading (failed)" 等錯誤訊息,
# 請將 php.ini 的 "allow_url_fopen" 改為【On】。
allow_url_fopen = On

# 接著重啟 apache。

 

◎ 将.env.example 复制一份,修改档名为 .env。

◎ 打开 .env,输入 DB 资料。

◎ 执行 cmd,在 htdocs/bs (bookstack 目录)执行 php artisan key:生成。

php artisan key:generate

 

◎ 到 phpMyAdmin 建一个空的资料库,编码为 utf8mb4_unicode_ci。

在 htdocs/bs (bookstack 目录) 新增一 .htaccess 档,内容如下 (此内容为 Apache 适用):

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

 

◎ 打开 Apache 的 httpd.conf ,修改根目录 (的DocumentRoot)为 bs (bookstack 目录) 底下的 public 目录。

◎ 执行php artisan migrate。

php artisan migrate
# 此為透過 Laravel 的 DB Migration 建構資料庫內容。

# 如果出現 could not find driver 等錯誤訊息,打開 PHP 的 php.ini,將下列 extension 的註解符號(;)拿掉。
;extension=pdo_mysql

 

◎ 完成!开启首页,以 admin@admin.com / password 登入。

 

【參考連結】

一个响应

  1. 【笔记】手动更新 Windows 版 BookStack | 老森常譚 说: |

    […] 【BookStack 安装笔记】在 Windows 安装 BookStack | 老森常譚 […]

发表评论

请注意:: 评论审核已启用,可能会耽误您的评论. 有没有必要重新提交您的评论.