string database, string query, int

Описание

int msql ( string database, string query, int link_identifier); Возвращает положительный идентификатор результата mSQL-запроса или false в случае ошибки. msql() выбирает базу данных и выполняет на ней запрос. Если не указан необязательный идентификатор связи, функция будет пытаться найти открытую связь с mSQL-сервером и если ни одной связи найдено не будет, функция попытается создать ее, как если бы вызывалась функция msql_connect() без аргументов (см. msql_connect() ).

Описание

int msql_affected_rows (int query_identifier); Возвращает количество строк результата запроса (т.е. количество строк, возвращаемых SELECT, количество строк, модифицированных UPDATE или количество строк, удаленных DELETE). См.также: msql_query()

Описание

int msql_close (int link_identifier); Возвращает true в случае успеха и false в случае ошибки. msql_close() закрывает связь с базой данных mSQL, которая ассоциирована с указанным идентификатором связи. Если идентификатор связи не указан, закрывается последняя открытая связь. Заметьте, что обычно нет необходимости это делать, т.к. непостоянные связи автоматически закрываются после исполнения скрипта. msql_close() не закрывает постоянную связь, открытую с помощью msql_pconnect() . См.также: msql_connect() и msql_pconnect() .

Описание

int msql_connect (string hostname); В случае успеха возвращает положительный идентификатор связи или false в случае ошибки. msql_connect() устанавливает соединение с mSQL сервером. Аргумент hostname - необязателен, и если он пропущен, подразумевается localhost. В случае второго вызова функции msql_connect() с одинаковыми аргументами, новой связи не образуется, а вместо нее возвращается идентификатор уже открытого соединения. Связь серверои будет закрыта сразу же, как только прекратится выполнение скрипта или ранее она не будет закрыта вызовом функции msql_close() . См.также msql_pconnect() , msql_close() .

Описание

int msql_create_db (string database name, int [ link_identifier ] ); msql_create_db() пытается создать новую базу данных на сервере, ассоциированном с указанным идентификатором связи. См.также: msql_drop_db() .

Описание

int msql_createdb ( string database name, int [ link_identifier ] ); Идентична msql_create_db() .

Описание

int msql_data_seek (int query_identifier, int row_number); Возвращает true в случае успеха и false в случае ошибки. msql_data_seek() передвигает внутренний указатель строки результата msql_data_seek() ассоциированного с указанным идентификатором запроса для того, чтобы указать на строку с конкретным номером. Вызов msql_fetch_row() возвратит эту строку. См.также: msql_fetch_row() .

Описание

string msql_dbname (int query_identifier, int i); msql_dbname() возвращает название базы данных записанной в положении i указателя, возвращаемого функцией msql_listdbs() . Для определения количества доступных баз данных может быть использована функция msql_numrows() .

Описание

int msql_drop_db ( string database_name, int link_identifier); Возвращает true в случае успеха и false в случае ошибки. msql_drop_db() пытается полностью удалить с сервера базу данных, ассоциированную с указанным идентификатором связи. См.также: msql_create_db() .

Описание

См. msql_drop_db() .

Описание

string msql_error ( ); Ошибки, идующие от сервера mSQL больше не выдают предупреждений. Вместо них используйте функции для извлечения строки ошибки.

Описание

int msql_fetch_array (int query_identifier); Возвращает массив, который соответствует извлеченной строке. Если больше строк нет, возвращается false. msql_fetch_array() это расширенная версия функции msql_fetch_row() . В дополнение к записи данных в массив с цифровыми индексами, данные также записываются в ассоциативный массив, использующий названия полей в качестве ключей. Будьте осторожны при извлечении данных из запроса, который может возвратить запись, содержащую одно поле со значением 0 (или пустую строку, или NULL). Важно заметить, что использование msql_fetch_array() работает совсем НЕ медленнее, чем msql_fetch_row() , причем обеспечивает при этом важные дополнения. За дополнительной информацией обратитесь к msql_fetch_row()

Описание

