Background

記錄一下再Laravel上對PostgreSQL的設定. 網路上都是MySQL的. (煙~)

Install

$ sudo yum install php56-pdo_pgsql php56w-pgsql

config

有兩個檔案分別要注意一下

config/database.php & .env, 這兩個檔案都必須要填入DB的資訊, .env.*.php 設定檔通常放在根目錄下, 這些檔案不會在版本控制當中.

/config/database.php

...
    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],

        'mysql' => [
            'driver' => 'mysql',
            'host' => env('DB_HOST', '127.0.0.1'),
            'port' => env('DB_PORT', '3306'),
            'database' => env('DB_DATABASE', 'forge'),
            'username' => env('DB_USERNAME', 'forge'),
            'password' => env('DB_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],

        'pgsql' => [
            'driver' => 'pgsql',
            'host' => env('DB_HOST', YOURHOST),
            'port' => env('DB_PORT', '5432'),
            'database' => env('DB_DATABASE', DBNAME),
            'username' => env('DB_USERNAME', USER),
            'password' => env('DB_PASSWORD', PASSWORD),
            'charset' => 'utf8',
            'prefix' => '',
            'schema' => 'public',
            'sslmode' => 'prefer',
        ],

    ],
...

.env

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:lyzdVGJ5Lsb+/RKTZyscVspCTpirnwxALGuJ7q4utXs=
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://localhost

#DB_CONNECTION=pgsql
#DB_HOST=paul-test.cjhahfrcbk1i.ap-northeast-1.rds.amazonaws.com
DB_PORT=5432
DB_DATABASE=paultest
DB_USERNAME=paul
DB_PASSWORD=PASSWORD

BROADCAST_DRIVER=log
CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=

Test

$ php artisan migrate:install

如果出現的不是 [2002] connection refuse之類的結果就表示你的DB連線部分是沒問題的.

make:migration

簡單紀錄一下 make:migration 這個指令怎麼用, 因為平常都直在下SQL所以用得有點不太習慣.

# create migration file
$ [php] artisan make:migration {action}_{table}_table [options]
  • options
  • --create={table_name}: 要新增的資料表名稱
  • --table={table_name}: 要變更的資料表名稱
  • 常見的{action}: create, add, remove

structure of migration file

在每個 migration 檔案中一定有兩個 method:

  • up:

撰寫對資料庫要做的所有動作. 如新增, 刪除資料表, or 新增, 刪減資料表欄位等等.

  • down:

相對於up, down裡面要寫的動作就是up的相反. 作為版本回朔的機制.

Other migrate command

  • migrate

  • 執行資料庫更變

  • migrate:status

  • 了解當前 migrate 的狀態. 跟 git status 差不多.

  • migrate:rollback

  • 回朔到上一次版本的資料庫內容.

Others

主要是一些觀念做個整理

  • 一個 migration 盡量只針對單一table完成須完成的動作. 如果要對多個資料表產生動作時, 就產生多個 migration 檔.

  • 在執行 migration 前, 必須確保 rollback的動作是沒問題的. (down的內容要測試的意思)