Laravelのバージョン確認方法｜artisan・Composer・ファイルで確認

Laravelのバージョンを確認する方法を、artisan・Composer・ファイルの3系統に整理して解説します。「今動かしているLaravel本体が何バージョンか」を最短で知りたい方は、まず php artisan --version を実行してください。

$ php artisan --version
Laravel Framework 11.9.2

この記事では、上記の最短手順に加えて、artisanが使えない環境での確認方法、Laravel本体・Laravel Installer・PHPのバージョンの違い、ローカルと本番でバージョンが食い違う場合の確認手順まで、実務で迷いやすいポイントをまとめて解説します。

Laravelを学び始めた方から、システム制作の現場で効率的なバージョン管理を求める方まで役立つ内容です。

最初に結論

忙しい人に向けて、確認方法を artisan・Composer・ファイル の3系統でまとめました。どれか1つで正確なバージョン番号が分かります。

# ── 1. artisan で確認（最も確実。実際に動くLaravel本体を表示）
 % php artisan --version
Laravel Framework 11.9.2

 % php artisan about        # PHP・環境・キャッシュ状況もまとめて表示


# ── 2. Composer で確認（インストール済みパッケージの実バージョン）
 % composer show laravel/framework | grep versions
versions : * v11.9.2


# ── 3. ファイルで確認（artisanが動かない環境でも読める）
 % grep 'laravel/framework' composer.json     # 許容範囲（例: ^11.0）
        "laravel/framework": "^11.0",
 % grep -A1 'laravel/framework' composer.lock  # 実際に固定されたバージョン


# ── （番外）Docker/Sail 環境
 % ./vendor/bin/sail artisan --version


# ── （番外）ソースコードから出力
dd(app()->version());   // Controller/Model
{{ app()->version() }}  // Blade

なお laravel --version（php を付けない）はLaravel Installerのバージョンで、プロジェクトのLaravel本体とは別物です。この違いは後半で詳しく説明します。次からは各方法を順に見ていきます。

Laravelバージョンの基本

Laravelとは

LaravelはPHPで書かれた人気のあるオープンソースのWebアプリケーションフレームワークです。

Taylor Otwellによって2011年に開発され、MVC（Model-View-Controller）アーキテクチャパターンに基づいて設計されています。その使いやすさ、拡張性、そして豊富な機能が、世界中の開発者に広く受け入れられる理由です。

Laravelは、簡単にデータベースの操作ができ、ルーティング、セッション、キャッシング、そして認証といった一般的なタスクを簡単に処理できるようにするための豊富なツールとリソースを提供します。

公式のドキュメントページはこちらになります。

https://laravel.com/docs/master

なぜバージョン管理が重要か

ソフトウェアの世界において、バージョン管理は極めて重要です。

適切なバージョンのソフトウェアが機能の互換性、セキュリティ、そしてシステムの安定性を保証するために必要だからです。

特にLaravelのようなフレームワークでは、新しいバージョンが定期的にリリースされ、それぞれが新機能や改善されたセキュリティ修正を提供しています。

バージョン管理が適切に行われていないと、予期せぬバグ、セキュリティの脆弱性、または非互換性が発生する可能性があります。これらはプロジェクトの遅延や、最悪の場合にはアプリケーションが動かない可能性があります。Laravelプロジェクトにおいては、使用しているバージョンを常に把握し、必要に応じて適切なアップデート計画を立てることが重要です。

また、Laravelのバージョン管理を適切に行うことで、開発者は新しい機能や改善を取り入れることができ、最終的にはより魅力的で、高機能なアプリケーションを構築することが可能になります。

このように、Laravelをはじめとするフレームワークの適切なバージョン管理は、安全で効果的なソフトウェア開発の礎を築くために不可欠です。それは単に新しい技術を追いかけるだけでなく、プロジェクトを未来へと向けて安定的に推進するための戦略的な判断と言えるでしょう。

Laravelのバージョンを確認する方法

Laravelフレームワークを使用して開発を行う際には、プロジェクトで利用しているLaravelのバージョンを正確に知ることが重要です。

これは、特定の機能の利用可否や、セキュリティパッチの適用状況を把握するために必要です。

以下に、Laravelのバージョンを確認するための主な方法を詳細に説明します。

1. コマンドラインを使用したバージョン確認

