Installing osCommerce v.4.0: Difference between revisions
Jump to navigation
Jump to search
After reviewing the license agreement click on the Accept and Start Installation button.
No edit summary Tag: Reverted |
No edit summary Tag: Reverted |
||
Line 23: | Line 23: | ||
<h4>'''PHP 7.0 to 8.0''' versions are supported by osCommerce 4. | <h4>'''PHP 7.0 to 8.0''' versions are supported by osCommerce 4.</h4> | ||
'''NOTE:''' ''We recommend to use PHP 7.2 and higher.'' | <h4>'''NOTE:''' ''We recommend to use PHP 7.2 and higher.''</h4> | ||
Required PHP modules: curl, ftp, gd, intl, mbstring, mysql, opcache (optional),soap, xml, xmlrpc, xsl, zip</h4> | <h4>Required PHP modules: curl, ftp, gd, intl, mbstring, mysql, opcache (optional),soap, xml, xmlrpc, xsl, zip</h4> | ||
'''*** MySQL Server ***''' | <h3>'''*** MySQL Server ***'''</h3> | ||
'''MySQL version 5.6.31, 5.7, 8.0 or MariaDB 10+''' | <h4>'''MySQL version 5.6.31, 5.7, 8.0 or MariaDB 10+'''</h4> | ||
'''*** Web Server ***''' | <h3>'''*** Web Server ***'''</h3> | ||
osCommerce 4 supports '''Apache 2.4''' without extra configuration. osCommerce 4 also supports '''Nginx 1.x''' with additional configuration. | <h4>osCommerce 4 supports '''Apache 2.4''' without extra configuration. osCommerce 4 also supports '''Nginx 1.x''' with additional configuration.</h4> | ||
'''NOTES:''' ''If you are running osCommerce 4 on a Linux server with SELinux, configure it to permit osCommerce 4 activities. If you are not familiar with SELinux, we recommend you to disable it, as osCommerce 4 does not function if it is misconfigured.'' | <h4>'''NOTES:''' ''If you are running osCommerce 4 on a Linux server with SELinux, configure it to permit osCommerce 4 activities. If you are not familiar with SELinux, we recommend you to disable it, as osCommerce 4 does not function if it is misconfigured.''</h4> | ||
'''*** Recommended PHP/MySQL Parameters ***''' | <h3>'''*** Recommended PHP/MySQL Parameters ***'''</h3> | ||
'''PHP''' | <h3>'''PHP'''</h3> | ||
These settings are done in the PHP configuration file php.ini of the server on which you are installing osCommerce 4: | <h4>These settings are done in the PHP configuration file php.ini of the server on which you are installing osCommerce 4:</h4> | ||
'''expose_php = Off''' | <h4>'''expose_php = Off'''</h4> | ||
'''max_execution_time = 600''' | <h4>'''max_execution_time = 600'''</h4> | ||
'''max_input_time = 600''' | <h4>'''max_input_time = 600'''</h4> | ||
'''max_input_vars = 10000''' | <h4>'''max_input_vars = 10000'''</h4> | ||
'''memory_limit = 256M''' | <h4>'''memory_limit = 256M'''</h4> | ||
'''post_max_size = 64M''' | <h4>'''post_max_size = 64M'''</h4> | ||
'''upload_max_filesize = 64M''' | <h4>'''upload_max_filesize = 64M'''</h4> | ||
'''max_file_uploads = 50''' | <h4>'''max_file_uploads = 50'''</h4> | ||
'''session.gc_probability = 1''' | <h4>'''session.gc_probability = 1'''</h4> | ||
'''session.gc_maxlifetime = 14400''' | <h4>'''session.gc_maxlifetime = 14400'''</h4> | ||
'''open_basedir = Off''' | <h4>'''open_basedir = Off'''</h4> | ||
'''Apache 2.4''' | <h3>'''Apache 2.4'''</h3> | ||
If you have ModSecurity installed on your Apache web server, you must either disable it or whitelist your osCommerce files (so they are exempt from all mod_security rules). | <h4>If you have ModSecurity installed on your Apache web server, you must either disable it or whitelist your osCommerce files (so they are exempt from all mod_security rules).</h4> | ||
Also make sure that at least Apache modules headers and rewrite are enabled, and X-Frame-Options header is set as below: | <h4>Also make sure that at least Apache modules headers and rewrite are enabled, and X-Frame-Options header is set as below:</h4> | ||
'''Header set X-Frame-Options: "sameorigin"''' | <h4>'''Header set X-Frame-Options: "sameorigin"'''</h4> | ||
We recommend to enable the following Apache modules: deflate, expires, headers, http2 (optional), rewrite, ssl | <h4>We recommend to enable the following Apache modules: deflate, expires, headers, http2 (optional), rewrite, ssl</h4> | ||
'''MySQL''' | <h3>'''MySQL'''</h3> | ||
Disable MySQL Strict Mode on the Server. Open MySQL/MariaDB configuration file with root privileges and insert the line under the [mysqld] section (if there is no [mysqld] section, create it) | <h4>Disable MySQL Strict Mode on the Server. Open MySQL/MariaDB configuration file with root privileges and insert the line under the [mysqld] section (if there is no [mysqld] section, create it)</h4> | ||
'''[mysqld]sql_mode = ""''' | <h4>'''[mysqld]sql_mode = ""'''</h4> | ||
'''Permissions''' | <h4>'''Permissions'''</h4> | ||
Change owner for Web root folder recursively in accordance which user permissions PHP scripts are running with. | <h4>Change owner for Web root folder recursively in accordance which user permissions PHP scripts are running with.</h4> | ||
By default, www-data | <h4>By default, www-data</h4> | ||
Regarding the server settings see also the article [[Installing osCommerce 4 on Dedicated Server, Cloud Server or VPS]] with the sample settings. | <h4>Regarding the server settings see also the article [[Installing osCommerce 4 on Dedicated Server, Cloud Server or VPS]] with the sample settings.</h4> | ||
'''Upload the installation onto the web server, and unpack it. Ensure you have at least 800 Mb free space. Then open the web server URL in the web browser.''' | <h4>'''Upload the installation onto the web server, and unpack it. Ensure you have at least 800 Mb free space. Then open the web server URL in the web browser.'''</h4> | ||
After reviewing the license agreement click on the '''Accept and Start Installation''' button. | <h4>After reviewing the license agreement click on the '''Accept and Start Installation''' button. | ||
[[File:Image 325.png|none|frame]] | [[File:Image 325.png|none|frame]] | ||
Make sure your website ('''Current''' column) meets the following server requirements ('''Recommended''' and '''Required''' columns) and click on '''Proceed''' button. | Make sure your website ('''Current''' column) meets the following server requirements ('''Recommended''' and '''Required''' columns) and click on '''Proceed''' button. | ||
Line 119: | Line 119: | ||
Pass the '''recaptcha''' and click on '''Complete Installation''' button. | Pass the '''recaptcha''' and click on '''Complete Installation''' button. | ||
[[File:Image 331.png|none|frame]] | [[File:Image 331.png|none|frame]] | ||
The system will redirect you to the same '''front end'''. | The system will redirect you to the same '''front end'''.</h4> | ||
[[File:Image 332.png|none|frame]] | [[File:Image 332.png|none|frame]] | ||
[[Category:Installation]] | [[Category:Installation]] |
Revision as of 17:45, 21 February 2023
no subcategories
Server Configuration and System
Requirements to Install osCommerce 4
Overview
This article describes the required web server configuration and system requirements to install osCommerce 4.
Requirements
*** PHP ***
PHP 7.0 to 8.0 versions are supported by osCommerce 4.
NOTE: We recommend to use PHP 7.2 and higher.
Required PHP modules: curl, ftp, gd, intl, mbstring, mysql, opcache (optional),soap, xml, xmlrpc, xsl, zip
*** MySQL Server ***
MySQL version 5.6.31, 5.7, 8.0 or MariaDB 10+
*** Web Server ***
osCommerce 4 supports Apache 2.4 without extra configuration. osCommerce 4 also supports Nginx 1.x with additional configuration.
NOTES: If you are running osCommerce 4 on a Linux server with SELinux, configure it to permit osCommerce 4 activities. If you are not familiar with SELinux, we recommend you to disable it, as osCommerce 4 does not function if it is misconfigured.
*** Recommended PHP/MySQL Parameters ***
PHP
These settings are done in the PHP configuration file php.ini of the server on which you are installing osCommerce 4:
expose_php = Off
max_execution_time = 600
max_input_time = 600
max_input_vars = 10000
memory_limit = 256M
post_max_size = 64M
upload_max_filesize = 64M
max_file_uploads = 50
session.gc_probability = 1
session.gc_maxlifetime = 14400
open_basedir = Off
Apache 2.4
If you have ModSecurity installed on your Apache web server, you must either disable it or whitelist your osCommerce files (so they are exempt from all mod_security rules).
Also make sure that at least Apache modules headers and rewrite are enabled, and X-Frame-Options header is set as below:
Header set X-Frame-Options: "sameorigin"
We recommend to enable the following Apache modules: deflate, expires, headers, http2 (optional), rewrite, ssl
MySQL
Disable MySQL Strict Mode on the Server. Open MySQL/MariaDB configuration file with root privileges and insert the line under the [mysqld] section (if there is no [mysqld] section, create it)
[mysqld]sql_mode = ""
Permissions
Change owner for Web root folder recursively in accordance which user permissions PHP scripts are running with.
By default, www-data
Regarding the server settings see also the article Installing osCommerce 4 on Dedicated Server, Cloud Server or VPS with the sample settings.