PHP enabled web server

Apache (recommended) – the Bitrix software was developed for Apache 1.3.x. However, the system will successfully run on Apache 2.x.

IIS (Internet Information Server) (also supported) – the system is able to run on IIS 5 and IIS 6. Internet Information Server requires additional setup to fully support Bitrix Site Manager.

Eserv (also supported) – the system was tested for compatibility with Eserv.

PHP

Bitrix Site Manager requires PHP version 5.0. or higher. It is recommended that you use the latest stable release of PHP to prevent PHP failures and to provide the maximum security at the server side.

The following PHP extensions are required:

• GD – image handling library. Required for building graphs and charts which is essential for the Statistics, Advertising and Helpdesk modules. The library is also used with CAPTCHA.
• PHP XML – used by the update system. This library is inluded in the standard installation package of PHP. The Windows version of PHP has a built-in XML support.
• FreeType – required for the correct functioning of CAPTCHA.
• Regular Expression support (POSIX and Perl compatible) – the system requires the regular expression support at the core level.
• Zlib compression – the compression library is required by the Compression module and the update system to decrease the amount of transferred data.

Database server support

MySQL

Since the version 5.0, the system requires the MySQL version at least 4.1.11 or higher. MySQL 5 is supported starting from the system version 4.1.6. However, certain fixes has been made later, in versions 5.0.

To support MySQL, the system requires the MySQL support for PHP to be installed.

Oracle and Oracle XE

The system is shipped with full support for the Oracle database engines. The system requires Oracle 10g or higher (or a stable release of Oracle XE) to be installed.

At the installation time, the system does not check the Oracle database engine edition (i.e. whether a full edition is installed, or XE). However, this check is performed at the update system run time. If the Oracle version on which the system runs does not match your license key, the update system will be disabled.

To fully support Oracle, your installation of PHP must include the appropriate support library. This means that the following extension is to be installed: php_oci8.dll.

MSSQL and MSSQL Express Edition

The system is shipped with full support for the MSSQL database engines. The system requires MSSQL 9.0 (2005) or higher (or MSSQL 2005 XE) to be installed.

At the installation time, the system does not check the MSSQL database engine edition (i.e. whether a full edition is installed, or Express Edition). However, this check is performed at the update system run time. If the MSSQL version on which the system runs does not match your license key, the update system will be disabled.

Web server configuration

For proper functioning, Bitrix Site Manager requires the following parameters to be set.

PHP settings

The following PHP parameters are essential.

1. memory_limit = 64M;

   Maximum amount of PHP memory required by the system core.

   Note: this parameter can be changed:

   • by editing the file php.ini directly;
   • from within a script by calling ini_set("memory_limit", "64M");
     This call is added to /bitrix/php_interface/dbconn.php at the installation time using the user-supplied value;
   • in the file .htaccess using the directive: php_value memory_limit 64M
   • in the file httpd.conf using the directive: php_admin_value memory_limit 64M
   Note: parameters can be altered from within the .htaccess file if the following conditions are met:

   • Apache (or compatible) web server is used;
   • .htaccess files are processed by a web server, which means that the web server configuration file (httpd.conf) contains the directive AllowOverride set to All or any value other than None;
   • PHP is installed as an Apache module (if PHP runs as CGI all the required parameters must be set when compiling PHP)

2. file_uploads = On;
   The parameter defines whether files can be uploaded to a server or not.

   Additionally, the following variables are also to be set:

   • upload_tmp_dir = <folder name>
   • upload_max_filesize = <required file size limit>
   Important! It is essential that the specified directory exists, and a current user (under which the web server runs) is granted the write permissions for this folder.

3. Proper PHP session handling is the indispensable condition. You are recommended to check that the folder where the session files are saved exists.

   Note: if the parameter session.save_path is missing from php.ini, the default value of /tmp is used.

   If the server URL's happen to contain the PHPSESSID=... parameter, you hide it as follows:

   • Add the line session.use_trans_sid = 0 to php.ini;
   • In .htaccess, add the following directive: php_flag session.use_trans_sid off
     The demo site has this line included in .htaccess, you can uncomment it if required.