Difference between revisions of "Installation"

From Zen Cart(tm) Wiki
Jump to: navigation, search
(Required)
m (Minor cleanup.)
Line 4: Line 4:
 
The '''Minimum''' suggested server requirements for running Zen Cart™ v1.2.x are:
 
The '''Minimum''' suggested server requirements for running Zen Cart™ v1.2.x are:
  
- PHP 4.1.x or higher (PHP 4.3.x for optimal performance),  
+
* PHP 4.1.x or higher (PHP 4.3.x for optimal performance),  
  
- Apache 1.3.x  
+
* Apache 1.3.x  
  
- MySQL 3.2x or higher.  
+
* MySQL 3.2x or higher.  
  
- Register Globals may be on or off
+
* Register Globals may be on or off
  
- PHP safe_mode '''off''' recommended.
+
* PHP safe_mode '''off''' recommended.
  
  
 
The '''Ideal''' server configuration is:
 
The '''Ideal''' server configuration is:
  
- PHP 4.3.x or higher  (ideally 4.3.11 or higher, or 4.4.x)
+
* PHP 4.3.x or higher  (ideally 4.3.11 or higher, or 4.4.x)
  
- Apache 1.3.x or 2.x
+
* Apache 1.3.x or 2.x
  
- MySQL 3.2x or 4.0.x  (with significant memory resources devoted to the MySQL processes)
+
* MySQL 3.2x or 4.0.x  (with significant memory resources devoted to the MySQL processes)
  
- Register Globals = off
+
* Register Globals = off
  
- PHP Safe_Mode=off
+
* PHP Safe_Mode = off
  
  
Line 43: Line 43:
  
 
MySQL 4.1.x uses an encryption scheme that is not 100% supported by PHP4, so may not work with Zen Cart unless you are using PHP5 ... which of course is not officially supported by Zen Cart yet.
 
MySQL 4.1.x uses an encryption scheme that is not 100% supported by PHP4, so may not work with Zen Cart unless you are using PHP5 ... which of course is not officially supported by Zen Cart yet.
MySQL 5 has some tighter constraints on various SQL statement constructs.  Zen Cart™ v1.2.x requires some coding alterations in order to work in a MySQL5 environment. Zen Cart™ v1.3.x has repaired these constructs and thus is expected to be compatible. Exhaustive testing has not yet been completed.
+
MySQL 5 has some tighter constraints on various SQL statement constructs.  Zen Cart™ v1.2.x requires some coding alterations in order to work in a MySQL5 environment. Zen Cart™ v1.3.x has repaired these constructs and thus is expected to be compatible. Exhaustive testing has not yet been completed.
 
Zen Cart™ has not been designed to use the advanced database features in MySQL5.
 
Zen Cart™ has not been designed to use the advanced database features in MySQL5.
  
Line 49: Line 49:
  
 
1. Download the latest code here:  [http://http://www.zen-cart.com/modules/mydownloads/singlefile.php?lid=14 Latest Release (Full Download)]
 
1. Download the latest code here:  [http://http://www.zen-cart.com/modules/mydownloads/singlefile.php?lid=14 Latest Release (Full Download)]
This will take you to SourceForge, which is where our files are distributed from. On that page you can choose the file you wish to download.  You will be asked to select a "mirror" (mirrors are different servers where the same files are hosted, but scattered around the world)... best to choose one close to your own geographic location.
+
This will take you to SourceForge, which is where our files are distributed from. On that page you can choose the file you wish to download.  You will be asked to select a "mirror" (mirrors are different servers where the same files are hosted, but scattered around the world). It's best to choose one close to your own geographic location.
  
 
(If you need to access an older version of Zen Cart™, you can find those files [http://sourceforge.net/project/showfiles.php?group_id=83781&package_id=125709 here]
 
(If you need to access an older version of Zen Cart™, you can find those files [http://sourceforge.net/project/showfiles.php?group_id=83781&package_id=125709 here]

Revision as of 22:08, 10 December 2005


Introduction

Required

The Minimum suggested server requirements for running Zen Cart™ v1.2.x are:

  • PHP 4.1.x or higher (PHP 4.3.x for optimal performance),
  • Apache 1.3.x
  • MySQL 3.2x or higher.
  • Register Globals may be on or off
  • PHP safe_mode off recommended.


The Ideal server configuration is:

  • PHP 4.3.x or higher (ideally 4.3.11 or higher, or 4.4.x)
  • Apache 1.3.x or 2.x
  • MySQL 3.2x or 4.0.x (with significant memory resources devoted to the MySQL processes)
  • Register Globals = off
  • PHP Safe_Mode = off


Other Things To Note:

NOTE: Many shipping and payment modules require cURL to be installed/compiled with php.

NOTE: Support for HTTPS may be required depending on the payment methods being accepted. The use of SSL during account creation and checkout is recommended.

NOTE: There are known issues on servers running php v4.1.2. Most issues have a workaround available.

PHP5

PHP5 is not officially supported by Zen Cart™ at the present time since it hasn't been exhaustively tested; however, many shopowners are successfully running their shops on servers using PHP5. The development of v1.3.x is using constructs that are more compliant with PHP5; but full specific testing for PHP5 is not a primary goal of the 1.3.x series.

MySQL 4.1 and 5.x

MySQL 4.1.x uses an encryption scheme that is not 100% supported by PHP4, so may not work with Zen Cart unless you are using PHP5 ... which of course is not officially supported by Zen Cart yet. MySQL 5 has some tighter constraints on various SQL statement constructs. Zen Cart™ v1.2.x requires some coding alterations in order to work in a MySQL5 environment. Zen Cart™ v1.3.x has repaired these constructs and thus is expected to be compatible. Exhaustive testing has not yet been completed. Zen Cart™ has not been designed to use the advanced database features in MySQL5.

Getting the code

1. Download the latest code here: Latest Release (Full Download) This will take you to SourceForge, which is where our files are distributed from. On that page you can choose the file you wish to download. You will be asked to select a "mirror" (mirrors are different servers where the same files are hosted, but scattered around the world). It's best to choose one close to your own geographic location.

(If you need to access an older version of Zen Cart™, you can find those files here

2. Unzip the file you downloaded. Using a tool like WinZip or WinRAR, you can extract the distribution files to your local computer.