magento_install_guide

hirokazu nishi — Sun, 22 Aug 2010 10:54:12 +0900

Magentoインストールガイド

システム要件

Magentoをインストールするためには以下のソフトウエアが必要です。 (お使いの環境がMagentoにマッチしているかは、右のリンク先にあるツールを使ってチェックできますテストスクリプト.)

1 - Linux, Windows, またはその他のUNIX互換オペレーティングシステム

2 - Apacheウェブサーバ (1.x or 2.x)

3 - PHP 5.2.0以上で以下のエクステンションが有効であること:

PDO/MySQL
MySQLi
mcrypt
mhash
simplexml
DOM

4 - MySQL 4.1.20以上

InnoDBストレージエンジンが利用可能であること

5 - Sendmail互換のSMTPサーバ (MTA)

Magentoはインストール先のサーバにMTAがない場合は直接メールサーバへメールを送信することができます。

バイトコードキャッシュのAPCをパフォーマンス向上のために使用することを推奨します。PECLアーカイブから入手することができます：http://pecl.php.net/package/APC
その他のバイトコードキャッシュシステムは現時点ではサポートされていません。

DNSの解決 (localhostにインストールする際は重要です)

Magentoのインストール処理はCookieを使用します。ほとんどのブラウザはlocalhostからのCookieを拒否します。そのため、エラーメッセージを伴わない問題をしばしば引き起こします。例えば言語設定をする場合に画面をリフレッシュしますが、標準の英語ロケールに戻されてしまいます。

この問題を回避するには、Magentoをインストールする際に127.0.0.1をドメイン名として使用するか、/etc/hostsファイルでlocalhostに別名を設定し、そのホスト名を使用してインストールを行うことです。設定例を以下に示します：

127.0.0.1 localhost www.localhost.com

PHPメモリ PHPのメモリ制限が低すぎる場合、商品画像を表示する際に問題が発生する可能性があります。もし、高画質画像をアップロードするつもりなら、php.iniでmemory_limit = 128M にすることをお勧めします。

Magentoをダウンローダーを使用してインストールする場合

この文書ではMagentoをMagentoダウンローダーを使用してインストールする方法を取り扱います。ダウンローダーはあなたのコンピュータからサーバへのFTPでのアップロードファイルサイズを縮小します。ダウンローダーを使用する場合は、FTPでダウンローダーをアップロードするだけです。ダウンローダーを実行する際に自動的に最新のMagentoの安定板リリースファイルを取得します。magentocommerce.comからダウンロードしたダウンローダーパッケージをお持ちの場合、このガイドにそってインストールを完了させてください。

作業手順

1. zipかtar.gz形式のインストーラパッケージをMagentoのサイトからダウンロードし、展開してください

2. FTPを使用して展開した全てのファイルをWebサーバにアップロードしてください。公開するHTMLファイルの場所にアップロードしてください

3. MySQLデータベースにデータベースを作成し、Magentoが使用するユーザーとパスワードを設定してください

インストーラを実行する前にサンプルデータをインストールしてください。
サンプルデータはMagentoのウェブサイトのインストーラと同じダウンロードページからダウンロードできます。
このステップはホスティング業者毎に異なります。異なる部分はこの文書では取り扱いません。ホスティング業者のサポートやドキュメントを参照し、作業してください。

4. 最上位のMagnetoディレクトリ（展開してアップロードしたファイルのことです）はインストーラが処理を正しく行えるように、適切なパーミッションを設定する必要があります。
設定のために、FTPクライアントで対象のディレクトリに移動してください。お使いのFTPクライアントで”パーミッションの変更”または”モード変更”の機能を選択してください。
機能を選択し、Webサーバがファイルを書き込めるようにパーミッションを設定してください。Linuxにおいては２つの方法があります：

数字で指定する (例： 785)
パーミッションをグループごとに指定する。 ユーザー, グループ, その他

