ネットショップ構築OSSパッケージ 「EC-CUBE（ECキューブ）」 のカスタマイズ・運用サイトへようこそ！ こちらは、電子商取引 (EC) のフリーなオープンソースソフトウェアである EC-CUBE（イーシー・キューブ）のカスタマイズに関するノウハウをまとめているサイトです。 EC-CUBEのインストール方法から環境設定、カスタマイズ方法、プログラムソース、文字化け、 エラー対策などを紹介しています。 ECサイト出店者増加に伴い、ネットショップ同士の競争は激化しています。 デフォルトのままのEC-CUBEで、売れるECサイトにできますか？ EC-CUBEのレンタルサーバの選び方から、ブロックの追加・編集方法、お問い合わせ機能のカスタマイズ、 SEO対策、商品画像のリサイズなど、メニューから選んでお探しください。 EC-CUBEをうまくインストールできない、文字化けしてしまう、などの対処法もまとめています。 適切にカスタマイズして、PC用サイトも、モバイル用サイトも、 デザイン性とユーザビリティの高いECサイトを運営しましょう！

EC-CUBEの基本的な使い方（基本情報管理やメルマガ管理などの見方）については、 EC-CUBEマニュアルをご覧ください。 EC-CUBE全般の質問とその答えについてはEC-CUBE Q&Aをご覧ください。 決済モジュールが出ない、メールの送信不能、RSS配信での日付バグ、モバイルXHTML化パースエラー･･･ 緊急に教えてほしいこと、お困りの質問にお答えしております。 デザインテンプレート、決済サービスなど関連サービスについてはEC-CUBE関連サービスをご覧ください。 EC-CUBE No.1パートナー最新情報ブログにも、EC-CUBEのUTF-8化についてや、定期購入について、 レンタルサーバについて、うまくインストールできない場合の要因などカスタマイズ関係の記事があります。 ご参照ください。 EC-CUBEのUTF-8化について･･･海外サイトの制作 UTF-8化への道 その1、その2 EC-CUBEの基幹システムについて･･･EC-CUBEでバックオフィス業務も効率化 大規模ECサイトの構築、開発について･･･「ちゃんとやるだけ」大規模ECサイト 商品の定期購入について･･･EC-CUBEで定期購入 ポイント管理について･･･EC-CUBEのポイント管理方法 決済サービスについて･･･EC-CUBEが電子マネーに対応、root権限がないサーバへの EC-CUBE インストール レンタルサーバについて･･･驚くべき理由でしばらく更新できず… 動的なブロックの追加について･･･EC-CUBEに動的なブロックを追加する方法 データベースについて･･･MySQL か PostgreSQL か うまくインストールできない場合の対処法について･･･うまくインストールできない3大要因 デザインカスタマイズについて･･･デザインのカスタマイズ

EC-CUBEとは、元々開発元のロックオン社が、予算数千万円規模のネットショップ構築用に開発していたものを オープンソースとして公開したものです。 EC-CUBE 公式サイトはこちら。

EC-CUBEのインストール、PHP・データベースについて解説しています。

EC-CUBEのインストール	EC-CUBEをダウンロード→ファイルをサーバ上の適切な場所に設置→ブラウザ上でインストール、という一連の流れについて記載してあります。
環境構築-Linux	EC-CUBEをインストールする環境を構築。 Apacheのダウンロードからインストールについて、PHPについて、MySQLやPostgreSQLといったデータベースの作成について記載してあります。
環境構築-Windows	当カスタマイズページでは、UNIX系OSでの構築を推奨致しますが、EC-CUBE公式サイトでは、Windows系のOSでも動作確認が取れていますので、Windows Serverでも問題ありません。

うまくインストールできなかった場合･･･
「EC-CUBEをインストールしたけどうまく動かない!?」という場合の要因は主に3つです。
・DBのバージョン･･･MySQLのバージョンが古く（特に多いのが4.0系）、インストール時にエラーが出るケース。
・文字コード･･･EC-CUBEの文字コードは EUC-JP。最近は UTF-8 が普及してきており、DBの文字コードと一致しないままインストールするとうまく動かないことがある。
・ファイル所有者、権限･･･Smartyのキャッシュディレクトリや、画像のアップロード先など、ファイルの書き込み権限がない。