object msql_fetch_field (int query_identifier, int field_offset); Возвращает объект, содержащий информацию о поле msql_fetch_field() может использоваться для извлечения информации о полях в некоторых результатх запросов. Если не указано смещение поля, то возвращается следующее поле не извлеченное функцией msql_fetch_field() поле. Свойствами объекта являются:

• name - название колонки
• table - название таблицы, которой принадлежит колонка to
• not_null - 1, если колонка не может быть равна null
• primary_key - 1, если колонка является первичным ключом
• unique - 1, если колонка является уникальным ключом
• type - тип колонки

См.также msql_field_seek() .

Описание

int msql_fetch_object (int query_identifier); Возвращает объект со свойствами, соответствующими извлеченной строке. Если больше нет строк, возвращается false. msql_fetch_object() эквивалентно msql_fetch_array() , с одним исключением - вместо массива возвращается объект. Это значит, что доступ у данным может производиться только по названию поля, а не по их смещению (числа - неправильные названия полей). По скорости работы функция иденитична msql_fetch_array() и msql_fetch_row() (разница очень маленькая). См.также: msql_fetch_array() and msql_fetch_row() .

Описание

array msql_fetch_row (int query_identifier); Возвращает массив, соответствующий извлеченной строке. Если больше нет строк, то возвращается false. msql_fetch_row() извлекает одну строку данных из результата, асслциированного с указанным идентификатором. Строка возвращается как массив. Каждая колонка результата записывается в массив со смещение, начиная со смещения 0. Следующий вызов msql_fetch_row() возвратит следубщую строку из результата. Если строк больше нет, возвратится false. См.также: msql_fetch_array() , msql_fetch_object() , msql_data_seek() , и msql_result() .

Описание

string msql_fieldname (int query_identifier, int field); msql_fieldname() возвращает название указанного поля. query_identifier - идентификатор запроса, и field - индекс поля. msql_fieldname($result, 2); возвратит название второго поля результата, ассоциированного с идентификатором результата.

Описание

int msql_field_seek (int query_identifier, int field_offset); Перемещает указатель на указанное смещение поля. Если последующий вызов msql_fetch_field() не будет включать в себя смещение поля, будет возвращено текущее поле. См.также: msql_fetch_field() .

Описание

int msql_fieldtable (int query_identifier, int field); Возвращает название таблицы, откуда было извлечено поле field .

Описание

string msql_fieldtype (int query_identifier, int i); msql_fieldtype() эквивалентно msql_fieldname() . Аргументы идентичны, но возвращается тип поля. Тип может быть следующим: "int", "string" или "real".

Описание

string msql_fieldflags (int query_identifier, int i); msql_fieldflags() возвращает флаги указанного поля. В текущий момент они могут быть следующими: "not null", "primary key", их комбинацией или "" (пустая строка).

Описание

int msql_fieldlen ( int query_identifier, int i); msql_fieldlen() возвращает длину указанного поля.

Описание

int msql_free_result (int query_identifier); msql_free_result() освобождает память, ассоциированную с query_identifier . Когда PHP завершает запрос, эта память осовобождается автоматически, таким образом Вам нужно вызывать эту функцию только тогда, когда Вы хотите быть уверены, что не используете слишком много памяти во время исполнения скрипта.

Описание

См. msql_free_result()

Описание

int msql_list_fields (string database, string tablename); msql_list_fields() извлекает информацию о данной таблице. Аргументами являются название базы данных и название таблицы. Возвращается указатель результата, который может быть использован функциями msql_fieldflags() , msql_fieldlen() , msql_fieldname() , и msql_fieldtype() . Идентификатор запроса - положительное целое число. Функция возвращает -1 если возникла ошибка. Строка, описывающая ошибку будет помещена в $phperrmsg , и до тех пор, пока функция не будет вызвана как @msql_list_fields() , строка ошибки будет выводится на печать. См.также msql_error() .

Описание

See msql_list_fields() .

Описание

int msql_list_dbs (void); msql_list_dbs() возвратит указатель на результат, содержащий базы данных, доступные с текущего msql демона. Используйте функцию msql_dbname() для извлечения имен таблиц.

Описание

См. msql_list_dbs() .

Описание

