Proyectos de Subversion Moodle

Rev

Autoría | Ultima modificación | Ver Log |

<?php
/**
 * ADOdb driver for ADS.
 *
 * NOTE: This driver requires the Advantage PHP client libraries, which
 * can be downloaded for free via:
 * @link http://devzone.advantagedatabase.com/dz/content.aspx?key=20
 *
 * This file is part of ADOdb, a Database Abstraction Layer library for PHP.
 *
 * @package ADOdb
 * @link https://adodb.org Project's web site and documentation
 * @link https://github.com/ADOdb/ADOdb Source code and issue tracker
 *
 * The ADOdb Library is dual-licensed, released under both the BSD 3-Clause
 * and the GNU Lesser General Public Licence (LGPL) v2.1 or, at your option,
 * any later version. This means you can use it in proprietary products.
 * See the LICENSE.md file distributed with this source code for details.
 * @license BSD-3-Clause
 * @license LGPL-2.1-or-later
 *
 * @copyright 2000-2013 John Lim
 * @copyright 2014 Damien Regad, Mark Newnham and the ADOdb community
 */

/*
DELPHI FOR PHP USERS:
      The following steps can be taken to utilize this driver from the
      CodeGear Delphi for PHP product:
        1 - See note above, download and install the Advantage PHP client.
        2 - Copy the following files to the Delphi for PHP\X.X\php\ext directory:
              ace32.dll
              axcws32.dll
              adsloc32.dll
              php_advantage.dll (rename the existing php_advantage.dll.5.x.x file)
        3 - Add the following line to the Delphi for PHP\X.X\php\php.ini.template file:
              extension=php_advantage.dll
        4 - To use: enter "ads" as the DriverName on a connection component, and set
            a Host property similar to "DataDirectory=c:\". See the Advantage PHP
            help file topic for ads_connect for details on connection path options
            and formatting.
        5 - (optional) - Modify the Delphi for PHP\X.X\vcl\packages\database.packages.php
            file and add ads to the list of strings returned when registering the
            Database object's DriverName property.

*/

// security - hide paths
if (!defined('ADODB_DIR')) {
        die();
}

define("_ADODB_ADS_LAYER", 2);

/*--------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------*/


class ADODB_ads extends ADOConnection
{
        var $databaseType = "ads";
        var $fmt = "'m-d-Y'";
        var $fmtTimeStamp = "'Y-m-d H:i:s'";
        var $concat_operator = '';
        var $replaceQuote = "''"; // string to use to replace quotes
        var $dataProvider = "ads";
        var $hasAffectedRows = true;
        var $binmode = ODBC_BINMODE_RETURN;
        var $useFetchArray = false; // setting this to true will make array elements in FETCH_ASSOC mode case-sensitive
        // breaking backward-compat
        //var $longreadlen = 8000; // default number of chars to return for a Blob/Long field
        var $_bindInputArray = false;
        var $curmode = SQL_CUR_USE_DRIVER; // See sqlext.h, SQL_CUR_DEFAULT == SQL_CUR_USE_DRIVER == 2L
        var $_genSeqSQL = "create table %s (id integer)";
        var $_autocommit = true;
        var $_lastAffectedRows = 0;
        var $uCaseTables = true; // for meta* functions, uppercase table names

        function __construct()
        {
        }

        // returns true or false
        function _connect($argDSN, $argUsername, $argPassword, $argDatabasename)
        {
                if (!function_exists('ads_connect')) {
                        return null;
                }

                if ($this->debug && $argDatabasename && $this->databaseType != 'vfp') {
                        ADOConnection::outp("For Advantage Connect(), $argDatabasename is not used. Place dsn in 1st parameter.");
                }
                $last_php_error = $this->resetLastError();
                if ($this->curmode === false) {
                        $this->_connectionID = ads_connect($argDSN, $argUsername, $argPassword);
                } else {
                        $this->_connectionID = ads_connect($argDSN, $argUsername, $argPassword, $this->curmode);
                }
                $this->_errorMsg = $this->getChangedErrorMsg($last_php_error);
                if ($this->connectStmt) {
                        $this->Execute($this->connectStmt);
                }

                return $this->_connectionID != false;
        }

