概要: Laravel Toolkit 是一個免費的Plesk擴展,您可以用來簡化與託管Laravel應用程式相關的日常任務。

在本主題中,您將學習如何在Plesk中上傳、配置和運行 Laravel 應用程式。注意,本主題假設您已經準備好應用程式,或者正在計畫創建應用程式。這並不是關於如何創建 Laravel 應用程式的指南。

前提條件

在您可以託管Laravel應用程式之前,必須在Plesk伺服器上安裝免費的`Laravel Toolkit擴展<https://www.plesk.com/extensions/laravel/>`__:

  • 如果您是Plesk管理員,請 從擴展目錄安裝擴展。
  • 否則,請聯繫您的主機提供商,並要求他們為您安裝該擴展。

安裝了擴展後,就可以開始了。您將看到螢幕左側的**Laravel**按鈕,以及您所有域名的域名卡上的**安裝Laravel應用程式**按鈕。

laravel drawer

laravel domain card install

更新您的應用程式

在配置和運行應用程式之前,您需要將其上傳到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 框架

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**安裝 Laravel 應用程式**。
  3. 選擇“安裝框架”,然後按一下**安裝應用程式**。
  4. 一旦安裝了框架,您需要將應用程式檔案上傳到Plesk(例如,使用 FTP檔案管理員),必要時替換默認文件。

從遠處 Git repository 安裝

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**安裝 Laravel 應用程式**。
  3. 選擇 「從遠端 repository 安裝」。
  4. 鍵入或粘上包含應用程式檔案的遠程 repository 的URL。
  5. 如果遠端repository需要驗證,請將您在此頁面上看到的公開金鑰添加到repository中。
  6. 點按 安裝應用程式

掃描現有應用程式

  1. 登錄到 Plesk
  2. Go to Websites & Domains, find the domain that will host your application, and then open the 「Hosting & DNS」 tab.
  3. 點按 主機設定
  4. 更改“文檔根目錄”值以匹配應用程式的公共目錄(預設情況下,/httpdocs/public)的路徑,然後按一下**確定**。
  5. 點按**安裝Laravel應用程式**,點按**取消**,然後點按**掃描**。

一旦您上傳或部署了您的應用程式的檔,並且您的應用程式已經在Laravel Toolkit中註冊,安裝Laravel應用程式按鈕將被替換為管理Laravel應用程式按鈕用於託管應用程式的域名。

laravel domain card manage

現在可以繼續下一步。

運行 Artisan、Composer 和 Node.js 命令

要管理Laravel應用程式,您可能需要運行Artisan、Composer 和/或 Node.js 命令。通過Laravel Toolkit 可以方便地從Plesk介面運行這些命令,而不需存取shell。

如果您不確定是否需要運行任何Artisan、Composer 和/或 Node.js 命令才能使應用程式正常運行,請諮詢向您提供該應用程式的人員或機構。

備註: 若要能夠運行 Node.js 命令,必須在 Plesk伺服器上安裝免費的 Node.js 擴展

laravel run commands

運行 Artisan、Composer 或 Node.js 命令

  1. 登錄到 Plesk

  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。

  3. 轉到相應的選項卡,鍵入您要運行的命令或從列表中選擇一個,然後按Enter鍵或按一下|laravel-run-button| 按鈕。

    備註: 在運行Node.js命令時,您可能需要指定一個特定的Node.js版本和/或套裝程式管理器,以使該命令達到預期的效果。如果您不確定該選擇什麼,請諮詢向您提供該應用程式的個人或機構。

查看應用程式的日誌檔

當它運行時,Laravel應用程式會將其日誌寫入一個單獨的日誌檔。您可以直接從Laravel Toolkit 介面看到該檔的內容,從而不管可能會出現什麼問題時都能實現更容易地監控應用程式和故障排除。

laravel view logs

查看應用程式的日誌檔

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. 點按 日誌

This will open the domain log browser showing only the log entries from the Laravel log.

查看應用程式的計畫任務

使用Laravel,您可以在應用程式的代碼中計畫任務,而不是使用外部計畫程式,如cron。使用Laravel Toolkit,您可以直接從Laravel Toolkit介面看到所有當前配置的計畫任務,還可以啟用或禁用Laravel計畫任務。

備註: 您無法從Laravel Toolkit 介面中添加、移除或編輯Laravel計畫任務。瞭解如何在應用程式的代碼內計畫任務

laravel view scheduled tasks

查看應用程式的計畫任務

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. 轉至“計畫任務”選項卡(僅在配置了一個或多個計畫任務時,該選項卡才可見)。

備註: 為了能夠啟用或禁用應用程式的計畫任務,您需要首先執行一個特定的操作,具體操作取決於您運行的是 Plesk for Linux 或 Plesk for Windows。您需要對每個託管要運行其計畫任務的Laravel應用程式的域名執行此操作。