EC-CUBE No.1パートナー最新情報ブログに『うまくインストールできない3大要因』や、『root権限がないサーバへの EC-CUBE インストール』といった記事があります。
その他、EC-CUBE開発コミュニティサイトで調べてみましょう。
■開発コミュニティサイト
http://xoops.ec-cube.net/

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

EC-CUBE公式サイトから、最新版をダウンロードしてください。
http://www.ec-cube.net/download/index.php

2009年04月現在、1系と2系とがありますが、公式サイトにもあるとおり、1系は開発終了となっていますので、2系のインストールを強くオススメします。

※最新の安定バージョンだからと言ってバグや不具合が無い事は保証されていません！既知のバグを含んでいる事もありますので、EC-CUBE TracやEC-CUBE開発コミュニティなどを必ずチェックしてください。

ソースにはzipとtar.gz、2種類の圧縮方式がありますが、tar.gzを選択しましょう。zip版の場合はパーミッションが適切に設定された状態で展開されない場合があり、インストール時に余計な手間が増える場合があります。

可能であれば設置先のサーバーのコンソールにSSH等でログインして「wget」で取得すると後々楽です。

$ wget http://downloads.ec-cube.net/src/eccube-2.3.4.tar.gz

デスクトップで解凍してサーバーにアップする場合

サーバーのコンソールにログインできず、FTPしか使用出来ない場合はデスクトップにダウンロードしたEC-CUBEのソースを解凍します。（WindowsXPであれば標準で解凍できると思います）

この時、解凍ソフトを使う場合は注意してください。ソフトによっては正常に解凍出来ない場合もあるそうです。

解凍後、解凍先のディレクトリにdataというフォルダとhtmlというフォルダができ上がります。 これをサーバーにFFFTP等のFTPソフトを使用してアップロードします。

アップロードする際の転送モード、文字エンコードには注意してください。FFFTP等では文字コードの自動変換機能が付いており、アスキーモードで転送したファイルを自動で任意の文字コードに変換してしまします。変換されるとインストールできなかったり、表示が文字化けしたりするので注意が必要です。全部バイナリモードで上げてください。

サーバー上で展開する場合

ダウンロードしてきたファイルを展開します
tar.gzの場合

$ wget http://downloads.ec-cube.net/src/eccube-2.3.4.tar.gz

http://hoge.jp/shop/をショッピングサイトのドキュメントルートに設定したい場合 /var/www/htdocsがWEBサーバーのドキュメントルートに設定されていたら

http://hoge.jp/shop/をショッピングサイトのドキュメントルートに設定したい場合
/var/www/htdocsがWEBサーバーのドキュメントルートに設定されていたら

これでhttp://hoge.jp/shop/install/にアクセスするとEC-CUBEのインストール画面が表示されます。

環境によってはシンボリックリンクでは正常に動作しない場合がある様なので、
その場合はhtml/define.phpの各相対パスを編集してください。

展開したhtmlディレクトリにブラウザでアクセスします。 必要な情報を入力し、「次へ」をひたすらクリックしていけば自動的にインストールされます。 インストールが完了したらhtml/installは必ず削除して下さい。そのまま放っておくと大変な事になります。

うまくインストールできなかった場合･･･
「EC-CUBEをインストールしたけどうまく動かない!?」という場合の要因は主に3つです。
・DBのバージョン･･･MySQLのバージョンが古く（特に多いのが4.0系）、インストール時にエラーが出るケース。
・文字コード･･･EC-CUBEの文字コードは EUC-JP。最近は UTF-8 が普及してきており、DBの文字コードと一致しないままインストールするとうまく動かないことがある。
・ファイル所有者、権限･･･Smartyのキャッシュディレクトリや、画像のアップロード先など、ファイルの書き込み権限がない。

EC-CUBE No.1パートナー最新情報ブログに詳細を載せています。


EC-CUBE開発コミュニティサイトを調べて見ると、けっこう解決したりしますよ。
■開発コミュニティサイト
http://xoops.ec-cube.net/

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

EC-CUBEの動作環境は、公式サイトによると以下の通りとなっています。
当サイトではApache、Linux(CentOS)、PHP5、PostgreSQL（一部MySQL）の環境をデフォルトとして記載します。

ソフトウェア要件

分類	ソフトウェア	動作確認済み
OS	Windows	Windows 2000 Professional
		Windows 2000 Server
		Windows 2003 Server
		WindowsXP Professional
		WindowsNT Workstation 4.0
		WindowsNT Server 4.0
	UNIX	Linux glibc 2.1/2.2/2.3
		FreeBSD 5.4以降
