wpdb::set_sql_mode( array $modes = array() )

Changes the current SQL mode, and ensures its WordPress compatibility.

Description

If no modes are passed, it will ensure the current MySQL server modes are compatible.

Parameters

$modesarrayoptional
A list of SQL modes to set.

Default:array()

Source

public function set_sql_mode( $modes = array() ) {
	if ( empty( $modes ) ) {
		$res = mysqli_query( $this->dbh, 'SELECT @@SESSION.sql_mode' );

		if ( empty( $res ) ) {
			return;
		}

		$modes_array = mysqli_fetch_array( $res );

		if ( empty( $modes_array[0] ) ) {
			return;
		}

		$modes_str = $modes_array[0];

		if ( empty( $modes_str ) ) {
			return;
		}

		$modes = explode( ',', $modes_str );
	}

	$modes = array_change_key_case( $modes, CASE_UPPER );

	/**
	 * Filters the list of incompatible SQL modes to exclude.
	 *
	 * @since 3.9.0
	 *
	 * @param array $incompatible_modes An array of incompatible modes.
	 */
	$incompatible_modes = (array) apply_filters( 'incompatible_sql_modes', $this->incompatible_modes );

	foreach ( $modes as $i => $mode ) {
		if ( in_array( $mode, $incompatible_modes, true ) ) {
			unset( $modes[ $i ] );
		}
	}

	$modes_str = implode( ',', $modes );

	mysqli_query( $this->dbh, "SET SESSION sql_mode='$modes_str'" );
}

Hooks

apply_filters( ‘incompatible_sql_modes’, array $incompatible_modes )

Filters the list of incompatible SQL modes to exclude.

Changelog

VersionDescription
3.9.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.