いずれかを選択してください: コマンドラインからインストール | 手動でインストール

コマンドラインからインストール

この方法は現在 *nix systems (Linux, OS X, Unix など) でのみ動作します。

我々のクイックインストーラは Oil パッケージ用に書き下ろされたインターフェースです。これを使用すると1つのコマンドで新しいプロジェクトを生成することができます。oil コマンドで 'php' を使用する必要もありません。

クイックインストーラをインストールするためには、シェルを開き次のコマンドを実行するだけです:

$ curl get.fuelphp.com/oil | sh

この場合、スクリプトを /usr/bin にインストールするためパスワードを尋ねてくるでしょう。

これであなたのプロジェクトでは 'php oil' の代わりに 'oil' だけを使用することができます。

バージョン 1.6 以前の oil スクリプトをインストール済みの場合は、composer を実行させるために再度、インストールし直す必要があります!

新しいプロジェクトを作成するには単に以下を実行します:

$ oil create <project_name>

これで、カレントディレクトリにあなたが指定したプロジェクト名のフォルダが作成されます。そしてリポジトリとすべてのサブモジュールをそのフォルダに複製します。

Note: これは、必要なディレクトリを書き込み可能にするための $ oil refine install も実行します。 そして、Composer により定義された依存ライブラリを取得する $ php composer.phar update も実行します。

手動でインストール

この方法は、あなたの Web サーバに Fuel フレームワークのデフォルトインストール構成を生成します。

GitHub からクローンする

$ cd /where/ever/your/webserver/root/is
$ git clone --recursive git://github.com/fuel/fuel.git

これは、あなたの Web サーバのルートに、FuelPHP のすべての Core パッケージを含む fuel フォルダを作成します。

Zip ファイルをダウンロードする

  1. Fuel フレームワークをダウンロードする
  2. ダウンロードしたファイルを解凍し、展開する
  3. ファイルをサーバへ移動する
    • ソース内の public ディレクトリは Web サーバの公開用ディレクトリ、例えば、 public_html, public, htdocs など)になります。 その内容をそこへ移動するか Fuel を使用したい webroot のサブディレクトリへ移動します。
    • fuel ディレクトリを公開ディレクトリの外に置くことをセキュリティの観点から推奨します。
    • index.php 内のパスを編集し、あなたの app, core, packages ディレクトリに合わせます。
    /
      fuel/
        app/
        core/
        packages/
      public/
        .htaccess
        assets/
        index.php
      oil
    

インストールの後は、フレームワークがアクセスする必要のあるフォルダのパーミッションが正しいことを確認してください。デフォルトのフォルダを書き込み可能にする oil タスクが用意されています:

$ php oil refine install
	Made writable: APPPATH/cache
	Made writable: APPPATH/logs
	Made writable: APPPATH/tmp
	Made writable: APPPATH/config

Composer

バージョン 1.6 から、FuelPHP は Composer パッケージマネージャを使い、 Packagist、GitHub、または、独自に定義された場所から、 依存ライブラリを動的に取得します。 Composer は、FuelPHP をインストールしたルートにある composer.json ファイルによりコントロールされます。 便利なように、FuelPHP に composer.phar ライブラリを含めていますので、composer を直接実行することができます:

$ php composer.phar self-update
php composer.phar update

重要なフレームワークのコンポーネントが composer 経由でロードされるため、このステップを実行しないと、FuelPHP は起動しません!

設定

メインの設定は app/config/config.php にあります。好きに編集してください。

ドキュメントルート内にインストールする

ポイント 3 で説明したように、セキュリティの観点から Web サーバのドキュメントルート内に Fuel をインストール しない ことを強く推奨します。

しかしながらそうしたいケースもあります。例えば、Apache の大量の動的なバーチャルホストモジュールのある (ローカルの) 開発環境は、 Web サーバを再起動せずに新しい開発環境を素早く構築するために使用されます。

これが必要な場合、ルートと決めたフォルダに FuelPHP をインストールします。その後、publc フォルダに移動し、 すべてのファイルを 1つ上の階層に移動し、public フォルダを削除します。public フォルダの唯一の目的は、Web サーバのドキュメントルートのためのアンカーポイントを提供することです。 FuelPHP をドキュメントルートフォルダにインストールしたら、もはや必要ありません。

これらの移動の後に、index.php の中のアプリケーションの位置を変更します:

define('APPPATH', realpath(__DIR__.'/fuel/app/').DIRECTORY_SEPARATOR);

いくつかのフォルダをより深くするのはどうでしょう?

違いはありません。手順はまったく同じです。

しかしながら、この場合のアプリケーションへのアクセスは、フォルダ構成のため少々複雑になるかもしれません。同じフォルダ構成のまま移動したファイル群にそのままアクセスすることは、 従来の .htaccess ではできません。

FuelPHP がドキュメントルートの "/deep/sub/folder" にインストールされているとすると、通常ならば http://example.org/deep/sub/folder でアプリケーションにアクセスする必要があります。

上位フォルダのどこかに以下の .htaccess を置くことで、存在しないファイルやディレクトリにアクセスがあった場合に、 あなたのアプリケーションにリダイレクトをさせることができます:

<IfModule mod_rewrite.c>
	RewriteEngine on

	# 存在するファイルやフォルダでなかったり、ルートへのリクエストの場合、リクエストをサブフォルダに送る
	RewriteCond %{REQUEST_FILENAME} !-f
	RewriteCond %{REQUEST_FILENAME} !-d [OR]
	RewriteCond $1 ^$

	RewriteRule ^(.*)$ /deep/sub/folder [R=301,L]
</IfModule>

これはリダイレクトであることに注意してください。ユーザにサブフォルダを隠しません。もし、サブフォルダを隠したい場合は、代わりに以下を使ってください:

<IfModule mod_rewrite.c>
	RewriteEngine on

	# 存在するファイルやフォルダでなかったり、ルートへのリクエストの場合、リクエストをサブフォルダに送る
	RewriteCond %{REQUEST_FILENAME} !-f
	RewriteCond %{REQUEST_FILENAME} !-d [OR]
	RewriteCond $1 ^$

	RewriteRule ^(.*)$ /deep/sub/folder [QSA,L]
</IfModule>

もちろん、もし "sub" フォルダに配置した場合は、URL から "sub/folder" を隠せますが、"deep" は隠せません...

環境を設定する

デフォルトでは、環境は開発モードにセットされています。Fuel は環境を使用して、使用するデータベース設定を定義します。しかし、他のことにも利用できます。

環境を設定するために、.htaccess ファイルに次の行を追加します。

SetEnv FUEL_ENV production

有効なオプションは Fuel クラスの クラス定数 内で定義されています。