Rails – タイムゾーン

2021-03-08 / tau / コメントする

概要

Railsでモデルのデータをデータベースに保存した時、OSやMySQLのタイムゾーンはJSTなのに、created_atやupdated_atの時刻がUSTで保存されているのに気付いた。

以下の2つの方法があるようだ。

データベースへの登録時刻をJSTにする方法
データベースへの時刻登録はUSTとし、表示をJSTにする方法

日本以外でも利用するデータベースの時刻を統一するにはUSTの方がよさそうなので、ここでは2つ目の方法を用いた。

プロジェクトのconf/application.rbに1行追加
- config.time_zone = ‘Tokyo’
サーバーが実行中の場合は再起動

これでデータベース上はUST、Railsでの扱いはJSTになる。

データベースへの記録はUST

文字列フィールドを1つ持つテスト用のモデルを生成・マイグレートする。

この操作は21時過ぎに実行したが、マイグレーションファイルの時刻が12時台で、9時間遅れているのでUSTとわかる。

なお。CentOSとMySQLのタイムゾーンはTokyoに設定されている。

Running via Spring preloader in process 26713
      invoke  active_record
      create    db/migrate/20210308121236_create_records.rb
      create    app/models/record.rb
      invoke    test_unit
      create      test/models/record_test.rb
      create      test/fixtures/records.yml
[vagrant@localhost demo_app]$ rails db:migrate
== 20210308121236 CreateRecords: migrating ====================================
-- create_table(:records)
   -> 0.0237s
== 20210308121236 CreateRecords: migrated (0.0238s) ===========================

Running via Spring preloader in process 26713

invoke active_record

create db/migrate/20210308121236_create_records.rb

create app/models/record.rb

invoke test_unit

create test/models/record_test.rb

create test/fixtures/records.yml

[vagrant@localhost demo_app]$ rails db:migrate

== 20210308121236 CreateRecords: migrating ====================================

-- create_table(:records)

-> 0.0237s

== 20210308121236 CreateRecords: migrated (0.0238s) ===========================

mysqlにテーブルが作られている。

mysql> show tables;
+-----------------------+
| Tables_in_demo_app_db |
+-----------------------+
| ar_internal_metadata  |
| records               |
| schema_migrations     |
+-----------------------+
3 rows in set (0.00 sec)

mysql> show tables;

+-----------------------+

| Tables_in_demo_app_db |

+-----------------------+

| ar_internal_metadata |

| records |

| schema_migrations |

+-----------------------+

3 rows in set (0.00 sec)

コントローラーを編集して、トップページ表示時にレコードを保存し、改めて読み込んで表示させる。

class DemoContentsController < ApplicationController
  def top_page
    record = Record.new({col1: 'abc'})
    record.save
    record = Record.find_by(col1: 'abc')
    puts "READ"
    p record
  end
end

class DemoContentsController < ApplicationController

def top_page

record = Record.new({col1: 'abc'})

record.save

record = Record.find_by(col1: 'abc')

puts "READ"

p record

end

データベースへの書き込み時と読み込み時の時刻がUSTになっている。

Started GET "/" for 10.0.2.2 at 2021-03-08 21:17:04 +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
   (1.9ms)  SELECT `schema_migrations`.`version` FROM `schema_migrations` ORDER BY `schema_migrations`.`version` ASC
Processing by DemoContentsController#top_page as HTML
  TRANSACTION (1.4ms)  BEGIN
  ↳ app/controllers/demo_contents_controller.rb:4:in `top_page'
  Record Create (1.6ms)  INSERT INTO `records` (`col1`, `created_at`, `updated_at`) VALUES ('abc', '2021-03-08 12:17:04.394262', '2021-03-08 12:17:04.394262')
  ↳ app/controllers/demo_contents_controller.rb:4:in `top_page'
  TRANSACTION (3.4ms)  COMMIT
  ↳ app/controllers/demo_contents_controller.rb:4:in `top_page'
  Record Load (2.3ms)  SELECT `records`.* FROM `records` WHERE `records`.`col1` = 'abc' LIMIT 1
  ↳ app/controllers/demo_contents_controller.rb:5:in `top_page'
READ
#<Record id: 1, col1: "abc", created_at: "2021-03-08 12:17:04.394262000 +0000", updated_at: "2021-03-08 12:17:04.394262000 +0000">
  Rendering layout layouts/application.html.erb
  Rendering demo_contents/top_page.html.erb within layouts/application
  Rendered demo_contents/top_page.html.erb within layouts/application (Duration: 1.8ms | Allocations: 705)
[Webpacker] Everything's up-to-date. Nothing to do
  Rendered layout layouts/application.html.erb (Duration: 16.2ms | Allocations: 6563)
Completed 200 OK in 79ms (Views: 20.0ms | ActiveRecord: 13.7ms | Allocations: 16960)

Started GET "/" for 10.0.2.2 at 2021-03-08 21:17:04 +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

(1.9ms) SELECT `schema_migrations`.`version` FROM `schema_migrations` ORDER BY `schema_migrations`.`version` ASC

Processing by DemoContentsController#top_page as HTML

TRANSACTION (1.4ms) BEGIN

↳ app/controllers/demo_contents_controller.rb:4:in `top_page'

Record Create (1.6ms) INSERT INTO `records` (`col1`, `created_at`, `updated_at`) VALUES ('abc', '2021-03-08 12:17:04.394262', '2021-03-08 12:17:04.394262')

↳ app/controllers/demo_contents_controller.rb:4:in `top_page'

TRANSACTION (3.4ms) COMMIT

↳ app/controllers/demo_contents_controller.rb:4:in `top_page'

Record Load (2.3ms) SELECT `records`.* FROM `records` WHERE `records`.`col1` = 'abc' LIMIT 1

↳ app/controllers/demo_contents_controller.rb:5:in `top_page'

READ

#<Record id: 1, col1: "abc", created_at: "2021-03-08 12:17:04.394262000 +0000", updated_at: "2021-03-08 12:17:04.394262000 +0000">

Rendering layout layouts/application.html.erb

Rendering demo_contents/top_page.html.erb within layouts/application

Rendered demo_contents/top_page.html.erb within layouts/application (Duration: 1.8ms | Allocations: 705)

[Webpacker] Everything's up-to-date. Nothing to do

Rendered layout layouts/application.html.erb (Duration: 16.2ms | Allocations: 6563)

Completed 200 OK in 79ms (Views: 20.0ms | ActiveRecord: 13.7ms | Allocations: 16960)

mysqlで登録されたレコードを確認すると、USTで保存されている。

