odbc_binmode

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_binmodeModifie la gestion des colonnes de données binaires

Description

odbc_binmode(resource $statement, int $mode): bool

odbc_binmode() contrôle la gestion des colonnes de données binaires. Les types ODBC SQL affectés sont BINARY, VARBINARY et LONGVARBINARY. Le mode par défaut peut être définie en utilisant la directive php.ini uodbc.defaultbinmode

Lorsqu'une donnée SQL est convertie en caractère C, (ODBC_BINMODE_CONVERT) les 8 bits du caractère source sont représentés par deux caractères ASCII. Ces caractères sont des représentations ASCII des nombres au format hexadécimal. Par exemple, le binaire 00000001 est converti en "01" et le binaire 11111111 est converti en "FF".

Alors que la gestion des colonnes BINARY et VARBINARY dépendent uniquement du binmode, la gestion des colonnes LONGVARBINARY dépend aussi de longreadlen, comme ceci :

Conversion des LONGVARBINARY
Mode Longueur Résultat
ODBC_BINMODE_PASSTHRU 0 passthru
ODBC_BINMODE_RETURN 0 passthru
ODBC_BINMODE_CONVERT 0 passthru
ODBC_BINMODE_PASSTHRU >0 passthru
ODBC_BINMODE_RETURN >0 Tel quel
ODBC_BINMODE_CONVERT >0 Caractère

Si odbc_fetch_into() est utilisé, passthru signifie qu'une chaîne vide sera retournée pour ces colonnes. Si la fonction odbc_result() est utilisée, passthru signifie que les données sont envoyés directement au client (i.e. imprimé).

Liste de paramètres

statement

L'identifiant de résultat.

Si statement vaut 0, ces paramètres seront appliqués aux nouveaux résultats.

mode

Valeurs possibles pour le paramètre mode :

  • ODBC_BINMODE_PASSTHRU : retourner les données en binaire
  • ODBC_BINMODE_RETURN : retourner sans conversion
  • ODBC_BINMODE_CONVERT : convertir en caractère

Note: La gestion des colonnes de type binary long est aussi affectée par la fonction odbc_longreadlen().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

add a note add a note

User Contributed Notes 4 notes

up
1
yhalmoe at yahoo dot no
14 years ago
For Sybase users (this probably applies to MS-SQL Server as well) who are using ODBC:

I was using the same code as mizmerize, but I was getting truncated data back from the server (at the 32kb mark) when selecting data with the image datatype. My Sybase server has a @@textsize property of 2Gb, which should be plenty. But apparently, the php ODBC driver resets this to 32Kb when a connection is made, and then sets it back to 2Gb after. The solution is to do a query:

<?php odbc_exec($connH, "set textsize 131072"); ?>

immediately before your main query, in mizmerize's code. That should override the default setting.
up
0
mizmerize at yahoo dot com
18 years ago
I am currently using an SQL Server 2000 used as a datasource for ODBC access, Testing PHP scripts from an Apache 2 server running on Windows 2000.

I was trying to get an image from the database using ODBC but the output always flushes automatically while I was just getting the result using odbc_result() function.

With this code, the picture automatically prints to the browser as soon as I hit odbc_result() (probably a bug, but bug reports aren't that easy to do).

<?php
  $connH
=odbc_pconnect("ImageDB","sa","",SQL_CUR_USE_IF_NEEDED) or die(odbc_errormsg());
   
$result=odbc_exec($connH, "SELECT Emp_Image FROM tblEmployeePics WHERE Emp_Id=547");
    if (
$result) {                           
       
odbc_longreadlen($result, 131072);       
       
odbc_binmode($result,ODBC_BINMODE_PASSTHRU);                           
//upon calling this, the output flushes out to the browser... made me scratch       
$m_FValue=odbc_result($result, 1);
}
?>

...after 48 hours of scratching I finally made a work around, but by using a function in the bin2hex() function documentation...

<?php
     
function hex2bin($data){
      
$len = strlen($data);
       return
pack("H" . $len, $data);
    }

   
   
$connH=odbc_pconnect("ImageDB","sa","",SQL_CUR_USE_IF_NEEDED) or die(odbc_errormsg());
   
$result=odbc_exec($connH, "SELECT Emp_Image FROM tblEmployeePics WHERE Emp_Id=547");
    if (
$result) {                           
       
odbc_longreadlen($result, 131072);       
       
odbc_binmode($result,ODBC_BINMODE_CONVERT);                           
       
$m_FValue=odbc_result($result, 1);
       
$out=hex2bin($m_FValue);
    }
?>

The trick was to convert the output into hex by changing odbc_binmode to  ODBC_BINMODE_CONVERT and using a handy function to convert it back to binary in order to facilitate manipulation of its size, depth etc...
up
0
andrea dot galli at acotel dot com
21 years ago
Example: retrieve image from database.

<?php

   $Link_ID
= odbc_connect("DSN", "user", "pass");
  
$Query_ID = odbc_exec($Link_ID, "SELECT picture FROM categories");

  
// change to ODBC_BINMODE_CONVERT for comparison

  
odbc_binmode($Query_ID, ODBC_BINMODE_RETURN);

  
$Images = odbc_result($Query_ID, 1);

   echo
$Images;

?>
up
-1
bortuzar
15 years ago
I set the odbc_longreadlen() at the beggining of my script so nText field types dont get truncated, like this:

<?php odbc_longreadlen (0, 1000000); ?>
To Top