phpPgAdmin 安装指南

译者:金步国


版权声明

本文译者是一位开源理念的坚定支持者,所以本文虽然不是软件,但是遵照开源的精神发布。

其他作品

本文译者十分愿意与他人分享劳动成果,如果你对我的其他翻译作品或者技术文章有兴趣,可以在如下位置查看现有的作品集:

联系方式

由于译者水平有限,因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好),请来信指出,任何提高译文质量的建议我都将虚心接纳。


以下内容来自于 phpPgAdmin-5.1 的 INSTALL 文件
-----------------------------
phpPgAdmin 安装指南
-----------------------------

1. 将下载的压缩包解压

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

   gunzip phpPgAdmin-*.tar.gz
   tar -xvf phpPgAdmin-*.tar

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

   bunzip2 phpPgAdmin-*.tar.bz2
   tar -xvf phpPgAdmin-*.tar

   对于 .zip 执行如下命令:

   unzip phpPgAdmin-*.zip

2. 配置 phpPgAdmin

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

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

3. 如果你是在安全模式下运行 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 ,
   需要长时间运行的导入、导出、事务处理,可能会由于超时而退出。

4. 确保已经为 PostgreSQL 开启了统计收集器(这个特性是默认开启的)。
   这样 phpPgAdmin 将能够显示表和索引的性能以及使用统计。
   为了确保启用这个功能,你应该检查一下 postgresql.conf 文件,确保下面的两行未被注释掉:

    track_activities
    track_counts

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

6. 重要 - 安全相关

   PostgreSQL 在默认情况下并不需要使用密码登录,
   我们强烈建议你在 pg_hba.conf 中配置为对本地链接使用 md5 密码,
   并为默认的超级用户设置一个密码。

   由于存在大量已经安装的 phpPgAdmin 并没有为本地连接设置密码,
   我们提供了一个名为'extra_login_security'的配置选项,它默认为 TRUE 。
   这意味着你不能使用'root','administrator','pgsql','postgres'用户或空密码登陆。

   仅在你对数据库进行了足够的安全设置以后才能将'extra_login_security'设为 fasle ,
   这样你就能使用管理员密码以管理员身份登陆。

7. [译者添加]当在 php.ini 中设置 display_errors = On 并且 error_reporting 包含 ERROR 以外级别的错误的时候,
   phpPgAdmin 常常不能流畅的使用,大约是由于编码并非严格遵守 PHP 开发者期望的编码风格所致吧。
   所以如果出现某些问题试试 display_errors = Off 看看,也许能解决使用中一些恼人的问题。