お使いのFTPクライアントが最初の方法を採用している場合、パーミッションをディレクトリに対して、777または0777で設定してください。
もしお使いのクライアントが2番目の方法を採用している場合、パーミッションの設定は下図のように表示されます（FTPクライアントによって画面の内容は異なります）

より細かいパーミッションに関する情報は右の記事を参照してください： Magento Filesystem Permissions

5. お使いのサーバが主にPHP4で動作している場合、インストールにはPHP5のCGIバイナリが必要です。PHP5のCGIセットアップを参照し、ステップ6に進む前に正しく設定してください。

6. お使いのサーバがApache2.0で動作している場合、Magentoインストールディレクトリにある.htaccessに以下の記述を追記してください：

AcceptPathInfo On

7. Webブラウザを使用してMagentoインストールウィザードにアクセスしてください。もしMagentoのファイルを http://www.example.com/magento/ にアップロードしている場合、インストールウィザードは右のURLになります： http://www.example.com/magento/downloader

8. インストーラバージョンをお使いの場合は、ダウンローダは最初のインストール処理で実行されます。Magentoのインストールに必要なコンポーネントをダウンロードします。
もし、”Warning”メッセージが緑色の背景のスクリーンに表示された場合、過度に心配する必要はありません。インストーラはすべてが成功したか失敗したかを検知します。
そしてすべてが成功すると、”Continue magento Installation”ボタンが最後に表示されます（約5分ほどかかります。お使いの環境によって変わります）。
“Continue Magento Installation”ボタンをクリックして、通常のインストールウィザードに進んでください。

9. ウィザードでは、Magentoの機能が要求する様々なシステムの設定を行います。ほとんどのオプションは自動的に検出されます。ですが、あなたにとって正しくないと思われるオプションはどれでも上書きすることができます。
最低でもステップ3の最初の入力欄、”Database connection”で表示されるデータベース接続のパラメータは環境に合わせて変更する必要があります。

10. 成功です！Magentoのインストールが完了しました。管理画面にアクセスし、あなたのオンラインショップの設定を始めましょう。

Magentoをフルパッケージリリースからインストールする

このドキュメントでは標準のMagentoインストール手順を取り扱います。magentocommerce.comから完全なリリースアーカイブをダウンロードしているなら、このガイドに沿ってインストールを完了してください。

作業手順

1. Magentoのウェブサイトから.zipまたは.tar.gzのファイルをダウンロードし、展開してください。

2. MagentoのファイルをFTPでWebサーバにアップロードしてください。

3. MySQLにデータベースを作成し、Magentoが使用するユーザとパスワードを設定してください。

このステップはホスティング業者毎に異なります。異なる部分はこの文書では取り扱いません。ホスティング業者のサポートやドキュメントを参照し、作業してください。

4. app/etc , var , and media のディレクトリをWebサーバが書き込めるように設定してください。設定のために、FTPクライアントで対象のディレクトリに移動してください。お使いのFTPクライアントで”パーミッションの変更”または”モード変更”の機能を選択してください。
機能を選択し、Webサーバがファイルを書き込めるようにパーミッションを設定してください。Linuxにおいては２つの方法があります：

数字で指定する (例： 785)
パーミッションをグループごとに指定する。 ユーザー, グループ, その他

5. お使いのサーバがsuPHPまたはsuEXECをサポートしている場合、パーミッションは 777の代わりに 755 が使用できます。

6. お使いのサーバが主にPHP4で動作している場合、インストールにはPHP5のCGIバイナリが必要です。PHP5のCGIセットアップを参照し、ステップ6に進む前に正しく設定してください。

7. WebブラウザでMagentoインストールウィザードにアクセスしてください。Magentoのファイルを http://www.example.com/magento/ にアップロードしている場合、インストールウィザードは右のURLになります: http://www.example.com/magento/installer

