PHP 7.0 sqlsrv driver early technical preview

Code for the sqlsrv driver for PHP 7.0

LICENSE

@@ -0,0 +1,14 @@
+Copyright(c) 2015 Microsoft Corporation
+All rights reserved.
+
+MIT License
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files(the "Software"), 
+to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions :
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 
+IN THE SOFTWARE.

README.md

@@ -0,0 +1,116 @@
+# Microsoft Drivers for PHP for SQL Server
+
+**Welcome to the Microsoft Drivers for PHP for SQL Server PHP 7 (Early Technical Preview)**
+
+The Microsoft Drivers for PHP for SQL Server are PHP extensions that allow for the reading and writing of SQL Server data from within PHP scripts. The SQLSRV extension provides a procedural interface while the PDO_SQLSRV extension implements PDO for accessing data in all editions of SQL Server 2005 and later (including Azure SQL DB). These drivers rely on the Microsoft ODBC Driver for SQL Server to handle the low-level communication with SQL Server.
+
+This preview contains the SQLSRV driver for 32-bit PHP 7 with limitations (see Limitations below for details).  Upcoming release(s) will contain more functionality, bug fixes, the PDO_SQLSRV driver, 64-bit support and more (see Plans below for more details).
+
+The Microsoft Drivers for PHP for SQL Server Team
+
+## Build
+
+Note: if you prefer, you can use the pre-compiled binary found [HERE]
+
+####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 SQLSRV driver
+
+1. Copy the sqlsrv source code directory from this repository into the ext subdirectory.
+
+2. Run `buildconf.bat` to rebuild the configure.js script to include the driver.
+
+3. Run `configure.bat --enable-sqlsrv=shared --with-odbcver=0x0380 [other options such as --disable-zts for the Non Thread Safe build]` to generate the makefile.  You can run `configure.bat --help` to see what other options are available.
+
+4. Run `nmake`.  It is suggested that you run the entire build.  If you wish to do so, run `nmake clean` first.
+
+5. To install the resulting build, run `nmake install` or just copy php_sqlsrv.dll to your PHP extension directory.
+
+This software has been compiled and tested under PHP 7.0.2 using the Visual C++ 2015 compiler.
+
+## Install
+
+####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][odbc]
+
+####Enable the SQLSRV driver
+
+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`.  If necessary, specify the extension directory using extension_dir, for example: `extension_dir = "C:\PHP\ext"`
+
+3. Restart the Web server.
+
+## Sample Code
+For samples, please see the sample folder.  For setup instructions, see [here] [phpazure]
+
+## Changes and Limitations
+
+This preview contains the 32-bit port for PHP 7 of the SQLSRV driver. The focus was on basic functionality. The following items are not supported:
+
+- PDO
+- Native 64 Bit
+- Backwards compatibility with PHP 5
+- Retrieving stream data and metadata
+- Retrieving some varchar, nvarchar, ntext, binary, varbinary, uniqueidentifier, datetime, smalldatetime, and timestamp fields
+- Handle UTF8 strings
+- Bind parameters with datetime types, streams, and arrays within arrays without references
+- Retrieve SQLTYPE_VARCHAR as an output parameter
+- Fetch a user defined object into a class
+
+And some aspects of the following items need improvement:
+- Memory management
+- Logging and error handling
+
+
+## Future Plans
+
+- PDO Support
+- Linux Version
+- Expand SQL 16 Feature Support (example: Always Encrypted)
+- Build Verification/Fundamental Tests
+- Bug Fixes
+
+##FAQs
+**Q:** Can we get dates for any of the Future Plans listed above?
+**A:** At this time, Microsoft is not able to announce dates. We are working extremely hard to release future versions of the driver. We will share future plans once they solidify over the next few weeks. 
+
+**Q:** What's next?
+**A:** On Jan 29, 2016, we have released the early technical preview for our PHP Driver. Our next step will be a Community Tech Preview with completed functionally, PDO support, and more.
+
+**Q:** Is Microsoft taking pull requests for this project?
+**A:** We will not be seeking to take pull requests until GA, Build Verification, and Fundamental tests are released. At this point Microsoft will also begin actively developing using this GitHub project as the prime repository.
+
+
+
+## License
+
+The Microsoft Drivers for PHP for SQL Server are licensed under the MIT license.  See the LICENSE file for more details.
+
+## Resources
+
+**Documentation**: [MSDN Online Documentation][phpdoc].  Please note that this documentation is not yet updated for PHP 7.
+**Team Blog**: Browse our blog for comments and announcements from the team in the [team blog][blog].
+**Known Issues**: Please visit the [project on Github][project] to view outstanding [issues][issues].
+
+[blog]: http://blogs.msdn.com/b/sqlphp/
+
+[project]: https://github.com/Azure/msphpsql
+
+[issues]: https://github.com/Azure/msphpsql/issues
+
+[phpweb]: http://php.net
+
+[phpbuild]: https://wiki.php.net/internals/windows/stepbystepbuild
+
+[phpdoc]: http://msdn.microsoft.com/en-us/library/dd903047%28SQL.11%29.aspx
+
+[odbc]: https://www.microsoft.com/en-us/download/details.aspx?id=36434
+
+[phpazure]: https://azure.microsoft.com/en-us/documentation/articles/sql-database-develop-php-simple-windows/
+
+

sample/sqlsrv_sample.php

@@ -0,0 +1,69 @@
+<?php
+    echo "\n";
+    $serverName = "tcp:yourserver.database.windows.net,1433";
+    $connectionOptions = array("Database"=>"yourpassword", "Uid"=>"yourusername", "PWD"=>"yourpassword");
+
+	 //Establishes the connection
+	 $conn = sqlsrv_connect($serverName, $connectionOptions);
+	 //Select Query
+	 $tsql = "SELECT [CompanyName] FROM SalesLT.Customer";
+	 //Executes the query
+	 $getProducts = sqlsrv_query($conn, $tsql);
+	 //Error handling
+	 if ($getProducts == FALSE)
+	 die(FormatErrors(sqlsrv_errors()));
+	 $productCount = 0;
+	 $ctr = 0;
+	 ?> 
+	 <h1> First 10 results are : </h1>
+	 <?php
+	 while($row = sqlsrv_fetch_array($getProducts, SQLSRV_FETCH_ASSOC))
+	 { 
+	 if($ctr>9)
+	 break; 
+	 $ctr++;
+	 echo($row['CompanyName']);
+	 echo("<br/>");
+	 $productCount++;
+	 }
+	 sqlsrv_free_stmt($getProducts);
+
+	 $tsql = "INSERT SalesLT.Product (Name, ProductNumber, StandardCost, ListPrice, SellStartDate) OUTPUT INSERTED.ProductID VALUES ('SQL New 1', 'SQL New 2', 0, 0, getdate())";
+	 //Insert query
+	 $insertReview = sqlsrv_query($conn, $tsql);
+	 if($insertReview == FALSE)
+	 die(FormatErrors( sqlsrv_errors()));
+	 ?> 
+	 <h1> Product Key inserted is :</h1> 
+	 <?php
+	 while($row = sqlsrv_fetch_array($insertReview, SQLSRV_FETCH_ASSOC))
+	 { 
+	 echo($row['ProductID']);
+	 }
+	 sqlsrv_free_stmt($insertReview);
+	 //Delete Query
+	 //We are deleting the same record
+	 $tsql = "DELETE FROM [SalesLT].[Product] WHERE Name=?";
+	 $params = array("SQL New 1");
+
+	 $deleteReview = sqlsrv_prepare($conn, $tsql, $params);
+	 if($deleteReview == FALSE)
+	 die(FormatErrors(sqlsrv_errors()));
+
+	 if(sqlsrv_execute($deleteReview) == FALSE)
+	 die(FormatErrors(sqlsrv_errors()));
+
+	function FormatErrors( $errors )
+	{
+	    /* Display errors. */
+	    echo "Error information: <br/>";
+
+	    foreach ( $errors as $error )
+	    {
+	        echo "SQLSTATE: ".$error['SQLSTATE']."<br/>";
+	        echo "Code: ".$error['code']."<br/>";
+	        echo "Message: ".$error['message']."<br/>";
+	    }
+	}
+
+?>

sqlsrv/CREDITS

@@ -0,0 +1 @@
+Microsoft Drivers 4.0.0 for PHP for SQL Server (SQLSRV driver)

sqlsrv/config.w32

@@ -0,0 +1,39 @@
+//----------------------------------------------------------------------------------------------------------------------------------
+// File: config.w32
+//
+// Contents: JScript build configuration used by buildconf.bat
+//
+// Microsoft Drivers 4.0 for PHP for SQL Server
+// Copyright(c) Microsoft Corporation
+// All rights reserved.
+// MIT License
+// Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files(the ""Software""), 
+//  to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+//  and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions :
+// The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 
+//  IN THE SOFTWARE.
+//---------------------------------------------------------------------------------------------------------------------------------
+
+ARG_ENABLE("sqlsrv", "enable Microsoft Drivers for PHP for SQL Server (SQLSRV driver)", "no");
+
+if( PHP_SQLSRV != "no" ) {
+
+    sqlsrv_src = "conn.cpp init.cpp stmt.cpp util.cpp core_init.cpp core_conn.cpp core_stmt.cpp core_util.cpp core_stream.cpp core_results.cpp";
+
+    if (CHECK_LIB("odbc32.lib", "sqlsrv") && CHECK_LIB("odbccp32.lib", "sqlsrv") && 
+       CHECK_LIB("version.lib", "sqlsrv") && CHECK_LIB("psapi.lib", "sqlsrv")) {
+
+       EXTENSION("sqlsrv", sqlsrv_src, PHP_SQLSRV_SHARED, "/DZEND_ENABLE_STATIC_TSRMLS_CACHE=1")
+
+       CHECK_HEADER_ADD_INCLUDE('sql.h', 'CFLAGS_SQLSRV_ODBC');
+       CHECK_HEADER_ADD_INCLUDE('sqlext.h', 'CFLAGS_SQLSRV_ODBC');
+       ADD_FLAG( 'LDFLAGS_SQLSRV', '/NXCOMPAT /DYNAMICBASE /debug' );
+       ADD_FLAG( 'CFLAGS_SQLSRV', '/D ZEND_WIN32_FORCE_INLINE' );
+       ADD_FLAG( 'CFLAGS_SQLSRV', '/EHsc' );
+       ADD_FLAG( 'CFLAGS_SQLSRV', '/GS' );
+       ADD_FLAG( 'CFLAGS_SQLSRV', '/Zi' );
+   }
+}