home *** CD-ROM | disk | FTP | other *** search
/ H4CK3R 4 / hacker04 / 04_HACK04.ISO / src / PHP / mysqldbclass.php3.txt < prev    next >
Encoding:
Text File  |  2002-05-06  |  11.8 KB  |  418 lines
  1. MySQL Database class 
  2.  
  3. This is a simple class which eases the use of the mysql connections. Should also work with version 3.0.5 and above of php. 
  4.  
  5.  
  6.  
  7. <?php 
  8.  
  9. /****************************************************************************** 
  10. Copyright   : living source gmbh, 1998  http://www.living-source.de 
  11. Author(en)  : Adi Sieker 
  12. Date    : 1999-05-15 
  13. Version     : 1.00 
  14. Datei    : database.inc.php3 
  15. ******************************************************************************/ 
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23. /****************************************************************************** 
  24.  
  25. Database Connection Class 
  26. ************** 
  27.  
  28. What it's for: 
  29. This Class Opens a Database Connection. It's useful if you need to make more 
  30. than 1 SQL Statement in a single PHP Script. 
  31. Use it with ReUseConn in the MySQLDatabase class. 
  32.  
  33. ******************************************************************************/ 
  34. class DBConnection 
  35. { 
  36.    var $iConnectId; 
  37.  
  38.        /****************************************************************************** 
  39.  
  40.       Function: Open 
  41.       ************** 
  42.       Parameters: 
  43.          $szDatabase == Name of the Database to connect to. 
  44.          $szHost     == Name of the Host on which szDatabase resides. Usually localhost 
  45.          $szUser     == Name of User to connect as. 
  46.          $szPassword == Password of the User. 
  47.  
  48.       Return: 
  49.          Return true if everything went well else it will return false. 
  50.  
  51.  
  52.       What it's for: 
  53.       This function actually opens the Database Connection. 
  54.  
  55.       ******************************************************************************/ 
  56.       function Open( $szDatabase, $szHost, $szUser, $szPassword ) 
  57.       { 
  58.          $this->iConnectId = false; 
  59.  
  60.          $iRet = true; 
  61.  
  62.          $this->iConnectId = mysql_connect( $szHost , $szUser, $szPassword ); 
  63.  
  64.          if( $this->iConnectId ) 
  65.             $iRet = mysql_select_db( $szDatabase, $this->iConnectId ); 
  66.          else 
  67.             $iRet = false; 
  68.  
  69.          return $iRet; 
  70.           /*echo "DBConnection";*/ 
  71.       } 
  72.  
  73.        /****************************************************************************** 
  74.  
  75.       Function: Connection 
  76.       ************** 
  77.       Parameters: 
  78.          None 
  79.  
  80.       Return: 
  81.          Returns the ConnectionID of the current Databae connection if a 
  82.          Database COnnection has been established else it will return false. 
  83.  
  84.  
  85.       What it's for: 
  86.          This function retruns the Database ConnectionID. Use can pass this 
  87.          functions return Value to the ReUseConn function of the MySQL Database Class. 
  88.       ******************************************************************************/ 
  89.       function Connection() 
  90.       { 
  91.          return $this->iConnectId; 
  92.       } 
  93.  
  94.  
  95. } 
  96.  
  97.  
  98.  
  99. /****************************************************************************** 
  100.  
  101. MySQL Database Class 
  102. ************** 
  103.  
  104. What it's for: 
  105. This class is used to Communicate with a mySQL Database Server. 
  106. ******************************************************************************/ 
  107. class MySQLDatabase 
  108. { 
  109.     // Class Variables 
  110.    var $iResultId; 
  111.    var $szSQLString; 
  112.    var $iNumRows; 
  113.    var $iCurrentRow; 
  114.    var $arRow; 
  115.  
  116.  
  117.        /****************************************************************************** 
  118.  
  119.       Function: Open 
  120.       ************** 
  121.       Parameters: 
  122.          $szDatabase == Name of the Database to connect to. 
  123.          $szHost     == Name of the Host on which szDatabase resides. Usually localhost 
  124.          $szUser     == Name of User to connect as. 
  125.          $szPassword == Password of the User. 
  126.  
  127.       Return: 
  128.          Return true if everything went well else it will return false. 
  129.  
  130.  
  131.       What it's for: 
  132.       This function actually opens the Database Connection. 
  133.  
  134.       ******************************************************************************/ 
  135.       function Open( $szDatabase, $szHost, $szUser, $szPassword ) 
  136.       { 
  137.          $this->iConnectId = false; 
  138.          $this->szSQLString =  ""; 
  139.          $this->iResultId = false; 
  140.          $this->iNumRows = false; 
  141.          $this->arRow = false; 
  142.          $this->iCurrentRow = 0; 
  143.  
  144.          $iRet = true; 
  145.  
  146.          $this->iConnectId = mysql_connect( $szHost , $szUser, $szPassword ); 
  147.  
  148.          if( $this->iConnectId ) 
  149.          {  $iRet = mysql_select_db( $szDatabase, $this->iConnectId ); 
  150.             if( !$iRet ) 
  151.                echo  "Selected Database doesn't exist!!!"; 
  152.          } 
  153.          else 
  154.          {  echo  "Connect didn't work out!!!"; 
  155.             $iRet = false; 
  156.          } 
  157.  
  158.          return $iRet; 
  159.       } 
  160.  
  161.        /****************************************************************************** 
  162.  
  163.       Function: ReUseConn 
  164.       ************** 
  165.       Parameters: 
  166.          $iDBConnection == A valid ConnectionID to a mySQL Database. 
  167.  
  168.       Return: 
  169.          None 
  170.  
  171.  
  172.       What it's for: 
  173.          This function reuses an already established Database connection. 
  174.  
  175.       ******************************************************************************/ 
  176.       function ReUseConn( $iDBConnection ) 
  177.       { 
  178.          $this->iConnectId = false; 
  179.          $this->szSQLString =  ""; 
  180.          $this->iResultId = false; 
  181.          $this->iNumRows = false; 
  182.          $this->arRow = false; 
  183.          $this->iCurrentRow = 0; 
  184.  
  185.          $this->iConnectId = $iDBConnection; 
  186.       } 
  187.  
  188.        /****************************************************************************** 
  189.  
  190.       Function: Query 
  191.       ************** 
  192.       Parameters: 
  193.          $szSelect == This parameter is a little misnamed. It should probably be called 
  194.                       $szQueryString 
  195.  
  196.       Return: 
  197.          true on ok. 
  198.          false on error. 
  199.  
  200.  
  201.  
  202.       What it's for: 
  203.          This function will actually Query the Database and set or reset some internal 
  204.          Variables which are needed. 
  205.  
  206.       ******************************************************************************/ 
  207.       function Query( $szSelect ) 
  208.       { 
  209.          $this->szSQLString =  ""; 
  210.          $this->szSQLString = $szSelect; 
  211.          $this->iResultId = false; 
  212.          $this->iNumRows = false; 
  213.          $this->arRow = false; 
  214.          $this->iCurrentRow = 0; 
  215.  
  216.          $iRet = true; 
  217.  
  218.          if( $this->iConnectId != 0) 
  219.          { 
  220.             if( strlen( $this->szSQLString ) > 0 ) 
  221.             { 
  222.                $this->iResultId = mysql_query( $this->szSQLString, $this->iConnectId ); 
  223.  
  224.                if( $this->iResultId ) 
  225.                { 
  226.                   $tok = strtok($this->szSQLString, " "); 
  227.                   $tok = strtoupper( $tok ); 
  228.  
  229.                   if( !strcmp( $tok,  "SELECT" ) ) 
  230.                      $this->iNumRows = mysql_num_rows( $this->iResultId ); 
  231.                   else 
  232.                      $this->iNumRows = mysql_affected_rows( $this->iResultId ); 
  233.                } 
  234.                else 
  235.                { 
  236.                    //echo "Error no ResultIndex!!!"; 
  237.                   $iRet = false; 
  238.                } 
  239.             } 
  240.             else 
  241.             { 
  242.                echo  "Open called without any SQL Query!!!"; 
  243.                $iRet = false; 
  244.             } 
  245.          } 
  246.  
  247.          return $iRet; 
  248.       } 
  249.  
  250.        /****************************************************************************** 
  251.  
  252.       Function: NumRows 
  253.       ************** 
  254.       Parameters: 
  255.          None 
  256.  
  257.       Return: 
  258.          The number of Rows affected by the last Query.. 
  259.  
  260.  
  261.  
  262.       What it's for: 
  263.          This function will return the number of affected Rows. Regardless if the 
  264.          last Query was a SELECT, UPDATE, DELETE, or INSERT Statment.. 
  265.  
  266.       ******************************************************************************/ 
  267.       function NumRows() 
  268.       { 
  269.          if( $this->iConnectId ) 
  270.             return $this->iNumRows; 
  271.          else 
  272.             return false; 
  273.       } 
  274.  
  275.        /****************************************************************************** 
  276.  
  277.       Function: MoveTo 
  278.       ************** 
  279.       Parameters: 
  280.          int $iRow == The Row to move to. 
  281.  
  282.       Return: 
  283.          true on success, else false. 
  284.  
  285.  
  286.  
  287.       What it's for: 
  288.          Moves the recordset to the specified row in the resultset. 
  289.          !!!! I implemented this function but haven't tested it yet!!!! *sorry* 
  290.  
  291.       ******************************************************************************/ 
  292.       function MoveTo( $iRow ) 
  293.       { 
  294.          if( $this->iConnectId && ($iRow <= $this->iNumRows) ) 
  295.          { 
  296.             if( mysql_data_seek( $this->iResultId , iRow ) ) 
  297.             {  $this->arRow = mysql_fetch_array( $this->iResultId ); 
  298.                $this->iCurrentRow = $iRow; 
  299.                return true; 
  300.             } 
  301.             else 
  302.                return false; 
  303.          } 
  304.          else 
  305.             return false; 
  306.       } 
  307.  
  308.        /****************************************************************************** 
  309.  
  310.       Function: GetField 
  311.       ************** 
  312.       Parameters: 
  313.          $szFeldName == Ups, some German slipped in here. 
  314.                         The field name for which to retrieve the Data. 
  315.  
  316.       Return: 
  317.          The Vaule of the Field. 
  318.  
  319.  
  320.  
  321.       What it's for: 
  322.          Retrieve the Vaule for Field in the current Row. 
  323.  
  324.       ******************************************************************************/ 
  325.       function GetField( $szFeldName ) 
  326.       {  return $this->arRow[$szFeldName]; 
  327.       } 
  328.  
  329.        /****************************************************************************** 
  330.  
  331.       Function: EchoFeld 
  332.       ************** 
  333.       Parameters: 
  334.          $szFeldName == Ups, some German slipped in here. 
  335.                         The field name for which to retrieve the Data. 
  336.  
  337.       Return: 
  338.          None. 
  339.  
  340.  
  341.  
  342.       What it's for: 
  343.          Echo the Vaule for Field in the current Row. 
  344.  
  345.       ******************************************************************************/ 
  346.       function EchoFeld( $szFeldName ) 
  347.       { 
  348.          echo $this->arRow[$szFeldName]; 
  349.       } 
  350.  
  351.        /****************************************************************************** 
  352.  
  353.       Function: NextRow 
  354.       ************** 
  355.       Parameters: 
  356.          None 
  357.  
  358.       Return: 
  359.          true if all OK. 
  360.          If something went wrong it will return false. 
  361.  
  362.  
  363.  
  364.       What it's for: 
  365.          Move to the NextRow in the result Set. 
  366.          This Function has to called directly after a query has been executed, otherwise 
  367.          no Data is available for retrieval. 
  368.  
  369.       ******************************************************************************/ 
  370.       function NextRow() 
  371.       { 
  372.          $iRet = true; 
  373.  
  374.          if( $this->iNumRows ) 
  375.          {  $this->arRow = mysql_fetch_array( $this->iResultId ); 
  376.  
  377.             if( $this->arRow ) 
  378.                $this->iCurrentRow++; 
  379.             else 
  380.                $iRet = false; 
  381.          } 
  382.          else 
  383.          { 
  384.             $iRet = false; 
  385.          } 
  386.          return $iRet; 
  387.  
  388.       } 
  389.  
  390.  
  391.        /****************************************************************************** 
  392.  
  393.       Function: Close 
  394.       ************** 
  395.       Parameters: 
  396.          None 
  397.  
  398.       Return: 
  399.          true on OK else false. 
  400.  
  401.  
  402.  
  403.       What it's for: 
  404.          Close a Databse Connection. 
  405.          Carefull here, if use initialised the Class with the function ReUSeConn. 
  406.          All query on this database connection will fail. This also counts for 
  407.          other instanceses of this Class. 
  408.  
  409.       ******************************************************************************/ 
  410.       function Close() 
  411.       { 
  412.          return mysql_close( $this->iConnectId ); 
  413.       } 
  414. } 
  415. $database_inc_php3 = 1; 
  416.  
  417. ?>
  418.