Guides > Databases > Postgresql > Php

在 Sealos DevBox 中使用 PHP 连接和操作 PostgreSQL 数据库的完整指南

本教程将详细介绍如何在 Sealos DevBox 开发环境中使用 PHP 连接并操作 PostgreSQL 数据库，包括环境配置、数据库操作以及最佳实践。

准备工作

在开始之前，请确保：

安装必要扩展

首先，在 Cursor 终端中运行以下命令，确保安装 PHP 的 PostgreSQL 扩展：

sudo apt-get update
sudo apt-get install php-pgsql

配置数据库连接

创建配置文件

首先，我们需要创建一个配置文件来存储数据库连接参数。在项目根目录下新建 config.php 文件：

config.php

<?php
return [
    'host' => 'your_database_host',
    'port' => '5432',
    'dbname' => 'your_database_name',
    'user' => 'your_username',
    'password' => 'your_password'
];

请将上述占位符替换为您在 Sealos 数据库应用中获取的实际 PostgreSQL 连接参数。

实现数据库连接类

接下来，创建一个用于处理数据库连接的 PHP 文件。新建 db_connect.php 文件：

db_connect.php

<?php
function getDbConnection() {
    $config = include 'config.php';
    
    $dsn = "pgsql:host={$config['host']};port={$config['port']};dbname={$config['dbname']};";
    
    try {
        $pdo = new PDO($dsn, $config['user'], $config['password'], [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
        echo "Connected successfully to the database.\n";
        return $pdo;
    } catch (PDOException $e) {
        die("Connection failed: " . $e->getMessage());
    }
}

这个函数通过 PDO (PHP Data Objects) 建立与 PostgreSQL 数据库的连接。PDO 提供了一个统一的接口来操作数据库，具有更好的安全性和可移植性。

编写测试脚本

创建一个测试脚本来验证数据库连接并执行基本的数据操作。新建 test_db.php 文件：

test_db.php

<?php
require_once 'db_connect.php';
 
$pdo = getDbConnection();
 
// Create a table
$pdo->exec("CREATE TABLE IF NOT EXISTS employees (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    position VARCHAR(100) NOT NULL
)");
echo "Table created successfully.\n";
 
// Insert a record
$stmt = $pdo->prepare("INSERT INTO employees (name, position) VALUES (?, ?)");
$stmt->execute(['John Doe', 'Developer']);
echo "Record inserted successfully.\n";
 
// Query the table
$stmt = $pdo->query("SELECT * FROM employees");
echo "Employees:\n";
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    echo "ID: {$row['id']}, Name: {$row['name']}, Position: {$row['position']}\n";
}
 
// Close the connection
$pdo = null;

此脚本演示了以下基本操作：

创建数据表
插入记录
查询数据
安全地关闭数据库连接

运行程序

在 Cursor 终端中执行以下命令来运行测试脚本：

php test_db.php

如果配置正确，您将看到脚本执行过程中的各项操作提示信息。

最佳实践

在使用 PHP 操作 PostgreSQL 数据库时，请遵循以下最佳实践：

使用环境变量或独立配置文件存储数据库连接信息
始终使用预处理语句防范 SQL 注入攻击
使用 try-catch 语句块处理潜在错误
操作完成后及时关闭数据库连接
在生产环境中使用连接池提升性能

常见问题排查

如果遇到连接问题，请按以下步骤进行排查：

核对 config.php 中的数据库连接信息
确认 PostgreSQL 数据库服务运行正常且可访问
检查 DevBox 环境的网络限制
验证 php-pgsql 扩展安装正确

想要深入了解更多关于 PHP 操作 PostgreSQL 的内容，请参考 PHP PostgreSQL 官方文档。

PHP

本页导航