Refresh Software Documentation » Selene Directory » Server Requirements

Selene Directory is written in PHP, uses a MySQL database and will run on any OS that both PHP and MySQL are available for. Selene Directory is developed and tested with Windows(IIS), Linux(Apache) and Mac(Apache) Operating Systems.

Important: The following information addresses many commonly asked questions related to hosting Selene Directory, however, this document is not exhaustive. If you have a question that is not addressed by the information below, or if you have questions about a specific aspect of your unique hosting service/server, please contact us to discuss hosting Selene Directory in further detail.

Contents

Minimum Versions

Required

Supported

  • PHP (5.2.17+)
  • MySQL (5.1.x+)

Recommended

  • PHP (5.3.x+)
  • MySQL (5.5.x+)

What's the Difference?

  • Required - Minimum for Selene Directory to function.
  • Supported - Oldest version currently eligible for support.
  • Recommended - Recommended for the best experience.

PHP

PHP 4, 5.0 & 5.1

Selene Directory will not work on these older versions of PHP and Refresh does not support them.

PHP 5.2

The PHP Group ended support for version 5.2 in July 2010 with the release of 5.2.14. To facilitate the transition to 5.3 Refresh has extended support for this platform (just as we did with PHP4).

While we currently provide support for PHP 5.2 a phase out date for this support is pending. Use of PHP 5.2 is not recommended.

PHP 5.3

Beginning with version 2.0 Selene Directory offers full support for PHP 5.3 and does not make use of any features deprecated in this release.

PHP 5.4

Beginning with version 2.0 Selene Directory offers full support for PHP 5.4 and does not make use of any features removed or deprecated in this release.

Additional Resources

MySQL

Until version 2.0 Selene Directory did not support MySQL running in ONLY_FULL_GROUP_BY mode. Users requiring support for this MySQL configuration should upgrade to version 2.0 (or newer).

MySQL 4.0, 4.1

Selene Directory will not work on these older versions of MySQL and Refresh does not support them.

MySQL 5.0

Support for this version of MySQL has been discontinued. While there are currently no known performance issues on this platform it's use is not recommended.

MySQL 5.1 & 5.5

Both versions are currently supported.

MySQL 5.6

This version is currently in development and Refresh does not support it yet. When support for this version is available this documentation will be updated.

Additional Resources

PHP & Hosting Settings/Requirements

Required

  • fsockopen & Internet Connection - If fsockopen is disabled, or your server is not connected to the internet (or it's outgoing connection is restricted by a firewall), Selene will not install or upgrade successfully.
  • Directory Permissions - Selene Directory requires the ability to write files to a limited number of directories for caching & image upload. Without the ability to write these files Selene Directory will not function. Contact your web host support or system administrator to confirm PHP write privileges in your environment and to discuss the best practice for configuring PHP application write access on your server.

Recommended

  • GD Graphics Library - Selene' native CAPTCHA image creation and newsletter tracking image require support for the GD Graphics Library. If the library is not available you will have the option to use the reCAPTCHA API for CAPTCHA functionality but tracking newsletters read by subscribers will not function correctly.

Unnecessary

  • register_globals - Selene Directory has no dependence on register_globals. It may remain in it's default "off" setting. (Note: This has been deprecated in PHP 5.3 and removed as of 5.4.)
  • short_open_tag - Selene Directory offers full support for the default PHP5 setting of short_open_tag = off.

Sending Email

Selene Directory supports authenticated & secure SMTP server connections. Email settings can be configured, and tested, within the admin console Preferences

Timezone Configuration

In some instances, dependent on PHP install configuration, users may see an error similar to:

date() [function.date]: It is not safe to rely on the system's timezone settings.

This error requires Selene Directory users to:

  1. Identify their timezone. (List of PHP Timezones.)
  2. Add the following code to their config.php file.
ini_set('date.timezone','Your_Timezone');

Where Your_Timezone is the PHP supported timezone setting appropriate for your timezone.

Session Save Path Configuration

Some hosts require users to configure PHP applications to write session data to a temporary directory assigned to their hosting account. This process requires Selene Directory users to:

  1. Identify their temporary directory path
  2. Add the following code into their config.php file.

To make this change add the following code to your Selene Directory's /inc/config.php file.

session_save_path("YOUR_HOME_DIRECTORY_PATH/cgi-bin/tmp");

Note: Insert the above code, updated for your unique server path, to your config.php file below line 11.

Finding YOUR_HOME_DIRECTORY_PATH

If you are unsure what your home directory path is please contact your hosting support or system administrator and they will be able to assist you further.

Confirmed Hosts That Require Session Save Path Configuration

BizLand
FatCow
iPage
iPower
StartLogic

Hosting Provider Specific Notes

Fasthosts Hosting Customers

It has been brought to Refresh's attention that under the Windows hosting service offered by Fasthosts they do not permit users to allow write access to directories for hosted apps. As a result Selene Directory will not work with Fasthosts Windows hosting service.

Please reference this knowledge base article for more information.

GoDaddy Hosting Customers

Selene Directory users have experienced anomalies with GoDaddy's PHP & MySQL configuration on their Windows Hosting Packages. GoDaddy hosting customers should use their Linux Hosting Package to host Selene, all reported issues related to GoDaddy hosting have been resolved by switching.

BizLand, FatCow, iPage, iPower and StartLogic Customers

Please see the note above about Session Save Path Configuration

Website Building Services

Selene Directory is not compatible with hosted "build a website" services. Because these services only allow users to manipulate simple HTML content within a predefined framework and not upload custom files or site components (specifically: PHP applications) Selene Directory will not work with these services.

It may be possible for you to utilize a subdomain to host Selene Directory outside of these types of services, however, you should speak with your system administrator or service support to discuss this in detail and confirm what types of deployment your existing service(s) support, what configuration options are available and what additional services (if any) are required to achieve your unique deployment goals.

Incompatible Services

The following list is not exhaustive, if you are uncertain about the compatibility of your website or hosting please contact us with questions.

  • Blogger (and Google Sites)
  • Homestead (and Intuit branded variations: Intuit Websites, Intuit Website Builder, etc.)
  • Moonfruit
  • Ning
  • Squarespace
  • Viviti
  • Webs (Formerly Freewebs)
  • Weebly
  • Wix

Server Level Support

For your safety and ours, Refresh does not provide server level assistance as part of our software support services. If you have questions about any aspect of your server or hosting service (including, but not limited to: DNS or server configurations, installing or configuring PHP & MySQL, etc.) you should contact your web host support, system administrator or internal IT support staff.