[edit] Last updated: Mon, 01 Nov 2010

LVII. Fonctions IBM DB2, Cloudscape et Apache Derby

Introduction

Ces fonctions vous permettent un accès aux IBM DB2 Universal Database, IBM Cloudscape et Apache Derby qui utilisent DB2 Call Level Interface (DB2 CLI).

Pré-requis

Pour se connecter à des bases de données IBM DB2 Universal Database pour linux, UNIX et Windows ou IBM Cloudscape ou Apache Derby, vous devez installer un client IBM DB2 Universal Database sur le même ordinateur qui utilise PHP. Cette extension a été développé et testé avec DB2 Version 8.2.

Pour se connecter à des bases de données IBM DB2 Universal Database pour z/OS ou iSeries, vous aurez aussi besoin de IBM DB2 Connect ou l'équivalent d'un programme DRDA.

Requirements on Linux or Unix

L'utilisateur appelant l'exécutable PHP ou module SAPI doit spécifier l'instance DB2 avant d'accéder à ces fonctions. Vous pouvez spécifier le nom de l'instance DB2 dans php.ini en utilisant l'option de configuration ibm_db2.instance_name ou vous pouvez approvisionner le profile de l'instance DB2 avant d'appeler l'exécutable PHP.

Si vous avez créée une instance DB2 nommée db2inst1 dans /home/db2inst1, par exemple, vous pouvez ajouter la ligne suivante à votre php.ini :

ibm_db2.instance_name=db2inst1

Si vous ne spécifiez pas cette option dans php.ini, vous devez exécuter la commande suivante pour modifier vos variables d'environnement pour autoriser l'accès à DB2 :

bash$ source /home/db2inst1/sqllib/db2profile

Pour permettre votre PHP sur votre serveur web d'accéder à ces fonctions, vous devez ajouter la même commande à votre script de démarrage de votre serveur Web (typiquement /etc/init.d/httpd or /etc/init.d/apache).

Installation

Pour compiler l'extension ibm_db2, les fichiers d'en-tête et de bibliothèques de l'application de développement de DB2 doivent être présents sur votre système. DB2 ne les installe pas par défaut, vous devrez donc retourner à l'installation de DB2 et ajouter cette option. Les en-têtes des fichiers sont inclus avec le client de développement d'application DB2, disponible librement au téléchargement depuis le support du site de la base de données universelle.

Si vous ajoutez les fichiers d'en-têtes et de bibliothèques de l'application de développement de DB2 sur un système Linux ou Unix où DB2 est déjà installé, vous devez lancer la commande db2iupdt -e pour mettre à jour les liens symboliques dans les fichiers d'en-têtes et de bibliothèques de vos exemples DB2.

ibm_db2 est une extension PECL, alors suivez les instructions présentes dans Chapitre 7 pour installer l'extension ibm_db2 pour PHP. Tapez la commande configure pour pointer vers l'emplacement de vos fichiers d'en-têtes et de bibliothèques de DB2 comme suit :

bash$ ./configure --with-IBM_DB2=/chemin/vers/DB2

La commande configure prend la valeur par défaut de /opt/IBM/db2/V8.1.

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Tableau 1. Options de configuration ibm_db2

Nom	Par défaut	Modifiable	Historique
ibm_db2.binmode	"1"	PHP_INI_ALL
ibm_db2.instance_name	`NULL`	PHP_INI_SYSTEM

Voici un éclaircissement sur l'utilisation des directives de configuration.

ibm_db2.binmode (entier)

Cette option contrôle le mode utilisé pour convertir à partir ou vers les données binaires dans l'application PHP.

1 (DB2_BINARY)
2 (DB2_CONVERT)
3 (DB2_PASSTHRU)

ibm_db2.instance_name (chaîne de caractères)

Sur les systèmes d'exploitation Linux et UNIX, cette option définit le nom de l'instance à utiliser pour les connexions aux bases de données cataloguées. Si cette option est utilisée, sa valeur prévaut sur la variable d'environnement DB2INSTANCE.

Cette option est ignorée sur les systèmes d'exploitation Windows.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

DB2_BINARY (entier): Spécifie que les données binaires seront retournées comme elles sont. Ceci est le mode par défaut.
DB2_CONVERT (entier): Spécifie que les données binaires seront converties en hexadécimal et retournées comme une chaîne ASCII.
DB2_PASSTHRU (entier): Spécifie que les données binaires seront converties en valeur NULL.
DB2_SCROLLABLE (entier): Spécifie le curseur flottant pour une déclaration de ressource. Ce mode permet un accès aléatoire aux lignes du jeu de résultats, mais présentement, il est supporté seulement par IBM DB2 Universal Database.
DB2_FORWARD_ONLY (entier): Spécifie un curseur d'avancement seul pour une déclaration de ressource. Il s'agit de la valeur par défaut de ce type de curseur, et il est supporté par tous les serveurs de base de données.
DB2_PARAM_IN (entier): Spécifie que la variable PHP doit être lié comme étant un paramètre ENTRANT pour une procédure d'enregistrement.
DB2_PARAM_OUT (entier): Spécifie que la variable PHP doit être lié comme étant un paramètre SORTANT pour une procédure d'enregistrement.
DB2_PARAM_INOUT (entier): Spécifie que la variable PHP doit être lié comme étant un paramètre ENTRANT/SORTANT pour une procédure d'enregistrement.
DB2_PARAM_FILE (entier): Spécifie que la colonne doit être lié directement à un fichier pour entrée.
DB2_AUTOCOMMIT_ON (entier): Spécifie que autocommit doit être activé.
DB2_AUTOCOMMIT_OFF (entier): Spécifie que autocommit doit être désactivé.
DB2_DOUBLE (entier): Spécifie que la variable doit être lié à un type DOUBLE, FLOAT ou REAL.
DB2_LONG (entier): Spécifie que la variable doit être lié à un type SMALLINT, INTEGER ou BIGINT.
DB2_CHAR (entier): Spécifie que la variable doit être lié à un type CHAR ou VARCHAR
DB2_CASE_NATURAL (entier): Spécifie que les noms de colonnes doivent être retournés dans leurs casses naturelles.
DB2_CASE_LOWER (entier): Spécifie que les noms de colonnes doivent être retournés en minuscule.
DB2_CASE_UPPER (entier): Spécifie que les noms de colonnes doivent être retournés en majuscule.

Types de ressources

L'extension ibm_db2 retourne des ressources de connexion, des ressources de déclaration et des ressources de jeu de résultats.

Table des matières
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_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_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_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_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 un jeu de résultats listant les tables et leurs métadatas qui leur sont associées d'une base de données

db2_autocommit

hw_api->userlist

[edit] Last updated: Mon, 01 Nov 2010

add a note User Contributed Notes Fonctions IBM DB2, Cloudscape et Apache Derby

Richard dot Ablewhite at gmail dot com 11-Sep-2008 03:17


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);

}

brent dot halsey at gmail dot com 11-Jun-2008 10:57


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!

Exi 05-Jun-2008 01:38


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.

kfoubert at sitecrafting dot com 29-Apr-2008 11:00


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