<?php
  
  namespace Doctrine\DBAL;
  
  class DBALException extends \Exception
  {
      public static function notSupported($method)
      {
          return new self("Operation '$method' is not supported by platform.");
      }
  
      public static function invalidPlatformSpecified()
      {
          return new self(
              "Invalid 'platform' option specified, need to give an instance of ".
              "\Doctrine\DBAL\Platforms\AbstractPlatform.");
      }
  
      public static function invalidPdoInstance()
      {
          return new self(
              "The 'pdo' option was used in DriverManager::getConnection() but no ".
              "instance of PDO was given."
          );
      }
  
      public static function driverRequired()
      {
          return new self("The options 'driver' or 'driverClass' are mandatory if no PDO ".
              "instance is given to DriverManager::getConnection().");
      }
  
      public static function unknownDriver($unknownDriverName, array $knownDrivers)
      {
          return new self("The given 'driver' ".$unknownDriverName." is unknown, ".
              "Doctrine currently supports only the following drivers: ".implode(", ", $knownDrivers));
      }
  
      public static function driverExceptionDuringQuery(\Exception $driverEx, $sql, array $params = array())
      {
          $msg = "An exception occurred while executing '".$sql."'";
          if ($params) {
              $msg .= " with params " . self::formatParameters($params);
          }
          $msg .= ":
  
  ".$driverEx->getMessage();
  
          return new self($msg, 0, $driverEx);
      }
  
      /**
       * Returns a human-readable representation of an array of parameters.
       * This properly handles binary data by returning a hex representation.
       *
       * @param array $params
       *
       * @return string
       */
      private static function formatParameters(array $params)
      {
          return '[' . implode(', ', array_map(function($param) {
              $json = @json_encode($param);
  
              if (! is_string($json) || $json == 'null' && is_string($param)) {
                  // JSON encoding failed, this is not a UTF-8 string.
                  return '"\x' . implode('\x', str_split(bin2hex($param), 2)) . '"';
              }
  
              return $json;
          }, $params)) . ']';
      }
  
      public static function invalidWrapperClass($wrapperClass)
      {
          return new self("The given 'wrapperClass' ".$wrapperClass." has to be a ".
              "subtype of \Doctrine\DBAL\Connection.");
      }
  
      public static function invalidDriverClass($driverClass)
      {
          return new self("The given 'driverClass' ".$driverClass." has to implement the ".
              "\Doctrine\DBAL\Driver interface.");
      }
  
      /**
       * @param string $tableName
       * @return DBALException
       */
      public static function invalidTableName($tableName)
      {
          return new self("Invalid table name specified: ".$tableName);
      }
  
      /**
       * @param string $tableName
       * @return DBALException
       */
      public static function noColumnsSpecifiedForTable($tableName)
      {
          return new self("No columns specified for table ".$tableName);
      }
  
      public static function limitOffsetInvalid()
      {
          return new self("Invalid Offset in Limit Query, it has to be larger or equal to 0.");
      }
  
      public static function typeExists($name)
      {
          return new self('Type '.$name.' already exists.');
      }
  
      public static function unknownColumnType($name)
      {
          return new self('Unknown column type "'.$name.'" requested. Any Doctrine type that you use has ' .
              'to be registered with \Doctrine\DBAL\Types\Type::addType(). You can get a list of all the ' .
              'known types with \Doctrine\DBAL\Types\Type::getTypeMap(). If this error occurs during database ' .
              'introspection then you might have forgot to register all database types for a Doctrine Type. Use ' .
              'AbstractPlatform#registerDoctrineTypeMapping() or have your custom types implement ' .
              'Type#getMappedDatabaseTypes(). If the type name is empty you might ' .
              'have a problem with the cache or forgot some mapping information.'
          );
      }
  
      public static function typeNotFound($name)
      {
          return new self('Type to be overwritten '.$name.' does not exist.');
      }
  }