Mac環境でMAMPを使用したインストール方法

インストールの前に

MAMPを使用してMacのローカル環境へインストールする方法を解説します。
この記事の構築環境は以下の通りです。

// サンプルの構築環境
MacOS 10.15.5(Catalina)
EC-CUBE 4.0.3
MAMP 5.7

MAMPをダウンロード、インストール

まずはMAMPを準備します。

MAMP公式サイトへアクセスし、
「Free Download」からダウンロードページへ移動します。
「MAMP&MAMP PRO」の最新バージョンをダウンロードします。(この記事では5.7)

インストールすると、アプリケーションの中にMAMPとMAMP PRO、2つのソフトがインストールされます。
こちらの解説ではMAMPを使用します。

EC-CUBEをダウンロード

続いて、EC-CUBEをダウンロードします。
EC-CUBE公式サイトのダウンロードページから最新版のEC-CUBEをダウンロードします。(この記事では4.0.3)
※ ダウンロードには会員登録が必要です。

ダウンロードしたら解凍します。

MAMPにEC-CUBEを配置

解凍したEC-CUBEをMAMPのhtdocsディレクトリ(フォルダ)に配置します。

配置したディレクトリの構造でショップのトップページURLが決まります。
http://localhost:8888/{htdocsの中に作成したディレクトリ名}/

例:eccube-4.0.3というディレクトリ名をshopに変更しhtdocsの中に配置した場合
■ ディレクトリ構造
/Applications/MAMP/htdocs/shop/

■ ショップのトップページURL
http://localhost:8888/shop/

※ まだEC-CUBEをインストールしていないので、ショップURLにアクセスしてもサイトは表示されません。

phpバージョンの設定

EC-CUBE4.0.3は、php7.1 〜7.3で動作確認しています。
MAMPの環境設定から該当のphpバージョンに変更します。

MAMPを起動します。

Macの左上のメニューから「MAMP」→「Preferences」をクリックします。
MAMP

MAMP

設定画面が開くので「PHP」の項目から「7.3.9」にチェックをして「OK」をクリックします。

データベース作成

MAMPからサーバーを立ち上げます。

MAMP

「Start Server」をクリックします。

MAMPのトップページが表示されます。
MAMP

ヘッダーメニューの「TOOLS」から「PHPMYADMIN」をクリックします。

phpMyAdminが開きます。

phpMyAdmin

「New」をクリックしてデータベース名を入力し、データベースを作成します。
※データベース名は外部から予測されにくい名前にしてください。

例
データベース名
`eccube123_`

照合順序はutf8mb4_general_ciのままで問題ありません。

MAMPにはデータベースアカウントが標準で入っており、そちらを使用してEC-CUBEをインストールします。
もし、アカウントを作成する場合は、メニューの「User accounts」から作成してください。

※ 本番環境としてデータベースを作成する場合、ユーザーアカウントを作成してください。 データベースの接続情報(データベース名、アカウント情報等)が外部に漏れると、個人情報の漏洩などの原因になります。 管理にはご注意ください。

EC-CUBEのインストール

ブラウザから以下のURLにアクセスします。
http://localhost:8888/{EC-CUBEをアップロードしたディレクトリ名}/

例
http://localhost:8888/shop/index.php/install/

install step2
インストール画面が表示されます。
「次へ進む」をクリックします。

install step2 「次へ進む」をクリックします。

サイトの設定

install step3

店舗の基本情報

  • あなたの店名
    • 店名を入力してください。日本語でも問題ありません。
  • メールアドレス
    • ここで指定するメールアドレス宛に注文通知メールなどが送信されます。
  • 管理画面ログインID
    • 管理画面にログインする際に利用する管理者のログインIDです。一番権限の強いスーパーユーザーなので、「admin」などの推測されやすいIDは不正アクセスや情報漏洩の元になるので避けてください。 適当な意味を持たない文字列が良いです。
  • 管理画面パスワード
    • 上記の管理者がログインする際に使用するパスワードを指定します。 ここで指定するパスワードを忘れると管理画面にログインできなくなるので必ず控えてください。
      EC-CUBEには管理者のパスワード再発行機能は実装されていません。
      管理者ログインIDと同様に意味を持たない複雑なパスワードにしてください。
      「test1234」や「password」などは絶対避けてください
  • 管理画面のディレクトリ名
    • 管理画面にアクセスする場合のURLになります。
      http://localhost:8888/{EC-CUBEをインストールしたディレクトリ}/{管理画面のディレクトリ名}/ でアクセスする事になります。
      こちらのディレクトリ名も「admin」や「dashboard」など推測されやすい文字列を指定すると危険です。
      適当な意味を持たない文字列を指定してください。
  • サイトのアクセスをSSL経由に強制します
    • ローカル環境では入力しないでください。
  • 管理画面へのアクセスを、以下のIPに制限します
    • 管理画面へのアクセスを特定のIPアドレスに固定します。
      ローカル環境では特に指定しなくて大丈夫です。
      こちらにIPアドレスを指定すると、指定したIPアドレスのみ管理画面にアクセスできます。
      指定した方がセキュリティは強くなりますが、スマートフォンの公衆回線からアクセスできなくなるなど、利便性は損ないます。
      固定IPをお持ちでない方は指定しないでください。

※ 管理画面のアクセス情報が漏洩すると個人情報の漏洩や詐欺に利用されるなど甚大な被害が発生します。取り扱いには充分にご注意ください。

メール設定

ローカル環境では特に指定しなくて問題ありません。

データベースの設定入力

install step 4

データベースの情報を入力します。
今回はMAMPに標準で用意されているデータベースアカウントを使用します。

MAMPのデータベースアカウントの確認方法

MAMPを開き、「Open WebStart page」をクリックしてMAMPトップページを立ち上げます。 Open WebStart page

スクロールするとデータベースアカウント情報が記載された項目があります。
MySQL account

こちらのアカウント情報を見ながら入力していきます。

  • データベースの種類
    • 今回はMySQLを使用します。
  • データベースのホスト名
    • localhostになります。
  • データベースのポート番号
    • 8889
  • データベース名
    • 準備したデータベース名を指定してください。 サンプルでは「eccube123_」です。
  • ユーザー名
    • rootになります。
  • パスワード
    • rootになります。

※ユーザー名やパスワードは本番環境では独自に作成してください。

一通り入力したら「次へ進む」をクリックします。

データベースの初期化

install step 6

データベースに初期データを登録します。

「次へ進む」をクリックします。

インストール完了

install step 6

おめでとうございます!
この画面が表示されたらインストール完了です。

管理画面の使い方はこちら

管理画面を表示をクリックすると、管理画面のログイン画面に遷移します。
店舗の基本情報で入力した管理者の情報で管理画面にログインしてください。

もし、ここでログインできない場合は、管理者のパスワードやログインIDを間違えて控えた可能性が高いので、インストールしたディレクトリの .envを削除し、データベースを空にして再度インストール手順を行ってください。