Updated master branch with 4.1.7-preview release (#325)

* fixed Github #182, empty bound output parameters

* Fixing the issue with buffered result sets, when connection option is set to utf8. See issue #192

* removing new lines

* Replcaing SQLSRV_ENCODING ( CP_UTF8) with SQLSRV_ENCODING_UTF8

* Replcaing SQLSRV_ENCODING ( CP_UTF8) with SQLSRV_ENCODING_UTF8

* fixed tab and spacing

* updated the code structure

* deleted pdo_sqlsrv obsolete folder

* Updated pdo driver source code path

* added pdo shared folder

* updated sqlsrv and pdo_sqlsrv config.w32 to get the dir name dynamically

* deleted shared folder inside pdo

* Initial AppVeyor CI test build.

* Remove AppVeyor whitelist for testing.

* Fix source file path.

* Update pdo_util.cpp

* changed tab to spaces

* fixed indentations

* fixed indentations

* moved templates to driver folder

* Enable build matrix for different SQL Server versions.

* fixed the limit for row count

* fix #173, #138 on Windows code

* fixed indentations

* revert core_results to 365220a

* Readme and Change updates for Windows release.

* Fix table rendering.

* Readme and Change updates for Windows release.

* Update change log.

* Readme and Change updates for Windows release.

* Remove Linux section.

* merged Linux to CPP files

* merged Linux to php_sqlsrv.h

* Merged Linux and Windows PDO_SQLSRV code

* merged core_conn from linux to Windows

* modified based on reviews

* updated to version 4.1.5

* fixed indentations

* updated the date to Jan 19

* updated core_init

* Small ifdef fix

* Spacing fixes

* Commented code removed

* fixed preprocessor directives

* merged core_stmt from Linux

* merged conversion functions in core_sqlsrv and core_util

* config.m4

* Capitalised win32

* Commented code removed

* merged core_sqlsrv.h

* merged core_stream

* merged core_results

* added Linux specific files

* added Linux specific files

* removed windows header

* removed header files included in core_sqlv from xplat

* Issue 228. Don't allow 0 for sqlsrv ClientBufferMaxKBSize.

Add new tests for sqlsrv and pdo.

* Issue 37. sqlsrv_has_rows does not fetch if already true.

Change sqlsrv_has_rows to not scroll if already true
when using forward only cursor.

* gaurded strsafe header

* Update pdo_dbh.cpp

* Update pdo_stmt.cpp

* Update pdo_init.cpp

* Update pdo_parser.cpp

* Remove comment line from test.

* Update test comments.

* Add Description section to phpt test.

* fixed included headers order

* fixed indentations and spacing

* fixed indentations on core_results

* fixed indentations on rowCount

* fixed indentations in updated code

* fixed indentations

* fixed indentations

* bumped version to windows version

* made the ifdef consitent

* fixed L166 indentations

* bumped version to 4.1

* bumped up the version to 4.1

* bumped up the version to 4.1

* updated to version 4.1

* updated version to 4.1

* Added config.m4

* Added build directory

* fixed closing } dropped indentations

* fixed core_conn

* renamed header files with the same name as windows headers

* renamed <intsafe> in xplat.h to xplat_intsafe

* safeguard get_col_meta

* edited included headers

* fixed invalid user pass issue in core_conn

* added TravisCI to merged-code branch

* updated renamed header

* removed comments

* updated travis docker with latest from linux branch

* applied peer review comments

* added packagize.sh

* fixed get_processor_arch comparisons

* removed unused sqlsrv_zend_hash_add

* Update srv_075_database_wide_string.phpt

* Update srv_075_database.phpt

* Update srv_074_database.phpt

* Update srv_074_database_wide_string.phpt

* Update srv_073_database.phpt

* Merge remaining PHP-7.0-Linux changes into merged codebase.

* Change $sample calculation to avoid conversion to float.

* Change FORMAT SQL to CAST as SQL 2008 does not support FORMAT.

* modified ifdef __linux__

* Update srv_037_transaction_rollback.phpt

* Tab/indentation fixes.

* replace __linux__ with _WIN32 define.

* Update Readme and Changelog for merged code.

* Add re2c and gcc to readme steps.

* Update version.h

* removed inconsistent code calling convert_string_from_utf16

* corrected comment

* Change branch links to dev in README

* Test: Bind values with PDO::PARAM_BOOL

* Update pdo_023.phpt

* Update README.md

