Composerによるインストール

Composerを使用して、システムにCodeIgniter4をインストールするには、いくつかの方法があります。

重要

CodeIgniter4には、Composer 2.0.14以降が必要です。

注記

Composerに慣れていない場合は、最初に基本的な使い方を読むことをお勧めします。

最初の方法は、CodeIgniter4を使用してスケルトン プロジェクトを作成し、それを新しいWebアプリケーションのベースとして使用する方法です。2番目の方法は、既存のWebアプリケーションにCodeIgniter4を追加する方法です。

注記

Gitリポジトリを使用してコードを保存したり、他の人と共同作業したりする場合、通常、**vendor**フォルダーは「git ignored」になります。このような場合は、リポジトリを新しいシステムにクローンするときに、composer updateを実行する必要があります。

アプリケーションスターター

CodeIgniter 4アプリケーションスターターリポジトリには、フレームワークの最新リリースバージョンに対するcomposer依存関係を持つスケルトンアプリケーションが含まれています。

このインストール方法は、新しいCodeIgniter4ベースのプロジェクトを開始したい開発者に適しています。

インストール

プロジェクトルートの上にあるフォルダーで

composer create-project codeigniter4/appstarter project-root

上記のコマンドは、**project-root**フォルダーを作成します。

「project-root」引数を省略すると、コマンドは「appstarter」フォルダーを作成します。これは必要に応じて名前を変更できます。

注記

v4.4.0より前では、CodeIgniterのオートローダーは、特定のオペレーティングシステムのファイル名で不正な特殊文字を許可していませんでした。使用できる記号は、/、_、.、:、\、およびスペースです。そのため、(、)などの特殊文字を含むフォルダーにCodeIgniterをインストールした場合、CodeIgniterは機能しませんでした。 v4.4.0以降、この制限は削除されました。

重要

本番サーバーにデプロイするときは、次のコマンドを実行することを忘れないでください

composer install --no-dev

上記のコマンドは、本番環境では不要な開発専用のComposerパッケージのみを削除します。これにより、vendorフォルダーのサイズが大幅に削減されます。

初期設定

インストール後、いくつかの初期設定が必要です。詳細は、初期設定を参照してください。

アップグレード

新しいリリースが公開されるたびに、プロジェクトルートのコマンドラインから

composer update

アップグレード手順を読み、重大な変更と機能強化を確認してください。

メリット

簡単なインストール。更新が容易。

デメリット

更新後、**プロジェクトスペース**（root、app、public、writable）のファイル変更を確認してマージする必要があります。

注記

プロジェクトスペースへの変更のマージを支援するサードパーティのCodeIgniterモジュールがいくつかあります：Packagistで探す。

構造

セットアップ後のプロジェクト内のフォルダー

  • app、public、tests、writable

  • vendor/codeigniter4/framework/system

最新の開発版

App Starterリポジトリには、Composerのソースを現在の安定版リリースとフレームワークの最新の開発ブランチの間で切り替えるためのbuildsスクリプトが付属しています。このスクリプトは、不安定になる可能性のある最新の未リリースの変更に対応しても構わない開発者向けです。

開発ユーザーガイドはオンラインでアクセスできます。これはリリースされたユーザーガイドとは異なり、明示的に開発ブランチに関連していることに注意してください。

最新の開発版の更新

プロジェクトルートで

php builds development

上記のコマンドは、**composer.json**を更新して、作業リポジトリのdevelopブランチを指すようにし、設定ファイルとXMLファイルの対応するパスを更新します。

buildsコマンドを使用した後、必ずcomposer updateを実行して、vendorフォルダーを最新のターゲットビルドと同期させてください。次に、以前のバージョンからのアップグレードを確認し、必要に応じてプロジェクトファイルを更新してください。

次のマイナーバージョン

buildsコマンドを使用した後、次のマイナーバージョンブランチを使用する場合は、**composer.json**を手動で編集します。

4.4ブランチを試す場合は、バージョンを4.4.x-devに変更します

"require": {
    "php": "^7.4 || ^8.0",
    "codeigniter4/codeigniter4": "4.4.x-dev"
},

composer updateを実行して、vendorフォルダーを最新のターゲットビルドと同期させます。次に、アップグレードガイド（**user_guide_src/source/installation/upgrade_{version}.rst**）を確認し、必要に応じてプロジェクトファイルを更新してください。

安定版リリースに戻す

変更を元に戻すには、次を実行します

php builds release

既存のプロジェクトへのCodeIgniter4の追加

「手動インストール」で説明したのと同じCodeIgniter 4フレームワークリポジトリを、Composerを使用して既存のプロジェクトに追加することもできます。

インストール

appフォルダー内にアプリケーションを開発し、publicフォルダーをドキュメントルートにします。

プロジェクトルートで

composer require codeigniter4/framework

重要

本番サーバーにデプロイするときは、次のコマンドを実行することを忘れないでください

composer install --no-dev

The above command will remove the Composer packages only for development
that are not needed in the production environment. This will greatly reduce
the vendor folder size.

セットアップ

  1. **vendor/codeigniter4/framework**から**app**、**public**、**tests**、**writable**フォルダーをプロジェクトルートにコピーします

  2. **vendor/codeigniter4/framework**から**env**、**phpunit.xml.dist**、**spark**ファイルをプロジェクトルートにコピーします

  3. **app/Config/Paths.php**の$systemDirectoryプロパティを調整して、ベンダーのものを参照する必要があります。例：__DIR__ . '/../../vendor/codeigniter4/framework/system'。

初期設定

いくつかの初期設定が必要です。詳細は、初期設定を参照してください。

アップグレード

新しいリリースが公開されるたびに、プロジェクトルートのコマンドラインから

composer update

アップグレード手順を読み、重大な変更と機能強化を確認してください。

メリット

比較的簡単なインストール。更新が容易。

デメリット

更新後も、**プロジェクトスペース**（ルート、app、public、writable）内のファイルの変更を確認する必要があります。

注記

プロジェクトスペースへの変更のマージを支援するサードパーティのCodeIgniterモジュールがいくつかあります：Packagistで探す。

構造

セットアップ後のプロジェクト内のフォルダー

  • app、public、tests、writable

  • vendor/codeigniter4/framework/system

翻訳のインストール

システムメッセージの翻訳を活用したい場合は、同様の方法でプロジェクトに追加できます。

プロジェクトのルートディレクトリ内で、コマンドラインから以下を実行します。

composer require codeigniter4/translations

composer update を実行するたびに、これらはフレームワークと共に更新されます。