File "InvalidQuery.php"

Full Path: /home/warrior1/public_html/plugins/google-listings-and-ads/src/Exception/InvalidQuery.php
File size: 4.31 KB
MIME-type: text/x-php
Charset: utf-8

<?php
declare( strict_types=1 );

namespace Automattic\WooCommerce\GoogleListingsAndAds\Exception;

use InvalidArgumentException;

defined( 'ABSPATH' ) || exit;

/**
 * Class InvalidColumn
 *
 * @package Automattic\WooCommerce\GoogleListingsAndAds\Exception
 */
class InvalidQuery extends InvalidArgumentException implements GoogleListingsAndAdsException {

	/**
	 * Create a new instance of the exception when a column is not valid for a given table.
	 *
	 * @param string $name        The column name.
	 * @param string $table_class The table class name.
	 *
	 * @return static
	 */
	public static function from_column( string $name, string $table_class ): InvalidQuery {
		return new static( sprintf( 'The column "%s" is not valid for table class "%s".', $name, $table_class ) );
	}

	/**
	 * Create a new instance of the exception when a column is not valid.
	 *
	 * @param string $name        The column name.
	 *
	 * @return static
	 */
	public static function invalid_column( string $name ): InvalidQuery {
		return new static( sprintf( 'The column "%s" is not valid, it should only contain the characters "a-zA-Z0-9._"', $name ) );
	}

	/**
	 * Create a new instance of the exception when a column is not valid for ordering.
	 *
	 * @param string $name The column name.
	 *
	 * @return static
	 */
	public static function invalid_order_column( string $name ): InvalidQuery {
		return new static( sprintf( 'The column "%s" is not valid for ordering results.', $name ) );
	}

	/**
	 * @param string $compare
	 *
	 * @return static
	 */
	public static function from_compare( string $compare ): InvalidQuery {
		return new static( sprintf( 'The compare value "%s" is not valid.', $compare ) );
	}

	/**
	 * @param string $relation
	 *
	 * @return static
	 */
	public static function where_relation( string $relation ): InvalidQuery {
		return new static( sprintf( 'The where relation value "%s" is not valid.', $relation ) );
	}

	/**
	 * Create a new instance of the exception when there is an error inserting data into the DB.
	 *
	 * @param string $error
	 *
	 * @return InvalidQuery
	 */
	public static function from_insert( string $error ): InvalidQuery {
		return new static( sprintf( 'Error inserting data into the database: "%s"', $error ) );
	}

	/**
	 * Create a new instance of the exception when trying to set an auto increment ID.
	 *
	 * @param string $table_class
	 * @param string $column_name
	 *
	 * @return InvalidQuery
	 */
	public static function cant_set_id( string $table_class, string $column_name = 'id' ): InvalidQuery {
		return new static( sprintf( 'Cannot set column "%s" for table class "%s".', $column_name, $table_class ) );
	}

	/**
	 * Create a new instance of the exception when there is an error deleting data from the DB.
	 *
	 * @param string $error
	 *
	 * @return InvalidQuery
	 */
	public static function from_delete( string $error ): InvalidQuery {
		return new static( sprintf( 'Error deleting data into the database: "%s"', $error ) );
	}

	/**
	 * Create a new instance of the exception when there is an error updating data in the DB.
	 *
	 * @param string $error
	 *
	 * @return InvalidQuery
	 */
	public static function from_update( string $error ): InvalidQuery {
		return new static( sprintf( 'Error updating data in the database: "%s"', $error ) );
	}

	/**
	 * Create a new instance of the exception when an empty where clause is provided.
	 *
	 * @return InvalidQuery
	 */
	public static function empty_where(): InvalidQuery {
		return new static( 'Where clause cannot be an empty array.' );
	}

	/**
	 * Create a new instance of the exception when an empty set of columns is provided.
	 *
	 * @return InvalidQuery
	 */
	public static function empty_columns(): InvalidQuery {
		return new static( 'Columns list cannot be an empty array.' );
	}

	/**
	 * Create a new instance of the exception when an invalid resource name is used.
	 *
	 * @return InvalidQuery
	 */
	public static function resource_name(): InvalidQuery {
		return new static( 'The resource name can only include alphanumeric and underscore characters.' );
	}

	/**
	 * Create a new instance of the exception when an invalid value is used for a column.
	 *
	 * @param string $name The column name.
	 *
	 * @return InvalidQuery
	 */
	public static function invalid_value( string $name ): InvalidQuery {
		return new static( sprintf( 'The value for column "%s" is not valid.', $name ) );
	}
}