phpPgAdmin开源版 v5.0.4 最新版

phpPgAdmin开源版是一款方便实用的PostgreSQL数据库管理工具。如何管理PostgreSQL数据库？phpPgAdmin开源版能够帮助您。该款软件可以对数据库进行多种操作，适用于PostgreSQL多种版本，新版本修复了bug，兼容性和代码清理功能得到了很大的改进，有需要的朋友可以下载！

安装使用方法

一、安装phpPgAdmin

将下载的压缩包解压

对于 tar.gz 执行如下命令：

复制代码 代码如下:

gunzip phpPgAdmin-*.tar.gz

tar -xvf phpPgAdmin-*.tar

对于 tar.bz2 执行如下命令：

复制代码 代码如下:

bunzip2 phpPgAdmin-*.tar.bz2

tar -xvf phpPgAdmin-*.tar

对于 .zip 执行如下命令：

复制代码 代码如下:

unzip phpPgAdmin-*.zip

二、 配置 phpPgAdmin

编辑 phpPgAdmin/conf/config.inc.php 文件

如果你搞乱了配置文件，你可以使用 config.inc.php-dist 文件进行恢复。

三、创建 reports 数据库

如果你希望启用 reports(一个很有用的特性)，那么请到'sql'子目录下查看 reports-pgsql.sql 脚本。

它包含了如何创建 reports 数据库的指导。

四、转储功能相关

如果你是在安全模式下运行 PHP ，为了让数据库转储能够正常工作，

你必须将 php.ini 中的'safe_mode_allowed_env_vars'指令包含 PGPASSWORD 和 PGUSER 环境变量，

同时还需要在'safe_mode_exec_dir'指令中包含 pg_dump 二进制文件所在的目录。

例如：

复制代码 代码如下:

safe_mode_allowed_env_vars = PHP_,PG

safe_mode_exec_dir = /usr/bin

一般说来，你总不希望 /usr/bin 中的所有程序都能被执行，

所以你可能需要将 pg_dump 和 pg_dumpall 复制到单独的目录中去。

同样，如果你希望 phpPgAdmin 支持转储，

你还需要确保 pg_dump 和 pg_dumpall 可以被运行 PHP 的进程执行。

最后，如果你以安全模式运行 phpPgAdmin ，

需要长时间运行的导入、导出、事务处理，可能会由于超时而退出。

五、PostgreSQL statistics collector

如果启用了 PostgreSQL 的统计程序(statistics collector)，

phpPgAdmin 将会显示表和索引的性能以及使用统计。

为了启用这个功能，需要将 postgresql.conf 文件中的如下行的注释取消：

复制代码 代码如下:

stats_start_collector = true

stats_command_string = true

stats_block_level = true

stats_row_level = true

六、cookies 相关

为了能够使用在浏览器中正常使用 phpPgAdmin ，你必须启用浏览器的 cookies 功能。

七、重要 - 安全相关

PostgreSQL 在默认情况下并不需要使用密码登录，

我们强烈建议你在 pg_hba.conf 中配置为对本地链接使用 md5 密码，

并为默认的超级用户设置一个密码。

由于存在大量已经安装的 phpPgAdmin 并没有为本地连接设置密码，

我们提供了一个名为'extra_login_security'的配置选项，它默认为 TRUE 。

这意味着你不能使用'root','administrator','pgsql','postgres'用户或空密码登陆。

仅在你对数据库进行了足够的安全设置以后才能将'extra_login_security'设为 fasle ，

这样你就能使用管理员密码以管理员身份登陆。

常见问题解答

一、安装错误

Q: 我已经安装了 phpPgAdmin ，但是当我企图使用它的时候，

我得到一个错误说我安装的 PHP 没有正确的编译数据库支持。

A: 这个信息的意思是你的 PHP 没有将 PostgreSQL 支持编译进去。正确的配置选项是 '--with-pgsql' 。

请仔细阅读 PHP 手册以获得关于如何编译 PHP 的更详细的信息。

PostgreSQL 支持可以编译为 PHP 的动态扩展模块，

因此如果你使用的是一个预编译版本的 PHP (Linux下的RPM包或Windows下的二进制文件之类)，

也许你只需要做一件事就可以了：

编辑 php.ini 文件并取消如下两行的注释：

(Windows下通常位于 C:\WINDOWS 或 C:\WINNT 目录，Linux 下通常位于 /etc/php.ini)

;extension=php_pgsql.dll ;Windows

;extension=pgsql.so ;Linux

使它变成：

extension=php_pgsql.dll ;Windows

extension=pgsql.so ;Linux

在基于 Red Hat 或 Fedora 的 Linux 发行版上，

该 PHP 扩展已经自动的在 /etc/php.d/pgsql.ini 文件中进行了配置，

只要安装 php-pgsql 软件包即可。

Q: 在 Windows 上使用 phpPgAdmin 时，我得到一个如下警告信息：

"Warning: session_start() [function.session-start]:

open(/tmp\sess_5a401ef1e67fb7a176a95236116fe348, O_RDWR) failed"

A: 你需要修改你的 PHP.INI 文件(通常位于 c:\windows 目录)并将如下行

session.save_path = "/tmp"

修改为

session.save_path = "c:\windows\temp"

并确保 c:\windows\temp 目录确实存在。

二、登陆错误

