PDO.GETATTRIBUTE(3)							 1						       PDO.GETATTRIBUTE(3)

PDO
::getAttribute - Retrieve a database connection attribute

SYNOPSIS

       public mixed PDO::getAttribute (int  $attribute)

DESCRIPTION

	This  function	returns  the  value  of a database connection attribute. To retrieve PDOStatement attributes, refer to PDOStatement.getAt-
       tribute(3).

	Note that some database/driver combinations may not support all of the database connection attributes.

PARAMETERS

	      o $attribute
		- One of the PDO::ATTR_* constants. The constants that apply to database connections are as follows:

		     o PDO::ATTR_AUTOCOMMIT

		     o PDO::ATTR_CASE

		     o PDO::ATTR_CLIENT_VERSION

		     o PDO::ATTR_CONNECTION_STATUS

		     o PDO::ATTR_DRIVER_NAME

		     o PDO::ATTR_ERRMODE

		     o PDO::ATTR_ORACLE_NULLS

		     o PDO::ATTR_PERSISTENT

		     o PDO::ATTR_PREFETCH

		     o PDO::ATTR_SERVER_INFO

		     o PDO::ATTR_SERVER_VERSION

		     o PDO::ATTR_TIMEOUT

RETURN VALUES

	A successful call returns the value of the requested PDO attribute. An unsuccessful call returns null.

EXAMPLES

       Example #1

	      Retrieving database connection attributes

	      <?php
	      $conn = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
	      $attributes = array(
		  "AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS",
		  "ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION",
		  "TIMEOUT"
	      );

	      foreach ($attributes as $val) {
		  echo "PDO::ATTR_$val: ";
		  echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "
";
	      }
	      ?>

SEE ALSO

       PDO.setAttribute(3), PDOStatement.getAttribute(3), PDOStatement.setAttribute(3).

PHP Documentation Group 												       PDO.GETATTRIBUTE(3)