Windows installation steps
You will probably need to build the sam extension for Windows as there
are only a limited range of pre-built binaries available from the SAM website.
The extension can be built using the standard Windows extension build procedures.
You will need the PHP source tree for the version of PHP you wish to
build the SAM extension against which you can obtain from php.net.
This should be unpacked into a working directory of your choice.
You will also need the libraries and headers used by PHP extensions
available from http://www.php.net/extra/win32build.zip and this
should be unzipped so that is in your working directory.
You should have something like:
c:\php-build\-
|
|---php-5.0.5--|---build
| |---ext
| |--- ...
|
|---win32build--|---bin
|---include
|---lib
You will need a compiler such as the free version of Visual Studio C++
Express from the Microsoft web site. Also you need the Microsoft
SDK Microsoft Windows Platform which again can be
downloaded from the Microsoft web site.
Obtain the SAM extension source using pear (pecl download sam) or by using
SVN and copy the files to a new "sam" directory under the "ext" directory
in your PHP source tree.
To build the extension open a build environment window by going to the
start
menu->all programs->microsoft platform SDK for windows->
open build environment window->windows 200 build environment->
set windows 2000 build environment (retail)
This should open a command prompt with all the environment variables
set up to access the platform SDK etc. You then need to set the
environment variables for Visual Studio by issuing the command
vcvars32.bat in the window.
Change directory to your working directory e.g.
cd c:\php-build. Then
make sure the win32build tools are accessible by adding them to the
PATH environment variable:
set PATH=..\win32build\bin;%PATH%
Run the buildconf.bat command. This should rebuild the
configure.js file.
Run the cscript command with the appropriate options. To build just the
SAM extension framework and MQTT support use:
cscript /nologo configure.js --with-sam
To build the SAM framework and the XMS support use:
cscript /nologo configure.js --with-sam --with-sam_xms="c:\program files\ibm\xms"
The additional parameter passed for sam_xms is the installation path to the
XMS libraries and runtime that were installed as described under prerequisites
at the top of this page.
You can specify whatever other cscript parameters you require to
include or exclude items from the php build or select options.
Assuming all has gone well so far you can now finally run a make for the SAM framework!
nmake php_sam.dll
Also if you are using the XMS support you must make the sam_xms extensions:
nmake php_sam_xms.dll
If you have used Visual Studio 2005 to build the DLLs please see below for additional steps that
must be carried out before proceeding further.
The DLLs created (php_sam.dll and optionally
php_sam_xms.dll) can now be copied to the subdirectory
appropriate for your PHP set-up. Make sure that the module(s) are loaded by
PHP, by adding following line to php.ini:
extension=php_sam.dll
If you intend to use the XMS support to access the IBM Messaging and Queuing family
you must also enable the SAM XMS extension.
extension=php_sam_xms.dll