Laravel Toolkit
Laravel Toolkit 是一個免費的Plesk擴展,您可以用來簡化與託管Laravel應用程式相關的日常任務。
概要: 在本主題中,您將學習如何在Plesk中上傳、配置和運行 Laravel 應用程式。注意,本主題假設您已經準備好應用程式,或者正在計畫創建應用程式。這並不是關於如何創建 Laravel 應用程式的指南。
前提條件
在您可以託管Laravel應用程式之前,必須在Plesk伺服器上安裝免費的`Laravel Toolkit擴展<https://www.plesk.com/extensions/laravel/>`__:
- 如果您是Plesk管理員,請 從擴展目錄安裝擴展。
- 否則,請聯繫您的主機提供商,並要求他們為您安裝該擴展。
安裝了擴展後,就可以開始了。您將看到螢幕左側的**Laravel**按鈕,以及您所有域名的域名卡上的**安裝Laravel應用程式**按鈕。
更新您的應用程式
在配置和運行應用程式之前,您需要將其上傳到Plesk伺服器,並在Laravel Toolkit中將其註冊。有三種方法可實現:
- 創建 Laravel 框架。如果您的應用程式存儲在電腦上的資料夾或壓縮檔中,或者您希望從頭創建應用程式,Laravel Toolkit 可以創建必要的目錄結構,還可以創建本地Git repository。
- 從遠程 Git repository 安裝。如果您的應用程式存儲在遠端repository中,那麼您可以將其部署到Plesk伺服器上。
- 掃描現有的應用程式。如果您已經將您的應用程式上傳到Plesk,您可以通過掃描方式在 Laravel Toolkit 中註冊您的應用程式。
備註: 要能夠創建Laravel 框架或從遠端 Git repository 進行安裝,必須在Plesk伺服器上安裝免費的`Git 擴展 <https://www.plesk.com/extensions/git/>`__。
創建 Laravel 框架
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**安裝 Laravel 應用程式**。
- 選擇“安裝框架”,然後按一下**安裝應用程式**。
- 一旦安裝了框架,您需要將應用程式檔案上傳到Plesk(例如,使用 FTP 或 檔案管理員),必要時替換默認文件。
從遠處 Git repository 安裝
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**安裝 Laravel 應用程式**。
- 選擇 「從遠端 repository 安裝」。
- 鍵入或粘上包含應用程式檔案的遠程 repository 的URL。
- 如果遠端repository需要驗證,請將您在此頁面上看到的公開金鑰添加到repository中。
- 點按 安裝應用程式。
掃描現有應用程式
#。轉到 網站與域名,找到將託管您的應用程式的域名,然後打開」主機與 DNS」 標籤。
- 點按 主機設定 。
- 更改“文檔根目錄”值以匹配應用程式的公共目錄(預設情況下,
/httpdocs/public
)的路徑,然後按一下**確定**。 - 點按**安裝Laravel應用程式**,點按**取消**,然後點按**掃描**。
一旦您上傳或部署了您的應用程式的檔,並且您的應用程式已經在Laravel Toolkit中註冊,安裝Laravel應用程式按鈕將被替換為管理Laravel應用程式按鈕用於託管應用程式的域名。
現在可以繼續下一步。
運行 Artisan、Composer 和 Node.js 命令
要管理Laravel應用程式,您可能需要運行Artisan、Composer 和/或 Node.js 命令。通過Laravel Toolkit 可以方便地從Plesk介面運行這些命令,而不需存取shell。
如果您不確定是否需要運行任何Artisan、Composer 和/或 Node.js 命令才能使應用程式正常運行,請諮詢向您提供該應用程式的人員或機構。
備註: 若要能夠運行 Node.js 命令,必須在 Plesk伺服器上安裝免費的 Node.js 擴展。
運行 Artisan、Composer 或 Node.js 命令
-
轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
-
轉到相應的選項卡,鍵入您要運行的命令或從列表中選擇一個,然後按Enter鍵或按一下|laravel-run-button| 按鈕。
備註: 在運行Node.js命令時,您可能需要指定一個特定的Node.js版本和/或套裝程式管理器,以使該命令達到預期的效果。如果您不確定該選擇什麼,請諮詢向您提供該應用程式的個人或機構。
查看應用程式的日誌檔
當它運行時,Laravel應用程式會將其日誌寫入一個單獨的日誌檔。您可以直接從Laravel Toolkit 介面看到該檔的內容,從而不管可能會出現什麼問題時都能實現更容易地監控應用程式和故障排除。
查看應用程式的日誌檔
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 點按 日誌。
這將打開 日誌瀏覽器,只顯示來自Laravel日誌的日誌條目。
查看應用程式的計畫任務
使用Laravel,您可以在應用程式的代碼中計畫任務,而不是使用外部計畫程式,如cron。使用Laravel Toolkit,您可以直接從Laravel Toolkit介面看到所有當前配置的計畫任務,還可以啟用或禁用Laravel計畫任務。
備註: 您無法從Laravel Toolkit 介面中添加、移除或編輯Laravel計畫任務。瞭解如何在應用程式的代碼內計畫任務
查看應用程式的計畫任務
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 轉至“計畫任務”選項卡(僅在配置了一個或多個計畫任務時,該選項卡才可見)。
備註: 為了能夠啟用或禁用應用程式的計畫任務,您需要首先執行一個特定的操作,具體操作取決於您運行的是 Plesk for Linux 或 Plesk for Windows。您需要對每個託管要運行其計畫任務的Laravel應用程式的域名執行此操作。
啟用 Plesk for Linux 中的計畫任務管理
- 登錄到 Plesk。
- 轉到 網站與域名,找到託管您的應用程式的域名,轉到 「主機與 DNS」 標籤,然後點按 主機存取。
- 在“通過SSH存取伺服器”下,選擇除“禁止”以外的任何選項,然後按一下**確定**。
啟用 Plesk for Windows 中的計畫任務管理
- 登錄到 Plesk。
- 轉到 網站與域名 找到託管您的應用程式的域名。
- 在 「帳戶」 下點按 自訂。
- 轉到“許可權”選項卡,選中“計畫程式管理”旁的核取方塊,然後按一下**更新並鎖定**。
您現在可以啟用或禁用應用程式的計畫任務。
啟用應用程式的計畫任務
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 點按“計畫任務”切換按鈕,以顯示“啟用”。
現在已為Laravel應用程式啟用了計畫任務。
編輯環境變數
您的應用程式可能需要一個或多個自訂環境變數才能正常運行,或者可能會根據已設定的環境變數更改其行為。如果您不確定應用程式是否需要任何環境變數才能正常運行,請諮詢向您提供該應用程式的人員或機構。
編輯環境變數
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 點按 「環境變數 (.env)」 旁的 編輯 按鈕。
- 根據需要編輯環境變數,然後按一下**更新**。
更新後的環境變數現在已經生效了。
更新您的應用程式
如果Laravel應用程式託管在遠端Git repository中,則需要確保將對遠端repository中的應用程式碼所做的更改傳播到Plesk伺服器。您可以手動部署更改,或者通過設定webhook來自動更新應用程式。
手動更新您的應用程式
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 轉到“部署”選項卡,然後按一下**更新**。
對遠端repository 中的應用程式碼所做的更改將被pull到Plesk伺服器。此外,還將安裝Composer依賴項。
如果您希望將對遠端 repository中的應用程式碼所做的更改自動傳播到Plesk伺服器,請設定webhook。
設定 webhook
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 進入“部署”選項卡,複製您在該處看到的 webbook URL,然後將其添加到遠端repository中。
現在,每次向存儲應用程式碼的遠端repository進行commit時,更改都將被pull到Plesk伺服器上。此外,還將安裝Composer依賴項。
您的應用程式可能需要在部署期間在伺服器上運行某些命令才能正常運行。為了避免手動運行這些命令,您可以配置每次更新應用程式時都運行的部署腳本。
如果您不確定應用程式在部署期間是否需要運行任何命令才能正常運行,請諮詢向您提供該應用程式的人員或機構。
備註: 在Plesk for Linux中,您需要先啟用SSH存取,然後才能從Laravel Toolkit介面編輯部署腳本。您只需執行一次此操作。
在Plesk for Linux中啟用編輯部署腳本
- 登錄到 Plesk。
- 轉到 網站與域名,找到託管您的應用程式的域名,轉到 「主機與 DNS」 標籤,然後點按 主機存取。
- 在“通過SSH存取伺服器”下,選擇除“禁止”以外的任何選項,然後按一下**確定**。
現在可以從 Laravel Toolkit 介面編輯部署腳本。
編輯部署腳本
- 登錄到 Plesk。
- 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
- 轉到“部署”選項卡,然後按一下**編輯腳本**。
- 鍵入或粘上部署腳本,然後按一下**更新**。
部署腳本現在已生效,並且將在每次更新應用程式時運行。