在 Ubuntu 下为 ThinkPHP 配置数据库

想在 Ubuntu 系统上为 ThinkPHP 项目配置数据库?这事儿其实不难,跟着下面这几个清晰的步骤走,就能顺利完成。整个过程可以概括为:安装数据库、配置 PHP 扩展、创建数据库用户,最后在 ThinkPHP 项目中完成连接设置。
1. 安装数据库服务器
第一步,自然是在你的 Ubuntu 服务器上安装一个数据库服务。MySQL 和 PostgreSQL 都是常见的选择,这里我们以最常用的 MySQL 为例。打开终端,依次执行以下两条命令:
sudo apt update
sudo apt install mysql-server
第一条命令用于更新软件包列表,确保安装的是最新版本;第二条命令则是实际安装 MySQL 服务器。
2. 安装 PHP 数据库扩展
数据库装好了,还得让 PHP 能和它“对话”。这就需要安装对应的 PHP 扩展。对于 MySQL 来说,通常是安装 php-mysql 这个包:
sudo apt install php-mysql
3. 重启 Web 服务器
安装完扩展后,为了让改动生效,别忘了重启你的 Web 服务器。根据你使用的是 Apache 还是 Nginx,选择对应的命令:
sudo systemctl restart apache2
或者
sudo systemctl restart nginx
4. 创建数据库和用户
接下来,我们需要进入 MySQL,创建一个专属于你项目的数据库和用户,并授予权限。这步很关键,直接关系到后续的连接安全。
首先,以 root 身份登录 MySQL:
mysql -u root -p
系统会提示你输入 root 用户的密码。登录成功后,你会看到 MySQL 的命令行提示符。然后,依次执行以下 SQL 语句。注意,请务必将示例中的 your_database_name、your_username 和 your_password 替换成你自己设定的值:
CREATE DATABASE your_database_name;
CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;
EXIT;
这几条命令的作用分别是:创建数据库、创建本地用户并设置密码、授予该用户对刚创建数据库的全部权限、刷新权限使授权立即生效,最后安全退出 MySQL。
5. 配置 ThinkPHP
服务器端的准备工作就绪,现在轮到配置 ThinkPHP 项目本身了。打开项目目录下的 config/database.php 配置文件,找到数据库连接部分,将其修改为与你刚才创建的信息一致:
return [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'your_database_name',
// 用户名
'username' => 'your_username',
// 密码
'password' => 'your_password',
// 端口
'hostport' => '3306',
// ...
];
保存文件,核心配置就完成了。
6. 测试数据库连接
配置完成后,最好测试一下连接是否真的通了。一个简单的方法是在 ThinkPHP 项目中创建一个测试方法。你可以在现有的控制器里添加,或者新建一个控制器。方法内容大致如下:
use think\Db;
public function testDatabase()
{
$result = Db::table('your_table_name')->select();
return json($result);
}
记得将 your_table_name 替换成你数据库中实际存在的表名。保存后,通过浏览器访问这个方法对应的路由,如果能看到返回的数据(或空数组),而没有报错,那就恭喜你——数据库连接一切正常。
走完以上六步,你的 ThinkPHP 项目在 Ubuntu 上的数据库环境就已经成功搭建好了。接下来,就可以安心地进行后续的应用程序开发和部署了。
