Merge pull request #3964 from greg0ire/moar-immutable-exceptions

Mark every exception as immutable

lib/Doctrine/DBAL/Cache/CacheException.php

@@ -4,6 +4,9 @@ namespace Doctrine\DBAL\Cache;
 
 use Doctrine\DBAL\DBALException;
 
+/**
+ * @psalm-immutable
+ */
 class CacheException extends DBALException
 {
     /**

lib/Doctrine/DBAL/ConnectionException.php

@@ -2,6 +2,9 @@
 
 namespace Doctrine\DBAL;
 
+/**
+ * @psalm-immutable
+ */
 class ConnectionException extends DBALException
 {
     /**

lib/Doctrine/DBAL/DBALException.php

@@ -22,6 +22,9 @@ use function preg_replace;
 use function spl_object_hash;
 use function sprintf;
 
+/**
+ * @psalm-immutable
+ */
 class DBALException extends Exception
 {
     /**

lib/Doctrine/DBAL/Driver/IBMDB2/DB2Exception.php

@@ -4,6 +4,9 @@ namespace Doctrine\DBAL\Driver\IBMDB2;
 
 use Exception;
 
+/**
+ * @psalm-immutable
+ */
 class DB2Exception extends Exception
 {
 }

lib/Doctrine/DBAL/Exception/ConnectionException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Base class for all connection related errors detected in the driver.
+ *
+ * @psalm-immutable
  */
 class ConnectionException extends DriverException
 {

lib/Doctrine/DBAL/Exception/ConstraintViolationException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Base class for all constraint violation related errors detected in the driver.
+ *
+ * @psalm-immutable
  */
 class ConstraintViolationException extends ServerException
 {

lib/Doctrine/DBAL/Exception/DatabaseObjectExistsException.php

@@ -8,6 +8,8 @@ namespace Doctrine\DBAL\Exception;
  * A database object is considered any asset that can be created in a database
  * such as schemas, tables, views, sequences, triggers,  constraints, indexes,
  * functions, stored procedures etc.
+ *
+ * @psalm-immutable
  */
 class DatabaseObjectExistsException extends ServerException
 {

lib/Doctrine/DBAL/Exception/DatabaseObjectNotFoundException.php

@@ -8,6 +8,8 @@ namespace Doctrine\DBAL\Exception;
  * A database object is considered any asset that can be created in a database
  * such as schemas, tables, views, sequences, triggers,  constraints, indexes,
  * functions, stored procedures etc.
+ *
+ * @psalm-immutable
  */
 class DatabaseObjectNotFoundException extends ServerException
 {

lib/Doctrine/DBAL/Exception/DeadlockException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a deadlock error of a transaction detected in the driver.
+ *
+ * @psalm-immutable
  */
 class DeadlockException extends ServerException implements RetryableException
 {

lib/Doctrine/DBAL/Exception/DriverException.php

@@ -7,6 +7,8 @@ use Exception;
 
 /**
  * Base class for all errors detected in the driver.
+ *
+ * @psalm-immutable
  */
 class DriverException extends DBALException
 {

lib/Doctrine/DBAL/Exception/ForeignKeyConstraintViolationException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a foreign key constraint violation detected in the driver.
+ *
+ * @psalm-immutable
  */
 class ForeignKeyConstraintViolationException extends ConstraintViolationException
 {

lib/Doctrine/DBAL/Exception/InvalidArgumentException.php

@@ -6,6 +6,8 @@ use Doctrine\DBAL\DBALException;
 
 /**
  * Exception to be thrown when invalid arguments are passed to any DBAL API
+ *
+ * @psalm-immutable
  */
 class InvalidArgumentException extends DBALException
 {

lib/Doctrine/DBAL/Exception/InvalidFieldNameException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for an invalid specified field name in a statement detected in the driver.
+ *
+ * @psalm-immutable
  */
 class InvalidFieldNameException extends ServerException
 {

lib/Doctrine/DBAL/Exception/LockWaitTimeoutException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a lock wait timeout error of a transaction detected in the driver.
+ *
+ * @psalm-immutable
  */
 class LockWaitTimeoutException extends ServerException implements RetryableException
 {

lib/Doctrine/DBAL/Exception/NonUniqueFieldNameException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a non-unique/ambiguous specified field name in a statement detected in the driver.
+ *
+ * @psalm-immutable
  */
 class NonUniqueFieldNameException extends ServerException
 {

lib/Doctrine/DBAL/Exception/NotNullConstraintViolationException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a NOT NULL constraint violation detected in the driver.
+ *
+ * @psalm-immutable
  */
 class NotNullConstraintViolationException extends ConstraintViolationException
 {

lib/Doctrine/DBAL/Exception/ReadOnlyException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a write operation attempt on a read-only database element detected in the driver.
+ *
+ * @psalm-immutable
  */
 class ReadOnlyException extends ServerException
 {

lib/Doctrine/DBAL/Exception/ServerException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Base class for all server related errors detected in the driver.
+ *
+ * @psalm-immutable
  */
 class ServerException extends DriverException
 {

lib/Doctrine/DBAL/Exception/SyntaxErrorException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a syntax error in a statement detected in the driver.
+ *
+ * @psalm-immutable
  */
 class SyntaxErrorException extends ServerException
 {

lib/Doctrine/DBAL/Exception/TableExistsException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for an already existing table referenced in a statement detected in the driver.
+ *
+ * @psalm-immutable
  */
 class TableExistsException extends DatabaseObjectExistsException
 {

lib/Doctrine/DBAL/Exception/TableNotFoundException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for an unknown table referenced in a statement detected in the driver.
+ *
+ * @psalm-immutable
  */
 class TableNotFoundException extends DatabaseObjectNotFoundException
 {

lib/Doctrine/DBAL/Exception/UniqueConstraintViolationException.php

@@ -4,6 +4,8 @@ namespace Doctrine\DBAL\Exception;
 
 /**
  * Exception for a unique constraint violation detected in the driver.
+ *
+ * @psalm-immutable
  */
 class UniqueConstraintViolationException extends ConstraintViolationException
 {

lib/Doctrine/DBAL/Query/QueryException.php

@@ -5,6 +5,9 @@ namespace Doctrine\DBAL\Query;
 use Doctrine\DBAL\DBALException;
 use function implode;
 
+/**
+ * @psalm-immutable
+ */
 class QueryException extends DBALException
 {
     /**

lib/Doctrine/DBAL/SQLParserUtilsException.php

@@ -6,6 +6,8 @@ use function sprintf;
 
 /**
  * Doctrine\DBAL\ConnectionException
+ *
+ * @psalm-immutable
  */
 class SQLParserUtilsException extends DBALException
 {

lib/Doctrine/DBAL/Schema/SchemaException.php

@@ -6,6 +6,9 @@ use Doctrine\DBAL\DBALException;
 use function implode;
 use function sprintf;
 
+/**
+ * @psalm-immutable
+ */
 class SchemaException extends DBALException
 {
     public const TABLE_DOESNT_EXIST       = 10;

lib/Doctrine/DBAL/Sharding/ShardingException.php

@@ -6,6 +6,8 @@ use Doctrine\DBAL\DBALException;
 
 /**
  * Sharding related Exceptions
+ *
+ * @psalm-immutable
  */
 class ShardingException extends DBALException
 {

lib/Doctrine/DBAL/Types/ConversionException.php

@@ -15,6 +15,8 @@ use function substr;
 
 /**
  * Conversion Exception is thrown when the database to PHP conversion fails.
+ *
+ * @psalm-immutable
  */
 class ConversionException extends DBALException
 {