カテゴリ: Laravel 更新日: 2026/03/31

Laravelのカラムタイプ一覧と使い分け!初心者でもわかるデータ型の基本

Laravelのカラムタイプ一覧と使い分け(string, integer, dateなど)
Laravelのカラムタイプ一覧と使い分け(string, integer, dateなど)

先生と生徒の会話形式で理解しよう

生徒

「Laravelでデータベースのテーブルを作るときに、カラムの型っていっぱいありますよね?どれを使えばいいのか分かりません…」

先生

「とても良い質問です。Laravelでは『マイグレーション』という仕組みを使ってテーブルを作りますが、その中でカラムタイプ(データ型)を指定します。これを正しく使い分けることが大切なんです。」

生徒

「カラムタイプって、数字とか文字の種類を指定するってことですか?」

先生

「そうです!例えば『名前』なら文字列(string)を使い、『年齢』なら整数(integer)を使います。それでは、Laravelでよく使うカラムタイプの一覧と、その使い分け方を詳しく見ていきましょう!」

1. Laravelのマイグレーションでカラムタイプを指定する方法

1. Laravelのマイグレーションでカラムタイプを指定する方法
1. Laravelのマイグレーションでカラムタイプを指定する方法

Laravelでデータベースのテーブルを作成・管理する仕組みを「マイグレーション」と呼びます。プログラミング未経験の方でも、PHPのコードを書くだけで直感的にデータベースの設計図が作れる非常に便利な機能です。

具体的には、マイグレーションファイル内のSchema::create()というメソッドの中で、$table->型名('カラム名')という形式で、保存したいデータの種類(データ型)を定義していきます。これにより、SQLというデータベース専用の言語を直接書かなくても、安全かつ正確にテーブルを構築できます。

例えば、会員登録システムを作る場合の基本的なサンプルコードを見てみましょう。


use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration {
    /**
     * マイグレーションの実行(テーブル作成)
     */
    public function up(): void {
        Schema::create('users', function (Blueprint $table) {
            $table->id(); // 自動で増える番号(主キー)
            $table->string('name'); // 名前を保存する「文字列」型
            $table->string('email')->unique(); // メールアドレス(重複不可)
            $table->integer('age'); // 年齢を保存する「整数」型
            $table->text('bio')->nullable(); // 自己紹介文(長い文章・空でもOK)
            $table->timestamps(); // 登録日時と更新日時を自動記録
        });
    }

    /**
     * マイグレーションの取り消し(テーブル削除)
     */
    public function down(): void {
        Schema::dropIfExists('users');
    }
};

このコードをコマンドで実行すると、データベース上には以下のような構造のテーブルが自動的に作成されます。


Field      | Type          | Null | Key | Default
-----------|---------------|------|-----|---------
id         | bigInt        | NO   | PRI | NULL
name       | varchar(255)  | NO   |     | NULL
email      | varchar(255)  | NO   | UNI | NULL
age        | int           | NO   |     | NULL
bio        | text          | YES  |     | NULL
created_at | timestamp     | YES  |     | NULL
updated_at | timestamp     | YES  |     | NULL

このように、Laravelでは「何番目のデータか(id)」「誰のデータか(name)」「どんな種類の値か(Type)」を、PHP側で一元管理できます。後から項目を増やしたい場合も、この設計図を修正して実行するだけなので、開発のミスを大幅に減らすことができます。

2. Laravelマイグレーションでよく使うカラムタイプ一覧と適切な使い分け

2. Laravelマイグレーションでよく使うカラムタイプ一覧と適切な使い分け
2. Laravelマイグレーションでよく使うカラムタイプ一覧と適切な使い分け

データベース設計において、どの「型(タイプ)」を選ぶかは非常に重要です。適切な型を選ぶことで、データの正確性が保たれ、動作スピードの向上にもつながります。ここでは、プログラミング初心者の方でもイメージしやすいよう、具体的な具体例を交えて解説します。

① string(短い文字列)

