phpPgAdmin

あらかじめ決めておく事項

phpPgAdmin 実行用のユーザ名 (Role Name) ，パスワード，テスト用に使うデータベースのデータベース名を決めておくこと。 好きに決めていいですが（半角文字でスペースを含まないこと）， この資料では，次のように書く．

• phpPgAdmin 実行用のユーザ名 (Role Name) とパスワード
  • ユーザ名: testuser
  • パスワード: hoge$#34hoge5

  phpPgAdmin を実行するときに，データベース管理者でログインするのは良くないため， 新しいユーザ (Role ともいう) を作る．

• データベース名： testdb

  これは、phpPgAdmin のテスト実行のために作るデータベース名です．分かりやすい名前を付けておくこと。

準備事項

次の設定を行うことになるので、確認しておく。

• Postgres データベース管理者のユーザ名とパスワード
  Postgres の管理者は、データベースへのあらゆる操作を許されたユーザである。 インストール時に設定したはずなので，確認しておく． 以下、Postgres データベース管理者のユーザ名は、pgadmin と書き、そのパスワードは、pgadminpass と書く。

phpPgAdmin のインストール (Windows の場合)

php のインストール

PHP のインストールの Web ページ の記述に沿って， PHP のインストールを行う．要点は下記の通り．

• ダウンロード

  http://www.php.net/downloads.php から，Windows 版（PHP 5.2.6 installer）をダウンロード

• インストール

  インストーラを起動

  • Web Server Setup で Apache 2.2.x Module を選択（Apacheの2.2系列がインストール済みの場合）

    あるいは、Web Server Setup　でApache 2.0.x　Module を選択（Apacheの2.0系列がインストール済みの場合）

  • Apache Configuration Directory　に、Apacheのconfディレクトリを入力（C:\Program Files\Apache Group\Apache2\conf\）
  • Extensionsの中から「Postgres」や「Multi-Byte String」など，必要なものを選び、Will be installed on local hard drive に変更する （選び間違っても簡単にやり直せるので，あまり，悩まないこと）．
• インストールの確認

  C:\Program Files\Apache Group\Apache2\htdocsに次の一行を含むtest.phpを作成

              <?php phpinfo();?>
  

  http://localhost/test.phpにアクセスし、画面が表示されることを確認

参考URL：http://mizushima.ne.jp/Windows/DB/phpPgAdmin/phpPgAdmin.php を参考にした（現在，このページは公開されていない）．

Apacheの設定

http://localhost/phpPgAdmin にアクセスするとindex.phpを開くように設定を変える

• 準備事項 Tomcat インストールとテスト実行 と， Apache HTTP サーバと Apache Tomcat コネクタ が済んでいること。
• C:\Program Files\Apache Group\Apache2\confにあるhttpd.confをテキストエディタで開き、次の行を変更

               【変更前】DirectoryIndex index.html index.html.var
               【変更後】DirectoryIndex index.html index.php
  

phpPgAdminのインストール

• ダウンロード http://phppgadmin.sourceforge.net/?page=download から phpPgAdmin-4.2.1.zipをダウンロード
• インストール

  phpPgAdmin-4.2.1.zipを解凍し、フォルダ名を phpPgAdmin に変更. phpPgAdminフォルダをhtdocs（C:\Program Files\Apache Group\Apache2\htdocs）にコピー

• phpPgAdmin\conf\config.inc.phpの修正

  PostgreSQLで作成したユーザ（postgres）でログインするために、config.inc.phpの以下のように修正

               【修正前】$conf['extra_login_security'] = true;
               【修正後】$conf['extra_login_security'] = false;
  

• インストールの確認

  http://localhost/phpPgAdmin にアクセスし、「phpPDAdmin4.2.1(PHP5.2.6)」を含む画面が表示されることを確認

phpPgAdmin のインストール (Linux の場合)

インストール

PHP のインストールを終えておくこと

http://sourceforge.net/projects/phppgadmin

cd /tmp
wget https://www.kkaneko.jp/computer/src/toollib/phpPgAdmin-4.2.1.tar.gz
cd /usr/local/apache2
tar -xvzof /tmp/phpPgAdmin-4.2.1.tar.gz

設定

• conf/config.inc.php の編集

  host, defaultdb, default_lang, pg_dump_path, pg_dumpall_path, extra_login_security, owned_only などを確認

      cd /usr/local/apache2/phpPgAdmin-4.2.1
      vi conf/config.inc.php
      $conf['default_lang'] = 'japanese';
  

• Apache の httpd.conf の

  vi /usr/local/apache2/conf/httpd.conf
  ---
  Alias /pgadmin/ "/usr/local/apache2/phpPgAdmin-4.2.1/"
  ---
  <Directory "/usr/local/apache2/phpPgAdmin-4.2.1">
      AllowOverride All
      Options ExecCGI
      Order allow,deny
      Allow from all
  </Directory>
  ---
  