Laravelプロジェクトのルートディレクトリでコマンドラインまたはターミナルを開き、以下のコマンドを実行することで、現在のLaravelのバージョンを簡単に確認できます。

$ php artisan --version
Laravel Framework 11.9.2

このコマンドは、Laravelの現在のバージョン番号を返します。実際に読み込まれているLaravel本体を表示するため、この方法が一番確実です。

Laravel 9以降であれば、php artisan about を使うとバージョンだけでなく、PHPのバージョン・環境（local / production）・キャッシュ状況などをまとめて確認できます。トラブルシューティングの起点として便利です。

$ php artisan about

  Environment .......................................................
  Application Name ......................................... Laravel
  Laravel Version .......................................... 11.9.2
  PHP Version .............................................. 8.3.6
  Composer Version ......................................... 2.7.7
  Environment .............................................. local
  Debug Mode ............................................... ENABLED
  ...

Laravel Version の行がLaravel本体、PHP Version の行がPHPのバージョンです。両者は別物なので、この画面で同時に確認できると混乱しにくくなります。

2. ファイルを調べる方法

Laravelは composer を使用することを前提としているため、プロジェクトの composer.json ファイルにも記述されています。

このファイルを開き、require セクションを確認することで、どのバージョンのLaravelがインストールされているかを見ることができます。例えば、以下のような記述が見られる場合があります。

"require": {
    "laravel/framework": "^7.0"
}

ただし composer.json が示すのは ^10.0 のような許容範囲であり、実際にインストールされている正確なバージョンではありません。「今入っている厳密なバージョン」を知りたいときは composer.lock を見ます。

# composer.lock には実際に固定されたバージョンが記録されている
$ grep -A1 '"laravel/framework"' composer.lock
            "name": "laravel/framework",
            "version": "v11.9.2",

ファイル	分かること	使いどころ
`composer.json`	許容範囲（例 `^11.0`）	どのメジャー系を想定しているか
`composer.lock`	固定された正確なバージョン	実際にインストール済みの版

チーム開発では、この composer.lock をGitで共有することで、全員が同じLaravelバージョンでインストールできるようになっています。「ローカルと本番でバージョンが違う」という事故を防ぐ要になるファイルです。

3. composerを使用した確認方法

composerを利用してインストールされたパッケージのリストから直接バージョンを確認することもできます。

ターミナルで以下のコマンドを実行します。

$ composer show laravel/framework | grep versions
versions : * v10.35.0

このコマンドは、インストールされているLaravelフレームワークの詳細な情報を表示し、その中にバージョン番号が含まれます。

4. Docker環境での確認方法

Dockerを使用してLaravelを実行している場合、コンテナ内で上記のいずれかのコマンドを実行する必要があります。

通常、以下のコマンドを使用してコンテナにアクセスし、その後にLaravelのバージョンを確認するコマンドを実行します。

docker exec -it <コンテナ名> bash
php artisan --version

# or

./vendor/bin/sail artisan --version

コンテナ内でシェルにアクセスした後、php artisan --version または composer show laravel/framework のコマンドを実行してバージョン情報を取得します。

sail を使用して Docker環境を設定している場合にはsailコマンドでの確認も可能です。

5. PHPファイル編集での確認

番外編としてLaravelプロジェクトのソースコードを変更することでバージョン番号を出力する方法があります。

Controllerやviewファイルなどで以下の記述をすれば確認できます

// ControllerやModelファイル
dd(app()->version());

// blade.php 等のviewファイル
{{ app()->version() }}

これらの方法を通じて、Laravelプロジェクトのバージョンを正確に把握し、適切な開発やメンテナンスを行いましょう。

Laravel本体・Laravel Installer・PHPのバージョンを混同しない

バージョン確認でつまずく最大の原因が、3つの別々のバージョンを取り違えることです。ここを整理しておくと、後で「表示された番号が思っていたものと違う」という混乱を防げます。

対象	意味	確認コマンド
Laravel本体（framework）	プロジェクトが動いているLaravelの版	`php artisan --version`
Laravel Installer	新規プロジェクト作成用のツール	`laravel --version`
PHP	Laravelを動かす土台の言語	`php -v`

特に間違えやすいのが php artisan --version と laravel --version です。後者（php を付けない）は Laravel Installer のバージョンを表示するもので、いま開いているプロジェクトのLaravel本体とはまったくの別物です。