int msql_list_tables (string database); msql_list_tables() в качестве параметра использует название базы данных, и возвращает у казатель на результат, примерно, как и функция msql() . Для извлечения настоящих названий таблиц должна быть использована функция msql_tablename() , параметром в которую передается указатель на результат.

Описание

См. msql_list_tables() .

Описание

int msql_num_fields (int query_identifier); msql_num_fields() возвращает количество полей в данных резултата. См.также: msql() , msql_query() , msql_fetch_field() , и msql_num_rows() .

Описание

int msql_num_rows (int query_identifier); msql_num_rows() возвращает количество строк данных результата. См.также: msql() , msql_query() , и msql_fetch_row() .

Описание

int msql_numfields (int query_identifier); Идентична msql_num_fields() .

Описание

int msql_numrows (void); Идентична msql_num_rows() .

Описание

int msql_pconnect (string hostname); Возвращает положительный идентификатор соединения в случае успеха или false в случае ошибки. msql_pconnect() ведет себя во многом также как msql_connect() с двумя главными отличиями: Во-первых, при соединении функция должна попытаться найти (постоянное) соединение, уж открытое с указанным хостом. Если таковое найдено, вместо открытия нового соединения будет возвращен идентификатор только что найденного. Во-вторых, соединение с SQl-сервером не закроется, когда завершится исполнение скрипты. Вместо этого, соединение останется открытым для будущего использования ( msql_close() не закроет соединение, установленно с помощью msql_pconnect()). Такой тип связи, поэтому, называется 'постоянным'.

Описание

int msql_query (string query, int link_identifier); msql_query() посылает запрос к текущей активной базе данных на сервере, которая задается идентификатором связи. Если идентификатор связи не указан, то будет использоваться последняя открытая связь. Если связи вообще не открыто, то функция пытается установить связь как если бы вызывалась функция msql_connect() . Возвращает положительный идентификатор запроса в случае успеха или false в случае ошибки. См.также: msql() , msql_select_db() , and msql_connect() .

Описание

См. sql_regcase() .

Описание

int msql_result ( int query_identifier, int i, mixed field); Возвращает содержимое ячейки с указанной строки и смещения в указанном рузльтате. msql_result() возвращает содержимое одной ячейки из результата. Аргумент field может быть смещением поля или его названием или же названием таблицы, точка, названием поля (fieldname.tablename). Если название колонки является псевдонимом ('select foo as bar from...'), используйте псевдоним вместо названия колонки. При работе с большими результатами запросов, Вы должны рассмотреть возможность использования одной из функций, которые извлекают колонку целиком. Т.к. эти функции извлекают содержимое нескольких ячеек за один вызов, то они работают НАМНОГО быстрее, чем msql_result(). Также заметьте, что при указании числового смещения поля функция работает гораздо быстрее, чем при указании названия поля или аргумента название_таблицы.название_поля. В качестве высокоскоростной альтернативы рекомендуем: msql_fetch_row() , msql_fetch_array() , и msql_fetch_object() .

Описание

int msql_select_db (string database_name, int link_identifier); Возвращает true в случае успеха и false в случае ошибки. msql_select_db() устанавливает текущую активную базу данных на сервере, которая ассоциируется с указанным идентификатором связи. Если не указан идентификатор связи, используется последняя открытая связь. Если не открыто ни одного соединения, функция попытается установить связь, как если бы вызывалась функция msql_connect(), и в дальнейшем использует установленную связь. Каждый последующий вызов msql_query() будет сделан на активную базу данных. См.также: msql_connect() , msql_pconnect() , и msql_query() .

Описание

См. msql_select_db() .

Описание

string msql_tablename (int query_identifier, int field); msql_tablename() использует в качестве аргументов указатель на рузультат, возвращаемый функцией msql_list_tables() и целый индекс и возвращает название таблицы. Функция msql_numrows() может быть использована для определения количества таблиц в результате запроса.

Описание

