PostgreSQL PHP 编程简介 · ZetCode 中文系列教程

# PostgreSQL PHP 编程简介 > 原文： [http://zetcode.com/db/postgresqlphp/intro/](http://zetcode.com/db/postgresqlphp/intro/) 在 PostgreSQL PHP 教程的第一章中，我们将提供必要的定义。我们将展示如何安装 PostgreSQL 数据库和所需的包。这些示例将使用 PHP CLI 在命令行上运行。为了运行示例，我们需要安装 PHP 语言（以 PHP CLI 的形式）和 PostgreSQL 数据库。我们还需要`php5-psql`包。 ## 关于 PostgreSQL 数据库 PostgreSQL 是一个功能强大的开源对象关系数据库系统。它是一个多用户数据库管理系统。它可以在多种平台上运行，包括 Linux，FreeBSD，Solaris，Microsoft Windows 和 Mac OS。 PostgreSQL 由 PostgreSQL 全球开发小组开发。 ## 设置 PostgreSQL 我们必须安装 PostgreSQL 数据库。 ```php $ sudo apt-get install postgresql ``` 在基于 Debian 的系统上，我们可以使用上述命令安装 PostgreSQL 数据库。 ```php $ sudo update-rc.d -f postgresql remove Removing any system startup links for /etc/init.d/postgresql ... /etc/rc0.d/K21postgresql /etc/rc1.d/K21postgresql /etc/rc2.d/S19postgresql /etc/rc3.d/S19postgresql /etc/rc4.d/S19postgresql /etc/rc5.d/S19postgresql /etc/rc6.d/K21postgresql ``` 如果我们从包中安装 PostgreSQL 数据库，它将自动添加到操作系统的启动脚本中。如果我们仅学习使用数据库，则不必在每次引导系统时都启动数据库。上面的命令删除 PostgreSQL 数据库的所有系统启动链接。 ```php $ /etc/init.d/postgresql status Running clusters: 9.1/main $ service postgresql status Running clusters: 9.1/main ``` 我们检查 PostgreSQL 服务器是否正在运行。如果没有，我们需要启动服务器。 ```php $ sudo service postgresql start * Starting PostgreSQL 9.1 database server [ OK ] ``` 在 Ubuntu Linux 上，我们可以使用`service postgresql start`命令启动服务器。 ```php $ sudo service postgresql stop [sudo] password for janbodnar: * Stopping PostgreSQL 9.1 database server [ OK ] ``` 我们使用`service postgresql stop`命令停止 PostgreSQL 服务器。 ```php $ sudo -u postgres createuser janbodnar Shall the new role be a superuser? (y/n) n Shall the new role be allowed to create databases? (y/n) y Shall the new role be allowed to create more new roles? (y/n) n ``` 我们在 PostgreSQL 系统中创建了一个新角色。我们允许它具有创建新数据库的能力。角色是数据库世界中的用户。角色与操作系统用户是分开的。我们创建了一个没有`-W`选项的新用户，例如我们尚未指定密码。这使我们能够使用该用户连接到数据库，而无需密码验证。请注意，这仅适用于本地主机。 ```php $ sudo -u postgres createdb testdb -O janbodnar ``` `createdb`命令使用所有者 janbodnar 创建一个新的 PostgreSQL 数据库。 ## PHP CLI 已知 PHP 语言可在 Web 服务器上运行。但是它也可以在命令行上使用。 PHP 命令行界面（PHP CLI）是一个库，使程序员可以在命令行上使用 PHP。使用 PHP CLI，我们可以使用 PHP-GTK 构建 GUI 应用，也可以创建简单的测试脚本。在本教程中，我们将使用命令行 PHP 解释器连接到 PostgreSQL 数据库。 ```php $ sudo apt-get install php5-cli ``` 我们在 Linux 系统上安装 PHP CLI 模块。 ## php5-pgsql 包 _php5-pgsql_ 是一个使用 PHP 语言与 PostgreSQL 数据库一起使用的包。在其他系统上，包名称可能不同。 ```php $ sudo apt-get install php5-pgsql ``` 我们启动以上命令来安装包。 ## 处理错误我们对处理 PHP 中的错误有一个简短的评论。 PHP 具有对错误报告的内置支持。细节可以在`php.ini`文件中控制。请注意，PHP CLI 版本具有单独的 INI 文件。它位于我们系统上的`/etc/php5/cli/php.ini`中。 `display_errors`指令控制是否显示内置错误消息。在开发环境中，将显示这些错误消息。在生产中，它们被抑制了。没有理由向用户显示这些技术消息。另外，这是潜在的安全风险。通常，我们应该将更具体的错误消息记录到日志文件中。 `log_errors`指令控制是否记录错误。 `error_log`指定应该记录脚本错误的文件的名称。如果未设置，则默认为 PHP CLI 的`stderr`。 `pg_last_error()`函数获取连接的最后一条错误消息字符串。它与内置错误报告中生成的错误消息相同。在本教程的示例中，我们不使用`pg_last_error()`函数，因为它复制了内置错误消息。我们有以下设置： ```php ... display_errors = On ... log_errors = On ; Our own custom based log file error_log = /home/janbodnar/.phpcli_log ... ``` 我们显示内置错误；它们显示在命令行上。错误消息还将记录到指定的日志文件中。如果我们不想在控制台上显示错误消息，只需关闭`display_errors`指令即可。 ```php $rs = pg_query($con, $query) or die("Cannot execute query: $query\n"); ``` 在脚本中，我们使用`die()`函数显示一条简单的错误消息，该消息易于理解。更具体的详细信息将保存到日志文件中。 `die()`函数也会终止脚本。 ## 版本在第一个代码示例中，我们将获取 PostgreSQL 数据库的版本。 ```php <?php $host = "localhost"; $user = "user12"; $pass = "34klq*"; $db = "testdb"; $con = pg_connect("host=$host dbname=$db user=$user password=$pass") or die ("Could not connect to server\n"); $query = "SELECT VERSION()"; $rs = pg_query($con, $query) or die("Cannot execute query: $query\n"); $row = pg_fetch_row($rs); echo $row[0] . "\n"; pg_close($con); ?> ``` 在上面的 PHP 脚本中，我们连接到先前创建的`testdb`数据库。我们执行一条 SQL 语句，该语句返回 PostgreSQL 数据库的版本。 ```php $host = "localhost"; $user = "user12"; $pass = "34klq*"; $db = "testdb"; ``` 这些是连接字符串变量。要创建到 PostgreSQL 数据库的连接，我们必须提供主机名，用户名和密码以及数据库名。 ```php $con = pg_connect("host=$host dbname=$db user=$user password=$pass") or die ("Could not connect to server\n"); ``` 我们连接到数据库服务器。如果无法创建连接，则`die()`函数将终止脚本并将错误消息打印到控制台。 `pg_connect()`函数返回连接资源，该资源将在以后与其他模块功能一起使用。 ```php $query = "SELECT VERSION()"; ``` 该 SQL 语句选择 PostgreSQL 数据库的版本。 ```php $rs = pg_query($con, $query) or die("Cannot execute query: $query\n"); ``` 使用`pg_query()`函数执行查询。 ```php $row = pg_fetch_row($rs); ``` 我们从返回的结果中获取数据。 ```php echo $row[0] . "\n"; ``` 我们将检索到的数据打印到控制台。数据以 PHP 数组的形式返回。数组的第一个元素是我们要查找的字符串。 ```php pg_close($con); ``` 使用`pg_close()`函数关闭与数据库的连接。 ```php $ php version.php PostgreSQL 9.1.3 on i686-pc-linux-gnu, compiled by gcc-4.6.real (Ubuntu/Linaro 4.6.1-9ubuntu3) 4.6.1, 32-bit ``` 运行`version.php`脚本。 ## 插入数据我们将创建一个`cars`表并在其中插入几行。 ```php <?php $host = "localhost"; $user = "user12"; $pass = "34klq*"; $db = "testdb"; $con = pg_connect("host=$host dbname=$db user=$user password=$pass") or die ("Could not connect to server\n"); $query = "DROP TABLE IF EXISTS cars"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "CREATE TABLE cars(id INTEGER PRIMARY KEY, mame VARCHAR(25), price INT)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(1,'Audi',52642)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(2,'Mercedes',57127)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(3,'Skoda',9000)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(4,'Volvo',29000)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(5,'Bentley',350000)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(6,'Citroen',21000)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(7,'Hummer',41400)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(8,'Volkswagen',21606)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); pg_close($con); ?> ``` 上面的脚本创建一个`Cars`表，并将 8 行插入到该表中。 ```php $query = "DROP TABLE IF EXISTS cars"; pg_query($con, $query) or die("Cannot execute query: $query\n"); ``` 如果汽车表已经存在，我们将其删除。 `pg_query()`函数在指定的数据库连接上执行给定查询。 ```php $query = "CREATE TABLE cars(id INTEGER PRIMARY KEY, mame VARCHAR(25), price INT)"; ``` 该 SQL 语句创建一个新的 cars 表。该表有三列。 ```php $query = "INSERT INTO cars VALUES(1,'Audi',52642)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); $query = "INSERT INTO cars VALUES(2,'Mercedes',57127)"; pg_query($con, $query) or die("Cannot execute query: $query\n"); ``` 我们要把两辆车插入表。 ```php pg_close($con); ``` 与数据库的连接已关闭。 ```php $ psql testdb psql (9.1.3) Type "help" for help. testdb=# SELECT * FROM cars; id | name | price ----+------------+-------- 1 | Audi | 52642 2 | Mercedes | 57127 3 | Skoda | 9000 4 | Volvo | 29000 5 | Bentley | 350000 6 | Citroen | 21000 7 | Hummer | 41400 8 | Volkswagen | 21606 9 | BMW | 36000 (9 rows) ``` 我们使用`psql`工具验证写入的数据。 ## 预备语句现在，我们将以预备语句来关注自己。在编写预备语句时，我们使用占位符，而不是直接将值写入语句中。预准备的语句可提高安全性和性能。预备语句是可用于优化性能的服务器端对象。准备查询后，将对其进行解析，重写和计划。以后只需要执行预备语句。因此，解析，重写和计划阶段仅执行一次，而不是每次执行语句时。准备的语句仅在当前数据库会话期间持续。会话结束时，预备语句将被遗忘，因此必须在重新使用之前重新创建它。 ```php $host = "localhost"; $user = "user12"; $pass = "34klq*"; $db = "testdb"; $id = 9; $name = "BMW"; $price = 36000; $con = pg_connect("host=$host dbname=$db user=$user password=$pass") or die ("Could not connect to server\n"); $query = "INSERT INTO cars VALUES($1, $2, $3)"; pg_prepare($con, "prepare1", $query) or die ("Cannot prepare statement\n"); pg_execute($con, "prepare1", array($id, $name, $price)) or die ("Cannot execute statement\n"); echo "Row successfully inserted\n"; pg_close($con); ``` 我们向汽车表添加一行。我们使用预备查询。 ```php $id = 9; $name = "BMW"; $price = 36000; ``` 我们有三个变量将用于构建查询。这些值可以例如来自网络表单。 ```php $query = "INSERT INTO cars VALUES($1, $2, $3)"; ``` 这是带有`$1`，`$2`和`$3`占位符的 SQL 查询。占位符将在以后填充。 ```php pg_prepare($con, "prepare1", $query) or die ("Cannot prepare statement\n"); ``` 在这里，我们通过调用`pg_prepare()`函数准备查询。函数的第二个参数是预备语句的名称。每个连接必须唯一。预备语句更快，并且可以防止 SQL 注入攻击。 ```php pg_execute($con, "prepare1", array($id, $name, $price)) or die ("Cannot execute statement\n"); ``` `pg_execute()`函数发送一个请求，以执行带有给定参数的预备语句，并等待结果。这些值绑定到占位符。 ```php $ php prepared.php Row successfully inserted testdb=# SELECT * FROM cars; id | name | price ----+------------+-------- 1 | Audi | 52642 2 | Mercedes | 57127 3 | Skoda | 9000 4 | Volvo | 29000 5 | Bentley | 350000 6 | Citroen | 21000 7 | Hummer | 41400 8 | Volkswagen | 21606 9 | BMW | 36000 (9 rows) ``` 我们在表上放了一辆新车。 ## 数据来源创建本教程时，请参考 [PostgreSQL PHP 手册](http://www.php.net/manual/en/book.pgsql.php)和 [PostgreSQL 文档](http://www.postgresql.org/docs/9.1/interactive/index.html)。这是 PostgreSQL PHP 教程的介绍性章节。