# プロジェクトのLaravel本体のバージョン
$ php artisan --version
Laravel Framework 11.9.2

# Laravel Installer（新規作成ツール）のバージョン ← 別物！
$ laravel --version
Laravel Installer 5.8.0

laravel new プロジェクト名 でプロジェクトを作るときに使うのがInstallerです。既存プロジェクトのバージョンを知りたいのに laravel --version を見てしまうと、無関係な番号を確認してしまうので注意してください。迷ったら php を付けた php artisan --version を実行するのが確実です。

artisanが実行できない場合の確認方法

php artisan --version がエラーになる、あるいはそもそも実行できない環境もあります。原因別に、artisanに頼らない確認方法を整理します。

「command not found」「could not open input file: artisan」：プロジェクトのルート（artisan ファイルがある階層）にいない可能性があります。ls artisan で存在を確認し、正しいディレクトリへ移動してください。
PHPのエラーで止まる（依存が壊れている・PHPバージョン不一致）：artisanはアプリを起動してから動くため、composer install 前や環境不整合では失敗します。この場合は artisan を介さず composer.lock を直接読みます。
SSHが使えない共有サーバーなど、そもそもコマンドを叩けない：ファイルだけで判断します。

# artisan を使わずに正確なバージョンを読む
$ grep -A1 '"laravel/framework"' composer.lock
            "name": "laravel/framework",
            "version": "v11.9.2",

コマンドが一切使えない場合でも、FTPやファイルマネージャーで composer.lock を開き、laravel/framework の version を探せば正確なバージョンが分かります。ソースを1行も動かさずに確認できるため、本番サーバーでも安全です。

ローカルと本番でバージョンが異なる場合の確認手順

「手元では動くのに本番で挙動が違う」ときは、ローカルと本番でLaravelやPHPのバージョンがずれていることがあります。次の手順で両方を突き合わせて確認します。

ローカルで確認：php artisan about でLaravel本体とPHPのバージョンを控えます。
本番で確認：本番サーバーにSSH接続し、プロジェクトのルートで同じ php artisan about（または php artisan --version と php -v）を実行します。
差分を比べる：Laravel本体・PHPそれぞれで番号が一致しているかを確認します。

ここで注意したいのは、Webサーバー（本番の実行環境）とCLIでPHPバージョンが異なるケースです。php -v はCLIのPHPを表示しますが、実際にサイトを動かしているのはWebサーバー側のPHPです。ブラウザ経由の値を確認したいときは phpinfo() を使います（詳しい手順は後述の「PHPバージョンの確認方法」を参照）。

Laravel本体のバージョンがローカルと本番でずれている場合は、composer.lock がGitで共有・デプロイされているか、本番で composer install（composer update ではなく）が実行されているかを確認してください。バージョンを揃える具体的な手順は、記事後半の「最新バージョンのLaravelにアップデートする理由と手順」でも解説しています。

セキュリティチェック方法

バージョン情報を確認する事は、使用できるツールの確認やセキュリティチェックのためにバージョン情報が必要になるかと思われます。

バージョン番号を確認する方法以外にも、Laravelプロジェクトの脆弱性を確認する方法が用意されています。ここではセキュリティチェックの方法についても取り上げます。

この章では、セキュリティチェックの重要性と、composer audit コマンドを使った依存関係の脆弱性チェック方法について解説します。

セキュリティチェックの重要性

Laravelプロジェクトのセキュリティチェックを行うことは、以下の理由から非常に重要です

脆弱性の早期発見
- 定期的なセキュリティチェックにより、脆弱性を早期に発見し、悪意のある攻撃者に悪用される前に修正することが可能になります。
データ保護
- ユーザーのデータ保護は法的義務であり、信頼の維持にも直結します。セキュリティの弱点を放置することは、データ漏洩のリスクを高め、企業の評判に損害を与えかねません。
コンプライアンスの遵守
- 多くの業界では、特定のセキュリティ基準への準拠が求められます。セキュリティチェックを通じて、これらの基準に適合していることを保証します。

これから紹介するコマンドを活用してセキュリティチェックを簡単に行っていきましょう。

`composer audit` で確認する方法

composer audit コマンドは、プロジェクトの依存関係に公知の脆弱性がないかをチェックするためのツールです。

