如何在ubuntu上配置thinkphp数据库连接

在 Ubuntu 上配置 ThinkPHP 的数据库连接，实际上就是几个关键步骤的组合。很多新手容易卡在环境准备阶段，或者配置文件写错一个字符就报错。今天我们把整个过程拆解开，每一步都讲清楚，顺带提几个容易踩的坑。

1. 安装 PHP 和 MySQL

首先，得确保系统里已经装好了 PHP 和 MySQL。如果还没装，用下面两条命令一次性搞定：

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

注意 php-mysql 这个扩展是连接数据库的桥梁，漏了后面连不上。

2. 配置 MySQL 数据库

安装完成后，先登录 MySQL 控制台（需要 root 权限）：

sudo mysql

然后创建一个新的数据库、用户，并授予权限。这里的关键是——数据库名、用户名、密码后面都要用到，建议写下来：

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 这边就准备好了。别忘了把 your_database_name、your_username、your_password 换成你自己的。

3. 安装 ThinkPHP

用 Composer 来安装 ThinkPHP 是最省事的：

composer create-project topthink/think your_project_name

项目创建好后，把整个 your_project_name 文件夹移到你想要的部署目录，比如 /var/www/html 或者你自己定义的路径。

4. 配置数据库连接

在 ThinkPHP 的项目根目录下，找到 .env 文件。如果不存在，就手动创建一个。然后打开它，把下面这段配置填进去——注意把占位符换成你自己的值：

DB_TYPE=mysql
DB_HOST=127.0.0.1
DB_NAME=your_database_name
DB_USER=your_username
DB_PWD=your_password
DB_PORT=3306
DB_PREFIX=

这里有个常见的坑：DB_PREFIX 留空意味着数据表没有前缀，如果你用的是现有数据库，最好填上对应的前缀，否则查询时会报错。

5. 测试数据库连接

一切配置完成后，在项目根目录下运行：

php think run

如果不出意外，你的 ThinkPHP 项目就会在本地服务器上跑起来，并且已经成功连上了 MySQL 数据库。这时候可以打开浏览器访问 http://localhost:8000 看看效果。

万一遇到问题，先检查配置文件里的 DB_HOST、DB_NAME 这些对不对，然后确认 MySQL 服务是否在运行：

sudo systemctl status mysql

如果服务没启动，用这个命令启动它：

sudo systemctl start mysql

另外，别忘了检查防火墙是否放行了 3306 端口——不过本地测试通常不需要，但如果你部署在远程服务器上，这一步就绕不过去了。