int mysql_affected_rows(int [link_identifier] ); mysql_affected_rows() возвращает количество столбцов, использованных запросами INSERT, UPDATE или DELETE на сервере, связываемом с определенным идентификатором связи(link_identifier). Если идентификатор связи не определен, используется последняя открытая связь. Если последний запрос был запрос DELETE без условия WHERE, ВСЕ записи будут удалены из таблицы, но эта функция возвратит нуль. Эта команда не действует при запросе SELECT, она действует только при запросах, изменяющих записи. Чтобы получить количество колонок возвращенных на запрос SELECT, используйте mysql_num_rows().

Описание

int mysql_close(int [link_identifier] ); Возвращает: true при успешном завершении, false при ошибке mysql_close() закрывает связь с базой данных MySQL, ассоциированной с определенным идентификатором связи(link identifier. Если идентификатор связи не определен, используется последняя открытая связь. Имейте в виду, что это не всегда необходимо, так как непостоянные открытые связи автоматически закрываются в конце выполнения сценария. mysql_close() не закроет устойчивые связи сгенерированные функцией mysql_pconnect(). См. также: mysql_connect(), и mysql_pconnect().

Описание

int mysql_connect(string [hostname] [:port] , string [username] , string [password] ); Возвращает: Правильный идентификатор связи MySQL при успешном выполнении, или false при ошибке. mysql_connect() устанавливает соединение с MySQL сервером. Все аргументы дополнительны(опциональны), и если они пропущены, то устанавливаются по умолчанию -('localhost', имя пользователя, который владеет процессом, пустой пароль). Строка "имя сервера"("hostname") также может содержать номер порта( подобно "hostname:port"). В случае, если будет сделан второй вызов mysql_connect() с теми же аргументами, никакая новая связь не установится - вместо этого, будет возвращен идентификатор связи уже открытой связи. Как только выполнение сценария закончится, связь с сервером закроется, если оно не было явно закрыто более ранний вызовом mysql_close(). См. также mysql_pconnect(), и mysql_close().

Описание

int mysql_create_db(string database name, int [link_identifier] ); mysql_create_db() пытается создавать новую базу данных на сервере связанном с определенным идентификатором связи. См. также: mysql_drop_db(). Для совместимости с более ранними версиями может также быть использована функция mysql_createdb() .

Описание

int mysql_data_seek(int result_identifier, int row_number); Возвращает: true при успешном выполнении , false при ошибке. mysql_data_seek() перемещает внутренний указатель столбца в MySQL запросе связанного с определенным идентификатором результата чтобы указать на определенный номер столбца. Последующий вызов mysql_fetch_row() должно возвратить этот столбец.

Описание

int mysql_db_query( string database, string query, int [link_identifier] ); Возвращает: Правильный идентификатор результата MySQL в результате запроса, или false при ошибке . mysql_db_query() выбирает базу данных и выполняет запрос на нее. Если дополнительный идентификатор связи не определен, функция попытается найти открытую связь с MySQL сервером и если такая связь не обнаружена, то она попытается создать ее, как если бы функция mysql_connect() была вызвана без аргументов. См. также mysql_connect(). Для обратной совместимости может быть также использована функция mysql().

Описание

int mysql_drop_db(string database_name, int [link_identifier] ); Возвращает: true при успешном выполнении , false при неудачном завершении. mysql_drop_db() пытается удалить целую базу данных с сервера, связанного с определенным идентификатором связи. См. также: mysql_create_db(). Для обратной совместимости может быть также использована функция mysql_dropdb().

Описание

int mysql_errno(int [link_identifier] ); Ошибки возвращающиеся с выходного буфера базы данных mySQL больше не делают предупреждение. Взамен, используйте эту функцию, чтобы получить номер ошибки. <?php mysql_connect("marliesle"); echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("nonexistentdb"); echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); echo mysql_errno().": ".mysql_error()."<BR>"; ?> См. также: mysql_error()

Описание

string mysql_error(int [link_identifier] ); Ошибки возвращающиеся с выходного буфера базы данных mySQL больше не делают предупреждение. Взамен, используйте эту функцию, чтобы получить строку описания ошибки. <?php mysql_connect("marliesle"); echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("nonexistentdb"); echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); echo mysql_errno().": ".mysql_error()."<BR>"; ?> См. также: mysql_errno()

