
Laravelから外部サーバーに立てたPostgreSQLに接続できないエラー`could not find driver`を解消した。

## 環境

- CentOS 7
- Laravel 5.8
- php7.3
- Nginx

php7.3はremiリポジトリのものを利用している。詳しくは下記の記事参照。

- [CentOS7にPHP7.3をインストールする](https://www.suzu6.net/posts/152-centos7-php-73/)

PostgreSQLに関して、`.env`と`\config\database.php`の設定をしてある。

`.env`

```
DB_CONNECTION=pgsql
DB_HOST=ホスト先のサーバIP
DB_PORT=5432
DB_DATABASE=db_name
DB_USERNAME=user_name
DB_PASSWORD=secret
```

`\config\database.php`

```php
'default' => env('DB_CONNECTION', 'pgsql'),
```

デフォルトをpgsqlに変更。

## 現象

コントローラー内でテーブルからデータを取得をする処理を実行した際に下記のエラー。

```log
[2019-05-15 04:58:19] local.ERROR: could not find driver (SQL: select * from "table_name") {"exception":"[object] (Illuminate\\Database\\QueryException(code: 0): could not find driver (SQL: select * from \"table_name\") at /srv/www/App/vendor/laravel/framework/src/Illuminate/Database/Connection.php:664, PDOException(code: 0): could not find driver at /srv/www/App/vendor/laravel/framework/src/Illuminate/Database/Connectors/Connector.php:70)
```

**要はPostgreSQLを操作するドライバーがないようです。**

### ドライバーのインストール

[こちら](https://qiita.com/SOJO/items/64bcc7954a32a5165498)の記事より、`php-pdo_pgsql`がPostgreSQLのドライバーみたいです。

その前に現在のphpのrpmを確認する。

```sh
$ rpm -qa | grep php
php-devel-7.3.4-1.el7.remi.x86_64
php-mbstring-7.3.4-1.el7.remi.x86_64
php73-php-json-7.3.4-1.el7.remi.x86_64
php-pecl-mcrypt-1.0.2-2.el7.remi.7.3.x86_64
php-pdo-7.3.4-1.el7.remi.x86_64
php73-php-common-7.3.4-1.el7.remi.x86_64
php-json-7.3.4-1.el7.remi.x86_64
php-cli-7.3.4-1.el7.remi.x86_64
php-gd-7.3.4-1.el7.remi.x86_64
php-common-7.3.4-1.el7.remi.x86_64
php-7.3.4-1.el7.remi.x86_64
php-xml-7.3.4-1.el7.remi.x86_64
php73-runtime-2.0-1.el7.remi.x86_64
php-fpm-7.3.4-1.el7.remi.x86_64
```

インストールする。

```sh
$ sudo yum install php-pdo_pgsql

インストール:
  php-pgsql.x86_64 0:7.3.5-1.el7.remi

依存性関連をインストールしました:
  oniguruma5.x86_64 0:6.9.2-1.el7.remi

依存性を更新しました:
  php.x86_64 0:7.3.5-1.el7.remi                      php-cli.x86_64 0:7.3.5-1.el7.remi
  php-common.x86_64 0:7.3.5-1.el7.remi               php-devel.x86_64 0:7.3.5-1.el7.remi
  php-fpm.x86_64 0:7.3.5-1.el7.remi                  php-gd.x86_64 0:7.3.5-1.el7.remi
  php-json.x86_64 0:7.3.5-1.el7.remi                 php-mbstring.x86_64 0:7.3.5-1.el7.remi
  php-pdo.x86_64 0:7.3.5-1.el7.remi                  php-xml.x86_64 0:7.3.5-1.el7.remi

完了しました!
```

無事、エラーが解消されました。

### Laravelのおすすめ参考書

こちらの書籍でLaravelの全体像が分かりやすいです。
MVCの概念の説明から開発環境の構築、Laravelの基本的な機能について学べます。

[PHPフレームワーク Laravel入門](https://amzn.to/2JVDkzI)

<a href="https://www.amazon.co.jp/PHP%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF-Laravel%E5%85%A5%E9%96%80-%E6%8E%8C%E7%94%B0%E6%B4%A5%E8%80%B6%E4%B9%83-ebook/dp/B07CLLW4MX/ref=as_li_ss_il?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=php7&qid=1558422296&s=books&sr=1-10&linkCode=li2&tag=suzu60c-22&linkId=619adb9f2b17c0e2847db78ab33c8e81" target="_blank"><img border="0" src="//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=B07CLLW4MX&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=suzu60c-22" ></a><img src="https://ir-jp.amazon-adsystem.com/e/ir?t=suzu60c-22&l=li2&o=9&a=B07CLLW4MX" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />

- バージョン：Laravel 5.4
- OS：Windows, Mac OS対応

注意：HTML/CSSが解かる人向けです。基本からちょっと外れたこと（既存のDBを使う方法など）は載っていません。

LaravelでPostgreSQLに接続できないエラー|could not find driver


Amazon Linux2にPostgreSQL10を入れたとき`psql`コマンドは使えたが、操作しようとするとき下記のようなエラーが出た。

```sh
psql: FATAL:  role "ec2-user" does not exist

psql: FATAL:  Peer authentication failed for user "postgres"
```

## 環境

- Amazon Linux2
- postgres10

インストールとバージョンの確認は以下。
パッケージマネージャは`yum`ではなく`amazon-linux-extras`を利用した。

```sh
$ sudo amazon-linux-extras install postgres10
$ psql -V
psql (PostgreSQL) 10.4
```

## 現象

ec2-userで操作すると「ロールec2-userは存在しない」とエラーが出た。
`psql -l`はデータベースのリストを確認するコマンド。

```sh
[ec2-user@hostname ~]$ psql -l
psql: FATAL:  role "ec2-user" does not exist
```

そこで、psqlの初期ユーザーの`postgres`で操作を試みた。
「ユーザー”postgres”のピア認証に失敗した」とエラーがでた。

```sh
[ec2-user@hostname ~]$ psql -l -U postgres
psql: FATAL:  Peer authentication failed for user "postgres"
```

また`root`ユーザーで試しても同様。

```sh
[ec2-user@hostname ~]$ sudo psql -l
psql: FATAL:  role "root" does not exist

[ec2-user@hostname ~]$ sudo psql -l -U postgres
psql: FATAL:  Peer authentication failed for user "postgres"
```

## 解決策

psqlの初期ユーザーではなく、実行ユーザーのpostgresで行う。

```sh
[ec2-user@hostname ~]$ sudo -u postgres psql -l
could not change directory to "/home/ec2-user": Permission denied
                                  List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges
-----------+----------+----------+-------------+-------------+-----------------------
 postgres  | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 |
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
(3 rows)
```

psqlの実行権限を変更しないといけない。

### 実行権限を修正

上記のエラーは設定によるものだった。
実行権限は`pg_hba.conf`で設定できる。

```sh
# コピー
$ sudo cp /var/lib/pgsql/data/pg_hba.conf /var/lib/pgsql/data/pg_hba.conf.org

# 確認
$ sudo cat /var/lib/pgsql/data/pg_hba.conf
```

```conf
# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident
```

ローカルからの接続のMETHODが`peer`になっていた。
これは実行者のユーザー名とデータベースユーザー名が一致するか検査している。

METHODを`trust`にして接続を無条件で許可するか、`md5`でパスワードを求めるようにか変更すると良い。

設定の詳細はドキュメントにある。

- [PostgreSQL 10.5文書](https://www.postgresql.jp/document/10/html/auth-pg-hba-conf.html)

psql FATA role "ec2-user" does not exist｜Amazon Linux2にPostgreSQL10を入れたとき


Amazon Linux2にPostgreSQL10をインストールして初期設定するまでの手順です。
yumリポジトリにはv10があるので楽に導入できました。

2019-06-26に２回目のインストールを行いました。
この手順で大丈夫そうです。

## 環境

- Amazon Linux2
- postgresql 10.4
- postgresql-server 10.4

## インストールと立ち上げ手順

### info

まずはインストールするパッケージの確認をする。
`yum info`の情報を載せた（一部省略）。

```sh
$ sudo yum info postgresql-server postgresql

Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name        : postgresql
Arch        : x86_64
Version     : 10.4
Release     : 5.amzn2.0.2
Size        : 5.2 M
Repo        : installed
From repo   : amzn2extra-postgresql10
Summary     : PostgreSQL client programs


Available Packages
Name        : postgresql-server
Arch        : x86_64
Version     : 10.4
Release     : 5.amzn2.0.2
Size        : 4.9 M
Repo        : amzn2extra-postgresql10/2/x86_64
Summary     : The programs needed to create and run a PostgreSQL server
```

yumリポジトリに[PostgreSQLのRepository Packages](https://yum.postgresql.org/repopackages.php#pg10)を導入が必要かと思ったが、`amzn2extra-postgresql10`に入っているようです。

### install

インストールとバージョンの確認は以下のコマンドでOK。

```sh
$ sudo yum install -y postgresql-server postgresql
```

```sh
$ psql -V
psql (PostgreSQL) 10.4
```

### 起動と自動起動

現時点ではpostgresqlが立ち上がっていないため、操作しようとすると下記のようなエラーが出る。

```sh
$ psql -l
psql: could not connect to server: No such file or directory
        Is the server running locally and accepting
        connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?
```

postgresqlを立ち上げ、自動起動させます。

```sh
# 自動起動
$ sudo systemctl enable postgresql

# 起動
$ sudo systemctl start postgresql

# ステータス確認
$ sudo systemctl status postgresql
● postgresql.service - PostgreSQL database server
   Loaded: loaded (/usr/lib/systemd/system/postgresql.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2019-05-14 14:41:05 JST; 1s ago
  Process: 13572 ExecStartPre=/usr/libexec/postgresql-check-db-dir %N (code=exited, status=0/SUCCESS)
 Main PID: 13574 (postmaster)
   CGroup: /system.slice/postgresql.service
           ├─13574 /usr/bin/postmaster -D /var/lib/pgsql/data
           ├─13577 postgres: logger process
           ├─13579 postgres: checkpointer process
           ├─13580 postgres: writer process
           ├─13581 postgres: wal writer process
           ├─13582 postgres: autovacuum launcher process
           ├─13583 postgres: stats collector process
           └─13584 postgres: bgworker: logical replication launcher
```

停止する際は、`sudo systemctl stop postgresql`でOKです。

### 立ち上がらないとき

```sh
$ sudo systemctl start postgresql
Job for postgresql.service failed because the control process exited with error code.
See "systemctl status postgresql.service" and "journalctl -xe" for details.
```

DBの初期化が必要だった

```sh
$ sudo postgresql-setup --initdb
```

## 初期設定

psqlで操作しようとした場合下記のようなエラー出ます。

```sh
$ psql -l
psql: FATAL:  role "ec2-user" does not exist
```

これは`pg_hba.conf`の初期設定が`peer`になっているためです。
一応、実行ユーザーのpostgresで行うと回避できます。

```sh
[ec2-user@hostname ~]$ sudo -u postgres psql -l
```

- [psql FATA role "ec2-user" does not exist｜Amazon Linux2にPostgreSQL10を入れたとき](https://www.suzu6.net/posts/158-amzon-linux2-postgres-error)

### 初期パスワード

ユーザpostgresも初期パスワードの設定が必要です。

```sh
$ sudo passwd postgres
Changing password for user postgres.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.
```

### postgresql.conf

`/var/lib/pgsql/data/`に設定ファイルが入っています。
`postgresql.conf`では外部に公開するためIPアドレスを変更しました。

```sh
# オリジナルを残して
$ sudo cp /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.org
# 編集する
$ sudo vi /var/lib/pgsql/data/postgresql.conf
```

```diff
-- #listen_addresses = 'localhost'          # what IP address(es) to listen on;
++ listen_addresses = '*'          # what IP address(es) to listen on;
                                        # comma-separated list of addresses;
                                        # defaults to 'localhost'; use '*' for all
                                        # (change requires restart)
#port = 5432                            # (change requires restart)
max_connections = 100                   # (change requires restart)
```

### pg_hba.conf

`pg_hba.conf`ではロールを設定します。

```sh
$ sudo cp /var/lib/pgsql/data/pg_hba.conf /var/lib/pgsql/data/pg_hba.conf.org
$ sudo vi /var/lib/pgsql/data/pg_hba.conf
```

ローカルからは認証をなくし、外部からはパスワードが必要になるよう変更します。

```diff
# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
-- local   all             all                                     peer
++ local   all             all                                     trust
# IPv4 local connections:
-- host    all             all             127.0.0.1/32            ident
++ host    all             all             0.0.0.0/0               md5
# IPv6 local connections:
-- host    all             all             ::1/128                 ident
++ #host    all             all             ::1/128                 ident
```

認証は以下の方式です。
> - Ident ： DB の所有者がシェルを実行している OS のユーザ名と一致するかで認証
> - MD5 ： PW 認証 (MD5-hashed)
> - Trust ： 認証せず、DB への接続許可 (PW スルー)
> 参考：[PostgreSQL 認証に失敗しないための Ident、MD5、Trust 比較](https://server.etutsplus.com/how-to-configure-postgresql-to-use-ident-md5-trust-authentication/)


設定が済んだら再起動します。

```sh
# 再起動
$ sudo systemctl restart postgresql
```

以上でPostgreSQL10のインストールと初期設定が終わりです。

```sh
# psqlに接続
$ psql -U postgres
```

Amazon Linux2にPostgreSQL10をインストールして初期設定する


CentOS 7にPostgreSQL 10をインストールしようとしましたが、どれを選べばよいか判らず困りました。
[yum.postgresql.org](https://yum.postgresql.org/)にダウンロードリンクがまとまっていますが、たくさんのリンクがあり初めは面食らうと思います。（最近は少しわかるようになってきた。）
また、ネットの記事から同じ環境で同じバージョンのインストール方法を見つけることは難しいです。

[www.postgresql.org](https://www.postgresql.org/download/)ではわかりやすく目的のリンクを探せるようになっていました。
英語やOSの違いでとっつきにくい部分があるので、翻訳しつつ使い方を紹介します。

Linuxを対象にしています。
ひとまず以下の環境向けの手順を示します。

- OS : CentOS 7.6 
  - architecture : x86_64
- PostgreSQL : 10


## Download URLの探し方

[www.postgresql.org](https://www.postgresql.org/download/)

まずは上記のダウンロードページを開きます。

![link](/images/posts/140/148/postgresql-download.png)

ページにはソースコードとバイナリパッケージがありますが、インストールが目的であるためバイナリパッケージを見ます。
「Binary packages」の「Linux」から目的の[ディストリビューション](https://ja.wikipedia.org/wiki/Linux%E3%83%87%E3%82%A3%E3%82%B9%E3%83%88%E3%83%AA%E3%83%93%E3%83%A5%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3)を選びます。

目的の**CentOS**がありました。
これをクリックして次のページへ進みます。

![link](/images/posts/140/148/selector.png)

今回紹介したいのはこのページです！
見て頂くとわかるように、バージョンやOSを選択するとインストールするコマンドまで表示してくれます。
目的のものだけ書いてあるため、混乱なくインストールできます。

### インストールの手順

項目の補足をしながら以下のの環境を作ってみます。

- OS : CentOS 7.6 
  - architecture : x86_64
- PostgreSQL : 10

#### 1. Select version: 

PostgreSQLのバージョンを聞かれています。
（RedHat系では）9.4から11まで選べます。

![step1](/images/posts/140/148/step1.png)

「10」を選びました。

#### 2. Select platform: 

PostgreSQLをインストールするOSを選びます。

![step2](/images/posts/140/148/step2.png)

「CentOS 7」を選びました。

#### 3. Select architecture: 

Linuxマシンのアーキテクチャ（ハードウェア）を選びます。

アーキテクチャはマシンのCPUです。
**x86_64**や**ppc64le**、**i386**などが該当します。

調べ方は`uname`コマンドを使う方法があります。
`uname -m`でマシン（ハードウェア）のタイプを表示します。

```sh
$ uname -m
x86_64

# arch コマンドも同等
$ arch
x86_64
```

![step3](/images/posts/140/148/step3.png)

**x86_64**を選びました。


- [Linuxカーネルのバージョン確認](https://uxmilk.jp/13610#js-heading5)
- [CentOS7で時間のずれを調整してみた](https://qiita.com/one-kelvin/items/36c59c674a82ff903143)
- アーキテクチャについての参考：[Linux カーネルの徹底調査 - IBM](https://www.ibm.com/developerworks/jp/linux/library/l-linux-kernel/index.html)

#### 4. Install the repository RPM:

Step 3まで選ぶと以降はインストールのコマンドです。
Linuxでコマンドを実行していきます。

目的のバージョンの**RPM**をインストールして、yumにリポジトリ情報を追加します。
先に`yum update`をしておくと良いです。

```sh
$ yum install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-6-x86_64/pgdg-sl10-10-2.noarch.rpm
（略）
インストール:
  pgdg-redhat-repo.noarch 0:42.0-4

完了しました!
```

RPMは、コンパイル済みのバイナリと関連するファイル群の情報をまとめたものです。
昔はソースコードだけ提供されていたため、コンパイルする必要がありました。

参考：[【パッケージ】Linuxの「パッケージ」と「yum」と「rpm」について勉強したのでまとめてみた。](https://qiita.com/sksmnagisa/items/05a6f8a707010b8bea56)

#### 5. Install the client packages:

本命のPostgreSQLをインストールします。

```sh
$ yum install postgresql10
(略)
インストール:
  postgresql10.x86_64 0:10.7-2PGDG.rhel7

依存性関連をインストールしました:
  libicu.x86_64 0:50.1.2-17.el7                                    postgresql10-libs.x86_64 0:10.7-2PGDG.rhel7

完了しました!
```

`yum info postgresql10`でインストール前に情報を確認できます。

#### 6. Optionally install the server packages:

オプションでpostgresql10-serverをインストールします。

```sh
$ yum install postgresql10-server
```

`yum info postgresql10`によると、「PostgreSQLサーバ上のPostgreSQLデータベースを操作したい場合は、このパッケージが必要」らしいです。なんとなく入れておきます。

#### 7. Optionally initialize the database and enable automatic start:

PostgreSQLの初期設定と自動的に立ち上がる設定です。


`systemctl`版の手順
```sh
# データベースの初期化
$ /usr/pgsql-10/bin/postgresql-10-setup initdb

# OS起動時にpostgresqlを自動起動する（同じ）
$ chkconfig postgresql-10 on

# postgresqlを立ち上げる
$ systemctl start postgresql-10
```

CentOS 7 から`systemctl`を使うよう変わりました。`service`コマンドはCentOS 6以前のコマンドです。

#### 操作のコマンド

postgresqlの操作コマンドも載せておきます。

```sh
# 起動
$ systemctl status postgresql-10

# ステータス確認
$ systemctl status postgresql-10

# 終了
$ systemctl stop postgresql-10

# 再起動
$ systemctl reload postgresql-10
```

以上です。

## 注意事項

### Fedoraについて

Red Hat系のFedoraをサーバ目的で使用することをPostgreSQLでは推奨していません。

> **Note**: due to the shorter support cycle on Fedora, all supported versions of PostgreSQL are not available on this platform. We do not recommend using Fedora for server deployments.
> 
> 雑訳：  
> $*$**注意**：Fedoraのサポートサイクルが短いため、サポートされているPostgreSQLの全バージョンはこのプラットフォーム（Fedora）では利用できません。Fedoraをサーバー配備に使用することはお勧めできません。

## 参考

- [PostgreSQL 10 を CentOS 7 に yum インストールする手順](https://weblabo.oscasierra.net/postgresql10-centos7-install/)

RPMやリポジトリなどの説明の参考とさせていただきました。

### おわりに

今回扱ったバージョン・OS以外のインストールも、同様にインストール手順が載っています。
悩んだら[www.postgresql.org](https://www.postgresql.org/download/)を辿ると良いでしょう。

LaravelでPostgreSQLに接続できないエラー|could not find driver

psql FATA role "ec2-user" does not exist｜Amazon Linux2にPostgreSQL10を入れたとき

Amazon Linux2にPostgreSQL10をインストールして初期設定する

欲しいバージョンのPostgreSQLのリンクがわからなくて困ったときのインストール方法｜CentOS版