        // returns true or false
        function _pconnect($argDSN, $argUsername, $argPassword, $argDatabasename)
        {
                if (!function_exists('ads_connect')) {
                        return null;
                }

                $last_php_error = $this->resetLastError();
                $this->_errorMsg = '';
                if ($this->debug && $argDatabasename) {
                        ADOConnection::outp("For PConnect(), $argDatabasename is not used. Place dsn in 1st parameter.");
                }
                //  print "dsn=$argDSN u=$argUsername p=$argPassword<br>"; flush();
                if ($this->curmode === false) {
                        $this->_connectionID = ads_connect($argDSN, $argUsername, $argPassword);
                } else {
                        $this->_connectionID = ads_pconnect($argDSN, $argUsername, $argPassword, $this->curmode);
                }

                $this->_errorMsg = $this->getChangedErrorMsg($last_php_error);
                if ($this->_connectionID && $this->autoRollback) {
                        @ads_rollback($this->_connectionID);
                }
                if ($this->connectStmt) {
                        $this->Execute($this->connectStmt);
                }

                return $this->_connectionID != false;
        }

        // returns the Server version and Description
        function ServerInfo()
        {

                if (!empty($this->host)) {
                        $stmt = $this->Prepare('EXECUTE PROCEDURE sp_mgGetInstallInfo()');
                        $res = $this->Execute($stmt);
                        if (!$res) {
                                print $this->ErrorMsg();
                        } else {
                                $ret["version"] = $res->fields[3];
                                $ret["description"] = "Advantage Database Server";
                                return $ret;
                        }
                } else {
                        return ADOConnection::ServerInfo();
                }
        }


        // returns true or false
        function CreateSequence($seqname = 'adodbseq', $start = 1)
        {
                $res = $this->Execute("CREATE TABLE $seqname ( ID autoinc( 1 ) ) IN DATABASE");
                if (!$res) {
                        print $this->ErrorMsg();
                        return false;
                } else {
                        return true;
                }

        }

        // returns true or false
        function DropSequence($seqname = 'adodbseq')
        {
                $res = $this->Execute("DROP TABLE $seqname");
                if (!$res) {
                        print $this->ErrorMsg();
                        return false;
                } else {
                        return true;
                }
        }


        // returns the generated ID or false
        // checks if the table already exists, else creates the table and inserts a record into the table
        // and gets the ID number of the last inserted record.
        function GenID($seqname = 'adodbseq', $start = 1)
        {
                $go = $this->Execute("select * from $seqname");
                if (!$go) {
                        $res = $this->Execute("CREATE TABLE $seqname ( ID autoinc( 1 ) ) IN DATABASE");
                        if (!$res) {
                                print $this->ErrorMsg();
                                return false;
                        }
                }
                $res = $this->Execute("INSERT INTO $seqname VALUES( DEFAULT )");
                if (!$res) {
                        print $this->ErrorMsg();
                        return false;
                } else {
                        $gen = $this->Execute("SELECT LastAutoInc( STATEMENT ) FROM system.iota");
                        $ret = $gen->fields[0];
                        return $ret;
                }

        }


        function ErrorMsg()
        {
                if ($this->_errorMsg !== false) {
                        return $this->_errorMsg;
                }
                if (empty($this->_connectionID)) {
                        return @ads_errormsg();
                }
                return @ads_errormsg($this->_connectionID);
        }


        function ErrorNo()
        {
                if ($this->_errorCode !== false) {
                        // bug in 4.0.6, error number can be corrupted string (should be 6 digits)
                        return (strlen($this->_errorCode) <= 2) ? 0 : $this->_errorCode;
                }

                if (empty($this->_connectionID)) {
                        $e = @ads_error();
                } else {
                        $e = @ads_error($this->_connectionID);
                }

                // bug in 4.0.6, error number can be corrupted string (should be 6 digits)
                // so we check and patch
                if (strlen($e) <= 2) {
                        return 0;
                }
                return $e;
        }