Add unixODBC 2.3.1 limitation for connection pooling with PDO.

* define SQL_GUID for PECL

* check if constant defined first

* In closeCursor check if statement has been executed before moving to next result.

* Change tab to spaces.

* Fix for issue 223

* added a test

* Modified the test 

to make it more robust

* Fix error message in close cursor. Change prepare to query in test.

* Fix and tests for issue #69

* fix formatting

* Fix issue #35

* add a simple test case with an input file

* simplified the test without image input

* Fix clang compile errors.

* Update README.md

* Add check for SQL_NO_TOTAL for SQLBindParameter out parameter.

* Update PHPT comment.

* Update PHPT comment and script.

* calculate field size instead of using column size and fixed the parameter encoding

* Remove uchar.h usage from buffered results.

* fix PHP7.1 debug abort error

* Add buffered sqlsrv test.

* use static cast for SQLSRV_ENCODING

* Update phpt comment.

* fixed issue #270

* test fetch binary

* added autonomous setup to test

* caps description

* Modify string_to_number utf8 conversion.

* Added survey

* fixed indentation and typo

* fixed indentations

* Changed db to tempdb and random table name

* fixed string quotes and free stmt

* fixed comment

* Change errno check to ERROR_SUCCESS

* Fix baseline for #297 changes.

* batch 1

* batch 2

* Fix memory leaks in buffered resultsets.

* batch 3

* modified tests based on review

* Added SELinux note for RedHat

* Issue #308

* Fix spacing

* Use a simpler way

* String release first

* String release first

* Modified based on review

* Modified note

* added a sqlsrv test, a variant

* Update srv_308_empty_output_param.phpt

* Update README.md

* appveyor.yml now outputs details of failing tests

* updated versioning to semantic versioning #282

* Update README.md

* changed locale for mac

* added client info tests

* added versioning notes

* updated precedence order example

* added 4.1.7 to changedlog

* updated PECL package version

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* part 1 with utf8 data

* MAC OS X announcement

* part 2 testing diff API

* part 3 testing rowCount

* part 4 fetching various types

* part 5 new sqlsrv tests

* removed redundant tests

* fixed some tests

* modified a failing test

* one more test

* Mac instructions (#319)

* Initial Mac instructions

* Add pecl install for mac

* Changing instructions for loading the drivers

* Updating apache install intructions for MAC

* Adding Mac related notes

* Minor cleanup

* appveyor.yml now outputs details of failing tests

* updated versioning to semantic versioning #282

* Update README.md

* changed locale for mac

* added client info tests

* added versioning notes

* updated precedence order example

* added 4.1.7 to changedlog

* updated PECL package version

* Update CHANGELOG.md

* Update CHANGELOG.md

* Update CHANGELOG.md

* MAC OS X announcement

* Updating Mac Apache Instructions. Also removing the step of manually adding drivers to the ini file.

* Adding php7.1-xml installation

* Apache config for Mac

* Fixing Apache config

* Update PECL instructions

* Fixed headers formatting

CHANGELOG.md

@@ -3,6 +3,37 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/) 
 
