From 5f62186ffae9e337f57ad27728c6296dd977cb01 Mon Sep 17 00:00:00 2001 From: David Puglielli Date: Tue, 8 May 2018 14:28:31 -0700 Subject: [PATCH] Updated Apache instructions, install order, fixed links --- Linux-mac-install.md | 26 +++++++++++++------------- README.md | 24 +++++++----------------- 2 files changed, 20 insertions(+), 30 deletions(-) diff --git a/Linux-mac-install.md b/Linux-mac-install.md index 7253925a..9a824be8 100644 --- a/Linux-mac-install.md +++ b/Linux-mac-install.md @@ -28,12 +28,12 @@ Install the ODBC driver for Ubuntu by following the instructions on the [Linux a ### Step 3. Install the PHP drivers for Microsoft SQL Server ``` +sudo pecl install sqlsrv +sudo pecl install pdo_sqlsrv sudo su echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini exit -sudo pecl install sqlsrv -sudo pecl install pdo_sqlsrv ``` ### Step 4. Install Apache and configure driver loading ``` @@ -42,8 +42,8 @@ apt-get install libapache2-mod-php7.2 apache2 a2dismod mpm_event a2enmod mpm_prefork a2enmod php7.2 -echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/php.ini -echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/php.ini +echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/30-pdo_sqlsrv.ini +echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/20-sqlsrv.ini ``` ### Step 5. Restart Apache and test the sample script ``` @@ -79,12 +79,12 @@ scl enable devtoolset-7 bash ``` ### Step 3. Install the PHP drivers for Microsoft SQL Server ``` +sudo pecl install sqlsrv +sudo pecl install pdo_sqlsrv sudo su echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini exit -sudo pecl install sqlsrv -sudo pecl install pdo_sqlsrv ``` An issue in PECL may prevent correct installation of the latest version of the drivers even if you have upgraded GCC. To install, download the packages and compile manually: ``` @@ -126,7 +126,7 @@ apt-get install curl apt-transport-https wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list apt-get update -apt-get install –y php7.2 php7.2-dev php7.2-xml +apt-get install -y php7.2 php7.2-dev php7.2-xml ``` ### Step 2. Install prerequisites Install the ODBC driver for Debian by following the instructions on the [Linux and macOS installation page](https://docs.microsoft.com/en-us/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server). @@ -140,12 +140,12 @@ locale-gen ### Step 3. Install the PHP drivers for Microsoft SQL Server ``` +sudo pecl install sqlsrv +sudo pecl install pdo_sqlsrv sudo su echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini exit -sudo pecl install sqlsrv -sudo pecl install pdo_sqlsrv ``` ### Step 4. Install Apache and configure driver loading ``` @@ -154,8 +154,8 @@ apt-get install libapache2-mod-php7.2 apache2 a2dismod mpm_event a2enmod mpm_prefork a2enmod php7.2 -echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/php.ini -echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/php.ini +echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/30-pdo_sqlsrv.ini +echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/20-sqlsrv.ini ``` ### Step 5. Restart Apache and test the sample script ``` @@ -182,12 +182,12 @@ Install the ODBC driver for Suse 12 by following the instructions on the [Linux ### Step 3. Install the PHP drivers for Microsoft SQL Server ``` +sudo pecl install sqlsrv +sudo pecl install pdo_sqlsrv sudo su echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/pdo_sqlsrv.ini echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/sqlsrv.ini exit -sudo pecl install sqlsrv -sudo pecl install pdo_sqlsrv ``` ### Step 4. Install Apache and configure driver loading ``` diff --git a/README.md b/README.md index 3d494d9c..9b8edbcd 100644 --- a/README.md +++ b/README.md @@ -45,12 +45,12 @@ Thank you for taking the time to participate in our last survey. You can continu ## Prerequisites -For full details on the system requirements for the drivers, see the [system requirements](https://docs.microsoft.com/en-us/sql/connect/php/system-requirements-for-the-php-sql-driver) on MSDN. +For full details on the system requirements for the drivers, see the [system requirements](https://docs.microsoft.com/en-us/sql/connect/php/system-requirements-for-the-php-sql-driver) on Microsoft Docs. On the client machine: - PHP 7.0.x, 7.1.x, or 7.2.x (7.2.0 and up on Unix, 7.2.1 and up on Windows) - 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], [Microsoft ODBC Driver 13][odbc13], or [Microsoft ODBC Driver 17][odbc17] +- [Microsoft ODBC Driver 17][odbc17], [Microsoft ODBC Driver 13][odbc13], or [Microsoft ODBC Driver 11][odbc11] On the server side, Microsoft SQL Server 2008 R2 and above on Windows is supported, as is Microsoft SQL Server 2016 and above on Linux. @@ -60,16 +60,16 @@ The drivers are distributed as pre-compiled extensions for PHP found on the [rel If you choose to build the drivers, you must be able to build PHP 7 without including these extensions. For help building PHP on Windows, see the [official PHP website][phpbuild]. For details on compiling the drivers, see the [documentation](https://github.com/Microsoft/msphpsql/tree/dev/buildscripts#windows) -- an example buildscript is provided, but you can also compile the drivers manually. -To load the drivers, make sure that the driver is in your PHP extension directory and enable it in your PHP installation's php.ini file by adding `extension=php_sqlsrv.dll` and/or `extension=php_pdo_sqlsrv.dll` to it. If necessary, specify the extension directory using `extension_dir`, for example: `extension_dir = "C:\PHP\ext"`. Note that the precompiled binaries have different names -- substitute accordingly in php.ini. For more details on loading the drivers, see [Loading the PHP SQL Driver](https://docs.microsoft.com/en-us/sql/connect/php/loading-the-php-sql-driver) on MSDN. +To load the drivers, make sure that the driver is in your PHP extension directory and enable it in your PHP installation's php.ini file by adding `extension=php_sqlsrv.dll` and/or `extension=php_pdo_sqlsrv.dll` to it. If necessary, specify the extension directory using `extension_dir`, for example: `extension_dir = "C:\PHP\ext"`. Note that the precompiled binaries have different names -- substitute accordingly in php.ini. For more details on loading the drivers, see [Loading the PHP SQL Driver](https://docs.microsoft.com/en-us/sql/connect/php/loading-the-php-sql-driver) on Microsoft Docs. Finally, restart the Web server. ## Install (UNIX) -For full instructions on installing the drivers on all supported Unix platforms, see [the installation instructions on MSDN](https://docs.microsoft.com/en-us/sql/connect/php/installation-tutorial-linux-mac). +For full instructions on installing the drivers on all supported Unix platforms, see [the installation instructions on Microsoft Docs](https://docs.microsoft.com/en-us/sql/connect/php/installation-tutorial-linux-mac). ## Sample Code -For PHP code samples, please see the [sample](https://github.com/Microsoft/msphpsql/tree/master/sample) folder or the [code samples on MSDN](https://docs.microsoft.com/en-us/sql/connect/php/code-samples-for-php-sql-driver). +For PHP code samples, please see the [sample](https://github.com/Microsoft/msphpsql/tree/master/sample) folder or the [code samples on Microsoft Docs](https://docs.microsoft.com/en-us/sql/connect/php/code-samples-for-php-sql-driver). ## Limitations and Known Issues Please refer to [Releases](https://github.com/Microsoft/msphpsql/releases) for the latest limitations and known issues. @@ -133,7 +133,7 @@ This project has adopted the Microsoft Open Source Code of Conduct. For more inf ## Resources -**Documentation**: [MSDN Online Documentation][phpdoc]. +**Documentation**: [Microsoft Docs Online][phpdoc]. **Team Blog**: Browse our blog for comments and announcements from the team in the [team blog][blog]. @@ -155,16 +155,6 @@ This project has adopted the Microsoft Open Source Code of Conduct. For more inf [odbc13]: https://www.microsoft.com/download/details.aspx?id=50420 -[odbc17]: https://github.com/Microsoft/msphpsql/tree/master/ODBC%2017%20binaries%20preview - -[odbcLinux]: https://msdn.microsoft.com/library/hh568454(v=sql.110).aspx +[odbc17]: https://www.microsoft.com/download/details.aspx?id=56567 [PHPMan]: http://php.net/manual/install.unix.php - -[LinuxDM]: https://msdn.microsoft.com/library/hh568449(v=sql.110).aspx - -[httpd_source]: http://httpd.apache.org/ - -[apr_source]: http://apr.apache.org/ - -[httpdconf]: http://php.net/manual/en/install.unix.apache2.php \ No newline at end of file