X-Payments:System requirements for X-Payments 3 - Revision history

Dohtur at 07:17, 18 January 2022

2022-01-18T07:17:11Z

Dohtur: /* PHP configuration */

2019-02-01T10:48:35Z

‎PHP configuration

Dohtur at 16:37, 26 September 2018

2018-09-26T16:37:33Z

Dohtur: /* PHP configuration */

2018-04-23T14:10:30Z

‎PHP configuration

Dohtur: /* PHP configuration */

2017-06-30T10:01:33Z

‎PHP configuration

Dohtur: /* PHP configuration */

2017-06-30T09:38:03Z

‎PHP configuration

Dohtur: /* Operating system */

2017-05-04T10:00:33Z

‎Operating system

Alex “Ambal” Mulin: /* PHP configuration */

2016-10-21T13:07:06Z

‎PHP configuration

Dohtur: /* PHP configuration */

2016-06-09T13:56:11Z

‎PHP configuration

Dohtur: Created page with "{{XP_manual_TOC}} For hassle-free installation and performance of X-Payments, your server must meet the following requirements:
==Operating syst..."

2016-06-09T07:41:11Z

Created page with "<noinclude>{{XP_manual_TOC}}</noinclude> For hassle-free installation and performance of X-Payments, your server must meet the following requirements: ==Operating syst..."

New page

<noinclude>{{XP_manual_TOC}}</noinclude>

For hassle-free installation and performance of X-Payments, your server must meet the following requirements:
 
==Operating system==
A Unix-based operating system (Linux, FreeBSD, etc)
 
==PHP configuration==

'''PHP version:'''

