Skip to content

Commit 428a6db

Browse files
author
Hadis Kakanejadi Fard
authored
Merge pull request #238 from v-dareck/Readmeupdate
Readme Updates for Windows 4.1.5
2 parents 07ea1d3 + 4a57536 commit 428a6db

File tree

3 files changed

+115
-52
lines changed

3 files changed

+115
-52
lines changed

CHANGELOG.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Change Log
2+
All notable changes to this project will be documented in this file.
3+
4+
The format is based on [Keep a Changelog](http://keepachangelog.com/)
5+
6+
## Windows 4.1.5 - 2017-01-19
7+
Updated Windows drivers (4.1.5) compiled with PHP 7.0.14 and 7.1 are available. Here is the list of updates:
8+
9+
### Added
10+
- Added Unicode Column name support([issue #138](https://github.com/Microsoft/msphpsql/issues/138)).
11+
12+
###Fixed
13+
- Fixed issue output parameters bound to empty string ([issue #182](https://github.com/Microsoft/msphpsql/issues/182)).
14+
- Fixed issue with SQLSRV_ATTR_FETCHES_NUMERIC_TYPE when column return type is set on statement ([issue #173](https://github.com/Microsoft/msphpsql/issues/173)).
15+
16+
17+
### Changed
18+
- 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:
19+
- if you are building the driver from source using PHP source, copy the "shared" folder as a subfolder to both the sqlsrv and pdo_sqlsrv folders.
20+
21+
## Windows 4.1.4 - 2016-10-25
22+
Windows drivers compiled with PHP 7.0.12 and 7.1 are available. Here is the list of updates:
23+
24+
### Changed
25+
- Drivers versioning has been redesigned as Major#.Minor#.Release#.Build#. Build number is specific to binaries and it doesn't match with the number on the source.
26+
27+
### Fixed
28+
- Fixed the issue with duplicate warning messages in PDO_SQLSRV drivers when error mode is set to PDO::ERRMODE_WARNING.
29+
30+
## Windows 4.1.3 - 2016-10-04
31+
Updated Windows drivers (4.1.3) compiled with PHP 7.0.11 and 7.1.0RC3 are available. Here is the list of updates:
32+
33+
### Fixed
34+
- Fixed [issue #139](https://github.com/Microsoft/msphpsql/issues/139) : sqlsrv_fetch_object calls custom class constructor in static context and outputs an error.
35+
36+
## Windows 4.1.2 - 2016-09-09
37+
Updated Windows drivers (4.1.2) compiled with PHP 7.0.10 are available. Here is the list of updates:
38+
39+
### Added
40+
- Added following integer SQL Types constants for cases which function-like SQL types constants cannot be used e.g. type comparison:
41+
42+
SQLSRV constant | Typical SQL Server data type | SQL type identifier
43+
------------ | ----------------------- | ----------------------
44+
SQLSRV_SQLTYPE_DECIMAL | decimal | SQL_DECIMAL
45+
SQLSRV_SQLTYPE_NUMERIC | numeric | SQL_NUMERIC
46+
SQLSRV_SQLTYPE_CHAR | char | SQL_CHAR
47+
SQLSRV_SQLTYPE_NCHAR | nchar | SQL_WCHAR
48+
SQLSRV_SQLTYPE_VARCHAR | varchar | SQL_VARCHAR
49+
SQLSRV_SQLTYPE_NVARCHAR | nvarchar | SQL_WVARCHAR
50+
SQLSRV_SQLTYPE_BINARY | binary | SQL_BINARY
51+
SQLSRV_SQLTYPE_VARBINARY | varbinary | SQL_VARBINARY
52+
53+
Note: These constants should be used in type comparison operations (refer to issue [#87](https://github.com/Microsoft/msphpsql/issues/87) and [#99](https://github.com/Microsoft/msphpsql/issues/99) ), and don't replace the function like constants with similar syntax. For binding parameters you should use the function-like constants, otherwise you'll get an error.
54+
55+
### Fixed
56+
- Fixed [issue #119](https://github.com/Microsoft/msphpsql/issues/119) (modifying class name in sqlsrv_fetch_object).
57+
58+
59+
## Windows 4.1.1 - 2016-08-22
60+
Updated Windows drivers(4.1.1) compiled with PHP 7.0.9 are available and include a couple of bug fixes:
61+
62+
### Fixed
63+
- Fixed issue with storing integers in varchar field.
64+
- Fixed issue with invalid connection handler if one connection fails.
65+
- Fixed crash when emulate prepare is on.
66+
67+
68+
## Windows 4.1.0 - 2016-07-28
69+
70+
### Fixed
71+
- `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` connection attribute flag is added to PDO_SQLSRV driver to handle numeric fetches from columns with numeric Sql types (only bit, integer, smallint, tinyint, float and real). This flag can be turned on by setting its value in `PDO::setAttribute` to `true`, For example,
72+
`$conn->setAttribute(PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE,true);`
73+
If `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is set to `true` the results from an integer column will be represented as an `int`, likewise, Sql types float and real will be represented as `float`.
74+
Note for exceptions:
75+
- When connection option flag `ATTR_STRINGIFY_FETCHES` is on, even when `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is on, the return value will still be string.
76+
- When the returned PDO type in bind column is `PDO_PARAM_INT`, the return value from a integer column will be int even if `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is off.
77+
- Fixed float truncation when using buffered query.
78+
- Fixed handling of Unicode strings and binary when emulate prepare is on in `PDOStatement::bindParam`. To bind a unicode string, `PDO::SQLSRV_ENCODING_UTF8` should be set using `$driverOption`, and to bind a string to column of Sql type binary, `PDO::SQLSRV_ENCODING_BINARY` should be set.
79+
- Fixed string truncation in bind output parameters when the size is not set and the length of initialized variable is less than the output.
80+
- Fixed bind string parameters as bidirectional parameters (`PDO::PARAM_INPUT_OUTPUT `) in PDO_SQLSRV driver. Note for output or bidirectional parameters, `PDOStatement::closeCursor` should be called to get the output value.

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Copyright(c) 2016 Microsoft Corporation
1+
Copyright(c) 2017 Microsoft Corporation
22
All rights reserved.
33

44
MIT License

README.md

Lines changed: 34 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -6,62 +6,32 @@ The Microsoft Drivers for PHP for SQL Server are PHP extensions that allow for t
66

77
This release contains the SQLSRV and PDO_SQLSRV drivers for PHP 7 with improvements on both drivers and some limitations (see Limitations below for details). Upcoming release(s) will contain more functionality, bug fixes, and more (see Plans below for more details).
88

9-
The Microsoft Drivers for PHP for SQL Server Team
9+
SQL Server Team
10+
###Status of Most Recent Builds
11+
| AppVeyor (Windows) |Travis CI (Linux) | Coverage Status
12+
|-------------------------|--------------------------| ------------------
13+
| [![av-image][]][av-site]| [![tv-image][]][tv-site] |[![Coverage Status][]][coveralls-site]
14+
15+
[av-image]: https://ci.appveyor.com/api/projects/status/github/Microsoft/msphpsql?branch=PHP-7.0&svg=true
16+
[av-site]: https://ci.appveyor.com/project/Microsoft-PHPSQL/msphpsql
17+
[tv-image]: https://travis-ci.org/Microsoft/msphpsql.svg?branch=PHP-7.0-Linux
18+
[tv-site]: https://travis-ci.org/Microsoft/msphpsql/
19+
[Coverage Status]: https://coveralls.io/repos/github/Microsoft/msphpsql/badge.svg?branch=PHP-7.0-Linux
20+
[coveralls-site]: https://coveralls.io/github/Microsoft/msphpsql?branch=PHP-7.0-Linux
1021

1122
##Get Started
1223

1324
* [**Ubuntu + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-ubuntu)
1425
* [**RedHat + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-rhel)
1526
* [**Windows + SQL Server + PHP 7**](https://www.microsoft.com/en-us/sql-server/developer-get-started/php-windows)
1627

17-
##Announcements
18-
19-
**October 25 , 2016** : Updated Windows drivers (4.1.4) compiled with PHP 7.0.12 and 7.1 are available. Here is the list of updates:
20-
21-
- Drivers versioning has been redesigned as Major#.Minor#.Release#.Build#. Build number is specific to binaries and it doesn't match with the number on the source.
22-
- Fixed the issue with duplicate warning messages in PDO_SQLSRV drivers when error mode is set to PDO::ERRMODE_WARNING.
23-
24-
**October 4 , 2016** : Updated Windows drivers (4.1.3) compiled with PHP 7.0.11 and 7.1.0RC3 are available. Here is the list of updates:
25-
26-
- Fixed [issue #139](https://github.com/Microsoft/msphpsql/issues/139) : sqlsrv_fetch_object calls custom class constructor in static context and outputs an error.
27-
28-
**September 9, 2016** : Updated Windows drivers (4.1.2) compiled with PHP 7.0.10 are available. Here is the list of updates:
29-
30-
- Fixed [issue #119](https://github.com/Microsoft/msphpsql/issues/119) (modifying class name in sqlsrv_fetch_object).
31-
- Added following integer SQL Types constants for cases which function-like SQL types constants cannot be used e.g. type comparison:
32-
33-
SQLSRV constant | Typical SQL Server data type | SQL type identifier
34-
------------ | ----------------------- | ----------------------
35-
SQLSRV_SQLTYPE_DECIMAL | decimal | SQL_DECIMAL
36-
SQLSRV_SQLTYPE_NUMERIC | numeric | SQL_NUMERIC
37-
SQLSRV_SQLTYPE_CHAR | char | SQL_CHAR
38-
SQLSRV_SQLTYPE_NCHAR | nchar | SQL_WCHAR
39-
SQLSRV_SQLTYPE_VARCHAR | varchar | SQL_VARCHAR
40-
SQLSRV_SQLTYPE_NVARCHAR | nvarchar | SQL_WVARCHAR
41-
SQLSRV_SQLTYPE_BINARY | binary | SQL_BINARY
42-
SQLSRV_SQLTYPE_VARBINARY | varbinary | SQL_VARBINARY
43-
44-
Note: These constants should be used in type comparison operations (refer to issue [#87](https://github.com/Microsoft/msphpsql/issues/87) and [#99](https://github.com/Microsoft/msphpsql/issues/99) ), and don't replace the function like constants with the similar syntax, for binding parameters you should use the function-like constants, otherwise you'll get an error.
4528

29+
##Announcements
4630

47-
**August 22, 2016** : Updated Windows drivers(4.1.1) compiled with PHP 7.0.9 are available and include a couple of bug fixes:
48-
49-
- Fixed issue with storing integers in varchar field.
50-
- Fixed issue with invalid connection handler if one connection fails.
51-
- Fixed crash when emulate prepare is on.
31+
**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/PHP-7.0-Linux/CHANGELOG.md) file.
5232

53-
**July 28, 2016** (4.1.0): Thanks to the community's input, this release expands drivers functionalities and also includes some bug fixes:
33+
Please visit the [blog][blog] for more announcements.
5434

55-
- `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` connection attribute flag is added to PDO_SQLSRV driver to handle numeric fetches from columns with numeric Sql types (only bit, integer, smallint, tinyint, float and real). This flag can be turned on by setting its value in `PDO::setAttribute` to `true`, For example,
56-
`$conn->setAttribute(PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE,true);`
57-
If `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is set to `true` the results from an integer column will be represented as an `int`, likewise, Sql types float and real will be represented as `float`.
58-
Note for exceptions:
59-
- When connection option flag `ATTR_STRINGIFY_FETCHES` is on, even when `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is on, the return value will still be string.
60-
- When the returned PDO type in bind column is `PDO_PARAM_INT`, the return value from a integer column will be int even if `SQLSRV_ATTR_FETCHES_NUMERIC_TYPE` is off.
61-
- Fixed float truncation when using buffered query.
62-
- Fixed handling of Unicode strings and binary when emulate prepare is on in `PDOStatement::bindParam`. To bind a unicode string, `PDO::SQLSRV_ENCODING_UTF8` should be set using `$driverOption`, and to bind a string to column of Sql type binary, `PDO::SQLSRV_ENCODING_BINARY` should be set.
63-
- Fixed string truncation in bind output parameters when the size is not set and the length of initialized variable is less than the output.
64-
- Fixed bind string parameters as bidirectional parameters (`PDO::PARAM_INPUT_OUTPUT `) in PDO_SQLSRV driver. Note for output or bidirectional parameters, `PDOStatement::closeCursor` should be called to get the output value.
6535

6636
## Build
6737

@@ -112,7 +82,6 @@ For samples, please see the sample folder. For setup instructions, see [here] [
11282

11383
## Known Issues
11484
- User defined data types and SQL_VARIANT.
115-
- Passing custom class constructor to sqlsrv_fetch_object reproduce an error([issue#139](https://github.com/Microsoft/msphpsql/issues/139)).
11685
- Binary column binding with emulate prepare ([issue#140](https://github.com/Microsoft/msphpsql/issues/140) )
11786

11887
## Future Plans
@@ -126,6 +95,7 @@ We appreciate you taking the time to test the driver, provide feedback and repor
12695
- Report each issue as a new issue (but check first if it's already been reported)
12796
- Try to be detailed in your report. Useful information for good bug reports include:
12897
* What you are seeing and what the expected behaviour is
98+
* Can you connect to SQL Server via `sqlcmd`?
12999
* Which driver: SQLSRV or PDO_SQLSRV?
130100
* Environment details: e.g. PHP version, thread safe (TS) or non-thread safe (NTS), 32-bit &/or 64-bit?
131101
* Table schema (for some issues the data types make a big difference!)
@@ -141,7 +111,7 @@ Thank you!
141111

142112
**Q:** What's next?
143113

144-
**A:** On Jan 29, 2016 we released an early technical preview for our PHP Driver and several since. We will continue to release frequently to improve the quality of our driver.
114+
**A:** On July 20, 2016 we released the early technical preview for our PHP Driver. We will continue releasing frequent technical previews until we reach production quality.
145115

146116
**Q:** Is Microsoft taking pull requests for this project?
147117

@@ -175,11 +145,24 @@ This project has adopted the Microsoft Open Source Code of Conduct. For more inf
175145

176146
[phpbuild]: https://wiki.php.net/internals/windows/stepbystepbuild
177147

178-
[phpdoc]: http://msdn.microsoft.com/en-us/library/dd903047%28SQL.11%29.aspx
148+
[phpdoc]: http://msdn.microsoft.com/library/dd903047%28SQL.11%29.aspx
149+
150+
[odbc11]: https://www.microsoft.com/download/details.aspx?id=36434
151+
152+
[odbc13]: https://www.microsoft.com/download/details.aspx?id=50420
153+
154+
[odbcLinux]: https://msdn.microsoft.com/library/hh568454(v=sql.110).aspx
155+
156+
[phpazure]: https://azure.microsoft.com/documentation/articles/sql-database-develop-php-simple-windows/
157+
158+
[PHPMan]: http://php.net/manual/install.unix.php
159+
160+
[LinuxDM]: https://msdn.microsoft.com/library/hh568449(v=sql.110).aspx
179161

180-
[odbc11]: https://www.microsoft.com/en-us/download/details.aspx?id=36434
162+
[httpd_source]: http://httpd.apache.org/
181163

182-
[odbc13]: https://www.microsoft.com/en-us/download/details.aspx?id=50420
164+
[apr_source]: http://apr.apache.org/
183165

184-
[phpazure]: https://azure.microsoft.com/en-us/documentation/articles/sql-database-develop-php-simple-windows/
166+
[httpdconf]: http://php.net/manual/en/install.unix.apache2.php
185167

168+
[ODBCinstallers]: https://blogs.msdn.microsoft.com/sqlnativeclient/2016/09/06/preview-release-of-the-sql-server-cc-odbc-driver-13-0-0-for-linux

0 commit comments

Comments
 (0)