Edit Report a Bug

    Fonctions IBM DB2

    Sommaire

    • db2_autocommit — Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données
    • db2_bind_param — Associe une variable PHP à un paramètre d'une requête SQL
    • db2_client_info — Retourne un objet avec des propriétés qui décrivent le client de base de données DB2
    • db2_close — Ferme une connexion de base de données
    • db2_column_privileges — Retourne un jeu de résultats listant les colonnes et ses privilèges d'une table
    • db2_columns — Retourne un jeu de résultats listant les colonnes et ses métadonnées d'une table
    • db2_commit — Valide la transaction
    • db2_conn_error — Retourne une chaîne contenant la valeur de SQLSTATE retournée par la dernière tentative de connexion
    • db2_conn_errormsg — Retourne le dernier message d'erreur de connexion ainsi que la valeur de SQLCODE
    • db2_connect — Retourne une connexion à une base de données
    • db2_cursor_type — Retourne le type de curseur utilisé par une ressource
    • db2_escape_string — Utilisé pour échapper certains caractères
    • db2_exec — Exécute une requête SQL directement
    • db2_execute — Exécute une requête SQL préparée
    • db2_fetch_array — Retourne un tableau, indexé par la position des colonnes, représentant une ligne du jeu de résultats
    • db2_fetch_assoc — Retourne un tableau, indexé par nom de colonne, représentant une ligne du jeu de résultats
    • db2_fetch_both — Retourne un tableau, indexé par nom de colonne et position, représentant une ligne du jeu de résultats
    • db2_fetch_object — Retourne un objet avec les propriétés représentant des colonnes dans la ligne extraite
    • db2_fetch_row — Modifie le pointeur du jeu de résultat à la prochaine ligne ou à la ligne demandée
    • db2_field_display_size — Retourne le maximum d'octets requis pour afficher une colonne
    • db2_field_name — Retourne le nom de la colonne du jeu de résultats
    • db2_field_num — Retourne la position du nom de la colonne du jeu de résultats
    • db2_field_precision — Retourne la précision de la colonne indiquée du jeu de résultats
    • db2_field_scale — Retourne l'échelle de la colonne indiquée du jeu de résultats
    • db2_field_type — Retourne le type de donnée de la colonne indiquée du jeu de résultats
    • db2_field_width — Retourne la largeur de la valeur courante de la colonne indiquée du jeu de résultats
    • db2_foreign_keys — Retourne un jeu de résultats listant les clés étrangères d'une table
    • db2_free_result — Libère la mémoire associée à un jeu de résultats
    • db2_free_stmt — Libère la mémoire associée à la ressource indiquée
    • db2_get_option — Récupère la valeur d'une option pour une requête ou une connexion
    • db2_last_insert_id — Retourne le dernier ID généré par la dernière requête d'insertion
    • db2_lob_read — Récupère de grands objets binaires de tailles prédéfinies à chaque invocation
    • db2_next_result — Demande le prochain jeu de résultats de la ressource indiquée
    • db2_num_fields — Retourne le nombre de champs contenu du jeu de résultats
    • db2_num_rows — Retourne le nombre de lignes affectées par une requête SQL
    • db2_pclose — Ferme une connexion persistante à la base de données
    • db2_pconnect — Retourne une connexion persistante à une base de données
    • db2_prepare — Prépare une requête SQL à être exécutée
    • db2_primary_keys — Retourne un jeu de résultats listant les clés d'une table
    • db2_procedure_columns — Retourne un jeu de résultats listant les paramètres de procédure d'enregistrement
    • db2_procedures — Retourne un jeu de résultats listant les procédures d'enregistrement enregistrées dans la base de données
    • db2_result — Retourne une colonne d'une ligne d'un jeu de résultats
    • db2_rollback — Annule une transaction
    • db2_server_info — Retourne un objet avec des propriétés qui décrivent le serveur de base de données DB2
    • db2_set_option — Fixe des options pour une connexion ou des ressources
    • db2_special_columns — Retourne un jeu de résultats listant les identifiants uniques des lignes d'une table
    • db2_statistics — Retourne un jeu de résultats listant les index et statistiques d'une table
    • db2_stmt_error — Retourne une chaîne contenant la valeur de SQLSTATE retournée par une requête SQL
    • db2_stmt_errormsg — Retourne le dernier message d'erreur d'une requête SQL
    • db2_table_privileges — Retourne un jeu de résultats listant les tables et leurs privilèges qui leur sont associées d'une base de données
    • db2_tables — Retourne la liste des tables et leurs métadonnées
    add a note add a note

    User Contributed Notes 5 notes

    up
    3
    Richard dot Ablewhite at gmail dot com
    16 years ago
    There seems to be a lot of good documentation
    for Linux users compiling PHP with DB2 support,
    but decent Windows notes are minimal.

    You do not need to install full DB2 clients to get DB2
    working with DB2, all you need is the IBM Data
    Server Driver for ODBC, CLI, and .NET which is only
    16.1 meg.

    You can download the driver from here:

    Direct Link:
    ftp://ftp.software.ibm.com/ps/products/db2/fixes2/englsh-us/
    db2_v95/dsdriver/fp2/v9.5fp2_nt32_dsdriver_EN.exe

    Home Page:
    http://www-01.ibm.com/support/docview.wss?rs=71&uid=swg21287889

    This includes both the drivers required and the PHP
    dll php_ibm_db2_5.2.2.dll

    Once installed the drivers do not setup the correct
    path environmental variable,
    so add the following to your path:

    C:\Program Files\IBM\IBM DATA SERVER DRIVER\bin

    Once thats done all should work! No massive
    400meg client downloads required.

    Whats even better about these drivers is that you
    dont need to install them,
    you can simply copy the bin directory to any server,
    add it to your path and it will just work.
    This is great for anyone developing PHP-GTK applications,
    I copy the bin directory into my php-gkt2 directory
    and execute using the following batch script:

    path = %PATH%;.\IBM DATA SERVER DRIVER\bin
    php-win.exe %*

    This lets me role out lightweight DB2 client desktop
    apps that dont have to be installed,
    can just be coppied from PC to PC or ran over a
    network or from USB stick.

    As your only installing the client drivers you wont be
    able to catalog databases,
    so always use the full connection string. Here is a
    quick bit of code to get you started:

    $database = 'databasename';
    $user = 'user';
    $password = 'password';
    $hostname = '127.0.0.1';
    $port = 50000;

    $conn_string = "DRIVER={IBM DB2 ODBC DRIVER};DATABASE=$database;" .
      "HOSTNAME=$hostname;PORT=$port;".
      "PROTOCOL=TCPIP;UID=$user;PWD=$password;";
    $conn = db2_connect($conn_string, '', '');

    $query = 'SELECT * FROM TABLE';
    $res = db2_prepare($conn, $query);
    db2_execute($res);

    while ($row = db2_fetch_array($res)) {
      print_r($row);
    }
    up
    3
    igtoth at gmail dot com
    10 years ago
    // IBM DB2 funcitons like MySQL (ODBC based)
    // "Ighor Toth" <igtoth@gmail.com>
    // Date: 08/05/2014

    // usage:
    // db2_connect(verbose,instance,username,password); -> also reads config file if nothing declared db2.conf.inc.php
    // db2_query(db2_connect_return,sql)
    // db2_fetch_array(result);
    // db2_fetch_object(result);
    // db2_display_table(db2_connect_return,sql); // select only

    function db2_connect($verbose = null,$db2name = null,$username = null,$password = null) {
        if(!isset($verbose)){
            $verbose = TRUE; // TRUE or FALSE, if not set TRUE
        }
        if(!isset($db2name)){ // NOT DECLARED
            include("db2.conf.inc.php"); // CHECK CONFIG FILE
            if(!isset($db2name)){
                if ($verbose == TRUE){
                    echo ("DB2 Instance not selected");
                    exit();
                } else {
                    exit();
                }
            }
        } else if (!isset($username)){
            echo ("DB2 Instance username not specified");
            exit();   
        }
        $db2conn = odbc_connect($db2name, $username, $password);
        if (($verbose == TRUE) && ($db2conn == 0)) {
            echo("Connection to database failed.");
            $sqlerror = odbc_errormsg($db2conn);
            echo($sqlerror);
        }
        return($db2conn);
    }

    function db2_query($db2conn,$sql){
        $result = odbc_exec($db2conn, $sql);
        if ($result == 0) {
            echo("QUERY = '$sql' FAILED.<br>\n");
            $sqlerror = odbc_errormsg($db2conn);
            echo($sqlerror);
        } else {
            // odbc_result_all prints all of the rows
            // for a result set ID as an HTML table
            return $result;
        }
    }

    function db2_fetch_array($result, $rownumber=null){
        $array = array();
        if (!($cols = odbc_fetch_into($result, $result_array, $rownumber))) {
            return false;
        }
        for ($i = 1; $i <= $cols; $i++) {
            $array[odbc_field_name($result, $i)] = $result_array[$i - 1];
        }
        return $array;
    }

    function db2_fetch_object($result){
        if(function_exists("db2_fetch_object")) return db2_fetch_object($result);
        $rs = array();
        $rs_obj = false;
        if( odbc_fetch_into($result, $rs) ){
            foreach( $rs as $key=>$value ){
                $fkey = odbc_field_name($result, $key+1);
                $rs_obj->$fkey = trim($value);
            }
        }
        return $rs_obj;
    }

    function db2_display_table($db2conn,$sql) {
        // select all rows from the table
        if(!isset($db2conn)||!isset($sql)){
            echo("ERROR db2_display_table: Function missing arguments");
            exit();
        }
        $check = explode(" ",$sql);
        if($check[0]!="SELECT"){
            echo("ERROR db2_display_table: Not SELECT SQL query");
        }
        if ($db2conn != 0) {
            // odbc_exec returns 0 if the statement fails;
            // otherwise it returns a result set ID
            $result = odbc_exec($db2conn, $sql);
            if ($result == 0) {
                echo("SELECT statement failed.");
                $sqlerror = odbc_errormsg($db2conn);
                echo($sqlerror);
            } else {
                // odbc_result_all prints all of the rows
                // for a result set ID as an HTML table
                odbc_result_all($result);
            }
        }
    }
    up
    1
    brent dot halsey at gmail dot com
    16 years ago
    Spent a lot of time trying to get this to work on a 64bit box.  You'll need to make sure you set your db2 client to 64 bit mode!  If you didn't set your instance to 64bit, you can run ./db2iupdt -w64 db2instance as root to set it.  Hope this helps someone!
    up
    0
    Exi
    16 years ago
    The DB/2 Run-Time-Client can be found here:
    http://www-1.ibm.com/support/docview.wss?rs=71&uid=swg21255394
    Select the 'Runtime Client Installable for Windows' further down the page and download it.
    Clients for other platform (incl. 64-Bit Windows) are also available from that page.
    up
    -1
    kfoubert at sitecrafting dot com
    16 years ago
    If you wish to connect to an iSeries Server, such as an AS/400, there are two options. Installing DB2 Express-C v9.5 and purchasing DB2 Connect Personal Edition for about $500 or getting System I Access for Linux, which is a free download. Please note the server requirements for each of these. For example, we originally went with DB2 Express-C and decided upon Ubuntu 7.10, but learned about System I Access, from an IBM rep, which requires redhat package manager, after the entire server was up and running.

    DB2 Express-C
    http://www-306.ibm.com/software/data/db2/express/

    DB2 Connect Personal
    http://www-306.ibm.com/software/data/db2/db2connect/edition-pe.html

    System I Access for Linux
    http://www-03.ibm.com/systems/i/software/access/index.html
    NOTE: System I Access requires redhat package manager.
    add a note add a note
    To Top