如何在 Debian 12 上安装 Laravel

Laravel 是一个基于 PHP 的 Web 应用程序框架，用于构建企业 Web 应用程序。它是一个免费开放的 Web 框架，遵循模型-视图-控制器 (MVC) 架构并基于 Symfony。它提供了优雅的语法，允许您使用干净的代码创建应用程序，并且易于阅读和理解。

Laravel 是一个企业级 Web 框架，用于构建企业级、健壮的全栈 Web 应用程序。 Laravel 应用程序从开发过程到生产都可以快速交付，不会让人头疼。

将 Laravel Web 框架与 React 或 Vue 等其他框架配对，可以创建一个美观且交互式的前端。此外，它还支持多种数据库，包括 MySQL、PostgreSQL、SQLite 和 SQL Server。 Laravel 还提供了安全身份验证的脚手架。

在本指南中，我们将向您展示如何在 Debian 12 上逐步安装 Laravel，以便您可以开始使用 Laravel 项目。我们将向您展示如何使用 Apache2 Web 服务器、MariaDB 和 PHP 8.2 安装 Laravel。

先决条件

以下是您需要遵循本指南的要求：

• Debian 12 服务器。
• 具有管理员权限的非 root 用户。

安装 LAMP 堆栈

您需要做的第一步是将 LAMP Stack（Apache2、MariaDB 和 PHP）安装到您的 Debian 服务器。然后，您还将验证 Apache2 和 mariaDB 服务以确保服务正在运行。

在安装软件包之前，运行 apt update 命令来更新和刷新 Debian 存储库。

sudo apt update

更新存储库后，通过执行下面的 apt install 命令来安装 LAMP Stack（Apache2、PHP 和 MariaDB）软件包。以下命令还会安装 Laravel 所需的一些 PHP 扩展。

sudo apt install apache2 php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip mariadb-server

输入 y 确认并继续安装。

安装 LAMP Stack 后，运行以下 systemctl 命令来验证 apache2 和 mariadb 服务。如果服务正在运行，您应该获得输出活动（正在运行）。

sudo systemctl status apache2
sudo systemctl status mariadb

对于 apache2 服务，你应该像这样放置：

下面是 mariadb 服务状态。

接下来，运行下面的 php 命令来验证 PHP 版本和 PHP 上启用的模块。您应该会看到安装了 PHP 8.2，并启用了一些模块，例如curl、date、dom 和 exif。

php -v
php -m

最后，启动您的网络浏览器并访问您的 Debian 服务器 IP 地址（即：http://192.168.10.15/）。如果安装成功，您应该会获得 Apache Web 服务器的 index.html 页面。

配置 PHP

要安装 Laravel，您必须启用一些 PHP 扩展，例如 fileinfo、mbstring 和 openssl。您可以通过 php.ini 文件启用这些扩展。

使用以下nano编辑器打开PHP配置文件/etc/php/8.2/apache2/php.ini。

sudo nano /etc/php/8.2/apache2/php.ini

取消注释以下行以启用扩展 fileinfo、mbstring 和 openssl。

extension=fileinfo
extension=mbstring
extension=openssl

完成后，保存文件并退出编辑器。

接下来，运行以下 systemctl 命令来重新启动 apache2 服务并应用更改。

sudo systemctl restart apache2

然后，通过运行下面的 php 命令确保启用 PHP 扩展 fileinfo、mbstring 和 openssl。

sudo php -m

现在使用以下命令创建一个新的 phpinfo 文件 /var/www/html/info.php。如果您的 PHP 和 Apache2 Web 服务器安装成功，这将显示有关 PHP 安装的详细信息。

echo "<?php phpinfo(); ?>" > /var/www/html/info.php

打开您喜欢的 Web 浏览器并访问服务器 IP 地址，然后访问路径文件 info.php（即：http://192.168.10.15/info.php）。如果成功，您应该看到如下输出：

配置 MariaDB 服务器

配置 PHP 后，您将配置 MariaDB 服务器，其中包括通过 mariadb-secure-installation 实用程序保护 MariaDB 服务器，然后为 Laravel 项目创建新的数据库和用户。

首先，运行下面的 mariadb-secure-installation 命令来保护您的 MariaDB 服务器安装。在此过程中，会要求您进行一些 MariaDB 配置，输入 Y 确认配置，或输入n 否。

sudo mariadb-secure-installation

以下是在此过程中会询问您的一些 MariaDB 设置：

• 当询问 MariaDB root 密码时，按ENTER。
• 当询问 unix_socket 身份验证方法时，输入n。
• 输入Y为MariaDB root用户设置新密码。然后，输入新密码并重复。
• 输入 Y 从 MariaDB 中删除默认的匿名用户。
• 然后，再次输入Y以禁用MariaDB root用户的远程登录。
• 输入Y从MariaDB中删除默认数据库测试。
• 最后，再次输入 Y以重新加载表权限并应用更改。

配置 MariaDB 服务器后，您需要为 Laravel 项目创建新的数据库和用户。

通过下面的mariadb命令登录MariaDB服务器。出现提示时输入您的 MariaDB 密码。

sudo mariadb -u root -p