stringは、名前やメールアドレス、住所など、比較的短いテキスト(標準では最大255文字)を保存する際に最もよく使われる型です。Excelの一つのセルに短い単語を入力するイメージです。


// ユーザー名やメールアドレスなどに使用
$table->string('name');
$table->string('email');

② text(長い文章)

textは、ブログの本文やお問い合わせ内容など、stringでは収まりきらない長い文章を保存するために使います。文字数の制限を気にせず、たっぷり書き込みたい場合に最適です。


// ブログの本文や、ユーザーへの紹介文などに使用
$table->text('biography');
$table->text('blog_content');

③ integer / bigInteger(整数・数値)

integerは「整数」を扱います。年齢や商品の個数など、小数点を含まない数値に使います。特に、ID番号やアクセス数のように非常に大きな数字になる可能性がある場合は、より大きな範囲を扱えるbigIntegerを選んでおくと安心です。


// 年齢(通常の整数)
$table->integer('age');
// 閲覧数(大きな整数)
$table->bigInteger('view_count');

④ boolean(真偽値・フラグ)

booleanは、「Yes(はい)」か「No(いいえ)」の2択の状態を管理します。プログラムの世界では true(1) や false(0) として扱われます。「公開中か?」「退会済みか?」といったスイッチのような役割に便利です。


// 公開フラグ(1なら公開、0なら非公開)
$table->boolean('is_published');

⑤ date / datetime / timestamp(日付・時刻)

日付や時刻を扱う型はいくつかあります。誕生日などの「日」だけで良い場合はdate、予約時間などの「秒」まで必要な場合はdatetimetimestampを使います。Laravelではデータの作成日時(created_at)を管理するために標準でよく使われます。


// 誕生日(2026-01-01形式)
$table->date('birthday');
// 予約日時(2026-01-01 10:00:00形式)
$table->timestamp('reserved_at');

⑥ decimal(正確な小数・金額)

decimalは、消費税や商品の金額、緯度経度など、正確な計算が求められる小数点を含む数値に使います。float(浮動小数点数)という型もありますが、お金を扱うシステムでは計算がズレにくいdecimalを使うのがエンジニアの鉄則です。


// 金額:合計8桁、そのうち小数点以下2桁まで(例:999999.99)
$table->decimal('price', 8, 2);

⑦ enum(決まった選択肢)

enumは、「あらかじめ決めた選択肢の中から一つだけ選ぶ」形式です。例えば、性別(男性・女性・その他)や、注文ステータス(準備中・発送済み・完了)などの限定的なデータを扱うのに向いています。


// ステータスを3つの選択肢から選ぶ
$table->enum('status', ['draft', 'published', 'archived']);

⑧ json(構造化データ)

jsonは、複数の設定情報を一つのまとまりとして保存したい時に使います。例えば、通知設定の「メールはON、プッシュ通知はOFF」といった複数の項目を一つのカラムに配列形式で詰め込むことができます。


// ユーザー設定などをまとめて保存
$table->json('user_settings');
???? 初心者へのアドバイス:
最初は「文字なら string」「数字なら integer」「長い文なら text」という3つを覚えるだけでも、簡単なアプリの設計は十分に可能です!少しずつ慣れていきましょう。

3. カラムタイプを選ぶときのポイント

3. カラムタイプを選ぶときのポイント
3. カラムタイプを選ぶときのポイント

データ型を選ぶときは、保存したいデータの「性質」を考えることが大切です。たとえば:

  • ユーザー名やタイトル → string
  • プロフィールの本文 → text
  • 年齢や数量 → integer
  • 金額 → decimal
  • 日付や時刻 → date / datetime

データ型を正しく使い分けることで、データベースが効率よく動作し、アプリケーションも安定します。

4. まとめ:カラムタイプを理解してデータベースを正しく設計しよう

4. まとめ:カラムタイプを理解してデータベースを正しく設計しよう
4. まとめ:カラムタイプを理解してデータベースを正しく設計しよう