composer 2.4 に追加された新しい機能であり、このコマンドを使用することでLaravelプロジェクトにインストールされているパッケージの安全性を簡単に確認できます。

コマンドのインストールと実行

まず、composer audit プラグインをインストールする必要があります。

composer 2.4 以上でなければアップデートを行なってください。

 % composer --version
Composer version 2.7.1 2024-02-09 15:26:28

 % composer self-update

アップデート後、以下のコマンドをプロジェクトのルートディレクトリで実行して、セキュリティチェックを行います

 % composer audit
Found 1 security vulnerability advisory affecting 1 package:
+-------------------+----------------------------------------------------------------------------------+
| Package           | livewire/livewire                                                                |
| Severity          | medium                                                                           |
| CVE               | CVE-2024-21504                                                                   |
| Title             | Cross-site Scripting in livewire/livewire                                        |
| URL               | https://github.com/advisories/GHSA-389c-cf87-qmwj                                |
| Affected versions | >=3.3.5,<3.4.9                                                                   |
| Reported at       | 2024-03-19T06:30:53+00:00                                                        |
+-------------------+----------------------------------------------------------------------------------+


# セキュリティチェックに問題がなければ以下の表示になります
 % composer audit     
No security vulnerability advisories found.

composer audit コマンドを実行すると、各依存関係についてのセキュリティレポートが表示されます。

もし脆弱性が検出された場合、どのパッケージが影響を受けているか、どのバージョンにアップデートすべきかが示されます。この情報に基づき、早急に対応することが推奨されます。

composer audit のようなツールを利用することで、セキュリティリスクを効果的に管理し、プロジェクトとユーザーの安全を守ることができます。定期的なセキュリティチェックとアップデートは、現代のウェブ開発において不可欠です。

Laravelのバージョン一覧と各バージョンの特徴

Laravelは多くのアップデートを経て成長を遂げてきました。

各バージョンは、新しい機能の追加、パフォーマンスの向上、そしてセキュリティの強化が行われています。ここでは、Laravelの歴史的なバージョン一覧と、それぞれのバージョンで導入された主な変更点や機能について詳しく見ていきます。

Laravelの歴史的なバージョン一覧

Laravelは以下のようなバージョンアップを重ねてきました：

Laravel 1（2011年リリース）
- 初版リリース。ルーティング、Eloquent ORM、セッション管理などの基本的な機能を提供。
Laravel 2（2011年後半）
- コントローラーのサポートを追加し、より堅牢なMVCアーキテクチャを導入。
Laravel 3（2012年初頭）
- マイグレーションサポート、セッション管理の強化、ユニットテストサポートなどが追加。
Laravel 4（2013年）
- 「Illuminate」パッケージが導入され、コードベースが完全にリファクタリングされた。これにより、より柔軟で再利用可能なコードが可能に。
Laravel 5（2015年）
- ルートキャッシング、環境構築がより簡単に、Elixirによるアセット管理が導入。
Laravel 6（2019年）
- LTS（長期サポート）バージョン。改善された認証機能、Lazy Collectionsの導入。
Laravel 7（2020年）
- Bladeコンポーネントタグ、HTTPクライアント、カスタムEloquentキャストが導入。
Laravel 8（2020年後半）
- Laravel Jetstreamが導入され、モデルファクトリの改善、ジョブバッチ処理などが加わった。
Laravel 9（2022年）
- Symfony 5.3への依存アップグレード、匿名スタブの導入など。

各バージョンの主な変更点と機能

各バージョンは以下のような特徴を持っています：

Laravel 4は、フレームワークのアーキテクチャを根本から見直したことで、拡張性とモジュラリティが大幅に向上しました。
Laravel 5は、アプリケーション開発のための環境構築を簡素化し、開発者がより迅速に作業を進められるようにするための多くの機能を追加しました。
Laravel 6のLTSリリースは、企業が長期間安心して使用できるサポートとアップデートを提供しました。
Laravel 7では、新しいBladeコンポーネントタグとHTTPクライアントが導入され、フロントエンドとの統合がさらに進みました。
Laravel 8では、新しい機能の追加だけでなく、既存のシステムの改善にも焦点が当てられ、アプリケーションのスケーラビリティとパフォーマンスが向上しました。
Laravel 9では、フレームワークとしての成熟度を示すため、依存関係のアップグレードやコア機能の改善が継続的に行われました。

