EC-CUBEインストールについて

ECサイト制作に関するご希望やお悩み、
まずはEC-CUBE公式アドバイザーにご相談ください。

EC-CUBEの基本的なインストール手順

簡単なインストール手順のご紹介となります。サーバーにより設定方法など異なりますので、合わせて動作検証済みレンタルサーバーでの、インストール方法をご参照ください。
ローカル環境へのインストール手順については「開発者向けドキュメント」をご参照ください。

必ずお読みください

最新版EC-CUBE4系ダウンロード版のインストール方法となります。ダウンロード版をお使いの場合、EC-CUBEのバージョンアップやメンテナンスもご自身で行なっていただく必要があります。合わせてセキュリティ対策のチェックも行なってください。

セキュリティ対策について

0. インストール前に以下の準備や確認をお願いいたします

  • システム要件の確認
    EC-CUBE最新版のシステム要件を満たしているかをご確認ください。
  • サーバー準備
    システム要件を満たしているサーバーをご用意ください。公式で動作検証済みレンタルサーバーはこちらになります。
  • データベースの準備
    MySQL、PostgreSQLどちらかの空のデータベースを新しく作成ください。作成方法は各ホスティング会社のヘルプをご参照ください。
  • メールアカウントの準備
    EC-CUBEから送られるメールの送信元に必要な以下のメールアカウント情報をご用意ください。
    メールアドレス/メールアカウントユーザ名/メールアカウントパスワード/メールサーバアドレス(SMTP/POPetc)
  • EC-CUBE最新バージョンのダウンロードファイル
    サーバーにアップする、EC-CUBEの最新バージョンをダウンロードページから、ご準備ください。

1. ファイルをサーバーにアップロードする

インストールするためには、ダウンロードしたEC-CUBEファイルをサーバーにアップロードする必要があります。
FTPソフトなどを使用し、サーバーにアップロードください。ファイル数が多いので、一度にアップロードできない場合は、ディレクトリごとにアップし直してください。

アップ先のディレクトリは、各ホスティング会社によって異なりますので各サービスのヘルプをご参照ください。

ファイルをサーバーにアップロードする イメージ

2. ブラウザからインストールウィザードへアクセス

サーバーへファイルアップロード完了後、ブラウザからEC-CUBEをアップロードしたURLへアクセスします。

例: http://example.com/{EC-CUBEをアップロードしたディレクトリ}

アクセスすると自動でインストーラーされ、インストールウィザードが開始されます。
赤いエラー表示が無いことを確認し「次へ進む」ボタンを押して、ウィザードを進めます。
※ エラー表示がある場合は、表示内容をホスティング会社に問い合わせるか、開発コミュニティなどをご活用ください。

ブラウザからインストールウィザードへアクセス イメージ

3. パーミッション(ファイル権限)チェック

パーミッションの設定で、エラーが出た場合は、FTPソフトや各ホスティング会社の管理画面から、ディレクトリとファイルのパーミッションを変更ください。 開発ドキュメントにも設定例が記載されています。

パーミッション(ファイル権限)チェック イメージ

4. サイトの設定&メール設定

店舗の基本情報を入力します。
店舗名・メールアドレスなどは管理画面から変更可能ですが、管理画面ログインID/パスワード/ディレクトリ名/SSL経由は、後からの変更が難しいものになりますので、しっかりここで設定と忘れないようにメモなど残しておきましょう。

メール設定では、準備しておいたメールアカウントの設定を行なってください。設定項目の詳細などは、開発ドキュメントも合わせてご参照ください。

サイトの設定&メール設定 イメージ

5. データベースの設定

準備しておいた、データベースの設定を入力します。設定項目の詳細などは、開発ドキュメントも合わせてご参照ください。

データベースの設定 イメージ

6. データベースの初期化

データベースに初期データを登録します。新規でデータベースを設定する場合は「データベースの初期化を行わない」にチェックは入れずに進んでください。

データベースの初期化 イメージ

7. インストール完了

以上でインストール完了となります。管理画面の表示をクリックし、IDとパスワードでログインできることを確認しましょう。
もし、ここでログインできない場合は、インストールしたディレクトリの .envの削除と、データベースを空にして再度インストール手順を行ってください。

インストール完了 イメージ

EC-CUBEのインストールで失敗しがちなポイント

インストールの際に、エラーが表示される失敗しがちなポイントになります。
以下の内容を確認し、それぞれの対応をお試しください。
それでも、うまくいかない場合は、各ホスティング会社や開発コミュニティにて、ご質問ください。

1. インストール画面へアクセスしたのに「404エラー」が表示される

インストール先のフォルダやアクセスするURLが間違っている可能性があります。必要なファイルを全てアップロードできているかを確認してください。

2. インストール画面へアクセスしたら画面が真っ白になる(エラーが表示される)

PHPのバージョンがインストールするEC-CUBEの要件を満たしていないと、インストール画面が真っ白になることがあります。利用しているホスティング会社の公式サイトなどで予め対応しているかをご確認ください。

EC-CUBE公式アドバイザー
ご相談窓口

  • 他社のASPやパッケージとの違いを知りたい
  • BtoCのサイトにBtoB機能を追加したい
  • 何から手をつければよいかわからない
  • オープンソースならではの注意事項を知りたい
  • 自社にマッチした制作会社を探したい
  • サイト制作だけでなく運営もサポートしてほしい

新規構築・リニューアル・取引先向けのWeb受発注システム(BtoB)や事業の拡大など、
今抱えている課題を解決する最適な業者探しを、アドバイザーがお手伝いします。