概要: 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. 键入或粘贴部署脚本,然后单击**更新**。

部署脚本现在已生效,并且将在每次更新应用程序时运行。