        function BeginTrans()
        {
                if (!$this->hasTransactions) {
                        return false;
                }
                if ($this->transOff) {
                        return true;
                }
                $this->transCnt += 1;
                $this->_autocommit = false;
                return ads_autocommit($this->_connectionID, false);
        }

        function CommitTrans($ok = true)
        {
                if ($this->transOff) {
                        return true;
                }
                if (!$ok) {
                        return $this->RollbackTrans();
                }
                if ($this->transCnt) {
                        $this->transCnt -= 1;
                }
                $this->_autocommit = true;
                $ret = ads_commit($this->_connectionID);
                ads_autocommit($this->_connectionID, true);
                return $ret;
        }

        function RollbackTrans()
        {
                if ($this->transOff) {
                        return true;
                }
                if ($this->transCnt) {
                        $this->transCnt -= 1;
                }
                $this->_autocommit = true;
                $ret = ads_rollback($this->_connectionID);
                ads_autocommit($this->_connectionID, true);
                return $ret;
        }


        // Returns tables,Views or both on successful execution. Returns
        // tables by default on successful execution.
        function &MetaTables($ttype = false, $showSchema = false, $mask = false)
        {
                $recordSet1 = $this->Execute("select * from system.tables");
                if (!$recordSet1) {
                        print $this->ErrorMsg();
                        return false;
                }
                $recordSet2 = $this->Execute("select * from system.views");
                if (!$recordSet2) {
                        print $this->ErrorMsg();
                        return false;
                }
                $i = 0;
                while (!$recordSet1->EOF) {
                        $arr["$i"] = $recordSet1->fields[0];
                        $recordSet1->MoveNext();
                        $i = $i + 1;
                }
                if ($ttype == 'FALSE') {
                        while (!$recordSet2->EOF) {
                                $arr["$i"] = $recordSet2->fields[0];
                                $recordSet2->MoveNext();
                                $i = $i + 1;
                        }
                        return $arr;
                } elseif ($ttype == 'VIEWS') {
                        while (!$recordSet2->EOF) {
                                $arrV["$i"] = $recordSet2->fields[0];
                                $recordSet2->MoveNext();
                                $i = $i + 1;
                        }
                        return $arrV;
                } else {
                        return $arr;
                }

        }

        function &MetaPrimaryKeys($table, $owner = false)
        {
                $recordSet = $this->Execute("select table_primary_key from system.tables where name='$table'");
                if (!$recordSet) {
                        print $this->ErrorMsg();
                        return false;
                }
                $i = 0;
                while (!$recordSet->EOF) {
                        $arr["$i"] = $recordSet->fields[0];
                        $recordSet->MoveNext();
                        $i = $i + 1;
                }
                return $arr;
        }

        /*
        See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odbc/htm/odbcdatetime_data_type_changes.asp
        / SQL data type codes /
        #define SQL_UNKNOWN_TYPE  0
        #define SQL_CHAR      1
        #define SQL_NUMERIC    2
        #define SQL_DECIMAL    3
        #define SQL_INTEGER    4
        #define SQL_SMALLINT    5
        #define SQL_FLOAT      6
        #define SQL_REAL      7
        #define SQL_DOUBLE      8
        #if (ODBCVER >= 0x0300)
        #define SQL_DATETIME    9
        #endif
        #define SQL_VARCHAR   12


        / One-parameter shortcuts for date/time data types /
        #if (ODBCVER >= 0x0300)
        #define SQL_TYPE_DATE   91
        #define SQL_TYPE_TIME   92
        #define SQL_TYPE_TIMESTAMP 93

        #define SQL_UNICODE                             (-95)
        #define SQL_UNICODE_VARCHAR                     (-96)
        #define SQL_UNICODE_LONGVARCHAR                 (-97)
        */
        function ODBCTypes($t)
        {
                switch ((integer)$t) {
                        case 1:
                        case 12:
                        case 0:
                        case -95:
                        case -96:
                                return 'C';
                        case -97:
                        case -1: //text
                                return 'X';
                        case -4: //image
                                return 'B';

                        case 9:
                        case 91:
                                return 'D';

                        case 10:
                        case 11:
                        case 92:
                        case 93:
                                return 'T';

                        case 4:
                        case 5:
                        case -6:
                                return 'I';

                        case -11: // uniqidentifier
                                return 'R';
                        case -7: //bit
                                return 'L';

                        default:
                                return 'N';
                }
        }

