Edit Report a Bug

    oci_parse

    (PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)

    oci_parse — Prépare une requête SQL avec Oracle

    Description

    oci_parse(resource $connection, string $sql): resource|false

    Prépare la requête sql en utilisant la connexion connection et retourne l'identifiant de requête qui pourra être utilisé avec les fonctions oci_bind_by_name(), oci_execute(), etc..

    Les identifiants de requête peuvent être libérés en utilisant la fonction oci_free_statement() ou en définissant la variable correspondante à la valeur null.

    Liste de paramètres

    connection

    Un identifiant de connexion Oracle, retourné par la fonction oci_connect(), oci_pconnect() ou oci_new_connect().

    sql

    La requête SQL ou PL/SQL.

    Les requêtes SQL ne doivent pas se terminer par un point-virgule (";"). Les requêtes PL/SQL doivent se terminer par un point-virgule (";").

    Valeurs de retour

    Retourne un gestionnaire de requête en cas de succès, ou false si une erreur survient.

    Exemples

    Exemple #1 Exemple avec oci_parse()

    <?php

    $conn     = oci_connect('hr', 'welcome', 'localhost/XE');

    // Analyse de la requête. Notez qu'il n'y a pas de point-virgule à la fin de la requête SQL
    $stid = oci_parse($conn, 'SELECT * FROM employees');
    oci_execute($stid);

    echo     "<table border='1'>\n";
    while (    $row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) {
    echo     "<tr>\n";
    foreach (    $row as $item) {
    echo     " <td>" . ($item !== null ? htmlentities($item, ENT_QUOTES) : "") . "</td>\n";
    }
    echo     "</tr>\n";
    }
    echo     "</table>\n";

    ?>

    Exemple #2 Exemple avec oci_parse() et une requête PL/SQL

    <?php

    /*
    Avant d'exécuter ce code PHP, vous devez créer une procédure stockée en
    SQL*Plus ou SQL Developer:

    CREATE OR REPLACE PROCEDURE myproc(p1 IN NUMBER, p2 OUT NUMBER) AS
    BEGIN
    p2 := p1 * 2;
    END;

    */

    $conn = oci_connect('hr', 'welcome', 'localhost/XE');
    if (!    $conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
    }

    $p1 = 8;

    // Lors de l'analyse PL/SQL, il doit y avoir un point-virgule à la fin de la chaîne
    $stid = oci_parse($conn, 'begin myproc(:p1, :p2); end;');
    oci_bind_by_name($stid, ':p1', $p1);
    oci_bind_by_name($stid, ':p2', $p2, 40);

    oci_execute($stid);

    print     "$p2\n"; // affiche 16

    oci_free_statement($stid);
    oci_close($conn);

    ?>

    Notes

    Note:

    Cette fonction ne valide pas la requête sql. La seule façon de savoir si la requête sql est valide est de l'exécuter.

    Voir aussi

    add a note add a note

    User Contributed Notes 5 notes

    up
    0
    interloper at ukr dot net
    9 years ago
    If you want using PL/SQL in variable:

    <?php
    $query     = "begin null;  end;";
    $stid = oci_parse($conn, "$query");
    ?>

    or

    <?php
    $stid     = oci_parse($conn, "begin null;  end;");
    ?>
    up
    0
    michael dot virnstein at brodos dot de
    16 years ago
    A neat way to parse a query only once per script, if the query is done inside a function:

    <?php
    function querySomething($conn, $id)
    {
        static     $stmt;

        if (    is_null($stmt)) {
                $stmt = oci_parse($conn, 'select * from t where pk = :id');
        }

            oci_bind_by_name($stmt, ':id', $id, -1);

            oci_execute($stmt, OCI_DEFAULT);

        return     oci_fetch_array($stmt, OCI_ASSOC);

    }

    ?>

    With the static variable, the statment handle isn't closed after the function has terminated. Very nice for functions that are called e.g. in loops. Unfortunately this only works for static sql. If you have dynamic sql, you can do the following:

    <?php

    function querySomething($conn, $data)
    {
        static     $stmt = array();
       
            $first = true;
       
            $query = 'select * from t';

        foreach (    $data as $key => $value) {
            if (    $first) {
                    $first = false;
                    $query .= ' where ';
            } else {
                    $query .= ' and ';
            }
           
                $query .= "$key = :b$key";
        }
       
            $queryhash = md5($query);
      
        if (    is_null($stmt[$queryhash])) {
                $stmt[$queryhash] = oci_parse($conn, $query);   
        }

        foreach (    $data as $key => $value) {
                // don't use $value, because we bind memory addresses here.
            // this would result in every bind pointing at the same value after foreach
                oci_bind_by_name($stmt[$queryhash], ":b$key", $data[$key], -1);
        }
       
            oci_execute($stmt[$queryhash], OCI_DEFAULT);

        return     oci_fetch_array($stmt[$queryhash], OCI_ASSOC);

    }

    ?>
    up
    0
    kurt at kovac dot ch
    20 years ago
    For those that are having trouble with error checking, i have noticed on a lot of sites that people are trying to check the statement handle for error messages with OCIParse. Since the statement handle ($sth) is not created yet, you need to check the database handle ($dbh) for any errors with OCIParse. For example:

    instead of:

    <?php
    $stmt     = OCIParse($conn, $query);
    if (!    $stmt) {
           $oerr = OCIError($stmt);
       echo     "Fetch Code 1:".$oerr["message"];
       exit;
    }
    ?>

    use:

    <?php
    $stmt     = OCIParse($conn, $query);
    if (!    $stmt) {
           $oerr = OCIError($conn);
       echo     "Fetch Code 1:".$oerr["message"];
       exit;
    }
    ?>

    Hope this helps someone.
    up
    0
    egypt at nmt dot edu
    21 years ago
    Whereas MySQL doesn't care what kind of quotes are around a LIKE clause, ociexecute gives the error:
        ociexecute(): OCIStmtExecute: ORA-00904: "NM": invalid identifier
    for the following.
    <?php
    $sql      = "SELECT * FROM addresses "
              . "WHERE state LIKE \"NM\"";  // error!
    $stmt = ociparse($conn, $sql);
    ociexecute($stmt);
    ?>

    it's fine if you just use single quotes:
        . "WHERE state LIKE 'NM'";
    but i think it's interesting that ociparse doesn't say anything
    up
    -5
    falundir at gmail dot com
    13 years ago
    When you want to call stored function (and want to read its result) which executes DML queries (insert, update, delete) inside its body you can't use "select your_stored_function(:param1, :param2) from dual" because you will receive "ORA-14551: cannot perform a DML operation inside a query" error.

    In order to call such function and get its result you need to wrap it into nested procedure with OUT parameter like this:

    DECLARE
      PROCEDURE caller(return_value OUT NUMBER) AS
      BEGIN
        return_value := your_stored_function(:param1, :param2);
      END;
    BEGIN
      caller(:return_value);
    END;

    and bind to :return_value variable to get the result of function.
    add a note add a note
    To Top