啟用 Plesk for Linux 中的計畫任務管理

  1. 登錄到 Plesk
  2. 轉到 網站與域名,找到託管您的應用程式的域名,轉到 「主機與 DNS」 標籤,然後點按 主機存取
  3. 在“通過SSH存取伺服器”下,選擇除“禁止”以外的任何選項,然後按一下**確定**。

啟用 Plesk for Windows 中的計畫任務管理

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到託管您的應用程式的域名。
  3. 在 「帳戶」 下點按 自訂
  4. 轉到“許可權”選項卡,選中“計畫程式管理”旁的核取方塊,然後按一下**更新並鎖定**。

您現在可以啟用或禁用應用程式的計畫任務。

啟用應用程式的計畫任務

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. 點按“計畫任務”切換按鈕,以顯示“啟用”。

現在已為Laravel應用程式啟用了計畫任務。

編輯環境變數

您的應用程式可能需要一個或多個自訂環境變數才能正常運行,或者可能會根據已設定的環境變數更改其行為。如果您不確定應用程式是否需要任何環境變數才能正常運行,請諮詢向您提供該應用程式的人員或機構。

編輯環境變數

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. 點按 「環境變數 (.env)」 旁的 編輯 按鈕。
  4. 根據需要編輯環境變數,然後按一下**更新**。

更新後的環境變數現在已經生效了。

Putting Your Application in Maintenance Mode

To prevent website visitors from seeing errors while you are working on or updating your application, you can put it in maintenance mode. While your application is in maintenance mode, website visitors will see a page showing a 「503 SERVICE UNAVAILABLE」 error.

Putting your application in maintenance mode

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. Click the Maintenance mode toggle button so that it shows 「Enabled」.

Your Laravel application is now in maintenance mode.

備註: Do not forget to take your application out of maintenance mode once you have finished working on or updating it.

更新您的應用程式

Whether your Laravel application’s files are stored in a local or a remote Git repository, you need to make sure that the changes made to the application’s code are propagated to the Plesk server. You can choose between deploying the changes manually or automatically.

If you need precise control over when your application is updated, we recommend updating it manually. This way, no changes made to the application’s code in the repository are propagated to the Plesk server until you are ready to do so. The downside of this approach is that you must perform manual actions every time the application needs to be updated.

手動更新您的應用程式

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. Go to the 「Deployment」 tab and, under 「Deployment mode」, select the 「Manual」 radio button.
  4. Under 「Deployment scenario」, clear the checkboxes corresponding to the steps you do not want to run during deployment, and then click Deploy.

Once Laravel Toolkit has run through all the deployment steps, your application and its dependencies will be updated.

If you want the changes made to the application’s code to be automatically propagated to the Plesk server, the method differs depending on whether the application’s code is stored in a local or a remote Git repository.

Updating your application automatically (local repository)

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. Go to the 「Deployment」 tab and under 「Deployment mode」 select the 「Automatic」 radio button.
  4. Under 「Deployment scenario」, clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time a commit is pushed to the master branch of the local repository storing the application’s code, your application and its dependencies will be updated.

Updating your application automatically (remote repository)

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. Copy the webhook URL you see here, and then add it to the remote repository. For specific instructions, see your repository provider’s documentation.
  4. Go to the 「Deployment」 tab and under 「Deployment mode」 select the 「Automatic」 radio button.
  5. Under 「Deployment scenario」, clear the checkboxes corresponding to the steps you do not want to run during deployment.

Now, every time the event triggering the webhook takes place in the remote repository storing the application’s code, your application and its dependencies will be updated.

Configuring a Deployment Script

您的應用程式可能需要在部署期間在伺服器上運行某些命令才能正常運行。為了避免手動運行這些命令,您可以配置每次更新應用程式時都運行的部署腳本。

如果您不確定應用程式在部署期間是否需要運行任何命令才能正常運行,請諮詢向您提供該應用程式的人員或機構。

備註: 在Plesk for Linux中,您需要先啟用SSH存取,然後才能從Laravel Toolkit介面編輯部署腳本。您只需執行一次此操作。

Enabling the ability to edit the deployment script in Plesk for Linux

  1. 登錄到 Plesk
  2. 轉到 網站與域名,找到託管您的應用程式的域名,轉到 「主機與 DNS」 標籤,然後點按 主機存取
  3. 在“通過SSH存取伺服器”下,選擇除“禁止”以外的任何選項,然後按一下**確定**。

現在可以從 Laravel Toolkit 介面編輯部署腳本。

編輯部署腳本

  1. 登錄到 Plesk
  2. 轉到 網站與域名 找到將託管您的應用程式的域名,然後按一下**管理 Laravel 應用程式**。
  3. 轉到“部署”選項卡,然後按一下**編輯腳本**。
  4. 鍵入或粘上部署腳本,然後按一下**更新**。

部署腳本現在已生效,並且將在每次更新應用程式時運行。