: PHP v 5.5.30 or later (versions 7.0.3 or later are recommended)
: [[X-Payments:FAQ#Can_you_tell_me_exactly_what_it_is_in_v5.3.0_that.27s_so_necessary_for_X-Payments.3F|Why PHP 5.3 or later?]]

'''php.ini settings:'''

:Mandatory:

:* safe_mode = off;
:* magic_quotes_sybase = off;
:* sql.safe_mode = off;
:* ini_set = on;
:* memory_limit >= 16M;

:Recommended:

:* disable_functions = NULL
:* max_execution_time >= 30;
:* memory_limit >= 32M;
:* max_input_time >= 30;
:* sendmail_from = username@example.com; (An email address that service email messages will be sent from)
:* precision = 14 (the default value set in the php.ini file).

'''PHP extensions:'''

:* PCRE;
:* HASH;
:* PDO with the MySQL driver;
:::'''''Important note about PDO extension:''''' X-Payments requires the PDO extension, as well as the MySQL PDO driver, to be installed as a shared module. In other words your php.ini file needs to be updated so that the PDO extensions will be loaded automatically when PHP runs: 
::::extension=php_pdo.so 
::::extension=php_pdo_mysql.so 
:::X-Payments will not install if you use a different PHP configuration (i.e. when PHP is compiled with the necessary PDO extensions like '--enable-pdo=shared' and '--with-pdo-mysql=shared'). In this case, please change the configuration as advised above (install both extensions as a shared module).
:::See also: http://php.net/manual/en/pdo.installation.php
:* mcrypt (To encrypt general data through the AES encryption algorithm);
:* XML DOM (To parse XML data);
:* cURL (To send secure HTTPS requests; cURL version 7.39.0 or better is recommended);
:* OpenSSL (To encrypt cardholder's data and API requests);
:* SOAP (Required for the Firstdata e4 payment gateway).
'''Miscellaneous:'''
:* The crontab on the server where X-Payments is installed must be configured to periodically run the script cron.php (needed for data cleaning tasks and subscriptions). For more info, see [[X-Payments:Installation#XPCronPhp|Running the cron.php script]].
:* Use SMTP server (with SMTP Authentication option enabled) instead the PHP function mail() to send email;
:* Allow the PHP function fsockopen to ensure correct performance of SMTP mailer.

{{Note|If you need detailed help on PHP configuration settings, please refer to http://www.php.net .}}
 

==MySQL configuration==

'''MySQL version:'''

:* MySQL versions 5.6 or later (5.7 is recommended).

'''MySQL user privileges:'''

:Basic level privileges

:* select_priv;
:* insert_priv;
:* update_priv;
:* delete_priv;
:* lock_tables_priv;
:* index_priv;

:Privileges for the software installation and upgrade

:* create_priv;
:* drop_priv;
:* alter_priv.

'''MySQL user limitations:'''

:* MAX_QUESTIONS - no limitations;
:* MAX_UPDATES - no limitations;
:* MAX_QUERIES_PER_HOUR - no limitations;
:* MAX_USER_CONNECTIONS - no limitations.
:* max_allowed_packet - from 8 MB to 16 MB (recommended);
:* wait_timeout - from 7200 to 28800 (recommended).

'''InnoDB:'''
:* Must be enabled. Make sure there is no "skip-innodb" in my.cnf.
 
==Apache configuration==

Apache is the recommended web server for X-Payments. The settings described below refer to Apache only.

'''Distributed configuration file:'''

:* AccessFileName .htaccess; (The filename must always be .htaccess);
:* AllowOverride = ALL; (You must have sufficient permissions to change the settings of the web directory through the .htaccess file).

'''PHP running mode:'''

:If PHP interpreter is compiled as CGI, it must have the --enable-force-cgi-redirect option (without --enable-discard-path) enabled. This allows you to avoid the trouble with setting 755 permissions on PHP scripts and registering #!/usr/bin/php.

'''Apache modules:'''

:Mandatory

:* mod_dir; (For correct operation of DirectoryIndex)
:* mod_access; (For correct operation of Deny From All and Allow From All)
:* mod_auth; (For correct HTTP authentication)

:Recommended

:* mod_expires; (To setup file caching)
:* mod_gzip / mod_deflate. (For page compression)
 
==HTTPS settings==

HTTPS must be enabled.
 
==Secure Shell access==

For some operations, you will need to have secure shell access to the server where X-Payments is installed. These operations include:

:* [[X-Payments:Codebook_regeneration|Codebook regeneration]]
:* [[X-Payments:User_manual#Managing_PIN-codes|PIN-codes generation]]

If shell access is not allowed, the necessary actions can be performed with the help of the PHP shell_exec() function. You'll need to create a script shell.php like the following:

<pre>
<?php

$cmd = 'SHELL COMMAND';

echo shell_exec $cmd . '2>&1';

?>
</pre>
(Be sure to replace SHELL COMMAND with the actual command that needs to be executed).

Upload this script onto the server where X-Payments is installed and allow it in the <xp-dir>/.htaccess file by adding the following lines:

<pre>
<Files ~ "shell.php">
Order deny,allow
Allow from all
</Files>
</pre>

Then open this file in the web browser.

{{Note1|'''Important''': Right after the operation has been completed, remove the shell.php file and restore the original <xp-dir>/.htaccess file.}}
 

==System parameters==

'''Network settings:'''

:* X-Payments must use the IPv4 protocol;
:* Outgoing TCP connections must be opened to ports 25, 80 and 443;
:* External domains must be allowed at both system and PHP levels, that is the PHP functions gethostbyaddr and gethostbyname must work without any limitations;
:* Domains hosted on a localhost server must be resolved to an external IP address if the server is behind NAT.

'''Disk space:'''

:* 15 MB for a fresh application installation;
:* From 5 MB for the database. Exact amount of disk space required for the database depends on the number of transactions.
 
==Shopping cart software==

Your shopping cart software must support [[X-Payments:API]]. This can be achieved by installing an appropriate X-Payments connector. 
More info about the connectors is available here: 
{{XP_connector_manuals}}
<noinclude>{{pdf_single}}</noinclude>

[[Category:X-Payments User Manual]]

@@ Line 11: / Line 11: @@
 '''PHP version:'''
-: PHP 7.1.x or PHP 7.2.x (For security reasons, the latest PHP version in the branch is required.)
+: PHP 7.4.x is recommended.
 '''php.ini settings:'''

@@ Line 11: / Line 11: @@
 '''PHP version:'''
-: PHP v 5.6.34, 7.0.29, 7.1.15, 7.2.3 (or newer versions in the same branches)
+: PHP 7.1.x or PHP 7.2.x (For security reasons, the latest PHP version in the branch is required.)
 '''php.ini settings:'''

@@ Line 61: / Line 61: @@
 :* standard;
 :* xmlwriter;
 :* mcrypt (Required only if upgrading X-Payments from a 3.0.x version; not needed if installing X-Payments version 3.1.0 or later. In 3.1.0 mcrypt has been replaced with openssl).

@@ Line 61: / Line 61: @@
 :* standard;
 :* xmlwriter;
-:* mcrypt (To encrypt general data through the AES encryption algorithm). Required if upgrading X-Payments from a 3.0.x version; not needed if installing X-Payments version 3.1.0 or later (In 3.1.0 mcrypt has been replaced with openssl).
+:* mcrypt (Required only if upgrading X-Payments from a 3.0.x version; not needed if installing X-Payments version 3.1.0 or later. In 3.1.0 mcrypt has been replaced with openssl).

@@ Line 34: / Line 34: @@
 '''PHP extensions:'''
 :* PCRE;
 :* HASH;
@@ Line 43: / Line 42: @@
 :::X-Payments will not install if you use a different PHP configuration (i.e. when PHP is compiled with the necessary PDO extensions like '--enable-pdo=shared' and '--with-pdo-mysql=shared'). In this case, please change the configuration as advised above (install both extensions as a shared module).
 :::See also: http://php.net/manual/en/pdo.installation.php
 :* XML DOM (To parse XML data);
 :* cURL (To send secure HTTPS requests; cURL version 7.39.0 or better is recommended);
@@ Line 59: / Line 57: @@
 :* libxml;
 :* mbstring;
 :* posix;
 :* spl;
 :* standard;
-:* xmlwriter.
+:* xmlwriter;

@@ Line 4: / Line 4: @@
 <br />
 ==Operating system==
-A Unix-based operating system (Linux, FreeBSD, etc)
+A Unix-like operating system (Linux, FreeBSD, etc)
 <br />
 ==PHP configuration==

@@ Line 33: / Line 33: @@
 '''PHP extensions:'''
 :* PCRE;
 :* HASH;
@@ Line 45: / Line 46: @@
 :* cURL (To send secure HTTPS requests; cURL version 7.39.0 or better is recommended);
 :* OpenSSL (To encrypt cardholder's data and API requests);
-:* SOAP (Required for the Firstdata e4 payment gateway).
+:* SOAP (Required for the Firstdata e4 payment gateway);
 '''Miscellaneous:'''
 :* The crontab on the server where X-Payments is installed must be configured to periodically run the script cron.php (needed for data cleaning tasks and subscriptions). For more info, see [[X-Payments:Installation#XPCronPhp|Running the cron.php script]].

← Older revision		Revision as of 13:56, 9 June 2016
Line 11:		Line 11:

	: PHP v 5.5.30 or later (versions 7.0.3 or later are recommended)		: PHP v 5.5.30 or later (versions 7.0.3 or later are recommended)
−	~~: [[X-Payments:FAQ#Can_you_tell_me_exactly_what_it_is_in_v5.3.0_that.27s_so_necessary_for_X-Payments.3F\|Why PHP 5.3 or later?]]~~

	'''php.ini settings:'''		'''php.ini settings:'''

X-Payments:System requirements for X-Payments 3 - Revision history

Dohtur at 07:17, 18 January 2022

Dohtur: /* PHP configuration */

Dohtur at 16:37, 26 September 2018

Dohtur: /* PHP configuration */

Dohtur: /* PHP configuration */

Dohtur: /* PHP configuration */

Dohtur: /* Operating system */

Alex “Ambal” Mulin: /* PHP configuration */

Dohtur: /* PHP configuration */

Dohtur: Created page with "{{XP_manual_TOC}} For hassle-free installation and performance of X-Payments, your server must meet the following requirements: ==Operating syst..."

Dohtur: Created page with "{{XP_manual_TOC}} For hassle-free installation and performance of X-Payments, your server must meet the following requirements:
==Operating syst..."