これらのバージョンごとの概要と特徴を理解することで、Laravelを効果的に活用し、より高品質なWebアプリケーションを開発するための選択を行うことができます。

特定PHPバージョンに対応したLaravelを確認

LaravelはPHPベースのフレームワークであり、その性能と機能は使用するPHPのバージョンに大きく依存します。

ここでは、各Laravelバージョンが要求するPHPのバージョンと、PHPのバージョンを確認する方法について説明します。

各Laravelバージョンに必要なPHPバージョン

Laravelの各リリースは特定のPHPバージョンと互換性があります。

以下は、代表的なLaravelバージョンとそれに必要なPHPバージョンの一覧です

バージョン	リリース時期	サポート	必要PHPバージョン
1	2011年6月
2	2011年11月
3	2012年2月
4.0	2013年5月		5.3以上
4.1	2013年12月		5.3以上
4.2	2014年6月		5.4以上
5.0	2015年2月		5.4以上
5.1	2015年9月	LTS	5.5.9以上
5.2	2015年12月		5.5.9以上
5.3	2016年8月		5.6.4以上
5.4	2017年1月		5.6.4以上
5.5	2017年8月	LTS	7.0以上
5.6	2018年2月		7.1.3以上
5.7	2018年9月		7.1.3以上
5.8	2019年2月		7.1.3以上
6	2019年9月	LTS	7.2以上
7	2020年3月		7.2.5以上
8	2020年9月		7.3以上
9	2022年2月		8以上
10	2023年2月		8.1以上
11	2024年3月		8.2以上

引用：https://ja.wikipedia.org/wiki/Laravel

この互換性は、新しいバージョンのPHPが提供する性能向上やセキュリティ機能を活用するために重要です。

Laravelの公式ドキュメントからサポートポリシーの記述があるため、PHPバージョンとの互換性を確認することができます。

https://laravel.com/docs/11.x/releases#support-policy

執筆当時(2024年5月3日) の最新版 Laravel v11はPHP8.2以降が必要で、セキュリティサポートは2026年3月12日までを予定しています。

他にも既存のLaravelプロジェクトが手元にある場合には composer.json を見ることで必要なPHPバージョンを確認することもできます。

"require": {
    "php": "^7.3|^8.0",
    "laravel/framework": "^8.75"
},

この例では、Laravel 8.x系が設定されており、PHPバージョン7.3以上または8.0以上に対応していることが分かります。

また、PHP自体のサポート期間も考慮する必要があり、非推奨のPHPバージョンを使用している場合はアップグレードが推奨されます。

PHPバージョンの確認方法

PHPのバージョンを確認するにはいくつかの方法があります。

最も一般的な方法はコマンドラインツールを使用する方法です。以下はPHPバージョンを確認するためのコマンドラインコマンドです

php -v

このコマンドを実行すると、現在システムにインストールされているPHPのバージョンが表示されます。この情報は、Laravelやその他のPHPベースのアプリケーションを適切に設定するために不可欠です。

また、Webサーバーを通じてPHPバージョンを確認する方法もあります。

通常、phpinfo() 関数を含むPHPファイルを作成し、ブラウザからそのファイルにアクセスすることで、PHPの詳細な情報を得ることができます。この方法は、CLI環境とWebサーバー環境で異なるPHPバージョンが使われている場合に特に有効です。

<?php
phpinfo();

このファイルをWebサーバーにアップロードし、ブラウザからアクセスすることで、インストールされているPHPの詳細な情報を確認することができます。

これにより、PHPの構成設定やモジュール情報も確認できるため、システムの設定やトラブルシューティングに役立ちます。

適切なバージョンのPHPを使用することで、Laravelの全機能を最大限に活用し、効率的で安全なアプリケーション開発を行うことが可能になります。

Laravel 11の新機能とリリース情報

現在(2024年4月28日)の最新版であるLaravel 11は、さらなる機能強化と最適化が図られたバージョンで、Laravelフレームワークの進化を示す重要なリリースとなっています。

ここではLaravel 11の主な新機能とリリース情報について詳しく解説します。

Laravel 11の主な新機能