mysql> SELECT * FROM records;
+----+------+----------------------------+----------------------------+
| id | col1 | created_at                 | updated_at                 |
+----+------+----------------------------+----------------------------+
|  1 | abc  | 2021-03-08 12:17:04.394262 | 2021-03-08 12:17:04.394262 |
+----+------+----------------------------+----------------------------+
1 row in set (0.00 sec)

mysql> SELECT * FROM records;

+----+------+----------------------------+----------------------------+

| id | col1 | created_at | updated_at |

+----+------+----------------------------+----------------------------+

| 1 | abc | 2021-03-08 12:17:04.394262 | 2021-03-08 12:17:04.394262 |

+----+------+----------------------------+----------------------------+

1 row in set (0.00 sec)

application.rbでタイムゾーンを設定

プロジェクトのconfig/aplication.rbに以下の1行を追加。

config.time_zone = 'Tokyo'

1	config.time_zone = 'Tokyo'

Railsサーバーを立ち上げなおして実行すると、表示がJSTになっている。

Started GET "/" for 10.0.2.2 at 2021-03-08 21:27:43 +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
   (1.7ms)  SELECT `schema_migrations`.`version` FROM `schema_migrations` ORDER BY `schema_migrations`.`version` ASC
Processing by DemoContentsController#top_page as HTML
  Record Load (2.3ms)  SELECT `records`.* FROM `records` WHERE `records`.`col1` = 'abc' LIMIT 1
  ↳ app/controllers/demo_contents_controller.rb:5:in `top_page'
READ
#<Record id: 1, col1: "abc", created_at: "2021-03-08 21:17:04.394262000 +0900", updated_at: "2021-03-08 21:17:04.394262000 +0900">
  Rendering layout layouts/application.html.erb
  Rendering demo_contents/top_page.html.erb within layouts/application
  Rendered demo_contents/top_page.html.erb within layouts/application (Duration: 4.0ms | Allocations: 705)
[Webpacker] Everything's up-to-date. Nothing to do
  Rendered layout layouts/application.html.erb (Duration: 24.3ms | Allocations: 6563)
Completed 200 OK in 96ms (Views: 31.1ms | ActiveRecord: 13.3ms | Allocations: 14376)

Started GET "/" for 10.0.2.2 at 2021-03-08 21:27:43 +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

(1.7ms) SELECT `schema_migrations`.`version` FROM `schema_migrations` ORDER BY `schema_migrations`.`version` ASC

Processing by DemoContentsController#top_page as HTML

Record Load (2.3ms) SELECT `records`.* FROM `records` WHERE `records`.`col1` = 'abc' LIMIT 1

↳ app/controllers/demo_contents_controller.rb:5:in `top_page'

READ

#<Record id: 1, col1: "abc", created_at: "2021-03-08 21:17:04.394262000 +0900", updated_at: "2021-03-08 21:17:04.394262000 +0900">

Rendering layout layouts/application.html.erb

Rendering demo_contents/top_page.html.erb within layouts/application

Rendered demo_contents/top_page.html.erb within layouts/application (Duration: 4.0ms | Allocations: 705)

[Webpacker] Everything's up-to-date. Nothing to do

Rendered layout layouts/application.html.erb (Duration: 24.3ms | Allocations: 6563)

Completed 200 OK in 96ms (Views: 31.1ms | ActiveRecord: 13.3ms | Allocations: 14376)

Rails – formヘルパーとCSRF対策

2021-03-08 / tau / コメントする

formヘルパーから生成されるタグ

たとえばfomr_tagヘルパーがレンダリングされると、formタグとhidden属性のinputタグが生成される。

<%= form_tag("/demo_contents/post_memo") do %>
↓
<form action="/demo_contents/post_memo" accept-charset="UTF-8" method="post">
<input type="hidden" name="authenticity_token" value="dN3WEdFwc6ZkCbiW_kMxFNPC_Ajz1BhnydL9kPbCcy3ZrcppdSYNHjitGKaRbvNuAQGxH_ihxcc6EjrK2AAUSA" />

<%= form_tag("/demo_contents/post_memo") do %>

↓

CSRF対策

form系のヘルパーで生成されるhiddenタイプのinputタグは、authenticity_tokenという名前でランダム文字列を値に持つ。

これはフォームに対する送信を確認するもので、Railsから送ったフォーム以外からの送信を排除するための仕掛け。

CSRF(Cross Site Request Forgeries)は、攻撃者のサイトへのリンクをクリックした場合に、そのサイトから意図しない送信が送られてしまうもの。

Railsではformヘルパーで生成されたトークンとサーバー内に持っているトークンが符合すれば、意図したフォームからの投稿と判断される。このためのメソッドがprotect_from_forgery。

Rails 5.2より前は、ApplicationControllerにprotect_from_forgeryが自動的に記述される。

class ApplicationController < ActionController::Base
  protect_from_forgery with: :exception
end

class ApplicationController < ActionController::Base

protect_from_forgery with: :exception

end

Rails 5.2以降はActionController::Baseで有効になっていて、追加記述の必要はない。

Rails – モデルによるDB操作の仕組み

2021-03-08 / tau / コメントする

概要

モデルによるデータベース操作を、できるだけ基本的な方法で行うことを試した。

またテーブル構造の変更に対して、マイグレーションを行わずにmysqlコンソールとコントロールファイル編集だけで対応できることを確認した。

モデルとテーブルの生成

モデルの生成

以下の様にモデルを生成する。このモデルは文字列型のフィールドを1つ持っている。

rails generate model record col1:string

[vagrant@localhost migrate]$ rails generate model record col1:string
Running via Spring preloader in process 24431
      invoke  active_record
      create    db/migrate/20210308054636_create_records.rb
      create    app/models/record.rb
      invoke    test_unit
      create      test/models/record_test.rb
      create      test/fixtures/records.yml

[vagrant@localhost migrate]$ rails generate model record col1:string

Running via Spring preloader in process 24431

invoke active_record

create db/migrate/20210308054636_create_records.rb

create app/models/record.rb

invoke test_unit

create test/models/record_test.rb

create test/fixtures/records.yml

app/models/record.rbが作成される。

class Record < ApplicationRecord
end

1 2	class Record < ApplicationRecord end

マイグレーションファイルも作成されていて、string型のフィールドが定義されている。

[vagrant@localhost demo_app]$ cat db/migrate/20210308054636_create_records.rb
class CreateRecords < ActiveRecord::Migration[6.1]
  def change
    create_table :records do |t|
      t.string :col1

      t.timestamps
    end
  end
end

[vagrant@localhost demo_app]$ cat db/migrate/20210308054636_create_records.rb

class CreateRecords < ActiveRecord::Migration[6.1]

def change

create_table :records do |t|

t.string :col1

t.timestamps