        function &MetaColumns($table, $normalize = true)
        {
                global $ADODB_FETCH_MODE;

                $false = false;
                if ($this->uCaseTables) {
                        $table = strtoupper($table);
                }
                $schema = '';
                $this->_findschema($table, $schema);

                $savem = $ADODB_FETCH_MODE;
                $ADODB_FETCH_MODE = ADODB_FETCH_NUM;

                /*if (false) { // after testing, confirmed that the following does not work because of a bug
                  $qid2 = ads_tables($this->_connectionID);
                  $rs = new ADORecordSet_ads($qid2);
                  $ADODB_FETCH_MODE = $savem;
                  if (!$rs) return false;
                  $rs->_fetch();

                  while (!$rs->EOF) {
                        if ($table == strtoupper($rs->fields[2])) {
                          $q = $rs->fields[0];
                          $o = $rs->fields[1];
                          break;
                        }
                        $rs->MoveNext();
                  }
                  $rs->Close();

                  $qid = ads_columns($this->_connectionID,$q,$o,strtoupper($table),'%');
                } */

                switch ($this->databaseType) {
                        case 'access':
                        case 'vfp':
                                $qid = ads_columns($this->_connectionID);#,'%','',strtoupper($table),'%');
                                break;


                        case 'db2':
                                $colname = "%";
                                $qid = ads_columns($this->_connectionID, "", $schema, $table, $colname);
                                break;

                        default:
                                $qid = @ads_columns($this->_connectionID, '%', '%', strtoupper($table), '%');
                                if (empty($qid)) {
                                        $qid = ads_columns($this->_connectionID);
                                }
                                break;
                }
                if (empty($qid)) {
                        return $false;
                }

                $rs = new ADORecordSet_ads($qid);
                $ADODB_FETCH_MODE = $savem;

                if (!$rs) {
                        return $false;
                }
                $rs->_fetch();

                $retarr = array();

                /*
                $rs->fields indices
                0 TABLE_QUALIFIER
                1 TABLE_SCHEM
                2 TABLE_NAME
                3 COLUMN_NAME
                4 DATA_TYPE
                5 TYPE_NAME
                6 PRECISION
                7 LENGTH
                8 SCALE
                9 RADIX
                10 NULLABLE
                11 REMARKS
                */
                while (!$rs->EOF) {
                        //  adodb_pr($rs->fields);
                        if (strtoupper(trim($rs->fields[2])) == $table && (!$schema || strtoupper($rs->fields[1]) == $schema)) {
                                $fld = new ADOFieldObject();
                                $fld->name = $rs->fields[3];
                                $fld->type = $this->ODBCTypes($rs->fields[4]);

                                // ref: http://msdn.microsoft.com/library/default.asp?url=/archive/en-us/dnaraccgen/html/msdn_odk.asp
                                // access uses precision to store length for char/varchar
                                if ($fld->type == 'C' or $fld->type == 'X') {
                                        if ($this->databaseType == 'access') {
                                                $fld->max_length = $rs->fields[6];
                                        } else {
                                                if ($rs->fields[4] <= -95) // UNICODE
                                                {
                                                        $fld->max_length = $rs->fields[7] / 2;
                                                } else {
                                                        $fld->max_length = $rs->fields[7];
                                                }
                                        }
                                } else {
                                        $fld->max_length = $rs->fields[7];
                                }
                                $fld->not_null = !empty($rs->fields[10]);
                                $fld->scale = $rs->fields[8];
                                $retarr[strtoupper($fld->name)] = $fld;
                        } else {
                                if (sizeof($retarr) > 0) {
                                        break;
                                }
                        }
                        $rs->MoveNext();
                }
                $rs->Close(); //-- crashes 4.03pl1 -- why?

                if (empty($retarr)) {
                        $retarr = false;
                }
                return $retarr;
        }