现在运行以下查询来创建新数据库 testapp、用户 testapp 和密码 password。请务必在以下查询中更改密码。

CREATE DATABASE testapp;
CREATE USER testapp@localhost IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON testapp.* TO testapp@localhost;
FLUSH PRIVILEGES;

接下来，运行以下查询以确保用户 testapp 可以访问数据库 testapp。

SHOW GRANTS FOR testapp@localhost;

下面的输出确认用户 testapp 可以访问数据库 testapp。

最后，输入 quit 退出 MariaDB 服务器并完成此步骤。

安装作曲家

Laravel 可以通过多种方式安装，最简单的就是通过 PHP 包管理器 Composer 安装。现在，您将把 Composer 安装到 Debian 服务器上。

要安装 Composer PHP 包管理器，请运行下面的 apt install 命令。当提示继续安装时，键入 y。

sudo apt install composer

安装完成后，运行以下命令找到composer的二进制文件并验证composer版本。

which composer
sudo -u www-data composer --version

Composer 二进制文件位于 /usr/bin/composer，并且安装了 Composer 2.5.5。

创建第一个 Laravel 项目

一切就绪后，您就可以安装并创建第一个 Laravel 项目了。您将使用 MariaDB 作为数据库创建第一个 Laravel 项目。

首先，为您的项目创建一个新的文档根目录 /var/www/testapp 并通过以下命令将所有权更改为 www-data 用户。您还将创建 Composer 将使用的目录 /var/www/.cache 和 /var/www/.config。

sudo mkdir -p /var/www/{.cache,.config,testapp}
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

现在移动到 /var/www/testapp/ 目录并运行下面的 Composer 命令来创建第一个 Laravel 项目。您的第一个 Laravel 项目存储在 /var/www/testapp/ 目录中。

cd /var/www/testapp/
sudo -u www-data composer create-project laravel/laravel .

在安装过程中，您应该得到类似的输出，如下所示：

创建 Laravel 项目后，接下来您将通过 .env 配置文件为您的项目设置数据库。 .env 文件用作 Laravel 项目的基本配置。

使用以下 nano 编辑器命令打开 .env 文件。

nano .env

将 APP_URL 参数更改为 Laravel 项目的本地域名。这样，您就可以通过本地域名访问您的项目。在本例中，域名为 testapp.local。

APP_URL=http://testapp.local

现在将数据库配置 DB_CONNECTION 更改为 mysql，并使用您的 MariaDB 数据库和用户详细信息更改 DB_DATABASE、DB_USERNAME 和 DB_PASSWORD 的详细信息。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=testapp
DB_USERNAME=testapp
DB_PASSWORD=password

完成后，保存文件并退出编辑器。

现在运行以下命令来迁移数据库。这将为 Laravel 项目创建表。

sudo -u www-data php artisan migrate

配置 Apache 虚拟主机

在以下步骤中，您将为 Laravel 项目创建新的 Apache2 虚拟主机配置。之后，您必须激活虚拟主机并验证Apache2配置，然后重新启动Apache2 Web服务器才能生效。

在为 Laravel 创建 Apache2 虚拟主机配置之前，您必须通过以下命令在 Apache2 上启用 rewrite 模块。

sudo a2enmod rewrite

使用以下 nano 编辑器命令创建 Apache2 虚拟主机配置 /etc/apache2/sites-available/laravel.conf。

sudo nano /etc/apache2/sites-available/laravel.conf

插入以下配置并将参数 ServerName 更改为您的域名。

<VirtualHost *:80>
    ServerAdmin [email 
    ServerName testapp.local
    DocumentRoot /var/www/testapp/public
    <Directory />
            Options FollowSymLinks
            AllowOverride None
    </Directory>
    <Directory /var/www/testapp>
            AllowOverride All
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

完成后，保存文件并退出编辑器。

接下来，运行以下命令激活虚拟主机配置 laravel.conf 并验证 Apache2 配置。如果您的配置正确，您应该会收到诸如语法正常之类的消息。

sudo a2ensite laravel.conf
sudo apachectl configtest

最后，通过执行以下命令并应用您所做的更改来重新启动 apache2 服务。

sudo systemctl restart apache2

访问 Laravel

如果您使用的是 Linux 客户端，请通过下面的 nano 编辑器命令修改 /etc/hosts 文件。

sudo nano /etc/hosts

如果您使用的是 Windows 计算机，请修改文件C:\Windows\System32\drivers\etc\hosts。

插入 Laravel 项目的域名和 Debian 服务器 IP 地址，如下所示：

192.168.10.15   testapp.local

保存文件并退出编辑器。

最后，启动 Web 浏览器并访问 Laravel 项目的本地域名（即：http://testapp.local）。如果成功，你应该会得到一个类似的 Laravel 页面，如下所示：

结论

总之，您已经在 Debian 12 服务器上安装了带有 LAMP Stack（Apache2、MariaDB 和 PHP）的 Laravel。您还安装了 Composer（PHP 包管理器），并将其用作 Laravel 的媒体安装。考虑到这一点，您现在可以使用 Laravel Web 框架和 MariaDB 作为应用程序的数据库来开发应用程序。