wpdb::set_charset( mysqli|resource $dbh, string $charset = null, string $collate = null )

Sets the connection’s character set.


Parameters

$dbh mysqli|resource Required
The connection returned by mysqli_connect() or mysql_connect().
$charset string Optional
The character set.

Default: null

$collate string Optional
The collation.

Default: null


Top ↑

Source

File: wp-includes/class-wpdb.php. View all references

public function set_charset( $dbh, $charset = null, $collate = null ) {
	if ( ! isset( $charset ) ) {
		$charset = $this->charset;
	}
	if ( ! isset( $collate ) ) {
		$collate = $this->collate;
	}
	if ( $this->has_cap( 'collation' ) && ! empty( $charset ) ) {
		$set_charset_succeeded = true;

		if ( $this->use_mysqli ) {
			if ( function_exists( 'mysqli_set_charset' ) && $this->has_cap( 'set_charset' ) ) {
				$set_charset_succeeded = mysqli_set_charset( $dbh, $charset );
			}

			if ( $set_charset_succeeded ) {
				$query = $this->prepare( 'SET NAMES %s', $charset );
				if ( ! empty( $collate ) ) {
					$query .= $this->prepare( ' COLLATE %s', $collate );
				}
				mysqli_query( $dbh, $query );
			}
		} else {
			if ( function_exists( 'mysql_set_charset' ) && $this->has_cap( 'set_charset' ) ) {
				$set_charset_succeeded = mysql_set_charset( $charset, $dbh );
			}
			if ( $set_charset_succeeded ) {
				$query = $this->prepare( 'SET NAMES %s', $charset );
				if ( ! empty( $collate ) ) {
					$query .= $this->prepare( ' COLLATE %s', $collate );
				}
				mysql_query( $query, $dbh );
			}
		}
	}
}


Top ↑

Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes

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