        // Returns an array of columns names for a given table
        function &MetaColumnNames($table, $numIndexes = false, $useattnum = false)
        {
                $recordSet = $this->Execute("select name from system.columns where parent='$table'");
                if (!$recordSet) {
                        print $this->ErrorMsg();
                        return false;
                } else {
                        $i = 0;
                        while (!$recordSet->EOF) {
                                $arr["FIELD$i"] = $recordSet->fields[0];
                                $recordSet->MoveNext();
                                $i = $i + 1;
                        }
                        return $arr;
                }
        }


        function Prepare($sql)
        {
                if (!$this->_bindInputArray) {
                        return $sql;
                } // no binding
                $stmt = ads_prepare($this->_connectionID, $sql);
                if (!$stmt) {
                        // we don't know whether odbc driver is parsing prepared stmts, so just return sql
                        return $sql;
                }
                return array($sql, $stmt, false);
        }

        function _query($sql, $inputarr = false)
        {
                $last_php_error = $this->resetLastError();
                $this->_errorMsg = '';

                if ($inputarr) {
                        if (is_array($sql)) {
                                $stmtid = $sql[1];
                        } else {
                                $stmtid = ads_prepare($this->_connectionID, $sql);

                                if ($stmtid == false) {
                                        $this->_errorMsg = $this->getChangedErrorMsg($last_php_error);
                                        return false;
                                }
                        }

                        if (!ads_execute($stmtid, $inputarr)) {
                                //@ads_free_result($stmtid);
                                $this->_errorMsg = ads_errormsg();
                                $this->_errorCode = ads_error();
                                return false;
                        }

                } else {
                        if (is_array($sql)) {
                                $stmtid = $sql[1];
                                if (!ads_execute($stmtid)) {
                                        //@ads_free_result($stmtid);
                                        $this->_errorMsg = ads_errormsg();
                                        $this->_errorCode = ads_error();
                                        return false;
                                }
                        } else {

                                $stmtid = ads_exec($this->_connectionID, $sql);

                        }
                }

                $this->_lastAffectedRows = 0;

                if ($stmtid) {

                        if (@ads_num_fields($stmtid) == 0) {
                                $this->_lastAffectedRows = ads_num_rows($stmtid);
                                $stmtid = true;

                        } else {

                                $this->_lastAffectedRows = 0;
                                ads_binmode($stmtid, $this->binmode);
                                ads_longreadlen($stmtid, $this->maxblobsize);

                        }

                        $this->_errorMsg = '';
                        $this->_errorCode = 0;
                } else {
                        $this->_errorMsg = ads_errormsg();
                        $this->_errorCode = ads_error();
                }

                return $stmtid;

        }

        /*
          Insert a null into the blob field of the table first.
          Then use UpdateBlob to store the blob.

          Usage:

          $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)');
          $conn->UpdateBlob('blobtable','blobcol',$blob,'id=1');
         */
        function UpdateBlob($table, $column, $val, $where, $blobtype = 'BLOB')
        {
                $last_php_error = $this->resetLastError();
                $sql = "UPDATE $table SET $column=? WHERE $where";
                $stmtid = ads_prepare($this->_connectionID, $sql);
                if ($stmtid == false) {
                        $this->_errorMsg = $this->getChangedErrorMsg($last_php_error);
                        return false;
                }
                if (!ads_execute($stmtid, array($val), array(SQL_BINARY))) {
                        $this->_errorMsg = ads_errormsg();
                        $this->_errorCode = ads_error();
                        return false;
                }
                return true;
        }

        // returns true or false
        function _close()
        {
                $ret = @ads_close($this->_connectionID);
                $this->_connectionID = false;
                return $ret;
        }

