phpPgAdmin
Related articles
phpPgAdmin is a web-based tool to help manage PostgreSQL databases using an PHP frontend.
Contents
Installation
PhpPgAdmin requires a web server with PHP, such as Apache. To set it up, see Apache HTTP Server and Apache HTTP Server#PHP.
Install the phppgadmin package.
Configuration
PHP
You need to enable the pgsql
extension in PHP by editing /etc/php/php.ini
and uncommenting the following line:
extension=pgsql.so
You need to make sure that PHP can access /etc/webapps
. Add it to open_basedir
in /etc/php/php.ini
if necessary:
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps
Web server
Apache
Create the Apache configuration file:
/etc/httpd/conf/extra/phppgadmin.conf
Alias /phppgadmin "/usr/share/webapps/phppgadmin" <Directory "/usr/share/webapps/phppgadmin"> DirectoryIndex index.php AllowOverride All Options FollowSymlinks Require all granted </Directory>
And include it in /etc/httpd/conf/httpd.conf
:
# phpPgAdmin configuration Include conf/extra/phppgadmin.conf
By default, everyone can see the phpPgAdmin page, to change this, edit /etc/httpd/conf/extra/phppgadmin.conf
to your liking. For example, if you only want to be able to access it from the same machine, replace Require all granted
by Require local
.
Lighttpd
The php setup for lighttpd is exactly the same as for apache. Make an alias for phppgadmin in your lighttpd config.
alias.url = ( "/phppgadmin" => "/usr/share/webapps/phppgadmin/")
Then enable mod_alias, mod_fastcgi and mod_cgi in your config ( server.modules section )
Make sure lighttpd is setup to serve php files, Lighttpd#FastCGI
Restart lighttpd and browse to http://localhost/phppgadmin/index.php
Nginx
Create a symbolic link to the /usr/share/webapps/phppgadmin directory from whichever directory your vhost is serving files from, e.g. /srv/http/<domain>/public_html/
sudo ln -s /usr/share/webapps/phppgadmin /srv/http/<domain>/public_html/phppgadmin
You can also setup a sub domain with a server block like so (if using php-fpm):
Also, you need to use at less php-fpm (you need it), you have to make it running first (if you not do it, you will have a "502 bad gateway" error instead of the phpPgadmin first page).
For make it running after install the package, make a "systemctl start php-fpm" (and enable it if you want to use it all the time and/or after reboot, by "systemctl enable php-fpm)
server { server_name phppgadmin.<domain.tld>; access_log /srv/http/<domain>/logs/phppgadmin.access.log; error_log /srv/http/<domain.tld>/logs/phppgadmin.error.log; location / { root /srv/http/<domain.tld>/public_html/phppgadmin; index index.html index.htm index.php; } location ~ \.php$ { root /srv/http/<domain.tld>/public_html/phppgadmin; fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME /srv/http/<domain.tld>/public_html/phppgadmin/$fastcgi_script_name; include fastcgi_params; } }
but there is an other simple way to do it running (also, if you need some other web apps, it would be easy more after):
server { listen 80; server_name localhost default_server; root /srv/http/www/public_html; index index.html index.html index.php; location ~ \.php$ { try_files $uri =404; include fastcgi_params; fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } }
with this config, your phppgadmin will be accessible at http://localhost/phppgadmin directly and you will be able also to add some other web apps easy in the same way
(just have to paste/link them under public_html directory and find it at localhost/your_webapps)
this config make working all php file inside your localhost directly
(also it is a good idea to allow a user http http in the top of this nginx file and make directory srv/http/ under http owner/group)
the "server" serve only if you want to create some other server name designed only for this...
also, make a root inside the location of php is not a simple way to do and make the config file in trouble...
phpPgAdmin configuration
phpPgAdmin's configuration file is located at /etc/webapps/phppgadmin/config.inc.php
. If you have a local PostgreSQL server, it should be usable without making any modifications.
If your PostgreSQL server is not on the localhost, edit the following line:
$conf['servers'][0]['host'] = ;
Accessing your phpPgAdmin installation
Your phpPgAdmin installation is now complete. Before start using it you need to restart your apache server by following command:
# systemctl restart httpd.service
You can access your phpPgAdmin installation by going to http://localhost/phppgadmin/
Troubleshooting
Login disallowed for security reasons
If extra login security is true, then logins via phpPgAdmin with no password or certain usernames (pgsql, postgres, root, administrator) will be denied. Only set this to false
once you have read the FAQ and understand how to change PostgreSQL's pg_hba.conf
to enable passworded local connections.
Edit /etc/webapps/phppgadmin/config.inc.php
and change the following line
$conf['extra_login_security'] = true;
to
$conf['extra_login_security'] = false;