Описание

array mysql_fetch_array(int result); Возвращает результат строки запроса как массив, или false при отсутствии результата. mysql_fetch_array() является расширенной версией функции mysql_fetch_row(). Кроме того, что она сохраняет данные в пронумерованных элементах, результатного массива, она также сохраняет ассоциативную связь, используя имена полей как ключи. Если два или более столбцов имеют одинаковые имена, то связку ключ/значение получает последний из них. Чтобы получить доступ к другому столбцу(-цам) с таким же именем, вы должны использовать индексы или задать псевдонимы(alias) для этих столбцов. select t1.f1 as foo t2.f1 as bar from t1, t2 Важно заметить, что использование mysql_fetch_array() НЕСУЩЕСТВЕННО медленнее, чем использование mysql_fetch_row(), пока это обеспечивает необходимую задачу. Более подробно см. mysql_fetch_row()

Описание

object mysql_fetch_field(int result, int [field_offset] ); Возвращает объект, содержащий информацию о поле. mysql_fetch_field() Может быть использована для получения информации о поле в определенном результате запроса. Если параметры поля не указаны, то будет запрошено поле, которое еще не было запрошено функцией mysql_fetch_field(). Свойствами объекта являются:

• name - имя столбца
• table - имя таблицы, содержащей столбец
• max_length - максимальная длинна столбца
• not_null - 1, если столбец не может принимать нулевые значения
• primary_key - 1, если столбец является первичным ключом.
• unique_key - 1 если столбец является уникальным ключом
• multiple_key - 1 если столбец является не-уникальным ключом
• numeric - 1 если столбец числовой
• blob - 1 это столбец является BLOB
• type - тип столбца
• unsigned - 1 если столбец не назван
• zerofill - 1 если столбец заполнен нулем

См. также mysql_field_seek()

Описание

array mysql_fetch_lengths(int result); Возвращает: Массив, который соответствует длинам каждого поля в последней строке, выбранной mysql_fetch_row(), или false при ошибке . mysql_fetch_lengths() хранит длины каждого столбца в последней колонке результата возвращенного функцией mysql_fetch_row() в массиве, нумеруемом с нуля. См. также: mysql_fetch_row().

Описание

object mysql_fetch_object(int result); Возвращает объект с свойствами, который соответствует полученной строке, или false если нет результата. mysql_fetch_object() подобна mysql_fetch_array(), с одним различием - вместо массива возвращается объект. Это означает, что Вы можете иметь доступ к данным только по именам полей, а не по их параметрам (индексные числа в данном случае являются неверным обращением). Вообще говоря, эта функция идентична mysql_fetch_array(), такая же быстрая как mysql_fetch_row() (различие незначительное).

Описание

array mysql_fetch_row(int result); Возвращает: Массив, который соответствует выбранным колонкам, или false если нет результата. mysql_fetch_row() выбирает столбец данных из результата, и связывает его с определенным идентификатором результата(индексом элемента массива). Запрос возвращается как массив. Каждый столбец результата хранится в элементах массива, пронумерованного с нуля. Последующий вызов функции mysql_fetch_row() должен возвратить следующую строку, или false если нет больше колонок. См. также: mysql_fetch_array(), mysql_fetch_object(), mysql_data_seek(), mysql_fetch_lengths(), и mysql_result().

Описание

string mysql_field_name(int result, int field_index); mysql_field_name() возвращает имя указанного поля. Аргументами функции являются идентификатор результата и индекс поля, т.е. mysql_field_name($result,2); Возвратит имя второй области в результат, связанный с идентификатором результата($result). Для обратной совместимости также может быть использована функция mysql_fieldname().

Описание

int mysql_field_seek(int result, int field_offset); Поиск в определенном поле. Если следующий вызов mysql_fetch_field() не содержит указания поля, то должно быть возвращено именно это поле. См. также: mysql_fetch_field().

Описание

string mysql_field_table(int result, int field_offset); Получает имя таблицы поля. Для обратной совместимости также может быть использована mysql_fieldtable() .

Описание

