Edit Report a Bug

    mssql_init

    (PHP 4 >= 4.0.7, PHP 5, PECL odbtp >= 1.1.1)

    mssql_init — ストアドプロシージャまたはリモートのストアドプロシージャを初期化する

    警告

    この関数は PHP 7.0.0 で 削除 されました。

    この関数の代替として、これらが使えます。

    説明

    mssql_init ( string $sp_name [, resource $link_identifier ] ) : resource

    ストアドプロシージャまたはリモートのストアドプロシージャを初期化します。

    パラメータ

    sp_name

    ストアドプロシージャ名。たとえば ownew.sp_name や otherdb.owner.sp_name のようになります。

    link_identifier

    mssql_connect() が返す MS SQL リンク ID。

    返り値

    "statement" リソースの ID を返します。これを使用して、 mssql_bind() や mssql_execute() をコールします。エラー時には FALSE を返します。

    例

    例1 mssql_init() の例

    <?php
    // MSSQL に接続し、データベースを選択します
    $link = mssql_connect('KALLESPC\SQLEXPRESS', 'sa', 'phpfi');
    mssql_select_db('php', $link);

    // 新しいステートメントを作成します
    $stmt = mssql_init('StatementTest', $link);

    // ここで値をバインドします

    // 値をバインドしたら、
    // mssql_execute でステートメントを実行します
    mssql_execute($stmt);

    // そして次のようにして開放します
    mssql_free_statement($stmt);
    ?>

    参考

    • mssql_bind() - ストアドプロシージャまたはリモートストアドプロシージャへパラメータを追加する
    • mssql_execute() - MS SQL サーバーデータベースでストアドプロシージャを実行する
    • mssql_free_statement() - ステートメントのメモリを開放する

    add a note add a note

    User Contributed Notes 2 notes

    up
    1
    shrockc at NOinhs dot orgSPAM
    22 years ago
    If you are performing a stored procedure inside a loop, it is a good idea to unset the variable that mssql_init returns so that you do NOT bind multiple values to the same stored procedure:

    foreach($input  as $sid=>$value) {
      $stmt = mssql_init("sp_doSomething");
      mssql_bind($stmt, "@sid", $sid, SQLINT4, false);
      mssql_bind($stmt, "@value", $value, SQLINT4, false);
      $result = mssql_execute($stmt);
      unset($stmt);  // <---VERY important
    }

    Even doing the mssql_init outside the loop does not help because of the multiple binds happening inside the loop.

    Failing to do the above generates "Access Violations...memory cannot be 'written'" errors on the server.  My hypothesis is that the error is generated when you try to bind to a stored procedure after it has already been executed.  You have been warned.
    up
    0
    fjortizATcomunetDOTes
    22 years ago
    this function was created to support 
    OUTPUT parameters and return values with
    MSSQL stored procedures. Before this,
    you could use T-SQL statement EXECUTE
    and mssql_query to execute a stored
    procedure, and it was fine as long as
    you don't need to retrieve OUTPUT or
    RETVAL values.


    Now you can use this set of functions to execute and retrieve these values:
    mssql_init
    mssql_bind
    mssql_execute

    Parameters:
    - sp_name : stored procedure name. It passes this string to a native DB-lib call, so I guess it supports all kinds of schemas (like "ownew.sp_name" or "otherdb.owner.sp_name")

    - connection id: a connection resource
    obtained with mssql_connect or similar.
    If not provided, it will proceed just
    like other similar mssql_* functions:
    uses a default open connection or
    creates a new one.

    Return value: a resource id, called
    "statement", used in subsequent calls to
    mssql_bind and mssql_execute.

    Note that many of the native MSSQL data types are directly supported, but I
    think that some others must be converted
    by other means (from varchar values for
    example). These unsupported types are:

    SQLMONEY4,SQLMONEY,SQLBIT,SQLDATETIM4,
    SQLDATETIME, SQLDECIMAL, SQLNUMERIC,
    SQLVARBINARY, SQLBINARY,SQLIMAGE

    More info on supported types and new constants in mssql_bind
    add a note add a note
    To Top