Rails初心者必見!PGジェムをOS XにインストールしてPostgreSQLを使ってみよう
RailsでPGジェムをOS Xにインストールする:ネイティブ拡張機能のビルドエラー解説
RailsでPostgreSQLを使うために必要なpg
ジェムをOS Xにインストールしようとすると、ネイティブ拡張機能のビルドエラーが発生するケースがあります。このエラーは、いくつかの原因によって発生します。
原因
主な原因は以下の3つです。
-
開発環境の不足:
-
依存関係の不足:
-
環境設定の問題:
解決策
以下の手順で解決を試みます。
以下のコマンドを実行して、必要な開発環境がインストールされていることを確認します。
xcode-select --version
brew doctor
不足している場合は、以下のコマンドを実行してインストールします。
xcode-select --install
brew install command-line-tools
pg
ジェムの依存関係を調べるには、以下のコマンドを実行します。
gem spec pg
出力結果を確認し、不足しているライブラリがあればインストールします。
以下の環境変数が正しく設定されていることを確認します。
PATH
:/usr/local/bin
が含まれていることLDFLAGS
:-L/usr/local/opt/libpq/lib
が含まれていること
設定が正しくない場合は、.bash_profile
などの設定ファイルに追記します。
その他の解決策
上記の解決策で問題が解決しない場合は、以下の方法を試みます。
pg
ジェムのバージョンを古いバージョンに変更する--with-pg-config
オプションを付けてgem install
を実行する- Homebrewで
libpq
をインストールする
補足
上記の解決策を試しても問題が解決しない場合は、以下の情報を提供すると、より具体的なアドバイスを提供できる可能性があります。
- 使用しているOSのバージョン
gem install pg
コマンドを実行した時のエラーメッセージ
# Gemfile
gem 'pg'
# config/database.yml
default: &default
adapter: postgresql
encoding: unicode
database: my_database
username: postgres
password:
development:
<<: *default
database: my_database_development
test:
<<: *default
database: my_database_test
実行方法
- 上記のコードを
Gemfile
とconfig/database.yml
に保存します。 bundle install
コマンドを実行して、pg
ジェムをインストールします。rails db:create
コマンドを実行して、データベースを作成します。rails s
コマンドを実行して、Railsサーバーを起動します。
注意点
- 上記のコードはサンプルです。実際の環境に合わせて変更する必要があります。
- PostgreSQLサーバーがインストールされていない場合は、事前にインストールする必要があります。
RailsでPGジェムをOS Xにインストールする:その他の方法
Homebrew Caskを使うと、pg
ジェムを含むPostgreSQLを簡単にインストールすることができます。
brew cask install postgresql
公式のバイナリパッケージを使う
PostgreSQLの公式ウェブサイトからバイナリパッケージをダウンロードしてインストールすることができます。
ソースコードからインストールする方法もありますが、上級者向けです。
ruby-on-rails postgresql macos