Laravelのマイグレーションで使うカラムタイプは、データの種類に合わせて選ぶことが重要です。最初は難しく感じるかもしれませんが、慣れてくると自然に判断できるようになります。

「文字か数値か」「日付か時間か」「選択式か」など、目的に応じて正しいタイプを使い分けるようにしましょう。

まとめ

まとめ
まとめ

ここまで、Laravelにおけるマイグレーションのカラムタイプ(データ型)について詳しく解説してきました。Webアプリケーション開発において、データベース設計は建物の基礎を作るような非常に重要な工程です。Laravelのマイグレーション機能を活用すれば、PHPコードを書くだけで直感的にテーブル構造を定義できるため、初心者の方でも比較的スムーズに取り組めるはずです。

今回ご紹介した各カラムタイプは、単にデータを保存する器を決めるだけでなく、アプリケーションの動作速度や、将来的な拡張性、さらにはデータの正確性にも直結します。例えば、一見すると同じ数字に見える「年齢」と「商品の価格」ですが、前者は「integer(整数)」で十分ですが、後者は消費税計算や割引率などを考慮して「decimal(小数を扱う型)」を選択するのが一般的です。このように、データの性質を見極める癖をつけることが、エンジニアとしてのステップアップに繋がります。

Laravelマイグレーションの具体的な活用例

実際の開発現場では、基本のカラムタイプに加えて「カラム修飾子(modifiers)」を組み合わせて使うことがよくあります。例えば、ユーザーの紹介文は空でも良い(NULLを許容する)設定にしたり、数値のデフォルト値を設定したりする場合です。

以下に、より実戦に近いマイグレーションファイルのサンプルプログラムを用意しました。これを参考に、各型の書き方とオプションの指定方法を復習してみましょう。


use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration {
    /**
     * マイグレーションの実行(テーブル作成)
     */
    public function up(): void {
        Schema::create('products', function (Blueprint $table) {
            // 自動増分のID(bigIncrements型)
            $table->id();

            // 商品名は文字列(255文字以内)
            $table->string('product_name');

            // 商品コードは一意(重複不可)にする
            $table->string('product_code')->unique();

            // 詳細説明は長い文章になるのでtext型
            $table->text('description')->nullable(); // nullableで空値を許可

            // 価格は正確な計算のためにdecimal型を使用(8桁、うち小数2桁)
            $table->decimal('price', 8, 2)->default(0);

            // 在庫数は整数型(符号なしのunsignedを使うと負の数を防げる)
            $table->unsignedInteger('stock_quantity')->default(0);

            // 公開フラグ(真偽値)
            $table->boolean('is_published')->default(false);

            // カテゴリー選択(enum型で特定の選択肢に限定)
            $table->enum('category', ['food', 'electronics', 'apparel', 'other']);

            // メタデータなどはJSON形式で保存すると柔軟性が高い
            $table->json('specifications')->nullable();

            // 作成日時と更新日時を自動管理
            $table->timestamps();

            // 論理削除用のカラム(deleted_at)を追加する場合
            $table->softDeletes();
        });
    }

    /**
     * マイグレーションのロールバック(テーブル削除)
     */
    public function down(): void {
        Schema::dropIfExists('products');
    }
};

上記のコードでは、nullable()default()といったメソッドを繋げて記述しています。これらは「チェインメソッド」と呼ばれ、カラムに詳細なルール(制約)を課すことができます。例えば、unique()を指定すると、同じ商品コードが二度と登録されないようにデータベースレベルで守ってくれます。

データベースに反映された結果を確認する

上記のマイグレーションファイルを作成した後、ターミナルで下記のコマンドを実行することで、実際にデータベースにテーブルが作成されます。


php artisan migrate

実行後、データベース管理ツールなどで構造を確認すると、Laravelが指定した型に合わせて、MySQLやPostgreSQLといった各DBエンジンに最適なSQLを発行してくれたことが分かります。