string mysql_field_type(int result, int field_offset); mysql_field_type() подобна функции mysql_field_name() . Аргументы идентичны, но возвращается тип поля. Это будет что-то из "int", "real", "string", "blob", или другие типы, которые подробно описываются в документации MySQL.

Описание

string mysql_field_flags(int result, int field_offset); mysql_field_flags() возвращает флаги указанного поля. Флаги передаются как одно слово на флаг, разделенные одним пробелом, так, что Вы можете разделить возвращенную величину используя explode(). Если ваша текущая версия MySQL их поддерживает, могут быть получены следующие флаги : : "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". Для обратной совместимости mysql_fieldflags() также может быть использована.

Описание

int mysql_field_len(int result, int field_offset); mysql_field_len() возвращает длину указанного поля. Для обратной совместимости mysql_fieldlen() также может быть использована.

Описание

int mysql_free_result(int result); mysql_free_result() должна быть использована только если Вы беспокоитесь об использовании слишком большого объема памяти, во время работы вашего скрипта. Вся используемая результатом память для определенного идентификатора результата автоматически будет освобождена. Для обратной совместимости mysql_freeresult() также может быть использована.

Описание

int mysql_insert_id(int [link_identifier] ); mysql_insert_id() возвращает ID сгенерированнуые для поля с автоинкрементом(AUTO_INCREMENTED). Эта функция не использует аргументов. Она возвратит автоматически сгенерированный номер ID возвращенный последним запросом INSERT.

Описание

int mysql_list_fields( string database_name, string table_name, int [link_identifier] ); mysql_list_fields() извлекает информацию о заданной tablename таблице. Аргументы - имя базы данных и имя таблицы. После выполнения возвращается указатель результата, который может использоваться функциями mysql_field_flags(), mysql_field_len(), mysql_field_name(), и mysql_field_type(). Идентификатор результата является положительным целым. Функция возвращает -1 если происходит ошибка. Строка описсания ошибки будет помещена в переменную $phperrmsg, и если функция не была вызвана как @mysql() то затем также будет выведено это описание ошибки. Для обратной совместимости mysql_listfields() также может быть использована.

Описание

int mysql_list_dbs(int [link_identifier] ); mysql_list_dbs() возвратит указатель результата, содержащий базы данных доступные текущему процессу mysql. Используйте функцию mysql_tablename(), чтобы просмотреть этот указатель результата. Для обратной совместимости mysql_listdbs() также может быть использована.

Описание

int mysql_list_tables(string database, int [link_identifier] ); mysql_list_tables() берет имя базы данных и указатель результата очень подобно функции mysql_db_query(). Функция mysql_tablename() должна использоваться, чтобы извлечь фактические имена таблиц с указателя результата. Для обратной совместимости mysql_listtables() также может быть использована.

Описание

int mysql_num_fields(int result); mysql_num_fields() получает количество полей в установленном результате. См. также: mysql_db_query(), mysql_query(), mysql_fetch_field(), mysql_num_rows(). Для обратной совместимости mysql_numfields() также может быть использована.

Описание:

int mysql_num_rows(int result); mysql_num_rows() получает количество столбцов в установленном результате См. также: mysql_db_query(), mysql_query() и, mysql_fetch_row(). Для обратной совместимости mysql_numrows() также может быть использована.

Описание

int mysql_pconnect(string [hostname] [:port] , string [username] , string [password] ); Возвращает: Правильный MySQL идентификатор устойчивой связи при успешном выполнении , или false при ошибке. mysql_pconnect() действует очень похоже на mysql_connect() с двумя важными различиями. Во-первых, при соединении, функция должна сначала попытаться найти (устойчивую) связь, которая уже открыта тем же хостом, именем пользователя и паролем. Если она обнаруживается, возвратится ее идентификатор, вместо открытия нового соединения. Во-вторых, соединение с сервером SQL не закроется, когда закончится выполнение сценария. Вместо этого, связь останется открытой для последующего использования (mysql_close() не закроет связи установленные функцией mysql_pconnect()). Потому этот тип связей назван 'устойчивый'. Содержание раздела