如何在Linux上使用PHP连接MariaDB数据库：详细指南

gitbox 2025-06-30

在Linux上使用PHP连接MariaDB的完整指南

在现代网站开发中，数据库的选择至关重要。MariaDB因其高性能和开源特性，成为了许多开发者的首选。PHP作为一种强大的动态网站开发工具，可以轻松与MariaDB搭配使用。本指南将详细说明如何在Linux环境下使用PHP连接MariaDB，并帮助你顺利搭建网站的数据库后台。

准备工作

在开始之前，首先确保你的Linux系统已经安装了MariaDB和PHP。可以通过以下命令来安装所需的软件：

sudo apt-get update
sudo apt-get install mariadb-server php php-mysql

安装完毕后的配置

安装完成后，需要对MariaDB进行初始化配置，包括设置数据库根用户的密码以及创建新的数据库。使用以下命令进入MariaDB的终端：

<span class="fun">sudo mysql</span>

设置根用户密码

在MariaDB终端中，运行以下命令设置根用户的密码：

ALTER USER 'root'@'localhost' IDENTIFIED BY '你的强密码';
FLUSH PRIVILEGES;

创建数据库

接下来，创建一个新的数据库。例如，可以创建一个名为 test_db 的数据库：

<span class="fun">CREATE DATABASE test_db;</span>

编写PHP代码

在连接数据库之前，请确保你的PHP环境正常运行。接下来，创建一个新的PHP文件，例如connect.php，并添加以下代码：

$servername = 'localhost';
$username = 'root';
$password = '你的强密码';
$dbname = 'test_db';

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检测连接
if ($conn->connect_error) {
    die('连接失败: ' . $conn->connect_error);
}
echo '连接成功';
$conn->close();

测试连接

将connect.php文件上传到你的服务器，并通过浏览器访问该文件。如果所有配置无误，你将看到“连接成功”的提示，表示PHP已成功连接到MariaDB数据库。

常见问题及解决方案

连接失败的原因

如果连接失败，常见的原因可能包括：

数据库服务未启动：确保MariaDB服务正在运行。你可以使用命令 sudo systemctl status mariadb 检查服务状态。
用户名或密码错误：仔细核对PHP代码中使用的用户名和密码。
权限问题：确保所使用的数据库用户拥有足够的访问权限。

总结

通过本文的指导，你应该能够在Linux环境中顺利地通过PHP连接MariaDB。无论是构建个人项目还是企业级应用，PHP和MariaDB的组合都能提供卓越的性能和灵活性。希望这篇指南能够帮助你更好地完成网站开发！