end

マイグレーション～テーブル生成

このモデルからマイグレーションによりテーブルを生成する。

rails db:migrate

[vagrant@localhost migrate]$ rails db:migrate
== 20210308054636 CreateRecords: migrating ====================================
-- create_table(:records)
   -> 0.0364s
== 20210308054636 CreateRecords: migrated (0.0365s) ===========================

[vagrant@localhost migrate]$ rails db:migrate

== 20210308054636 CreateRecords: migrating ====================================

-- create_table(:records)

-> 0.0364s

== 20210308054636 CreateRecords: migrated (0.0365s) ===========================

mysqlでテーブルが生成されていることと、そのテーブルの構造が確認できる。

mysql> show tables;
+-----------------------+
| Tables_in_demo_app_db |
+-----------------------+
| ar_internal_metadata  |
| records               |
| schema_migrations     |
+-----------------------+
3 rows in set (0.00 sec)

mysql> desc records;
+------------+--------------+------+-----+---------+----------------+
| Field      | Type         | Null | Key | Default | Extra          |
+------------+--------------+------+-----+---------+----------------+
| id         | bigint       | NO   | PRI | NULL    | auto_increment |
| col1       | varchar(255) | YES  |     | NULL    |                |
| created_at | datetime(6)  | NO   |     | NULL    |                |
| updated_at | datetime(6)  | NO   |     | NULL    |                |
+------------+--------------+------+-----+---------+----------------+
4 rows in set (0.00 sec)

mysql> show tables;

+-----------------------+

| Tables_in_demo_app_db |

+-----------------------+

| ar_internal_metadata |

| records |

| schema_migrations |

+-----------------------+

3 rows in set (0.00 sec)

mysql> desc records;

+------------+--------------+------+-----+---------+----------------+

+------------+--------------+------+-----+---------+----------------+

| id | bigint | NO | PRI | NULL | auto_increment |

| col1 | varchar(255) | YES | | NULL | |

+------------+--------------+------+-----+---------+----------------+

4 rows in set (0.00 sec)

モデルの構造の確認

コントローラーからモデルの内容を出力させる。

class DemoContentsController < ApplicationController
  def top_page
    puts "EXAMPLE"
    record = Record.new
    p record
  end
end

class DemoContentsController < ApplicationController

def top_page

puts "EXAMPLE"

record = Record.new

p record

end

トップページを出力させると、サーバー実行中のコンソールに以下が出力される。

app/controllers/demo_contents_controller.rb:4:in `top_page'
Started GET "/" for 10.0.2.2 at 2021-03-** **:**:** +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
Processing by DemoContentsController#top_page as HTML
EXAMPLE
#<Record id: nil, col1: nil, created_at: nil, updated_at: nil>

app/controllers/demo_contents_controller.rb:4:in `top_page'

Started GET "/" for 10.0.2.2 at 2021-03-** **:**:** +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

Processing by DemoContentsController#top_page as HTML

EXAMPLE

#<Record id: nil, col1: nil, created_at: nil, updated_at: nil>

Railsデフォルトのid、created_at、updated_atに加えてcol1が要素に加わっている。

データの登録確認

トップページアクセス時にレコードを1つ登録する。レコードのフィールドはハッシュで指定する。

lass DemoContentsController < ApplicationController
  def top_page
    puts "EXAMPLE"
    record = Record.new({col1: 'abc'})
    p record
    record.save
  end
end

lass DemoContentsController < ApplicationController

def top_page

puts "EXAMPLE"

record = Record.new({col1: 'abc'})

p record

record.save

end

Railsサーバーのコンソールに以下が出力され、データが生成・登録されていることがわかる。

app/controllers/demo_contents_controller.rb:6:in `top_page'
Started GET "/" for 10.0.2.2 at 2021-03-** **:**:** +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
Processing by DemoContentsController#top_page as HTML
EXAMPLE
#<Record id: nil, col1: "abc", created_at: nil, updated_at: nil>
  TRANSACTION (2.7ms)  BEGIN
  ↳ app/controllers/demo_contents_controller.rb:6:in `top_page'
  Record Create (2.4ms)  INSERT INTO `records` (`col1`, `created_at`, `updated_at`) VALUES ('abc', '2021-03-** **:**:**.501886', '2021-03-** **:**:**.501886')
  ↳ app/controllers/demo_contents_controller.rb:6:in `top_page'
  TRANSACTION (9.4ms)  COMMIT

app/controllers/demo_contents_controller.rb:6:in `top_page'

Started GET "/" for 10.0.2.2 at 2021-03-** **:**:** +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

Processing by DemoContentsController#top_page as HTML

EXAMPLE

#<Record id: nil, col1: "abc", created_at: nil, updated_at: nil>

TRANSACTION (2.7ms) BEGIN

↳ app/controllers/demo_contents_controller.rb:6:in `top_page'

Record Create (2.4ms) INSERT INTO `records` (`col1`, `created_at`, `updated_at`) VALUES ('abc', '2021-03-** **:**:**.501886', '2021-03-** **:**:**.501886')

↳ app/controllers/demo_contents_controller.rb:6:in `top_page'

TRANSACTION (9.4ms) COMMIT

mysqlでもテーブルへの登録状況が確認できる。

mysql> SELECT * FROM records;
+----+------+----------------------------+----------------------------+
| id | col1 | created_at                 | updated_at                 |
+----+------+----------------------------+----------------------------+
|  1 | abc  | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 |
+----+------+----------------------------+----------------------------+
1 row in set (0.00 sec)

mysql> SELECT * FROM records;

+----+------+----------------------------+----------------------------+

| id | col1 | created_at | updated_at |

+----+------+----------------------------+----------------------------+

| 1 | abc | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 |

+----+------+----------------------------+----------------------------+

1 row in set (0.00 sec)

データの読み込み確認

トップページ読み込み時にデータベースを読み込んで表示するように変更する。

class DemoContentsController < ApplicationController
  def top_page
    puts "EXAMPLE"
    records = Record.all
    p records
  end
end

class DemoContentsController < ApplicationController

def top_page

puts "EXAMPLE"

records = Record.all

p records

end

出力は以下のとおりで、データベースの内容が読みだされている。

app/controllers/demo_contents_controller.rb:5:in `top_page'
.....
EXAMPLE
  Record Load (2.0ms)  SELECT `records`.* FROM `records` /* loading for inspect */ LIMIT 11
  ↳ app/controllers/demo_contents_controller.rb:5:in `p'
#<ActiveRecord::Relation [#<Record id: 1, col1: "abc", created_at: "2021-03-** **:**:**.501886000 +0000", updated_at: "2021-03-** **:**:**.501886000 +0000">]>