INFO  Preparing database.
Creating migrations table ................................... 16ms DONE
Running migrations.
2026_01_31_000000_create_products_table .................... 35ms DONE

このように、Laravelのカラムタイプをマスターすれば、複雑なSQL文を暗記していなくても、安全かつ効率的にデータベースを構築できます。まずはよく使う「string」「integer」「boolean」「text」「timestamps」の5つを完璧に使いこなせるようになりましょう。

また、開発が進むにつれて「カラムを追加したい」「型を変更したい」という場面も出てきます。その際も新しいマイグレーションファイルを作成して対応するのがLaravelの流儀です。履歴をコードで残せるため、チーム開発でも「誰がいつ、どの型に変えたのか」が一目瞭然になります。

先生と生徒の振り返り会話

生徒

「先生、まとめのプログラムを見てびっくりしました!ただ型を指定するだけじゃなくて、nullable()とかdefault()みたいに、色々なルールを付け加えられるんですね。」

先生

「その通りです。これを使いこなすと、変なデータがデータベースに入り込むのを防げるので、プログラム本体のコードもシンプルに保てるんですよ。例えば、価格にマイナスの値が入らないようにする工夫なども大切ですね。」

生徒

「なるほど。あと、金額にdecimalを使う理由もよく分かりました。以前、普通の小数型を使っていたら、計算結果が微妙にズレて困ったことがあったんです。あれは型の特性のせいだったんですね。」

先生

「素晴らしい気づきですね。コンピュータは小数の計算が苦手な場合があるので、お金を扱うときは精度の高いdecimalが鉄則です。他にも、フラグ管理にはboolean、選択肢が決まっているならenumといった具合に、適材適所で使い分けていきましょう。」

生徒

「はい!まずは基本の5つからしっかり覚えて、徐々に特殊な型にも挑戦してみます。マイグレーションコマンドを打つのが楽しくなってきました!」

先生

「その意気です。もしどの型を使うか迷ったら、公式ドキュメントのカラムタイプ一覧を辞書代わりに引く癖をつけるといいですよ。次は、実際に作ったテーブルからデータを取得する『Eloquent(エロクアント)』について学んでいきましょう!」

関連記事:
カテゴリの一覧へ
新着記事
New1
Symfony
Symfonyのルーティング構成の基本を完全解説!初心者向けにYAML・PHP・アノテーション方式をやさしく紹介
New2
Laravel
Laravelのルートグループの使い方!初心者でもわかるprefixやミドルウェアの設定方法
New3
PHP
PHPのswitch文の使い方!多くの条件分岐をスッキリ書く方法と注意点
New4
Symfony
Symfony学習に役立つおすすめドキュメント・教材・リソース一覧【初心者向け】
人気記事
No.1
Java&Spring記事人気No1
PHP
PHPで文字列を結合する方法!ドット演算子と代入演算子の使い方を徹底解説
No.2
Java&Spring記事人気No2
PHP
PHPのif文の使い方を完全ガイド!初心者でもわかる条件分岐の基本
No.3
Java&Spring記事人気No3
Laravel
Laravelのresponse()関数の使い方を完全ガイド!初心者でもわかるレスポンス制御とHTTPレスポンスの基本
No.4
Java&Spring記事人気No4
Symfony
Symfonyで翻訳(i18n)機能を使う方法を解説!初心者にもわかる国際化対応の基本
No.5
Java&Spring記事人気No5
Laravel
LaravelのAPIルーティングを設定する方法!初心者でもわかるapi.phpの使い方
No.6
Java&Spring記事人気No6
PHP
PHPのswitch文の使い方!多くの条件分岐をスッキリ書く方法と注意点
No.7
Java&Spring記事人気No7
Laravel
Laravelのインストール方法まとめ!ComposerとLaravel Installerの使い方
No.8
Java&Spring記事人気No8
Laravel
LaravelでRemember Me(ログイン状態保持)機能を実装する方法を完全解説!初心者でも安心の認証入門