8. ウィザードでは、Magentoの機能が要求する様々なシステムの設定を行います。ほとんどのオプションは自動的に検出されます。ですが、あなたにとって正しくないと思われるオプションはどれでも上書きすることができます。
最低でもステップ3の最初の入力欄、”Database connection”で表示されるデータベース接続のパラメータは環境に合わせて変更する必要があります。

9. 成功です！Magentoのインストールが完了しました。管理画面にアクセスし、あなたのオンラインショップの設定を始めましょう。

Appendix: PHP5 CGI Setup

Some hosting providers do not yet provide PHP5 on their servers, opting instead to stay with PHP4 for the time being. As Magento is a PHP5-only application, this can be a barrier for some users. This document outlines a possible workaround for such a scenario. The goal is to install PHP5 as a CGI binary and configure the web server (Apache) to use it instead of the default PHP4.

Requirements

Every hosting provider has a slightly different way of doing things, so it's important to know if this method will work with your provider before continuing. Below is a list of the basic requirements that this document requires. If you're unsure as to whether your provider supports these requirements, pass the list along to them and find out.

Operating System: Linux
Web Server: Apache with CGI support

FileInfo override control via .htaccess files
A user-writable cgi-bin directory
FTP access to your web root and cgi-bin directories

Instructions

Step 1: Upload the PHP5 CGI binary

It is possible to compile a PHP5 binary yourself, but for the purposes of this solution, we've provided one for you. You can download it here: http://www.magentocommerce.com/support/php5cgi/php5-cgi

Once downloaded, use your FTP client to upload the file to your cgi-bin directory. If you don't know where your cgi-bin directory is, ask your hosting provider.

After uploading, use your FTP client to set the proper mode on the php5-cgi file. This function varies for each FTP client, but it usually called “Change Permissions” or “Change Mode” or “Chmod”. Once you find the function, you must set the permissions so the web server can run this file. There are two typical ways of representing file permissions in Linux:

As a number (eg, 755)
As a series of permissions categorized into user, group, and other

If your FTP client uses the first representation, set the permission on the php5-cgi binary to be 755, or 0755. If your FTP client uses the second representation, set the permissions as shown in the image below.

Step 2: Modify the Magento .htaccess file

By default, the web server will want to run the Magento application using PHP4, which will not work. In order to point it to the new PHP5 CGI binary, you must modify the .htaccess file in the Magento top-level directory.

Using your FTP client, edit the file .htaccess in your top-level magento directory.

The file is somewhat long so we won't list it all here. But the first few lines at the top should look like this:

First, remove the # symbol from the beginning of the last three lines listed in the excerpt above. This will enable the special CGI handler for your Magento site. Next, you'll want to modify the path in the Action line to point to the location of the php5-cgi binary you uploaded in Step 1. This path should be relative to the web root of your site.

That's it! You can now proceed with the rest of the Magento installation using one of the methods described above.

Bad location to the PHP5 binary. Make sure the AddHandler directive in your .htaccess file is pointing to the correct location for the PHP5 binary. You can often test it by trying to surf to the location with your web browser. For example, if your site is www.example.com and your PHP5 location is /cgi-bin/php5-cgi , try visiting http://www.example.com/cgi-bin/php5-cgi with your web browser. If you see an “Internal Server Error” message, then that means your PHP5 binary is in the correct location. If you get a “File not found” message, then this is not the correct location.
Bad permissions on the PHP5 binary. Double check the permissions on the PHP5 CGI binary you uploaded in Step 1. They should be 755 or “rwxr-xr-x”, depending on your FTP client's representation.

Appendix: Cron job setup

Please see this article for cronjob setup: How to Set Up a cron Job.

magento 日本語wiki

magento_install_guide

Magentoインストールガイド

システム要件

Magentoをダウンローダーを使用してインストールする場合

作業手順

Magentoをフルパッケージリリースからインストールする

作業手順

Appendix: PHP5 CGI Setup

Requirements

Instructions

Troubleshooting

I still see “Invalid PHP version” when visiting my Magento page.

I see “Internal Server Error” when visiting my Magento page.

Appendix: Cron job setup