+## Windows/Linux/MAC 4.1.7-preview - 2017-03-07
+Updated PECL release packages. Here is the list of updates:
+### Added
+- The early technical preview (ETP) for SQLSRV and PDO_SQLSRV drivers for MAC with basic functionalities is now available. Both drivers has been built and tested on MAC OS version El Capitan (OS X 10.11).
+
+### Fixed
+#### SQLSRV and PDO_SQLSRV
+- Fixed null returned when an empty string is set to an output parameter ([issue #308](https://github.com/Microsoft/msphpsql/issues/308)).
+- Fixed memory leaks in buffered result sets.
+- Fixed clang compile errors.
+
+#### SQLSRV only
+- Fixed debug abort error when building the driver in debug mode with PHP 7.1.
+- Fixed string truncation when binding varchar(max), nvarchar(max), varbinary(max), and xml types ([issue #231](https://github.com/Microsoft/msphpsql/issues/231)).
+- Fixed fatal error when fetching empty nvarchar ([issue #69](https://github.com/Microsoft/msphpsql/issues/69)).
+- Fixed fatal error when calling sqlsrv_fetch() with an out of bound offset for SQLSRV_SCROLL_ABSOLUTE ([issue #223](https://github.com/Microsoft/msphpsql/issues/223)).
+
+#### PDO_SQLSRV only
+- Fixed wrong value returned when fetching varbinary value on Linux ([issue #270](https://github.com/Microsoft/msphpsql/issues/270)).
+- Fixed binary data not returned when the column is bound by name ([issue #35](https://github.com/Microsoft/msphpsql/issues/35)).
+- Fixed exception thrown on closeCursor() when the statement has not been executed ([issue #267](https://github.com/Microsoft/msphpsql/issues/267)).
+
+### Known Issues
+- User defined data types and SQL_VARIANT ([issue #127](https://github.com/Microsoft/msphpsql/issues/127)).
+- Binary column binding with emulate prepare ([issue #140](https://github.com/Microsoft/msphpsql/issues/140)).
+- Segmentation fault may result when an unsupported attribute is used for connection.
+
+#### MAC only
+- If loading both sqlsrv and pdo_sqlsrv, the order matters (even when dynamically). For PDO_SQLSRV scripts, load pdo_sqlsrv.so first. For SQLSRV scripts, load sqlsrv.so first.
+- Connection pooling not working.
+
 ## Windows/Linux 4.1.6 - 2017-02-03
 Updated PECL release packages. Here is the list of updates:
 ### Added
@@ -61,7 +92,7 @@ Linux drivers compiled with PHP 7.0.13 are available for Ubuntu 15.04, Ubuntu 16
 
 ### Changed
 - Code structure is updated to facilitate the development; shared codes between both drivers are moved to "shared" folder to avoid code duplication issues in development. To build the driver from source, use "packagize" script as follows:
-	 - if you are using the phpize, clone or download the “source”, run the script within the “source” directory and then run phpize.
+	 - if you are using the phpize, clone or download the “source”, run the script within the “source” directory and then run phpize.
 	 - if you are building the driver from source using PHP source, give the path to the PHP source to the script. 
 
 ### Fixed

README.md

@@ -8,14 +8,14 @@ This release contains the SQLSRV and PDO_SQLSRV drivers for PHP 7 with improveme
 
 SQL Server Team
 
-##Take our survey
+
+## Take our survey
 
 Thank you for taking time to take our Febraury survey. Let us know how we are doing and how you use PHP by taking our March pulse survey:
 
 <a href="https://www.surveymonkey.com/r/YDFJ23X"><img style="float: right;"  height="67" width="156" src="https://meetsstorenew.blob.core.windows.net/contianerhd/survey.png?st=2017-02-17T22%3A03%3A00Z&se=2100-02-18T22%3A03%3A00Z&sp=rl&sv=2015-12-11&sr=b&sig=DJSFoihBptSvO%2BjvWzwpHecf8o5yfAbJoD2qW5oB8tc%3D"></a>
 
-
-###Status of Most Recent Builds
+### Status of Most Recent Builds
 | AppVeyor (Windows)      |Travis CI (Linux) |        Coverage Status  
 |-------------------------|--------------------------| ------------------
 | [![av-image][]][av-site]| [![tv-image][]][tv-site] |[![Coverage Status][]][coveralls-site]
@@ -27,16 +27,17 @@ Thank you for taking time to take our Febraury survey. Let us know how we are do
 [Coverage Status]: https://coveralls.io/repos/github/Microsoft/msphpsql/badge.svg?branch=dev
 [coveralls-site]: https://coveralls.io/github/Microsoft/msphpsql?branch=dev
 
-##Get Started
+## Get Started
 
 * [**Ubuntu + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-ubuntu)
 * [**RedHat + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-rhel)
 * [**Windows + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-windows)
 * [**Docker**](https://hub.docker.com/r/lbosqmsft/mssql-php-msphpsql/)
 
-##Announcements
 
-**December 19, 2016**: We are delighted announce that production release for PHP Linux Driver for SQL Server is available. PECL packages (4.0.8) are updated with the latest changes, and Linux binaries (4.0.8) compiled with PHP 7.0.14 are available for Ubuntu 15.04, Ubuntu 16.04, and RedHat 7.2. For complete list of changes please visit [CHANGELOG](https://github.com/Microsoft/msphpsql/blob/dev/CHANGELOG.md) file.
+## Announcements
+
+**March 7, 2017**: We are trilled to announce that the early technical preview for SQLSRV and PDO_SQLSRV drivers is now available, both drivers have been built and tested on El Capitan (OS X 10.11). For complete list of changes please visit [4.1.7-preview release notes](https://github.com/Microsoft/msphpsql/releases/tag/v4.1.7-preview).
 
  Please visit the [blog][blog] for more announcements.
 
@@ -45,11 +46,11 @@ Thank you for taking time to take our Febraury survey. Let us know how we are do
 
 Note: if you prefer, you can use the pre-compiled binary found [HERE](https://github.com/Azure/msphpsql/releases)
 
-####Prerequisites
+#### Prerequisites
 
 You must first be able to build PHP 7 without including these extensions.  For help with doing this, see the [official PHP website][phpbuild] for building your own PHP on Windows.
 
-####Compile the drivers
+#### Compile the drivers
 
 1. Copy the sqlsrv and/or pdo_sqlsrv source code directory from this repository into the ext subdirectory.
 
@@ -67,23 +68,23 @@ This software has been compiled and tested under PHP 7.0.8 using the Visual C++
 
 ## Install (Windows)
 
-####Prerequisites
+#### Prerequisites
 
 - A Web server such as Internet Information Services (IIS) is required. Your Web server must be configured to run PHP
 - [Microsoft ODBC Driver 11][odbc11] or [Microsoft ODBC Driver 13][odbc13]
 
-####Enable the drivers
+#### Enable the drivers
 
 1. Make sure that the driver is in your PHP extension directory (you can simply copy it there if you did not use nmake install).
 
 2. Enable it within your PHP installation's php.ini: `extension=php_sqlsrv.dll` and/or `extension=php_pdo_sqlsrv.dll`.  If necessary, specify the extension directory using extension_dir, for example: `extension_dir = "C:\PHP\ext"`
 
 3. Restart the Web server.
 
-## Install (Linux)
-Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apache, and Microsoft PHP drivers on Ubuntu 15, 16 and RedHat 7. To see how to get PHP SQLSRV drivers running on Debian, please visit [Wiki](https://github.com/Microsoft/msphpsql/wiki/Dockerfile-for-getting-pdo_sqlsrv-for-PHP-7.0-on-Debian-in-3-ways). Note that Debian is not officially supported and this instruction hasn't been tested in our test lab.
+## Install (UNIX)
+Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apache, and Microsoft PHP drivers on Ubuntu 15, 16, RedHat 7 and Mac OS X. To see how to get PHP SQLSRV drivers running on Debian, please visit [Wiki](https://github.com/Microsoft/msphpsql/wiki/Dockerfile-for-getting-pdo_sqlsrv-for-PHP-7.0-on-Debian-in-3-ways). Note that Debian is not officially supported and this instruction hasn't been tested in our test lab.
 
-### Step 1: Install  PHP (unless already installed)
+### Step 1: Install  PHP7 (unless already installed)
 
 #### PHP 7.0
 
@@ -113,6 +114,17 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 	yum update
 	yum install php php-pdo php-xml php-pear php-devel re2c gcc-c++ gcc
 
+**Mac OS X**
+
+	/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+	brew tap 
+	brew tap homebrew/dupes
+	brew tap homebrew/versions
+	brew tap homebrew/homebrew-php
+	brew install php70 --with-pear --with-httpd24 --with-cgi
+	echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.bash_profile
+	echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile
+*Note: Restart the terminal if PHP(`php -v`) is not updated.
 
 
 #### PHP 7.1
@@ -123,7 +135,7 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 	sudo su
 	add-apt-repository ppa:ondrej/php
 	apt-get update
-	apt-get -y install php7.1 mcrypt php7.1-mcrypt php-mbstring php-pear php7.1-dev 
+	apt-get -y install php7.1 mcrypt php7.1-mcrypt php-mbstring php-pear php7.1-dev php7.1-xml
 
 **RedHat 7**
 
@@ -135,6 +147,19 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 	yum-config-manager --enable remi-php71
 	yum update
 	yum install php php-pdo php-xml php-pear php-devel
+
+**Mac OS X**
+
+	/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+	brew tap 
+	brew tap homebrew/dupes
+	brew tap homebrew/versions
+	brew tap homebrew/homebrew-php
+	brew install php71 --with-pear --with-httpd24 --with-cgi
+	echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.bash_profile
+	echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile
+*Note: Restart the terminal if PHP(`php -v`) is not updated.
+
 
 ### Step 2: Install  pre-requisites
 
@@ -178,15 +203,21 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 	echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
 	echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
 	source ~/.bashrc
+
+**Mac OS X**
 
+	brew tap microsoft/msodbcsql https://github.com/Microsoft/homebrew-msodbcsql
+	brew update
+	brew install unixodbc
+	brew install msodbcsql
+	brew install llvm --with-clang --with-clang-extra-tools
+	brew install autoconf
 
-
-
-*Note: On Ubuntu, you need to make sure you install PHP 7 before you proceed to step 2. The Microsoft PHP Drivers for SQL Server will only work for PHP 7+.
+*Note: You need to make sure you install PHP 7 before you proceed to step 3. The Microsoft PHP Drivers for SQL Server will only work for PHP 7+.
 
 ### Step 3: Install Apache
 
-####PHP 7.0
+#### PHP 7.0
 
 **Ubuntu**
 
@@ -197,65 +228,36 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 
     sudo yum install httpd
 
-####PHP 7.1 
+**Mac OS X** 
+
+    (echo "<FilesMatch .php$>"; echo "SetHandler application/x-httpd-php"; echo "</FilesMatch>";) >> /usr/local/etc/apache2/2.4/httpd.conf
+
+#### PHP 7.1 
 
 **Ubuntu**
 
-	sudo apt-get install libapache2-mod-php7.1 
-	sudo apt-get install apache2
+    sudo apt-get install libapache2-mod-php7.1 
+    sudo apt-get install apache2
 
 **RedHat** 
 
     sudo yum install httpd 
+
+**Mac OS X** 
+
+    (echo "<FilesMatch .php$>"; echo "SetHandler application/x-httpd-php"; echo "</FilesMatch>";) >> /usr/local/etc/apache2/2.4/httpd.conf
 
 
 ### Step 4: Install the Microsoft PHP Drivers for SQL Server
 
+    sudo pear config-set php_ini `php --ini | grep "Loaded Configuration" | sed -e "s|.*:\s*||"` system
     sudo pecl install sqlsrv
     sudo pecl install pdo_sqlsrv
 
-*Note: it installs the stable version, for specific version you should set the version. For example, `sudo pecl install sqlsrv-4.0.8`
-
-       
-### Step 5: Add the Microsoft PHP Drivers for SQL Server to php.ini
-
-
-####PHP 7.0
-
-**Ubuntu**
+*Note: it installs the stable version, for specific version you should set the version. For example, do `sudo pecl search sqlsrv` to search for the latest releases and `sudo pecl install sqlsrv-[version]` to install a specific version.
+Drivers are Mac-compatible starting from 4.1.7preview release. .
 
-	echo "extension=/usr/lib/php/20151012/sqlsrv.so" >> /etc/php/7.0/apache2/php.ini
-	echo "extension=/usr/lib/php/20151012/pdo_sqlsrv.so" >> /etc/php/7.0/apache2/php.ini
-	echo "extension=/usr/lib/php/20151012/sqlsrv.so" >> /etc/php/7.0/cli/php.ini
-	echo "extension=/usr/lib/php/20151012/pdo_sqlsrv.so" >> /etc/php/7.0/cli/php.ini
-
-
-**RedHat** 
-
-	echo "extension= /usr/lib64/php/modules/sqlsrv.so" > /etc/php.d/sqlsrv.ini
-	echo "extension= /usr/lib64/php/modules/pdo_sqlsrv.so" > /etc/php.d/pdo_sqlsrv.ini
-
-
-####PHP 7.1
-
-
-**Ubuntu 16.04**
-
-	echo "extension=/usr/lib/php/20160303/sqlsrv.so" >> /etc/php/7.1/apache2/php.ini
-	echo "extension=/usr/lib/php/20160303/pdo_sqlsrv.so" >> /etc/php/7.1/apache2/php.ini
-	echo "extension=/usr/lib/php/20160303/sqlsrv.so" >> /etc/php/7.1/cli/php.ini
-	echo "extension=/usr/lib/php/20160303/pdo_sqlsrv.so" >> /etc/php/7.1/cli/php.ini
-
-
-
-**RedHat** 
-
-	echo "extension= /usr/lib64/php/modules/sqlsrv.so" > /etc/php.d/sqlsrv.ini
-	echo "extension= /usr/lib64/php/modules/pdo_sqlsrv.so" > /etc/php.d/pdo_sqlsrv.ini
-
-
-
-### Step 6: Restart Apache to load the new php.ini file
+### Step 5: Restart Apache to load the new php.ini file
 
 **Ubuntu**
 
@@ -264,9 +266,15 @@ Following instructions shows how to install PHP 7.x, Microsoft ODBC driver, apac
 **RedHat**
 
 	sudo apachectl restart 
+
+**Mac OS X** 
+
+	sudo apachectl restart 
+
+*Note to RedHat users: SELinux is installed by default and runs in Enforcing mode. To allow Apache to connect to database through SELinux, do this `sudo setsebool -P httpd_can_network_connect_db 1`     
 
-### Step 7: Create your sample app
-Navigate to `/var/www/html` and create a new file called testsql.php. Copy and paste the following code in tetsql.php and change the servername, username, password and databasename.
+### Step 6: Create your sample app
+Navigate to `/var/www/html` (`/usr/local/var/www/htdocs` on Mac) and create a new file called testsql.php. Copy and paste the following code in tetsql.php and change the servername, username, password and databasename.
 
     <?php
     $serverName = "yourServername";
@@ -307,9 +315,9 @@ Navigate to `/var/www/html` and create a new file called testsql.php. Copy and p
     }  
     ?>
 
-### Step 8: Run your sample app
+### Step 7: Run your sample app
 
-Go to your browser and type in http://localhost/testsql.php
+Go to your browser and type in http://localhost/testsql.php (http://localhost:8080/testsql.php on Mac)
 You should be able to connect to your SQL Server/Azure SQL Database.
 
 The drivers are distributed as shared binary extensions for PHP. They are available in thread safe (*_ts.so) and-non thread safe (*_nts.so) versions. The source code for the drivers is also available, and you can choose whether to compile them as thread safe or non-thread safe versions. The thread safety configuration of your web server will determine which version you need. 
@@ -331,11 +339,29 @@ For samples, please see the sample folder.  For setup instructions, see [here] [
 - Binary column binding with emulate prepare ([issue#140](https://github.com/Microsoft/msphpsql/issues/140) )
 - Linux
    - The following features are not supported with connection pooling:
+     - PDO is only supported with unixODBC 2.3.1.
      - Unicode connection strings
      - sqlsrv_server_info and sqlsrv_client_info return false 
      - In certain scenarios a generic error message maybe returned instead of a specific error when pooling is disabled
      - When retrieving data from columns with a data type of XML, varchar(max), nvarchar(max), or varbinary(max) no data maybe returned or the data maybe truncated depending on the length of the data in the source table.
 
+## Version number
+Version number of PHP drivers follow the [semantic versioning](http://semver.org/):
+
+Given a version number MAJOR.MINOR.PATCH, 
+
+ - MAJOR version is incremented when an incompatible API changes is made, 
+ - MINOR version is incremented when a functionality in a backwards-compatible manner is added, and
+ - PATCH version is incremented when backwards-compatible bug fixes are made.
+
+version number MAY have trailing pre-release version to indicate the stability, and/or build meta data.
+
+- Pre-release version is denoted by hyphen followed by `preview` or `rc` keyword and may be followed by a series of dot separated identifiers. Production quality releases do not contain the pre-release version. `preview` has lower precedence than `rc`. Example of precedence: *preview < preview.1 < rc < rc.1*. 
+*Note that PECL package version does not have the hyphen before pre-release version, due to restrictions in PECL. Example of PECL package version: 1.2.3preview*
+- Build metadata MAY be denoted by a plus sign followed by 4 digits, such as  `1.2.3-preview+5678` or `1.2.3+5678`. Build meta data does NOT figure into the precedence order.
+
+
+
 ## Future Plans
 - Expand SQL 16 Feature Support (example: Always Encrypted).
 - Build Verification/Fundamental Tests.

appveyor.yml

@@ -165,7 +165,11 @@ test_script:
 
 after_test:
     - cd %APPVEYOR_BUILD_FOLDER%\test\    
-    - python output.py    
+    - python output.py 
+    - ps: $files = Get-ChildItem sqlsrv\*.diff   
+    - ps: foreach($file in $files){ls $file; more $file; more "$file.out"}  
+    - ps: $files = Get-ChildItem pdo_sqlsrv\*.diff   
+    - ps: foreach($file in $files){ls $file; more $file; more "$file.out"}  
     - ps: (new-object net.webclient).UploadFile("https://ci.appveyor.com/api/testresults/junit/$($env:APPVEYOR_JOB_ID)", (Resolve-Path .\nativeresult1.xml))
     - ps: (new-object net.webclient).UploadFile("https://ci.appveyor.com/api/testresults/junit/$($env:APPVEYOR_JOB_ID)", (Resolve-Path .\nativeresult2.xml))
     - ps: >-