[Notes] BookStack install Windows installation BookStack

Last update:2020/09/09

◎ to GitHub Download Release version。

◎ unzip and copy to the apache htdocs directory under。

◎ Installation composer

  # Composer 為一 php 相依性套件管理工具。    # 安裝時會需要指定 php.exe 的路徑,並新增到 Windows 環境變數,  # 因此日後如果 php 的路徑有改變,可直接去修改環境變數的 path。    # 安裝過程會檢查 php.ini 設定,並協助修正。  # 以我來說,基於安全性的因素,"allow_url_fopen" 平常我會設為【Off】,  # 但這會造成 Composer 無法下載套件,  # 因此安裝過程會將此設定改成【On】,並產生一個 "php.ini~orig" 的原始備份檔。  


◎ cmd execution,Switch to htdocs / bs (bookstack directory),Composer install execution –no-dev。

  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。


◎ copy of the .env.example,Modify the file named .env。

◎ Open .env,DB data input。

◎ cmd execution,In htdocs/bs (bookstack directory)Execute php artisan key:generate。

  php artisan key:generate  


◎ phpMyAdmin to build an empty database,Encoded as utf8mb4_unicode_ci。

In htdocs/bs (bookstack directory) Add a .htaccess file,Follows (This content is for Apache):

  Options +FollowSymLinks  RewriteEngine On    RewriteCond %{REQUEST_FILENAME} !-d  RewriteCond %{REQUEST_FILENAME} !-f  RewriteRule ^ index.php [L]  


◎ Open the Apache httpd.conf ,Modify the root directory (DocumentRoot)Is bs (bookstack directory) Under the public directory。

◎ execute php artisan migrate。

  php artisan migrate  # 此為透過 Laravel 的 DB Migration 建構資料庫內容。    # 如果出現 could not find driver 等錯誤訊息,打開 PHP 的 php.ini,將下列 extension 的註解符號(;)拿掉。  ;extension=pdo_mysql  


◎ complete! Open the home page,To [email protected] / login password。



Leave a Comment

Please note: Comment moderation is enabled and may delay your comment. There is no need to resubmit your comment.