Laravel 11では、アプリケーション構造の合理化、秒単位のレート制限、ヘルスルーティング、エンクリプションキーの滑らかな回転、キューテストの改善、Reverbメールトランスポートの再送、新しいArtisanコマンドなどが導入されました。

また、WebSocketサーバとしてのReverbも新たに導入され、リアルタイム機能が強化されています。

Laravel 11のリリース日と初期反応

Laravel 11は2024年3月12日にリリースされました。

このバージョンは、よりスリムで現代的な開発体験を提供することを目的としており、開発者からの初期反応は非常に肯定的です。特にアプリケーション構造の合理化と新しいリアルタイム機能の導入が評価されています。

詳細はLaravelの公式リリースノートをご覧ください。

Laravel 11のリリースは、Laravelフレームワークが持続的に成長し続けていることを示しており、新旧のユーザーに最新の機能を提供することで、その人気をさらに確固たるものにしています。

このアップデートは、ウェブ開発の最前線で活躍するための新たな道具を開発者に提供し、今後のプロジェクトにおいて大きな影響を与えることが期待されています。

今後のLaravel開発の展望

LaravelはPHPフレームワークの中でも特に革新的であり続けています。開発の進行に伴い、次のような方向性が期待されます

パフォーマンスのさらなる向上
- Laravelコミュニティは常にフレームワークの最適化を求めています。将来的には、より高速でスケーラブルなアプリケーションを容易に開発できるようになることでしょう。
AIとの統合
- 人工知能との統合により、Laravelはよりスマートなアプリケーションの開発をサポートする可能性があります。これにより、ユーザーの行動を予測するアルゴリズムや、自動化されたデータ処理が簡単に実装できるようになるかもしれません。
エコシステムの拡張
- Laravelのエコシステムは、さらに多くのパッケージやツールが追加され、開発者がより多様な機能を簡単に実装できるようになることが期待されます。

今後もLaravelはそのユーザーフレンドリーな設計と強力なコミュニティによって、Web開発の主要なフレームワークとしての地位を保ち続けるでしょう。

これらの展望が現実のものとなるにつれて、Laravelは世界中の開発者にとってさらに価値あるツールとなるはずです。

バージョン管理のベストプラクティス

Laravelのバージョン管理は、プロジェクトの成功にとって非常に重要です。

適切なバージョン管理は、アプリケーションが最新の機能、セキュリティアップデート、そしてバグ修正を享受できるようにするために不可欠です。

以下に、バージョン管理のベストプラクティスをいくつか挙げます

常に最新の情報を保持
- LaravelとPHPのリリースノートを定期的にチェックし、新しいバージョンがリリースされた際にはその内容を理解することが重要です。
適切なアップグレード計画の立案
- 新しいバージョンへのアップグレードは計画的に行うべきです。アップグレード前には、バックアップの取得、必要な依存関係の確認、そしてテスト環境での検証が必要です。
セキュリティパッチの迅速な適用
- セキュリティに関するアップデートは、リリースされ次第すぐに適用することが推奨されます。これにより、脆弱性を悪用されるリスクを最小限に抑えることができます。

Laravel バージョン確認、終わりに

以上、Laravel バージョン確認方法でした。

バージョンの確認が必要な時は

初めて学ぶので実行の確認をしたい
追加開発する前に情報をまとめたい
セキュリティチェックをしたい

のどれかになるかと思います。

追加開発やセキュリティチェックの場合にはサポート期間内のバージョンかを確認することもオススメします。

https://laravel.com/docs/11.x/releases#support-policy

https://laravelversions.com/ja

サポート終了したと言うことは新たに発見された抜け道が放置されている状態で、データ漏洩の危険性があります。

あわせて読みたい関連記事

バージョンの確認ができたら、次のステップとして以下の記事も参考にしてください。

Laravel 8 -> 9へバージョンアップした経験をまとめました：サポート切れのバージョンを使っていた場合のアップデート手順を、実際の経験をもとに解説しています。
レンタルサーバーにLaravelをデプロイするDeployerの使い方：ローカルと本番でバージョンを揃えてデプロイする際の参考になります。
Laravel入門：初心者におすすめの学習書と取り組み方：これからLaravelを学ぶ方向けに、学習の進め方をまとめています。

（最終更新日：2026年7月19日）

以上、今回もお仕事お疲れ様でした。

Comments