BookStack 官方提供的 更新方式 是透過 Git 的一行指令就完成,不過因為我對於 Git 僅是一知半解,因此仍採用較為麻煩的手動更新方式,以下為步驟筆記。
◎ 到 GitHub 下載 Release 版本。
◎ 將 apache/htdocs 原本的 BookStack 目錄更改名稱,並將剛剛下載的壓縮檔解壓至此。
◎ 將原本 BookStack 目錄的 .htaccess 檔複製到新目錄。
◎ 使用 WinMerge 比對新的 .env.example 與舊的 .env 差異,更新內容後另存為 .env。
◎ 執行 cmd,切換到 htdocs/bookstack (新的 bookstack 目錄),執行 composer install –no-dev。(請先確認 php.ini 的 allow_url_fopen 為 On)
composer install --no-dev # 此指令是讓 composer 透過 bookstack 目錄裡的 composer.json, # 安裝或更新所需的 php 相關元件。 # 如果有跳出 php 不是內部或外部指令的錯誤訊息, # 可以檢查 Windows 環境變數的 path 路徑, # php 目錄的路徑是不是有改變。 # 如果有跳出 Failed to download 訊息, # 可以檢查 php 的 allow_url_fopen 是不是沒打開。
◎ 執行 php artisan migrate。
php artisan migrate # 此指令為透過 Laravel 的 DB Migration 建構資料庫內容。
◎ 清除 php cache。
php artisan cache:clear php artisan view:clear
◎ 完成!
【參考連結】
- Updating BookStack · BookStack
- 【BookStack 安裝筆記】在 Windows 安裝 BookStack | 老森常譚