言語	PHP	PHP4.1.x以降
		PHP5.0.x以降
ライブラリ	画像生成	freetype2 2.1.x以降
		gd 2.0.x以降
データベース	Postgres	PostgreSQL 7.4.x以降
	MySQL	MySQL4.1以上
		(MySQL5.x系を含む）

MySQLもサポートされていますが、PostgreSQLをオススメします。
理由についてはMySQL、PostgreSQLを参照してください。

ハードウェア構成（最小値）

• CPU:intel Pentium互換 300MHz以上を推奨
• MEM:OSの最低動作環境以上
• HDD:50MB以上を推奨

　※商品情報の登録情報は含みません。

上記はあくまで最小値。多分ギリギリEC-CUBEが動くスペックだと思います。
また、商品データ数や規格数、カテゴリ数が増えると処理が重くなるのでDBServerをWEBServerと分けることや、メモリの量に関しても注意が必要です。
特にデータベースサーバーに関しては数万件のデータを扱うのであれば64BitのCPUが必須になって来ると思います。

管理機能対応ブラウザ

• Microsoft Internet Explorer 6.0(SP1)以上

• Fire Fox 1.5.0.4以上

最初から本番環境で、EC-CUBEを構築していくのなら特に問題はありませんが、
開発環境で構築した上で、本番環境へと移行する場合、同じ環境が構築できていた方が、移行がスムーズに行えます。

開発環境を一から構築できるのであれば、

• どのアプリの、どのバージョンを、どのようなオプションでインストールしたのか
• 設定ファイルのどの部分を変更したのか

を逐一残しておくことをオススメします。
環境移行時の作業が格段に楽になります。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

• OSSの中だけでなく、最も有名なWEBServerのひとつ。
• 2009年現在、1.3系と2系が多く運用されている。
• ほぼすべてのLinuxディストリビュージョンにプリインストールされている。（MacOSXにも入ってます。）

ソースから

ほとんどのLinuxディストリビュージョンにインストールされているので、新たにダウンロードしてインストールする事はほとんど無いと思いますが、最新版を入れたい時には必要な作業です。

ダウンロード

• http://www.apache.jp/misc/download.html から適当なミラーを選択し、欲しいバージョンを探す
• サーバーのコンソールにログインする

$ wget http://ftp.riken.jp/net/apache/httpd/httpd-2.2.10.tar.gz

等でダウンロードしてください。

インストール

コンパイルする。

$ tar xvfz httpd-2.2.version.tar.gz //解凍
$ cd httpd-2.2.10 //解凍したディレクトリに移動
$ ./configure –enable-module=all –enable-mods-shared=all //コンパイル設定
–enable-module=all –enable-mods-shared=allは目的に合わせて変更してください。
$ make
$ make install

yumでインストール（パッケージ管理）

$ yum check-update //念の為アップデート $ yum install httpd

Apacheの設定は主にhttpd.confで設定します。通常であれば/etc/httpd/conf/あたりにあります。
インストールした段階では特に設定する事はありません。デフォルトの設定で十分動きます。

ソースからインストールした場合は、インストールされているモジュールを確認してください。
パッケージでインストールした場合、多くのモジュールが自動でインストールされ、有効になっているので、使わないモジュールはコメントアウトしておきましょう。
.htaccessを有効にする為には、

AllowOverride None
↓
AllowOverride All

と、変更してください。

shopをバーチャルホストで運用する場合

http://www.hogehoge.jp/shop/の様なサブディレクトリではなく、http://shop.hogehoge.jpの様なサブドメインで運用する場合はバーチャルホストの設定が必要です。

<‎VirtualHost *80>
ServerAdmin hoge-san@hogehoge.jp
DocumentRoot /var/www/shop/html/
ServerName shop.hogehoge.jp
ErrorLog /var/www/shop/error.log
TransferLog /var/www/shop/access.log
<‎/VirtualHost>

設定ファイル（httpd.conf）について

• 設定項目（SSL,バーチャルホスト,PHPなど）毎に設定ファイルを分けてインクルードさせるよりも、一つの設定ファイルに書いてしまった方が動作は速いようです。
• mod_rewriteを有効にする場合は、設定ディレクティブに必ず「RewriteBase」を書くこと。これが無いと遅くなります。

EC-CUBE2.0系について、EC-CUBE No.1パートナー最新情報ブログにも記事があります。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

• 比較的平易な文法のため、初心者にも習得しやすい言語です。
• サーバ上で動作し、その結果をWEBブラウザに対して返すため、WEBブラウザに対して送信されるデータは通常のHTMLです。

ソースから

freetype2を入れる

$ cd /usr/local/src
$ wget http://download.savannah.gnu.org/releases/freetype/freetype-doc-2.3.7.tar.gz
$ tar xvfz freetype-doc-2.3.7.tar.gz
$ cd freetype-2.3.7
$ ./configure –enable-shared
$ make
$ make install

phpのコンパイル

※コンパイルオプションには要注意！

$ cd /usr/local/src
$ wget http://jp2.php.net/get/php-5.2.5.tar.gz/from/jp.php.net/mirror
$ tar xvfz php-5.2.5.tar.gz
$ cd php-5.2.5
$ ./configure \
–prefix=/usr/local/php-5.2.5 \
–with-apxs2=/usr/local/apache/bin/apxs \
–with-mysql=/usr/local/mysql \
–with-pgsql=/usr/local/pgsql \ –enable-mbstring \
–with-zlib \
–with-gd \
–with-freetype-dir
$ make
$ make install
$ ln -s /usr/local/php-5.2.5 /usr/local/php

yumを使う

$ yum install php php-{mbstring,pgsql,mysql,ldap,imap,pear}

※pgsql,mysqlに関しては、お使いになる方どちらか一方で構いません。

• php.ini

以下の項目を設定します。

mbstring.language = Japanese
output_handler = mb_output_handler
mbstring.encoding_translation = 1
magic_quotes_gpc = 0
mbstring.internal_encoding = UTF-8
upload_max_filesize = 5M
memory_limit = 256M

• httpd.conf（apacheの設定）

動作モードによって振舞が若干変わります。ここではapacheモジュールとして設定。（yumで入れた時は必要ありません）

LoadModule php4_module libexec/libphp5.so //LoadModuleの最後に追記
AddModule mod_php5.c　　//AddModuleの最後に追記
DirectoryIndex index.html index.php　//index.phpを追記
AddType application/x-httpd-php .php .php5
AddType application/x-httpd-php-source .phps .php4s

編集が終わったら

$ /etc/init.d/httpd restart

などでapacheを再起動します。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

EC-CUBEで使用できるデータベースは基本的にはPostgreSQLとMySQLの2つです。
PostgreSQLとMySQLについては、EC-CUBE No.1パートナー最新情報ブログにも記事があります。

EC-CUBEはデータベース周りの処理にPEARのDBライブラリを使っているので、頑張ればOracle等でも使用は可能です。
ただ、かなりのカスタマイズが必要になります。

どちらも利用できる環境であれば、2008年10月現在はPostgreSQLをオススメします。元々開発元のロックオンがPostgreSQLで開発していた経緯があり、PostgreSQLの方がスムーズに動きます。

元々、PostgreSQLは商用データベースに負けない機能の豊富さを、MySQLは商用データベースに負けない処理スピードを目指して開発されてきた経緯があり、多機能なPostgreSQL、高速なMySQLという印象がありますが、近年はどちらも早いですし、どちらも多機能です。

ただ、EC-CUBEに関しては、上記のような経緯から、現状ではPostgreSQLをお勧めします。
また、このwikiのカスタマイズ内容に関しても、特別な記載のない場合は、PostgreSQLでのカスタマイズだとお考えください。

テーブル名の命名規則

予約済み？カラム名

EC-CUBEは管理画面等からデータを削除してもレコードに削除フラグを立てるだけでDELETE文は発行しません。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

• 歴史があり、最も有名なOSSデータベースのひとつ。
• 最も使われるデータベースフォーマットに、動作の速いMyISMと多機能なInnoDBの2つがある。EC-CUBEはトランザクション処理が必要な為、InnoDBを使用（遅い）
• MySQLClusterなど、冗長化、スケーラビティに特化したソリューションが多く、大規模サイトでも実績が豊富。
• 大概のレンタルサーバーで利用が可能。ただ安価なレンタルサーバーではバージョン4.1以降では無いことが多いので注意が必要。（EC-CUBEに必要なトランザクション機能のサポートが4.1以降の為）

yumやrpm等のパッケージ管理機能を利用してインストールしても、特に問題なく動きます。
MySQLの公式マニュアルでもパッケージでのインストールが推奨されています。
日本語のドキュメントも準備されていますので、詳しくはMySQL ABを参照してください。

ユーザの作成

インストールが完了したら、次にデータベースへのアクセス用にユーザを作成します。
コンソールでmysqlクライアントにrootでログインし、
WEBserverとDBserverが同一マシンの場合

mysql-> GRANT ALL PRIVILEGES ON *.* TO ‘eccube’@'localhost’
　-> IDENTIFIED BY ‘some_pass’ WITH GRANT OPTION;

注：上記はあくまで設定例です。EC-CUBEを動かす為にはGRANTオプションは必要ではありません。
詳しくはこちらをご参照ください。

DBの作成

EC-CUBE用のデータベースを作成します。
既にあるDBを利用する事も可能ですが、パフォーマンス、セキュリティ上専用データベースを作成した方が無難です。

mysql-> CREATE DATABASE [IF NOT EXISTS] db_name;

EC-CUBEでは、パフォーマンスより出来るだけ多くのデータベースで動く様に設計されています。その為、MySQLではかなりパフォーマンスが犠牲になっている部分があります。

もし、MySQL5以降を使っているのであれば、各クエリや処理方法、テーブルのインデックスをMySQLに最適化させる事によりかなりのパフォーマンスアップが期待できます。

MySQLのInnoDBは多機能な反面、制約も多いです。特に他のアプリケーションと連携させる為に同一データベース内にEC-CUBEのテーブルを作成する場合は注意してくだい。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

• 歴史があり、最も有名なOSSデータベースのひとつ。
• UPDATE,DELETE処理では実データは削除せず、削除フラグを立て、更新データを追加しています。その為、UPDATE、DELTE処理は早いですが、繰り返してると削除フラグの立っているデータが蓄積し、実データ量が膨張するので、適度にバキューム（最適化）する必要があります。

詳しくは日本PostgreSQLユーザー会、SRA OSSをご参照ください。

yumやapt等のパッケージ管理機能を利用してインストールしても問題なく動きます。お急ぎの方はこちらで入れてしまいましょう。

本番用のサーバーで、リソースを効率的に使用したい場合は、きちんとソースからコンパイルしましょう。 コンパイル方法は上記の日本PostgreSQLユーザー会のマニュアルを参考にして下さい。

ユーザーの作成

インストールが完了したら、次にデータベースへのアクセス用にユーザー(ROLE)を作成します。通常、PostgreSQLをインストールすると、postgresというROLEが作成されますが、このスーパーユーザーをそのまま使用するのはセキュリティ上問題があるのでやめましょう。

CREATE USER name PASSWORD ‘string’;

また、PostgreSQはMySQLよりセキュリティ（DBへのアクセス）について少々厳格になっています。要件に合わせたセキュリティレベルを保持できるよう適切な認証方式を選択してください。

password、md5、crypt認証

DBの作成

EC-CUBE用のデータベースを作成します。
既にあるDBを利用する事も可能ですが、パフォーマンス、セキュリティ上専用データベースを作成した方が無難です。

CREATE DATABASE dbname OWNER rolename;

pg_hba.confファイル（アクセス権）の設定

PostgreSQLはMySQLに比べてこの辺の設定がシビアです。間違えると動かないので注意して下さい。
WEBServerと同一サーバーでPostgreSQLを動かすのであれば

local database 作成したユーザー password

で良いと思います。（auth-methodは場合によってはidentでも）

• autovacuum(自動バキューム)の設定はとても大切です。適切に設定してください。
• TCP/IP接続（localhost）よりも、UNIXソケットでの接続の方が最大20%早くなるそうです。

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！

EC-CUBE公式サイトでは、Windows系のOSでも動作確認が取れていますので、
Windows Serverでも問題ありません。
ただし、当wikiでは、以下の理由から、UNIX系OSでの構築を推奨致します。

• レンタルサーバの多くはOSとしてLinuxを採用
• EC-CUBEコミュニティサイト参加者の多くはLinux環境で使用
• EC-CUBE公式ガイドブックでもLinux環境での使用を想定

また、当wikiにおいても、カスタマイズなどの動作検証は、全てLinux環境にて行っております。

※決してWindows Serverを使うな、ということではありません。
（Windowsでも、Linuxで紹介したソフトウェアは全てインストール可能です）

EC-CUBEのインストールや、ECサイトの開発・構築でお困りなら、
ネットショップ構築パッケージEC-Orangeにお問い合わせください！