如何在 Ubuntu 22.04 上使用 Apache 2 安装 Laravel PHP 框架

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

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

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

在本教程中，您将学习如何在最新的 Ubuntu 22.04 LTS 上安装 Laravel。这还包括如何为 Laravel 开发设置 LAMP 堆栈。

先决条件

• Ubuntu 22.04 机器。本示例使用Ubuntu服务器。
• 具有 sudo 管理员权限的非 root 用户，也可以使用 root 用户。

安装 Apache Web 服务器

在第一步中，您将把 Apache2 Web 服务器安装到您的 Ubuntu 系统上。在此示例中，您将使用 Apache Web 服务器运行 Laravel Web 框架。

现在运行下面的 apt 命令来更新和刷新您的 Ubuntu 存储库。

sudo apt update

接下来，使用以下命令安装 Apache2 Web 服务器包。

sudo apt install apache2

输入Y确认并按ENTER开始安装。 Apache Web 服务器安装将开始。

Apache2安装完成后，您需要将HTTP和HTTPS服务添加到UFW防火墙。

运行下面的 ufw 命令将 HTTP 和 HTTPS 服务添加到 UFW 防火墙。

sudo ufw allow "Apache Full"

最后，打开网络浏览器并在地址栏上输入服务器IP地址（例如http://192.168.10.15）。现在您应该看到 Apache2 Web 服务器的默认 index.html 页面。

安装 PHP 8.1

安装 Apache Web 服务器后，您将在 Ubuntu 22.04 计算机上安装和配置 PHP。默认的 Ubuntu 22.04 存储库提供 PHP 包 v8.1，并且它很好地支持 Laravel Web 框架。

RUn 下面的 apt 命令为 Laravel Web 框架安装 PHP 包。

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

输入Y确认安装，然后按ENTER继续。 PHP 安装将开始。

现在，PHP 安装完成后，使用 nano 编辑器编辑配置 php.ini。

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

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

extension=fileinfo
extension=mbstring
extension=openssl

完成后保存并关闭文件。

接下来，重新启动 Apache2 服务以将新更改应用到您的 PHP 配置。

sudo systemctl restart apache2

最后，通过运行以下命令来测试并验证您的 PHP 配置。

检查 Ubuntu 机器上安装的 PHP 版本。

php --version

在下面的屏幕截图中，您可以看到 Ubuntu 计算机上安装了 PHP 8.1.2。

检查 PHP 环境中所有启用的扩展。

php -m

安装 MariaDB 服务器

您现在已经安装了 Apache2 Web 服务器和 PHP 软件包。现在您将在 Ubuntu 22.04 计算机上安装和配置 MariaDB 数据库服务器。您还将为 Laravekl 项目创建一个新的 MariaDB 数据库和用户。

要将 MariaDB 数据库安装到 Ubuntu 计算机，可以运行下面的 apt 命令。

sudo apt install mariadb-server

输入Y确认并按ENTER开始安装。

MariaDB安装完成后，使用以下命令以root用户身份登录MariaDB shell。

sudo mysql -u root -p

现在运行以下 mariaDB 查询来为 Laravel 项目创建新的数据库和用户。在此示例中，您将使用用户 laravel 创建数据库 laravelapp，密码为“password”。

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

现在运行查询“EXIT”以从 MariaDB shell 注销。您现在已经安装了 MariaDB 数据库服务器，并为 laravel 项目创建了新的数据库和用户。

安装作曲家

在本节中，您将安装 Composer。它是 PHP 编程语言的包管理器，就像 Python 上的 pip、Ruby 上的 gem、npm 或 Node.js 上的yarn。

Laravel Web 框架可以通过多种方式安装。在此示例中，您将使用 Composer 安装 Laravel Web 框架。

现在运行以下命令来下载 Composer 的安装程序。

curl -sS https://getcomposer.org/installer -o composer-setup.php

现在运行安装程序脚本“composer-setup.php”来安装 Composer。这会将 Composer 安装到目录 /usr/local/bin 目录中。

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

下面是安装Composer时的截图。

安装完成后，运行以下命令来检查并验证 Composer 安装。

检查 Composer 的版本。

sudo -u www-data composer --version

显示Composer的帮助内容。

sudo -u www-data composer --help

现在您已准备好开始 Laravel 安装。

开始安装 Laravel

在开始安装 Laravel 之前，让我们为 Laravel 项目创建新目录。

在此示例中，您将创建三个目录，“.cache”用于存储 PHP 包的缓存，目录“.config”用于存储 Composer 的附加配置，以及目录“laravelapp”用于 Laravel 项目本身。所有这些目录都将在“/var/www
”目录下可用。

运行以下命令为 Laravel 安装创建新目录。

mkdir -p /var/www/{.cache,.config,laravelapp}

现在将 Laravel 和 Composer 目录的所有权更改为用户和组 www-data。

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

接下来，使用以下命令移动到 /var/www/laravelapp 目录。

cd /var/www/laravelapp/

然后使用下面的composer命令安装Laravel Web框架。命令末尾的点会将 Laravel 安装在当前工作目录 /var/www/laravelapp 上。

sudo -u www-data composer create-project laravel/laravel .

下面是 Laravel 安装过程的截图。

下面是Laravel安装完成后的结果。

接下来，安装完成后，使用nano编辑器编辑文件“.env”。该配置是Laravel的主要环境配置，包括安装的URL、数据库详细信息等。

nano .env

将 APP_URL 配置更改为您的 Laravel 安装域名。在此示例中，laravel 将在域名 laravelapp.hwdomain.io 上运行。

APP_URL=http://laravelapp.hwdomain.io

现在使用您的数据库配置更改数据库详细信息。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravelapp
DB_USERNAME=laravel
DB_PASSWORD=password

完成后保存并关闭文件。

您现在已经完成了 Laravel Web 框架与 MariaDB 数据库服务器的安装。

设置 Apache 虚拟主机

现在是时候为 Laravel Web 框架设置 Apache2 虚拟主机了。在此示例中，Laravel 项目将在本地域 laravelapp.hwdomain.io 上运行。

使用 Nano 编辑器创建一个新文件“/etc/apache2/sites-available/laravel.conf”。

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

将以下配置添加到文件中。如果您使用的是自己的域名，则可以更改域名。另外，请务必更改 Laravel 项目的文档根目录的路径。

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

完成后保存并关闭文件。

接下来，使用以下命令激活 Apache2 模块重写并激活虚拟主机配置 laravel.conf。

sudo a2enmod rewrite
sudo a2ensite laravel.conf

现在验证 Apache2 配置并确保没有错误。

sudo apachectl configtest

现在，使用以下命令重新启动 Apache2 服务，为 Laravel 项目应用新的虚拟主机配置。

sudo systemctl restart apache2

现在您已经完成了 Laravel 的 Apache 虚拟主机配置。

在您的计算机上，使用 nano/vim 编辑器编辑 /etc/hosts 文件。

sudo nano /etc/hosts

添加以下配置。请务必更改您的详细服务器的域名和 IP 地址。

192.168.10.15 laravelapp.hwdomain.io

完成后保存并关闭文件。

最后，返回网络浏览器并在地址栏输入 laravel 安装 URL（即 http://laravelapp.hwdomain.io）。您应该会看到 Laravel Web 框架的默认索引页面。另外，在底部，您可以看到刚刚安装的 Laravel 版本和当前使用的 PHP 版本。

结论

恭喜！您现在已经在 Ubuntu 22.04 上成功安装了 Laravel Web 框架。您还了解了 Laravel Web Farmwork 的 LAMP Stack 的基本配置。