mysql_query

Description

mysql_query() sends a query (to the currently
active database on the server that's associated with the
specified link_identifier).

Parameters

query

A SQL query

The query string should not end with a semicolon.

link_identifier

The MySQL connection. If the
link identifier is not specified, the last link opened by
mysql_connect() is assumed. If no such link is found, it
will try to create one as if mysql_connect() was called
with no arguments. If by chance no connection is found or established, an
E_WARNING level warning is generated.

Return Values

For SELECT, SHOW, DESCRIBE or EXPLAIN statements,
mysql_query()
returns a resource on success, or FALSE on
error.

For other type of SQL statements, UPDATE, DELETE, DROP, etc,
mysql_query() returns TRUE on success
or FALSE on error.

The returned result resource should be passed to
mysql_fetch_array(), and other
functions for dealing with result tables, to access the returned data.

Use mysql_num_rows() to find out how many rows
were returned for a SELECT statement or
mysql_affected_rows() to find out how many
rows were affected by a DELETE, INSERT, REPLACE, or UPDATE
statement.

mysql_query() will also fail and return FALSE
if the user does not have permission to access the table(s) referenced by
the query.

Examples

Example 1. Invalid Query

The following query is syntactically invalid, so
mysql_query() fails and returns FALSE.

<?php// This could be supplied by a user, for example$firstname = 'fred';$lastname = 'fox';

// Formulate Query// This is the best way to perform a SQL query// For more examples, see mysql_real_escape_string()$query = sprintf("SELECT firstname, lastname, address, age FROM friends WHERE firstname='%s' AND lastname='%s'",mysql_real_escape_string($firstname),mysql_real_escape_string($lastname));