Go to file
2016-01-01 04:02:20 +13:00
_config API Upgraded module to use new database ORM 2014-07-11 09:46:32 +12:00
code Converted to PSR-2 2015-12-18 07:50:59 +13:00
tests Converted to PSR-2 2015-12-18 07:50:59 +13:00
_config.php MINOR Removed whitespace from _config 2010-05-13 12:26:07 +00:00
_register_database.php API Upgraded module to use new database ORM 2014-07-11 09:46:32 +12:00
.appveyor.yml FIX: Fix errors in Appveyor config 2015-08-12 14:03:47 +12:00
.editorconfig Added standard .editorconfig file 2015-12-17 10:22:29 +13:00
.scrutinizer.yml Added basic scrutinizer config. 2015-08-12 14:09:32 +12:00
.travis.yml Added standard Travis config 2016-01-01 04:02:20 +13:00
composer.json Add composer hints to let 'composer install' run on module. 2015-08-12 11:16:31 +12:00
README.md Add AppVeyor build status badge 2015-08-12 11:13:05 +12:00

SQL Server Database Module

Allows SilverStripe to use SQL Server databases.

Build status

Maintainer Contact

  • Sean Harvey (Nickname: halkyon) <sean (at) silverstripe (dot) com>

Requirements

  • SilverStripe 3.0+
  • SQL Server 2008, 2008 R2, or 2012.

*nix

  • PHP with mssql extension and FreeTDS

Windows

Note: SQL Server Express can also be used which is provided free by Microsoft. However, it has limitations such as 10GB maximum database storage.

Installation

These steps will install the latest SilverStripe stable, along with this module using Composer:

  • Install SilverStripe: composer create-project silverstripe/installer /my/website/folder
  • Install module: cd /my/website/folder && composer require silverstripe/mssql "*"
  • Open the SilverStripe installer by browsing to install.php, e.g. http://localhost/silverstripe/install.php
  • Select SQL Server 2008+ in the database list and enter your SQL Server database details

Troubleshooting

Q: SQL Server resides on a remote host (a different machine) and I can't connect to it from mine.

A: Please ensure you have enabled TCP access using SQL Server Configuration Manager and opened firewall ports.

Q: I just installed SQL Server, but it says that it cannot connect

A: Sometimes SQL Server will be installed as a non-default instance name, e.g. "SQLExpress" instead of "MSSQLSERVER" (the default.) If this is the case, you'll need to declare the instance name when setting the server in your PHP database configuration. For example: (local)\SQLExpress. The first part before the slash indicates the server host, or IP address. In this case, (local) indicates localhost, which is the same server PHP is running on. The second part is the SQL Server instance name to connect to.

Q: I'm getting unicode SQL Server errors connecting to SQL Server database (e.g. Unicode data in a Unicode-only collation or ntext data cannot be sent to clients using DB-Library (such as ISQL) or ODBC version 3.7 or earlier)

A: If you are using FreeTDS make sure you're using TDS version 8.0 in freetds.conf. If on Windows, ensure you use the SQL Server Driver for PHP and NOT the mssql drivers provided by PHP.

Q: Using FreeTDS I can't connect to my SQL Server database. An error in PHP says the server doesn't exist

A: Make sure you've got an entry in /etc/freetds/freetds.conf that points to your server. For example:

[myserver]
	host = myserver.mydomain.com
	port = 1433
	tds version = 8.0

Then you can use "myserver" (the bit in square brackets above) as the server name when connecting to the database. Note that if you're running Macports, the file is located in /opt/local/etc/freetds/freetds.conf.

Alternatively, if you don't want to keep adding more entries to the freetds.conf to nominate more SQL Server locations, you can instead use the full the host/ip and port combination, such as "myserver:1433" (1433 being the default SQL Server port.) and ensure the "tds version = 8.0" is set globally in the freetds.conf file.

Note: Use tabs not spaces when editing freetds.conf, otherwise it will not load the configuration you have specified!

Note: Certain distributions of Linux use SELinux which could block access to your SQL Server database. A rule may need to be added to allow this traffic through.