• postgresql.conf の編集

  vi /usr/local/pgsql/cc/postgresql.conf
  ----
          stats_start_collector = true
          stats_command_string = true
          stats_block_level = true
          stats_row_level = true
  ----
  

• (オプション) .htaccess におけるパスワードの設定

  phpPgAdmin 使用者のユーザ名とパスワードを、.htaccess に設定します．

  • ユーザ名: testuser
  • パスワード: hoge$#34hoge5

  で説明している．

  # すでに他のユーザが存在するときは -c をはずす
  /usr/local/apache2/bin/htpasswd -b -c /usr/local/apache2/conf/.htpasswd testuser hoge$#34hoge5
  cat /usr/local/apache2/conf/.htpasswd
  vi /usr/local/apache2/testuser-4.2.1/.htaccess
  ----
  AuthGroupFile /dev/null
  AuthName "testuser (PostgreSQL) Page"
  AuthType Basic
  require valid-user
  ----
  

phpPgAdmin の機能

phpPgAdmin が持つ以下の機能を説明する．

• データベース・一般ユーザのアカウント（ユーザ名とパスワード）作成（SQL でなく，グラフィカル・ユーザ・インタフェースを使用），
• データベースの作成と権限の設定（SQL でなく，グラフィカル・ユーザ・インタフェースを使用），
• テーブル定義（SQL でなく，グラフィカル・ユーザ・インタフェースを使用），
• SQL の編集と実行，
• テーブルの一覧表示と中身の表示と更新（行の追加，行の削除，値の更新），
• テーブルのエクスポートなど

新規ユーザ名，パスワードの登録

1. http://localhost/phpPgAdmin/にアクセス
2. ログイン

   画面左の"PostgreSQL"をクリック データベース管理者のユーザ名と，パスワードを入力して，データベース管理者としてログインする．

3. "Roles"をクリック
4. "Create role"をクリック (データベースを扱う新規ユーザ名，パスワードの登録)
5. Rolename・パスワード・確認を入力

   Can login?にチェック
   Rolename： testuser (ユーザ名)
   パスワード： hoge$#34hoge5
   

6. 画面左の"サーバー"をクリック、ログアウト

注意：ログイン後、戻るボタンを押してログイン画面に戻ると，作成した「testuser」ではログインできなくなることがある。  

権限の設定

psql コマンドを使う方法

psql コマンドを使い、 testuser 使用者のユーザ名とパスワードを、testdb データベースに設定します。

su - postgres
pg_ctl -D /usr/local/pgsql/data -l /usr/local/pgsql/logfile -o "-i" start
psql -U pgadmin testdb
create user "testuser" with password 'hoge$#34hoge5' nocreatedb nocreateuser;
\q
pg_ctl stop

テーブル（テーブル名は commodity とします）への権限を与えます．

grant select rule references trigger
on table commodity
to testuser;

参考Ｗｅｂページ: http://www.kids-clinic.jp/uni/phppgadmin.html の記事を参考にしました．  

テーブル定義

SQL を使わずに，専用ツールを使うこともできる． テーブル定義は，SQL を使った方が簡単にできるでしょう．

1. "テーブル"をクリック
2. "テーブルを作成する"をクリック
3. 名前・カラムの数を入力　
4. "次に"をクリック
5. カラム・長さを入力
6. データ型を選択
7. 他は必要であればチェック、入力する
8. "作成"クリック

SQL の編集と実行

SQL を簡単に実行できるので便利です．

1. phpPgAdmin において，ユーザ名 testuser とパスワード hoge$#34hoge5 でログイン，
2. 画面左の "postgres" をクリック
3. 画面中央の "SQL" をクリック
4. SQL を自由に書いて実行できる。

   書いたSQLを実行するときは「実行カラム」 をクリック。

SQL の例

create table commodity (
    id integer primary key not null,
    name varchar(32) not null,
    price integer );
insert into commodity values( 1, 'apple', 50 );
insert into commodity values( 2, 'orange', 20 );
insert into commodity values( 3, 'strawberry', 100 );
insert into commodity values( 4, 'watermelon', 150 );
insert into commodity values( 5, 'melon', 200 );
insert into commodity values( 6, 'banana', 100 );
select * from commodity;

期待される結果。

       TYPE NAME       PRICE
       ---- ---------- -----
          1 apple         50
          2 orange        20
          3 strawberry   100
          4 watermelon   150
          5 melon        200
          6 banana       100

テーブルの一覧表示と中身の表示と更新（行の追加，行の削除，値の更新）

テーブルの中身を簡単に閲覧でき、行の追加，削除，更新も簡単に行えるので便利です．挿入は，次の手順で行う． phpPgAdmin で，

1. "テーブル"クリック
2. 操作の欄の対象のテーブルの"挿入"クリック
3. データを入力
4. "挿入"クリック

テーブルのエクスポート

CSV 形式のファイルに、テーブルの中身をエクスポートすることも簡単に行えます。

閲覧，編集したいテーブル名を右クリック． 「CSVファイルの出力」でエクスポート。