app/controllers/demo_contents_controller.rb:5:in `top_page'

.....

EXAMPLE

Record Load (2.0ms) SELECT `records`.* FROM `records` /* loading for inspect */ LIMIT 11

↳ app/controllers/demo_contents_controller.rb:5:in `p'

#<ActiveRecord::Relation [#<Record id: 1, col1: "abc", created_at: "2021-03-** **:**:**.501886000 +0000", updated_at: "2021-03-** **:**:**.501886000 +0000">]>

MySQLでのテーブル変更

以下の様にmysqlで直接テーブルにフィールドを加える。

mysql> ALTER TABLE records ADD col2 INT;
Query OK, 0 rows affected (0.03 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> SELECT * FROM records;
+----+------+----------------------------+----------------------------+------+
| id | col1 | created_at                 | updated_at                 | col2 |
+----+------+----------------------------+----------------------------+------+
|  1 | abc  | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 | NULL |
+----+------+----------------------------+----------------------------+------+
1 row in set (0.00 sec)

mysql> ALTER TABLE records ADD col2 INT;

Query OK, 0 rows affected (0.03 sec)

Records: 0 Duplicates: 0 Warnings: 0

mysql> SELECT * FROM records;

+----+------+----------------------------+----------------------------+------+

| id | col1 | created_at | updated_at | col2 |

+----+------+----------------------------+----------------------------+------+

| 1 | abc | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 | NULL |

+----+------+----------------------------+----------------------------+------+

1 row in set (0.00 sec)

Railsで変更後テーブルへの書き込み

トップページアクセス時に、フィールド追加後のテーブルに新たなデータを書き込むように変更。

class DemoContentsController < ApplicationController
  def top_page
    puts "EXAMPLE"
    record = Record.new({col1: 'ABC', col2: 123})
    p record
    record.save
  end
end

class DemoContentsController < ApplicationController

def top_page

puts "EXAMPLE"

record = Record.new({col1: 'ABC', col2: 123})

p record

record.save

end

トップページ表示時にデータが登録され、テーブルは以下の様に更新されている。

mysql> SELECT * FROM records;
+----+------+----------------------------+----------------------------+------+
| id | col1 | created_at                 | updated_at                 | col2 |
+----+------+----------------------------+----------------------------+------+
|  1 | abc  | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 | NULL |
|  2 | ABC  | 2021-03-** **:**:**.219484 | 2021-03-** **:**:**.219484 |  123 |
+----+------+----------------------------+----------------------------+------+
2 rows in set (0.00 sec)

mysql> SELECT * FROM records;

+----+------+----------------------------+----------------------------+------+

| id | col1 | created_at | updated_at | col2 |

+----+------+----------------------------+----------------------------+------+

| 1 | abc | 2021-03-** **:**:**.501886 | 2021-03-** **:**:**.501886 | NULL |

| 2 | ABC | 2021-03-** **:**:**.219484 | 2021-03-** **:**:**.219484 | 123 |

+----+------+----------------------------+----------------------------+------+

2 rows in set (0.00 sec)

Rails – プロジェクトでのデータベース準備

2021-03-08 / tau / コメントする

概要

Railsでモデルによりフォームやデータベースとのやり取りをする流れ。

プロジェクト生成時にDBMSを指定
database.ymlを編集してデータベースを生成
モデルを生成
マイグレーションでテーブルを生成
モデルでフォームデータを取得
モデルでテーブルを読み書き

プロジェクト生成時

プロジェクト生成時にDBMSを指定する。

Rails2.0.2以降ではデフォルトデータベースがMySQLからSQLiteに変更
MySQLを使う場合、プロジェクト生成時に以下の様に指定

rails generate project_name -d mysql rails generrate project_name --database=mysql

データベースの生成・操作

database.ymlの編集

config/database.ymlファイルの内容を設定・変更

default: &default
  #adapter: sqlite3
  adapter: mysql2 # MySQLを使う設定になっているか確認
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  timeout: 5000
  encoding: utf8
  username: root  # MySQLのユーザー名を確認
  password: ****  # MySQLのパスワードを確認

development:
  <<: *default
  #database: db/development.sqlite3
  database: ****  # 利用するDB名を設定

test:
  <<: *default
  #database: db/test.sqlite3
  database: ****  # 利用するDB名を設定またはコメントアウト

production:
  <<: *default
  #database: db/production.sqlite3 # 利用するDB名を設定またはコメントアウト

default: &default

#adapter: sqlite3

adapter: mysql2 # MySQLを使う設定になっているか確認

pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

timeout: 5000

encoding: utf8

username: root # MySQLのユーザー名を確認

password: **** # MySQLのパスワードを確認

development:

<<: *default

#database: db/development.sqlite3

database: **** # 利用するDB名を設定

test:

<<: *default

#database: db/test.sqlite3

database: **** # 利用するDB名を設定またはコメントアウト

production:

<<: *default

#database: db/production.sqlite3 # 利用するDB名を設定またはコメントアウト

データベースの生成

以下のコマンドでdatabase.ymlの設定に従ってデータベースを生成。

rails db:create

データベースの確認

以下のいずれかの方法で、アプリケーションのデータベースを確認できる。

mysql -u user -pを実行してMySQLのコンソールに入る
プロジェクトディレクトリー内でrails dbconsoleを実行して、アプリケーションが使うデータベースをuseした状態でMySQLのコンソールに入る

データベースの削除

以下のコマンドでアプリケーションで使っているデータベースが削除される。有無を言わさずすべてのテーブルごと消えてしまうので注意。

rails db:drop

実行例

database.yml

データベース名を設定する。以下はdemo_appアプリケーションでdemo_app_dbを使う設定。

[vagrant@localhost demo_app]$ cat config/database.yml
.....
default: &default
  adapter: mysql2
  encoding: utf8mb4
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  username: root
  password: vagrant
  socket: /var/lib/mysql/mysql.sock

development:
  <<: *default
  database: demo_app_db
.....

[vagrant@localhost demo_app]$ cat config/database.yml

.....

default: &default

adapter: mysql2

encoding: utf8mb4

pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

username: root

password: vagrant

socket: /var/lib/mysql/mysql.sock

development:

<<: *default

database: demo_app_db

.....

データベースの生成

rails db:createコマンドでdatabase.ymlの設定を使ってデータベースを作成する。

[vagrant@localhost demo_app]$ rails db:create
Created database 'demo_app_db'

1 2	[vagrant@localhost demo_app]$ rails db:create Created database 'demo_app_db'

rails dbconsoleコマンドでデータベースが作成されたことを確認。

mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| demo_app_db        |
| information_schema |
| mysql              |
| performance_schema |
| sys                |
| testdb             |
+--------------------+
6 rows in set (0.00 sec)

mysql> show databases;

+--------------------+

| Database |

+--------------------+

| demo_app_db |

| information_schema |

| mysql |

| performance_schema |

| sys |

| testdb |

+--------------------+

6 rows in set (0.00 sec)

Rails – ヘルパーメソッド

2021-03-06 / tau / コメントする

主なヘルパーメソッド

link_to

<a>要素を生成する。

基本形

<%= link_to "表示テキスト", URL %>

<a href=URL>表示テキスト</a>を生成
URLは文字列形式のほか、routes.rbでas:指定をしたパス(***_path)を指定可能

属性の追加

<%= link_to text, URL, :attr_name => 'attr_value' %>

たとえばid属性の場合、:id => 'ID'など
複数の属性をカンマで区切って列挙できる

フォーム関係

フォームヘルパー(旧)

Rails – DB操作～基礎的な読み書き

2021-03-03 / tau / コメントする

概要

Railsでデータベースを操作する場合、フォームの入力～モデル～データベースを自動で関連付ける方法が一般的
ここでは、モデルオブジェクトを直接操作してデータベースとの間での書き込み・読み込み処理を整理する

手順

書き込み

手順は以下の通り。

カラム＝プロパティーを指定してモデルインスタンスを生成
- @model_name = ModelName.new(col1: val1, ...)
インスタンスメソッドsaveでデータベースに書き込み
- @model_name.save
結果として返されるtrue/falseに応じて必要な処理を行う

    @tweet = Tweet.new(name: params[:name], content: params[:tweet])
    if @tweet.save
      redirect_to('/')
    else
      render 'new' and return
    end

@tweet = Tweet.new(name: params[:name], content: params[:tweet])

if @tweet.save

redirect_to('/')

else

render 'new' and return

end

読み込み

全データを読み出す場合、モデルクラスのクラスメソッドallを使う。

@model_names = ModelName.all

この変数をviewなどで利用するときは、各フィールドをプロパティーとして参照する。

@model_names.col1

Rails – 基礎的なフォーム

2021-03-02 / tau / コメントする

概要

フォームとのパラメーターのやりとりのみを確認する。

既存のビューにフォーム関係のタグを書き、新たなアクションに送信する
既存のコントローラーにそのアクションを追加し、フォームからのデータをパラメータとして受け取る
受け取ったパラメーターをフォームを書いた既存のビューに渡してレンダリング
フォーム関連のタグをヘルパーに置き換える

元になる枠組み

プロジェクト：demo_app
コントローラー：demo_contents
アクション：top_page
ビュー：top_page.html.erb

STEP-1～form_tag

ビューファイルへのフォームの記述

top_page.html.erbに以下の内容を記述。

<h1>メモパッド</h1>
<%= form_tag("/demo_contents/post_memo") do %>
  <input type="text" name="memo" placeholder="メモを入力" value="">
  <input type="submit" value="書き込み">
<% end %>

<h1>メモパッド</h1>

<%= form_tag("/demo_contents/post_memo") do %>

<% end %>

上記のform_tagは、submitされた内容を指定したアクションにpostするformタグを生成する。

ただし直接formタグを書くと”invalid authenticity token”エラーになる。

コントローラーにアクション追加

フォームからPOSTで送られる内容を受けるアクションを、コントローラにメソッドとして追加する。

class DemoContentsController < ApplicationController
  def top_page
  end

  def post_memo
  end
end

class DemoContentsController < ApplicationController

def top_page

end

def post_memo

end

ルーティングの追加

config/routes.rbファイルに、POSTに対するアクションメソッドへのルーティングを追加する。

Rails.application.routes.draw do
  root to: 'demo_contents#top_page'
  post 'demo_contents/post_memo', to: 'demo_contents#post_memo'
end

Rails.application.routes.draw do

root to: 'demo_contents#top_page'

post 'demo_contents/post_memo', to: 'demo_contents#post_memo'

end

アクションの確認

ルートページにフォームが表示され、テキストボックスにメモを入力して送信ボタンを押すと、Railsサーバーにデータが送られている様子が表示される。

Started POST "/demo_contents/post_memo" for 10.0.2.2 at 2021-03-01 22:28:24 +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
Processing by DemoContentsController#post_memo as HTML
  Parameters: {"authenticity_token"=>"[FILTERED]", "memo"=>"メモ"}
No template found for DemoContentsController#post_memo, rendering head :no_content
Completed 204 No Content in 5ms (Allocations: 1537)

Started POST "/demo_contents/post_memo" for 10.0.2.2 at 2021-03-01 22:28:24 +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

Processing by DemoContentsController#post_memo as HTML

Parameters: {"authenticity_token"=>"[FILTERED]", "memo"=>"メモ"}

No template found for DemoContentsController#post_memo, rendering head :no_content

Completed 204 No Content in 5ms (Allocations: 1537)

STEP-2～params

params変数の確認

フォームからsubmitされたときのフォーム要素の値は、params変数に格納される
params変数はハッシュで、フォーム要素のname属性で指定した内容がキーになる

確認のため、demo_contentsコントローラーのpost_memoアクションに1行追加する。

class DemoContentsController < ApplicationController
  def top_page
  end

  def post_memo
    puts params[:memo]
  end
end

class DemoContentsController < ApplicationController

def top_page

end

def post_memo

puts params[:memo]

end

ここでテキストボックスにメモを入力して送信すると、Railsサーバーにその内容が表示される。

Started POST "/demo_contents/post_memo" for 10.0.2.2 at 2021-03-01 22:46:37 +0900
Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1
Processing by DemoContentsController#post_memo as HTML
  Parameters: {"authenticity_token"=>"[FILTERED]", "memo"=>"メモ"}
メモ
No template found for DemoContentsController#post_memo, rendering head :no_content
Completed 204 No Content in 1ms (Allocations: 329)

Started POST "/demo_contents/post_memo" for 10.0.2.2 at 2021-03-01 22:46:37 +0900

Cannot render console from 10.0.2.2! Allowed networks: 127.0.0.0/127.255.255.255, ::1

Processing by DemoContentsController#post_memo as HTML

Parameters: {"authenticity_token"=>"[FILTERED]", "memo"=>"メモ"}

メモ

No template found for DemoContentsController#post_memo, rendering head :no_content

Completed 204 No Content in 1ms (Allocations: 329)

params変数のHTMLへの反映

上記のpost_memoアクションの内容を以下の様に変更する。

viewから参照可能な@memoにフォームから受け取ったparams[:memo]の内容をセット
トップページへのレンダリングとreturn

@変数はクラスのインスタンス変数で、これをアクションとビューで共有できる。

class DemoContentsController < ApplicationController
  def top_page
    @memo = ""
  end

  def post_memo
    @memo = params[:memo]
    render "demo_contents/top_page" and return
  end
end

class DemoContentsController < ApplicationController

def top_page

@memo = ""

end

def post_memo

@memo = params[:memo]

render "demo_contents/top_page" and return

end

またビューファイルtop_page.html.erbに以下の様に追記する。コントローラーでセットされた@memoの内容をHTMLで表示させている。

<h1>メモパッド</h1>
<%= form_tag("/demo_contents/post_memo") do %>
  <input type="text" name="memo" placeholder="メモを入力" value="">
  <input type="submit" value="書き込み">
<% end %>

<h2>メモの内容</h2>
<p><%= @memo %></p>

<h1>メモパッド</h1>

<%= form_tag("/demo_contents/post_memo") do %>

<% end %>

<h2>メモの内容</h2>

この結果、送信ボタンを押すと入力したメモの内容がtop_pageに表示されるようになる。

STEP-3～フォームヘルパー

フォーム内の要素を、以下の様にフォームヘルパー関数に書き換える。

さらにformヘルパーはhiddenタイプのinputタグを追加するが、これはCSRF対策のため。

<h1>メモパッド</h1>
<%= form_tag("/demo_contents/post_memo") do %>
  <%= label_tag(:memo, "メモ:") %>
  <%= text_field_tag(:memo, nil, placeholder: "メモの内容") %>
  <%= submit_tag("書き込み") %>
<% end %>

<h2>メモの内容</h2>
<p><%= @memo %></p>

<h1>メモパッド</h1>

<%= form_tag("/demo_contents/post_memo") do %>

<%= label_tag(:memo, "メモ:") %>

<%= text_field_tag(:memo, nil, placeholder: "メモの内容") %>

<%= submit_tag("書き込み") %>

<% end %>

<h2>メモの内容</h2>

上記のlabel_tag、text_field_tag、submit_tagはそれぞれ対応するタグに変換される～フォームヘルパー(旧)。

<%= label_tag(:memo, "メモ:") %>
↓
<label for="memo">メモ:</label>

<%= text_field_tag(:memo, nil, placeholder: "メモの内容") %>
↓
<input id="memo" name="memo" type="text" placeholder="メモの内容">

<%= submit_tag("書き込み") %>
↓
<input name="commit" type="submit" value="書き込み" />

<%= label_tag(:memo, "メモ:") %>

↓

<%= text_field_tag(:memo, nil, placeholder: "メモの内容") %>

↓

<%= submit_tag("書き込み") %>

↓

form_tagヘルパーのまとめ

フォーム全体

form_tag…endヘルパーでフォーム全体を囲む
form_tagではポスト先のURLを指定する
ポスト先のURLはroutes.rbでポスト先アクションにルーティングしておく

<%= form_tag("URL") do %>
.....
<% end %>

<%= form_tag("URL") do %>

.....

<% end %>

フォーム内のヘルパー

label、inputタグに置き換えられるヘルパーの多くは、第1引数にname属性に対応する引数をとる
この名前引数には、一般にシンボルがあてられる

label_tag(:user_name, "入力してください")
text_field_tag(:user_name)
↓
<label for="user_name">入力してください</label>
<input type="text" id="user_name" name="name>

label_tag(:user_name, "入力してください")

text_field_tag(:user_name)

↓

<label for="user_name">入力してください</label>

受信側での扱い

受信側ではparamsというハッシュにフォームからの受信結果が入れられる
受信のためにルーティングされたアクション内で、このparamsを参照する
paramsのキーに、フォームでname属性に指定したシンボルを使って値を読み出す

class DemoContentsController < ApplicationController
  .....

  def post_process
    puts params[:user_name]
  end
end

class DemoContentsController < ApplicationController

.....

def post_process

puts params[:user_name]

end

Rails – フォームヘルパー(旧)

2021-03-02 / tau / コメントする

共通事項

名前の指定

タグのid/nameやラベルのforに指定する識別子の指定方法に、文字列とシンボルの2種類がある。

text_field_tag(:name) text_field_tag("name")

いずれも生成されるタグはid/nameに文字列が設定される。

<input type="text" id="name" name="name">

基本系

form_tag

form_tagはfomタグを生成する(Railsdoc)。

form_tag(action [option/HTML_attr/event]) do
end

アクションを指定

<%= form_tag('/users') do %>
<% end %>
↓
<form action="users" method="post">
</form>

<%= form_tag('/users') do %>

<% end %>

↓

</form>

メソッドを指定

<%= form_tag('/users', method: :put) do %>
<% end %>
↓
<form action="users" method="put">
</form>

<%= form_tag('/users', method: :put) do %>

<% end %>

↓

</form>

multipart指定

<%= form_tag('/users', multipart: true) do %>
<% end %>
↓
<form action="users" method="post" enctype="multipart/form-data">
</form>

<%= form_tag('/users', multipart: true) do %>

<% end %>

↓

</form>

submit_tag

submit_tagはinputタグのtype="submit"を生成する(Railsdoc)。

submit_tag([button_name , option/HTML_attr/event])

ボタン名を指定：第1引数はボタン名

<%= submit_tag("送信") %>
<input type="submit" name="commit" value="送信" data-disable-with="送信">

1 2	<%= submit_tag("送信") %> <input type="submit" name="commit" value="送信" data-disable-with="送信">

無効化

submit_tag("送信", disabled: true)
<input disabled="disabled" name="commit" data-disable-with="送信" type="submit" value="送信">

1 2	submit_tag("送信", disabled: true) <input disabled="disabled" name="commit" data-disable-with="送信" type="submit" value="送信">

POST中の表示の指定

submit_tag "送信", data: { disable_with: "送信中..." }
<input name="commit" data-disable-with="送信中..." type="submit" value="送信">

1 2	submit_tag "送信", data: { disable_with: "送信中..." } <input name="commit" data-disable-with="送信中..." type="submit" value="送信">

label_tag

label_tagはフォーム要素と関連付けられたラベルタグを生成する(Railsdoc)。

label_tag(id&name [, contents [, HTML_attr or event])

識別子と内容を指定

label_tag(:name, "入力してください")
text_field_tag(:name)
↓
<label for="name">入力してください</label>
<input type="text" id="name" name="name>

label_tag(:name, "入力してください")

text_field_tag(:name)

↓

<label for="name">入力してください</label>

テキスト入力系

text_field_tag

text_field_tagはinputタグのtype="text"を生成する(Railsdoc)。

text_field_tag(id&name [, value, option/HTML_attr/event])

識別子のみ指定：第1引数がidとnameにセットされる

text_field_tag(:name)
<input id="name" name="name" type="text">

1 2	text_field_tag(:name) <input id="name" name="name" type="text">

値を指定：第2引数がvalueの値になる

text_field_tag(:name, "initial value")
<input id="name" name="name" type="text" value="initial value">

1 2	text_field_tag(:name, "initial value") <input id="name" name="name" type="text" value="initial value">

識別子とプレースホルダーを指定

text_field_tag(:name, nil, placeholder: "Input here')
<input id="name" name="name" type="text" placeholder="Input here">

1 2	text_field_tag(:name, nil, placeholder: "Input here') <input id="name" name="name" type="text" placeholder="Input here">

クラス指定

text_field_tag(:name, nil, class: "class_name")
<input id="name" name="name" type="text" class="class_name">

1 2	text_field_tag(:name, nil, class: "class_name") <input id="name" name="name" type="text" class="class_name">

Rails – ルーティング

2021-03-01 / tau / コメントする

ルーティングファイルの役割

RailsがユーザーのブラウザーからGETやPOSTなどのリクエストを受け取ると、まずルーティングファイルを参照する。

ルーティングファイルには、リクエストの種類、リクエストのターゲットURL、ターゲットURLに対応するコントローラーとアクションが記述されている。

その内容に従って必要なコントローラーが呼び出されて処理を行った後、ユーザー側へレンダリングされた内容が返される。

ファイルの位置とファイル名

ルーティングファイル(routes.rb)は、プロジェクト生成時にconfigディレクトリー下に生成される。

config/routes.rb

ファイルの内容

アクションを指定してコントローラーを生成すると、routes.rbにそのアクションへのルーティングを記述した1行が追加される。

たとえばコントローラーとしてdemo_contents、そのアクションとしてtop_pageを指定して生成すると以下のような内容でルーティングの記述が追加される。

Rails.application.routes.draw do
  get 'demo_contents/top_page'
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

Rails.application.routes.draw do

get 'demo_contents/top_page'

# For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html

end

一方、アクションを指定せずにコントローラーだけ指定して生成すると、route.rbへの追加は行われない。

Rails.application.routes.draw do
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

Rails.application.routes.draw do

# For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html

end

基本的なルーティングの書き方

URL指定

以下の3つの記述は全て等価で、ブラウザーからURLをlocalhost:3000/demo_contents/top_pageと指定してGETリクエストしたとき、demo_contentsコントローラーのtop_pageアクションが実行される。

  get 'demo_contents/top_page'
  get 'demo_contents/top_page' => 'demo_contents#top_page'
  get 'demo_contents/top_page', to: 'demo_contents#top_page'

get 'demo_contents/top_page'

get 'demo_contents/top_page' => 'demo_contents#top_page'

get 'demo_contents/top_page', to: 'demo_contents#top_page'

2つ目と3つ目の記述法では、URLに他の表現を設定することが可能。

以下の例ではlocalhost:3000/fooを指定した時に、demo_contentsコントローラーのtop_pageアクションが実行される。

  get 'foo', to: 'demo_contents#top_page'
  get 'foo', controller: 'demo_contents', action: 'top_page'

1 2	get 'foo', to: 'demo_contents#top_page' get 'foo', controller: 'demo_contents', action: 'top_page'

ルートページの指定

ルートページとして特定のコントローラー・アクションを設定するときは、以下の様に記述する。

  root 'demo_contents#top_page'
  root :to  => 'demo_contents#top_page'
  root to: 'demo_contents#top_page'

root 'demo_contents#top_page'

root :to => 'demo_contents#top_page'

root to: 'demo_contents#top_page'

項設定すると、localhost:3000のようにブラウザーからリクエストするとdemo_contentsのtop_pageアクションが実行される。

基礎的なルーティング

rails routesによるルーティングの確認、to:によるURLの置き換え、as:による名前付けなどの基礎的な事項は以下にまとめた。

基礎的なルーティング

RESTful

今後

Rails – コントローラー／ビュー～ページの作成

2021-03-01 / tau / コメントする

概要

プロジェクト生成直後などに、コントローラーとアクションを生成してページをつくり、確認する。

生成時

コントローラーファイルが生成される
アクションに対してビューファイルが生成される
リクエストに対するコントローラーとアクションのルーティングが定義される

実行時

ユーザー側のブラウザー／クライアントからGETなどのリクエストでページが要求される
リクエストはプロジェクトのroutes.rbファイルの内容に従ってコントローラークラスのアクションメソッドに送られる
アクションメソッドは必要な内容を実行し、ビューファイルをレンダリング
レンダリングされたページがコントローラーを介してクライアントに送られる

手順

ディレクトリーの移動

プロジェクトディレクトリーに移動する。

cd project_name

コントローラーとアクションの生成

以下のコマンドでコンローラーを作成する。アクションを指定しない時はaction_nameを省略してもよい。

rails generate controller controller_name action_name

プロジェクトディレクトリー下に以下のファイルが作成される。

app/controllers/controller_name_controller.rb
app/views/controller_name/action_name.html.erb
app/assets/stylesheets/controller_name.scss

コントローラーファイル

ファイルの位置とファイル名

app/controllers下のファイルにコントローラーのクラスが定義される。

クラスファイル名はスネークケース末尾に'_controller'がつけられる。拡張子は.rb。

controller_name_controller.rb

ファイルの内容

ファイル内容はクラス定義で、コントローラーとアクションを指定して生成した場合、以下が定義されている。

コントローラークラス
- コントローラークラスはApplicationControllerクラスを継承
- クラス名はパスカルケースで、末尾に'_Controller'がつけられる
  - ControllerNameController
アクションメソッド
- コントローラークラスのメソッドとして定義される
- アクション名はスネークケース
  - action_name

class DemoContentsController < ApplicationController
  def top_page
  end
end

class DemoContentsController < ApplicationController

def top_page

end

後からアクションを追加する場合、コントロールクラスのメソッドとして追加し、ルーティングを設定する。

ビューファイル

ファイルの位置とファイル名

app/viewsディレクトリーの下にコントローラー名と同じフォルダーが作成され、その下にアクション名と同じ名前のスネークケースでアクションメソッドが定義される。拡張子は.html.erb。

app/views/demo_contents/top_page.html.erb

ファイルの内容

コントローラー追加直後のビューファイルの内容はシンプルで、コントローラー#ビューの表示がH1要素で、その場所がp要素で書かれている。

<h1>DemoContents#top_page</h1>
<p>Find me in app/views/demo_contents/top_page.html.erb</p>

1 2	<h1>DemoContents#top_page</h1> <p>Find me in app/views/demo_contents/top_page.html.erb</p>

後からアクションを追加する場合、アクション名と同じファイル名でhtml.erbファイルを作成し、その内容にHTMLを書いていく。

スタイルシート

ファイルの位置とファイル名

コントローラーを生成すると、アプリケーション固有のスタイルシートがapp/assets/stylesheetsにつくられる。ファイル名はコントローラーと同じスネークケースで拡張子は.scss。

app/assets/stylesheets/controller_name.scss

拡張子からわかるように、スタイルシートはSCSSで書くことを想定している。

ファイルの内容

ファイルの内容はコメントのみで、ゼロからスタイルを指定するようになっている。

[vagrant@localhost demo_app]$ cat app/assets/stylesheets/demo_contents.scss
// Place all the styles related to the demo_contents controller here.
// They will automatically be included in application.css.
// You can use Sass (SCSS) here: https://sass-lang.com/

[vagrant@localhost demo_app]$ cat app/assets/stylesheets/demo_contents.scss

// Place all the styles related to the demo_contents controller here.

// They will automatically be included in application.css.

// You can use Sass (SCSS) here: https://sass-lang.com/

参照：Railsにおけるスタイルシートの設定

ルーティングファイル

ファイルの位置とファイル名

ルーティングファイルはconfigディレクトリー下のroutes.rbファイル。

config/routes.rb

ファイルの内容

コントローラーが生成されるのに合わせて、routes.rbに1行追加される。

Rails.application.routes.draw do
  get 'controller_name/action_name'
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

Rails.application.routes.draw do

get 'controller_name/action_name'

# For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html

end

この場合、ブラウザー側からは以下のURLでアクセスするとアクションメソッドで指定したページが表示される。

localhost:3000/controller_name/action_name

参照：Railsにおけるルーティング、基礎的なルーティング

確認

ここでプロジェクトディレクトリー下でRailsサーバーを立ち上げる

rails s -b 0.0.0.0

その後ホストのブラウザーで以下のURLを直に入力すると、シンプルなページが表示される。

localhost:3000/controller_name/action_name

ページの削除

コントローラーの削除は以下のコマンドで実行。

rails destroy controller controller_name

このコマンドでコントローラーファイルやビューファイルなどはきれいに削除されるが、routes.rbの記述だけは残るため別途削除する必要がある。

Rails.application.routes.draw do
  get 'controller_name/action_name' →この1行を削除
end

Rails.application.routes.draw do

get 'controller_name/action_name' →この1行を削除

end

実行例

コントローラーとアクションの生成

demo_appというプロジェクトを作成した後、demo_contentsというコントローラーとその下のtop_pageというアクションを定義する。

[vagrant@localhost demo_app]$ rails generate controller demo_contents top_page
Running via Spring preloader in process 23232
      create  app/controllers/demo_contents_controller.rb
       route  get 'demo_contents/top_page'
      invoke  erb
      create    app/views/demo_contents
      create    app/views/demo_contents/top_page.html.erb
      invoke  test_unit
      create    test/controllers/demo_contents_controller_test.rb
      invoke  helper
      create    app/helpers/demo_contents_helper.rb
      invoke    test_unit
      invoke  assets
      invoke    scss
      create      app/assets/stylesheets/demo_contents.scss

[vagrant@localhost demo_app]$ rails generate controller demo_contents top_page

Running via Spring preloader in process 23232

create app/controllers/demo_contents_controller.rb

route get 'demo_contents/top_page'

invoke erb

create app/views/demo_contents

create app/views/demo_contents/top_page.html.erb

invoke test_unit

create test/controllers/demo_contents_controller_test.rb

invoke helper

create app/helpers/demo_contents_helper.rb

invoke test_unit

invoke assets

invoke scss

create app/assets/stylesheets/demo_contents.scss

コントローラーファイル

ファイルの位置と名前

app/controllersディレクトリーの下に以下のファイルが生成される。

demo_contents_controller.rb

ファイル名はスネークケースで、コントローラー名の後ろに_controllersが付加される。拡張子は.rb。

ファイルの内容

パスカルケースでコントローラークラスの空の定義が生成される。この場合はdemo_contentsからDemoContentsControllerクラスが定義され、メソッド名はスネークケースでtop_pageとなっている。

[vagrant@localhost demo_app]$ cat app/controllers/demo_contents_controller.rb
class DemoContentsController < ApplicationController
  def top_page
  end
end

[vagrant@localhost demo_app]$ cat app/controllers/demo_contents_controller.rb

class DemoContentsController < ApplicationController

def top_page

end

ビューファイル

新たに作成されたapp/views/demo_contentsディレクトリーに、アクションに対応したビューファイルが生成されている。

[vagrant@localhost demo_app]$ cat app/views/demo_contents/top_page.html.erb
<h1>DemoContents#top_page</h1>
<p>Find me in app/views/demo_contents/top_page.html.erb</p>

[vagrant@localhost demo_app]$ cat app/views/demo_contents/top_page.html.erb

<h1>DemoContents#top_page</h1>

<p>Find me in app/views/demo_contents/top_page.html.erb</p>

この場合、ディレクトリー名がコントローラー名demo_contents、ビューファイル名がアクション名に基づいてtest_page.html.erbとなっている。

ファイルの内容はシンプルなHTML。

H1要素でコントローラークラス名とアクション名(DemoContents#top_page)を表示
p要素でビューファイルのパスを表示(app/views/demo_contents/top_page.html.erb)

スタイルシート

app/assets/stylesheets/に作成されたスタイルシート(demo_contents.scss)の内容を確認してみる。コメントのみの空の内容なのが確認できる。

[vagrant@localhost demo_app]$ cat app/assets/stylesheets/demo_contents.scss
// Place all the styles related to the demo_contents controller here.
// They will automatically be included in application.css.
// You can use Sass (SCSS) here: https://sass-lang.com/

[vagrant@localhost demo_app]$ cat app/assets/stylesheets/demo_contents.scss

// Place all the styles related to the demo_contents controller here.

// They will automatically be included in application.css.

// You can use Sass (SCSS) here: https://sass-lang.com/

ルーティングファイル

config/routes.rbを確認すると1行追加されている。

[vagrant@localhost demo_app]$ cat config/routes.rb
Rails.application.routes.draw do
  get 'demo_contents/top_page'
  # For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html
end

[vagrant@localhost demo_app]$ cat config/routes.rb

Rails.application.routes.draw do

get 'demo_contents/top_page'

# For details on the DSL available within this file, see https://guides.rubyonrails.org/routing.html

end

以下のURLでアクションで設定されたページが表示される。

localhost:3000/demo_contents/top_page

表示結果は以下のとおりシンプル。