Executing SQL Server Stored Procedures With PHP - Executing stored procedures

(Page 4 of 6 )

Executing a stored procedure with PHP and the mssql_xxx set of functions is easy. To execute a stored procdure that accepts no parameters and doesn't return a value, we only need to make use of the mssql_init and mssql_execute functions.

Open query analyzer on your SQL Server and run the following code:

USE Northwind

GO

CREATE PROC sp_AddNewShipper

AS

-- Add a record to the shippers table

INSERT INTO Shippers(CompanyName, Phone)

VALUES('Johns Shipping', '(555) 555-0493')

We've just created a new stored procedure that's attached to the Northwind database. It's called sp_AddNewShipper. When it is executed, it will add a new record to the shippers table and won't return a value.

To execute sp_AddNewShipper from PHP, create a new file called shipper.php and enter the following code into it:

<?php

$myServer = "localhost";

$myUser = "sa";

$myPass = "";

$myDB = "Northwind";

$s = @mssql_connect($myServer, $myUser, $myPass)

or die("Couldn't connect to SQL Server on $myServer");

$d = @mssql_select_db($myDB, $s)

or die("Couldn't open database $myDB");

$query = mssql_init("sp_AddNewShipper", $s);

$result = mssql_execute($query);

?>

When you run the script in your web browser and then check the shippers table of your Northwind database, you'll see that we've just added a new record:



The only new parts of our code are the calls to mssql_init and mssql_execute:

$query = mssql_init("sp_AddNewShipper", $s);

$result = mssql_execute($query);

The call to mssql_init initializes our call to the sp_AddNewShipper stored procedure. It's main use is to facilitate the addition of output parameters for stored procedure calls (which we will look at next), and its signature looks like this:

int mssql_init ( string sp_name [, int conn_id])

It accepts the name of the stored procedure as well as an optional connection identifier, which we've passed in as $s. It returns a numerical identifier that we then pass to mssql_execute. Mssql_execute actually creates all of the necessary SQL plumbing and executes our stored procedure on the SQL Server. Its signature looks like this:

int mssql_execute ( int stmt)

Nothing to really explain about the mssql_execute function except that it takes the identifier of the statement to execute (which is returned by a call to mssql_init) and returns a result that can optionally include one/more records.

It's good to be able to execute stored procedures that don't accept or return any parameters, but in the real world stored procedures usually accept and/or return both parameters and values.

Clear your query analyzer window and enter the following batch of TSQL code:

USE Northwind

GO

CREATE PROC sp_GetProductsBySupplier

@supplierId TINYINT

AS

-- Return products whose supplierId field is @supplierId

SELECT ProductName

FROM Products

WHERE SupplierID = @supplierId

ORDER BY ProductName ASC

We've just created a stored procedure called sp_GetProductsBySupplier. It accepts one integer input parameter called SupplerID, which will be used to return all products from the Northwind products table based on that products SupplierID field.

We can now use PHP and the mssql_xxx functions to execute our stored procedure, passing in an input parameter that contains an integer value (which will be used to filter the products based on their SupplierID field). Create a new file called products.php and enter the following code into it:

<?php

$myServer = "localhost";

$myUser = "sa";

$myPass = "";

$myDB = "Northwind";

$s = @mssql_connect($myServer, $myUser, $myPass)

or die("Couldn't connect to SQL Server on $myServer");

$d = @mssql_select_db($myDB, $s)

or die("Couldn't open database $myDB");

$query = mssql_init("sp_GetProductsBySupplier", $s);

$supId = 2;

mssql_bind($query, "@supplierId", &$supId, SQLINT2);

$result = mssql_execute($query);

$numProds = mssql_num_rows($result);

echo "<h1>" . $numProds . " Product" . ($numProds == 0 ? "" : "s") . " Found: </h1>";

while($row = mssql_fetch_row($result))

{

echo "<li>" . $row[0] . "</li>";

}

?>

Here's a screen shot of the output from products.php:



We can also run our stored procedure using query analyzer with the following code:

USE Northwind

GO

EXEC sp_GetProductsBySupplier 2

... which produces the following output in query analyzer:



The only new mssql function that we're calling in products.php is mssql_bind, which we can use to create a new input/output parameter for our stored procedure. Its signature looks like this:

int mssql_bind ( int stmt, string param_name, mixed var, int type [, int is_output [, int is_null [, int maxlen]]])

In our example we want to pass in one numerical input parameter, so we use mssql_bind like this:

mssql_bind($query, "@supplierId", $supId, SQLINT2);

For the type parameter, I've specified SQLINT2, which is defined by PHP internally to represent an integer of two bytes. Other possible values for the type parameter include SQLTEXT, SQLVARCHAR, SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT and SQLFLT8.

I haven't specified a value for the is_output, is_null and maxlen parameters. If I wanted to, I could've specified FALSE for is_output, meaning that our parameter is an input parameter and not an output parameter (is_output defaults to false anyway, so I chose not to specify it).

Once we've bound our parameter to our stored procedure, we execute the stored procedure using mssql_execute, capturing its recordset into a variable called $result:

$result = mssql_execute($query);

Next: Capturing output parameters and return values >>
 

More PHP Articles
More By Joe O'Donnell

Comments On: Executing SQL Server Stored Procedures With PHP

>>> Be the FIRST to comment on this article!