Q: 我总是得到一个"Login failed"，我确定我使用了正确的用户名和密码!

A: 检查一下 PostgreSQL 日志，它会告诉你登陆失败的准确原因。

编辑 PostgreSQL 的"data"目录下的 pg_hba.conf 文件，

确保你拥有访问数据库服务器的正确权限。

如果你将 phpPgAdmin 安装在一个不同于 PostgreSQL 服务器所在的机器上，

另一个可能的原因是 PostgreSQL 在启动时没有启用 TCP/IP sockets 。

要启用它，可以编辑 postgresql.conf 文件，将如下行

#tcpip_socket = false

修改为

tcpip_socket = true

然后重启 PostgreSQL 。

[译者注]从 8.0 版本开始，原来的 virtual_host 和 tcpip_socket 配置指令已经被 listen_addresses 代替。

请参阅 PostgreSQL 获取更多对 listen_addresses 指令的解释。

Q: 有些用户会得到 "Login disallowed for security" 错误信息

A: phpPgAdmin 默认禁止空密码或特定用户(pgsql, postgres, root, administrator)登陆。

在改变这个默认行为(将 config.inc.php 文件中的 $conf['extra_login_security'] 设置为 false)之前，

请首先仔细阅读 PostgreSQL 文档中关于客户端认证的部分，

并充分理解如何修改 PostgreSQL 的 pg_hba.conf 配置文件以启用密码保护本地连接。

Q: 我可以使用任意密码登陆!

A: PostgreSQL 默认运行于"信任模式"。意思是对于本地连接不检查密码。

我们强烈建议你修改 pg_hba.conf 文件，并将登陆类型改为 'md5'。

注意，一旦你将'local'登陆类型修改为'md5'，你就可能需要在启动 PostgreSQL 的时候输入密码。

要避开它，可以使用一个 .pgpass 文件，相关说明请参考 PostgreSQL 文档 libpq 部分。

三、其它错误

Q: 当我通过表单向数据库输入非ASCII数据时，它被当着十六进制数或 Ӓ 格式插入。

A: 你没有使用正确的编码创建数据库。

这个问题会出现在你企图向一个 SQL_ASCII 数据库输入元音变音(umlaut)，

或者向 EUC-JP 数据库输入 SJIS 字符的时候。

Q: 当我 drop 并重建一个同名的表的时候，失败了。

A: 最简单的办法是使用 PostgreSQL 7.3 以上的版本。

Q: 当我浏览一个表的时候，'edit(编辑)'和'delete(删除)'链接并没有显示出来。

A: phpPgAdmin 将按顺序使用如下值作为行唯一标识符

1. 主键

2. 唯一索引(不能是部分索引或表达式索引)

3. OID 列(需要连续扫描以进行更新，除非你在 OID 列上建立了索引)

此外，唯一索引中的任何 NULL 值都会导致那一行不可编辑。同样，因为在同一张表中 OID 可能会重复，

phpPgAdmin 将会在改变那一行以后进行确认修改的是否确实是那一行，否则将进行回滚。

四、转储相关

Q: 如何启用数据库转储功能?

A: 你需要配置 config.inc.php 文件，以指定 pg_dump 和 pg_dumpall 的位置。

这样数据库导出功能将会显示出来。

Q: 我想在 Windows 上使用 pg_dump ，我应当到哪里下载 pg_dump.exe ?

A: 你需要安装 PostgreSQL 8.0 for Windows 或更高的版本。

可以到 http://www.postgresql.org/ftp/win32/ 去下载。

安装好以后可以在 config.inc.php 中设置 pg_dump 和 pg_dumpall 的位置。

Q: 为什么我不能在 SQL 窗口重新加载转储出来的 SQL 脚本?

A: 在执行 SQL 脚本时有如下限制：

* 只有上传的 SQL 脚本可以包含 COPY 命令，并且必须使用 PHP 4.2 以上版本。

* 'psql' 命令，比如 '\connect' 根本不会工作。

* 多行 SQL 语句同样不会工作，比如：

CREATE TABLE example (

a INTEGER

);

* 在执行脚本的过程中不能切换数据库和用户。

我们打算在将来的版本中减少这些限制，但是对于 PostgreSQL 本身的限制无能为力，

因此我们推荐你使用'psql'工具来恢复完整的 SQL 转储结果。

五、其它问题

Q: 当插入行的时候，'Value(值)' 或 'Expression(表达式)' 选框是什么意思?

A: 选择'Expression'表示你可以使用函数、运算符、字段名等等，

同时你需要正确的使用引号界定字符串值。

选择'Value'则表示无论你输入的内容是什么，都将按原样插入数据库中。

Q: 为什么表的'Info(信息)'页始终不显示任何信息?

A: 'Info'页用于显示其它表到这个表的外键以及来自 PostgreSQL 的统计信息。

而状态统计程序默认状态下并未启用。要启用它请查看 postgresql.conf 文件中的 stats_* 选项。

将这些选项全部设为'true'并重启 PostgreSQL 即可。

Q: 为什么我不能下载 SQL 窗口中执行的查询的结果数据?

A: 你需要选中 'Paginate results' 选项以允许下载。

Q: 我想帮助 phpPgAdmin 的开发，我应当怎么做?

A: 我们非常愿意得到你的帮助!请阅读 DEVELOPERS 和 TRANSLATORS 文件。