[edit] 安裝問題排除

儘管安裝 xt:Commerce 的程序已經非常的簡單，但在不同的伺服器環境及操作情境錯誤的情況下，仍是不斷的有新的問題發生，以下僅就用戶經常在論壇提出的問題作整理：

[edit] 安裝步驟 3 的錯誤

[edit] 漢語版 xtc_installer 安裝目錄名稱修正

• 錯誤狀況1：

SQL file does not exist: /var/www/xtc_installer/xtcommerce.sql 

• 解決方式：

安裝 xt:Commerce 漢語版，必須先將 xtc_installer_cn 資料夾改為 xtc_installer 再開始安裝。

• 錯誤狀況2：

在安裝過程中出現的都是英語提示，無論在開始選擇簡體還是繁體中文。

• 解決方式：

這是因為你直接進入 xtc_installer_cn 目錄下安裝系統所致，請依錯誤狀況1將中文安裝資料夾改名， 再進入 http://your-domain/xtc_installer/ 來安裝。

[edit] 漢語 3.1 版，請直接進入 xtc_installer_zh 目錄安裝即可

[edit] 安裝步驟 6 的錯誤

[edit] 檢查所輸入的資料庫伺服器名稱

• 錯誤訊息：

Warning: mysql_connect(): Unknown MySQL Server Host 'localhost ' (11001) 
in c:\appserv\www\xtcommerce\inc\xtc_db_connect.inc.php on line 24
Unable to connect to database server!

• 解決方式：

如果 Web 伺服器與 MySQL 伺服器皆安裝於同一部機器中，請輸入 localhost (預設值)，勿再加入其它任何字元(包含空白)， 如果各安置在不同機器上，請輸入 yourdb-ip:3306 ，並請注意到防火牆等安全設置是否合宜(是否開放3306埠及相關的安全防護措施)

[edit] 修正資料庫中文編碼

• 錯誤訊息：

1267 - Illegal mix of collations (big5_chinese_ci,IMPLICIT) and (latin1_swedish_ci,COERCIBLE) for operation 'like'

select distinct zone_id from zones where zone_country_id = '44' and (zone_name like '?啣?撣?' or zone_code like '%?啣?撣?')

[XT SQL Error]

• 解決方式：

請參考安裝-在你的主機PC UTF-8 環境調校，正確設置資料庫的中文編碼。

[edit] 免費虛擬主機空間問題

[edit] 檔案權限設置錯誤

[edit] .htaccess 設置

• 錯誤訊息：

ERROR 500 (Internal Server Error)

• 解決方式：

這樣的情形不是每台主機都會遇到... 請編輯 /apache/conf/httpd.conf 檔，找到

#LoadModule rewrite_module modules/mod_rewrite.so

將前方的#註解符號拿掉，以啟用 Rewrite Engine。

繼續找到並啟用類似下列的相關描述：

<Directory "/usr/local/apache/htdocs">
  AllowOverride Limit
</Directory>

假設 Limit 值會影響到其它的系統，或可以設定成 AllowOverride All， 設定完成後，請重新啟動 Apache ，該設定值才會生效。

你可以在 xt:Commerce 的網頁根目錄及相關目錄中發現 .htaccess ，它是以目錄為一個驗證的節點所設置的網頁認證檔，簡單的說凡是要存取該目錄的網頁皆需要通過 .htaccess 的驗證或設置條件之後才可以存取，設置它的目地在於讓各目錄可以客製原先 httpd.conf 環境配置的不足，它可以有幾個面向：

• 是否允許顯示該目錄下的檔案列表
• 基本認證
• 錯誤及預設頁面設置
• 設置 WWW 及轉址
• 設置各種不同形式的允許、限制、禁止該目錄下的檔案。
• 設置 Rewrite Engine 環境配置。

你可以在以下的目錄發現它：

• /.htaccess
• /admin/backups/.htaccess
• /admin/includes/modules/fckeditor/.htaccess
• /cache/.htaccess
• /download/.htaccess
• /inc/.htaccess
• /includes/.htaccess
• /lang/.htaccess
• /pub/.htaccess
• /templates/.htaccess
• /templates_c/.htaccess

一般而言，你只要修改在根目錄下的 .htaccess 檔案，找到以下描述：

RewriteBase /svn_3.0/xtc30/xtcommerce/

請將它改寫成相應你所設置的商店路徑，例 /shop ：

RewriteBase /shop

相關的細節請參考 Apache tutorial:.htaccess

[edit] xt:Commerce 環境設定檔調整

[edit] xt:Commerce 環境設定檔調整

[edit] e-Mail 環境參數調整

[edit] PHP 相關 function 設置

[edit] cURL 設置

[edit] XAMPP

• XAMPP 已內建 cURL，請調整 xampp 目錄下的->
  • /apache/bin/php.ini
  • /php/php.ini

• 如果你是使用早期一點的 XAMPP 版本，可能還會遇到需要修改 ->
  • /php/php4/php.ini
  • /php/php5.ini

請在大概是第 578 行的位置找到 程式碼:

extension=php_curl.dll

將它前面的;註解符號拿掉並存檔

• 還請同時檢查 /php/browscap/browscap.ini 是否有以下描述：

程式碼:

[curl/*]
parent=Rippers
browser="cURL"

重新啟動 xampp (apache) 後應即生效。

[edit] 中文編碼轉換函數設置

[edit] Windows 環境

• 首先你必須確認 php_iconv.dll 及 iconv.dll 是否存在於你的伺服器內，例：

php/extensions/php_iconv.dll
apache/bin/iconv.dll

如果沒有，建議採用XAMPP套件或至gnuwin32.sourceforge.net下載。

• 接著尋找 php.ini 檔內是否有以下描述：
  • /apache/bin/php.ini
  • /php/php.ini

extension=php_iconv.dll

如果前面有;註解符號，將其拿掉即可

[edit] Linux環境

• 一般來說，市面上大多數版本的 Linux 只要建立 apache 及 php 服務即內含 iconv ，不需額外處置，你可以在此下載： www.gnu.org

[edit] 圖片函數設置

移植到另一部伺服器

xt:Commerce 安裝服務