        function _affectedrows()
        {
                return $this->_lastAffectedRows;
        }

}

/*--------------------------------------------------------------------------------------
   Class Name: Recordset
--------------------------------------------------------------------------------------*/

class ADORecordSet_ads extends ADORecordSet
{

        var $bind = false;
        var $databaseType = "ads";
        var $dataProvider = "ads";
        var $useFetchArray;

        function __construct($id, $mode = false)
        {
                if ($mode === false) {
                        global $ADODB_FETCH_MODE;
                        $mode = $ADODB_FETCH_MODE;
                }
                $this->fetchMode = $mode;

                $this->_queryID = $id;

                // the following is required for mysql odbc driver in 4.3.1 -- why?
                $this->EOF = false;
                $this->_currentRow = -1;
                //parent::__construct($id);
        }


        // returns the field object
        function &FetchField($fieldOffset = -1)
        {

                $off = $fieldOffset + 1; // offsets begin at 1

                $o = new ADOFieldObject();
                $o->name = @ads_field_name($this->_queryID, $off);
                $o->type = @ads_field_type($this->_queryID, $off);
                $o->max_length = @ads_field_len($this->_queryID, $off);
                if (ADODB_ASSOC_CASE == 0) {
                        $o->name = strtolower($o->name);
                } else {
                        if (ADODB_ASSOC_CASE == 1) {
                                $o->name = strtoupper($o->name);
                        }
                }
                return $o;
        }

        /* Use associative array to get fields array */
        function Fields($colname)
        {
                if ($this->fetchMode & ADODB_FETCH_ASSOC) {
                        return $this->fields[$colname];
                }
                if (!$this->bind) {
                        $this->bind = array();
                        for ($i = 0; $i < $this->_numOfFields; $i++) {
                                $o = $this->FetchField($i);
                                $this->bind[strtoupper($o->name)] = $i;
                        }
                }

                return $this->fields[$this->bind[strtoupper($colname)]];
        }


        function _initrs()
        {
                global $ADODB_COUNTRECS;
                $this->_numOfRows = ($ADODB_COUNTRECS) ? @ads_num_rows($this->_queryID) : -1;
                $this->_numOfFields = @ads_num_fields($this->_queryID);
                // some silly drivers such as db2 as/400 and intersystems cache return _numOfRows = 0
                if ($this->_numOfRows == 0) {
                        $this->_numOfRows = -1;
                }
                //$this->useFetchArray = $this->connection->useFetchArray;
        }

        function _seek($row)
        {
                return false;
        }

        // speed up SelectLimit() by switching to ADODB_FETCH_NUM as ADODB_FETCH_ASSOC is emulated
        function &GetArrayLimit($nrows, $offset = -1)
        {
                if ($offset <= 0) {
                        $rs =& $this->GetArray($nrows);
                        return $rs;
                }
                $savem = $this->fetchMode;
                $this->fetchMode = ADODB_FETCH_NUM;
                $this->Move($offset);
                $this->fetchMode = $savem;

                if ($this->fetchMode & ADODB_FETCH_ASSOC) {
                        $this->fields =& $this->GetRowAssoc();
                }

                $results = array();
                $cnt = 0;
                while (!$this->EOF && $nrows != $cnt) {
                        $results[$cnt++] = $this->fields;
                        $this->MoveNext();
                }

                return $results;
        }


        function MoveNext()
        {
                if ($this->_numOfRows != 0 && !$this->EOF) {
                        $this->_currentRow++;
                        if ($this->_fetch()) {
                                return true;
                        }
                }
                $this->fields = false;
                $this->EOF = true;
                return false;
        }

        function _fetch()
        {
                $this->fields = false;
                $rez = @ads_fetch_into($this->_queryID, $this->fields);
                if ($rez) {
                        if ($this->fetchMode & ADODB_FETCH_ASSOC) {
                                $this->fields =& $this->GetRowAssoc();
                        }
                        return true;
                }
                return false;
        }

        function _close()
        {
                return @ads_free_result($this->_queryID);
        }

}