mssql_bind(3) [php man page]

MSSQL_BIND(3)															     MSSQL_BIND(3)

mssql_bind - Adds a parameter to a stored procedure or a remote stored procedure

SYNOPSIS

       bool mssql_bind (resource  $stmt, string  $param_name, mixed  &$var, int  $type, [bool  $is_output = false], [bool  $is_null = false], [int
       $maxlen = -1])

DESCRIPTION

	Binds a parameter to a stored procedure or a remote stored procedure.

PARAMETERS

	      o $stmt
		- Statement resource, obtained with mssql_init(3).

	      o $param_name
		- The parameter name, as a string.

	      Note

		      You have to include the @ character, like in the T-SQL syntax. See the explanation included in mssql_execute(3).

	      o $var
		- The PHP variable you'll bind the MSSQL parameter to. It is passed by reference, to retrieve OUTPUT and RETVAL values	after  the
		procedure execution.

	      o $type
		- One of: SQLTEXT, SQLVARCHAR, SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT, SQLFLT4, SQLFLT8, SQLFLTN.

	      o $is_output
		-  Whether  the value is an OUTPUT parameter or not. If it's an OUTPUT parameter and you don't mention it, it will be treated as a
		normal input parameter and no error will be thrown.

	      o $is_null
		- Whether the parameter is NULL or not. Passing the NULL value as $var will not do the job.

	      o $maxlen
		- Used with char/varchar values. You have to indicate the length of the data so if the parameter is a varchar(50), the	type  must
		be SQLVARCHAR and this value 50.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      mssql_bind(3) example

	      <?php
	      // Connect to MSSQL and select the database
	      mssql_connect('KALLESPCSQLEXPRESS', 'sa', 'phpfi');
	      mssql_select_db('php');

	      // Create a new stored prodecure
	      $stmt = mssql_init('NewUserRecord');

	      // Bind the field names
	      mssql_bind($stmt, '@username',  'Kalle',	SQLVARCHAR,  false,  false,  60);
	      mssql_bind($stmt, '@name',      'Kalle',	SQLVARCHAR,  false,  false,  60);
	      mssql_bind($stmt, '@age',       19,	SQLINT1,     false,  false,   3);

	      // Execute
	      mssql_execute($stmt);

	      // Free statement
	      mssql_free_statement($stmt);
	      ?>

SEE ALSO

       mssql_execute(3), mssql_free_statement(3), mssql_init(3).

PHP Documentation Group 													     MSSQL_BIND(3)

SQLSRV_EXECUTE(3)														 SQLSRV_EXECUTE(3)

sqlsrv_execute - Executes a statement prepared withsqlsrv_prepare(3)

SYNOPSIS

       bool sqlsrv_execute (resource  $stmt)

DESCRIPTION

	Executes  a  statement prepared with sqlsrv_prepare(3). This function is ideal for executing a prepared statement multiple times with dif-
       ferent parameter values.

PARAMETERS

	      o $stmt
		- A statement resource returned by sqlsrv_prepare(3).

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      sqlsrv_execute(3) example

	       This example demonstrates how to prepare a statement with sqlsrv_prepare(3) and re-execute it multiple times (with different param-
	      eter values) using sqlsrv_execute(3).

	      <?php
	      $serverName = "serverNamesqlexpress";
	      $connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
	      $conn = sqlsrv_connect( $serverName, $connectionInfo);
	      if( $conn === false) {
		  die( print_r( sqlsrv_errors(), true));
	      }

	      $sql = "UPDATE Table_1
		      SET OrderQty = ?
		      WHERE SalesOrderID = ?";

	      // Initialize parameters and prepare the statement.
	      // Variables $qty and $id are bound to the statement, $stmt.
	      $qty = 0; $id = 0;
	      $stmt = sqlsrv_prepare( $conn, $sql, array( &$qty, &$id));
	      if( !$stmt ) {
		  die( print_r( sqlsrv_errors(), true));
	      }

	      // Set up the SalesOrderDetailID and OrderQty information.
	      // This array maps the order ID to order quantity in key=>value pairs.
	      $orders = array( 1=>10, 2=>20, 3=>30);

	      // Execute the statement for each order.
	      foreach( $orders as $id => $qty) {
		  // Because $id and $qty are bound to $stmt1, their updated
		  // values are used with each execution of the statement.
		  if( sqlsrv_execute( $stmt ) === false ) {
			die( print_r( sqlsrv_errors(), true));
		  }
	      }
	      ?>

NOTES

	When  you  prepare  a statement that uses variables as parameters, the variables are bound to the statement. This means that if you update
       the values of the variables, the next time you execute the statement it will run with updated parameter values.	For  statements  that  you
       plan to execute only once, use sqlsrv_query(3).

SEE ALSO

       sqlsrv_prepare(3), sqlsrv_query(3).

PHP Documentation Group 													 SQLSRV_EXECUTE(3)