Функции MySQL PHP
- Предыдущая страница PHP Math
- Следующая страница PHP MySQLi
PHP MySQL Обзор
Функции MySQL позволяют вам получить доступ к серверу базы данных MySQL.
Установка
Чтобы успешно использовать функции этого класса, необходимо добавить поддержку MySQL при компиляции PHP.
При компиляции достаточно использовать опцию конфигурации --with-mysql[=DIR], где опциональный [DIR] указывает на директорию установки MySQL.
Хотя эта библиотека расширения MySQL совместима с версиями MySQL 4.1.0 и новее, она не поддерживает дополнительные функции, предоставляемые этими версиями. Чтобы использовать эти функции, пожалуйста, используйте библиотеку расширения MySQLi.
Если необходимо одновременно устанавливать библиотеку расширения mysql и библиотеку расширения mysqli, необходимо использовать одну и ту же клиентскую библиотеку, чтобы избежать конфликтов.
Установка на Linux системе
PHP 4
Опция --with-mysql по умолчанию включена. Это поведение по умолчанию можно отключить с помощью опции конфигурации --without-mysql. Если MySQL включен, но не указан путь к установке, PHP будет использовать привязанную библиотеку клиентских соединений MySQL.
Пользователи других приложений, использующих MySQL (например, auth-mysql), не должны использовать привязанную библиотеку, а должны указать путь к安装在 MySQL директории, например: --with-mysql=/путь/к/mysql. Это будет принудительно заставить PHP использовать клиентскую библиотеку соединений, установленную вместе с MySQL, что позволит избежать конфликтов.
PHP 5+
MySQL по умолчанию не включен и не имеет привязанной библиотеки MySQL. Используйте опцию конфигурации --with-mysql[=DIR], чтобы добавить поддержку MySQL. Вы можете MySQL Скачивание заголовочных файлов и библиотек.
Установка на Windows системе
PHP 4
PHP MySQL расширение уже включено в PHP.
PHP 5+
MySQL по умолчанию не включен, поэтому его необходимо активировать в файле php.ini, добавив динамическую библиотеку php_mysql.dll. Кроме того, PHP требует доступа к библиотеке клиентских соединений MySQL. В дистрибутиве PHP для Windows включена библиотека libmysql.dll, чтобы PHP мог общаться с MySQL, этот файл должен быть добавлен в переменную системы PATH.
Чтобы активировать любую библиотеку расширения PHP (например, php_mysql.dll), команда extension_dir должна быть установлена в директорию библиотек расширения. Пример значения extension_dir в PHP 5: c:\php\ext.
Комментарии:Если при запуске веб-сервера出现类似的 ошибок: "Unable to load dynamic library './php_mysql.dll'", это означает, что система не может найти php_mysql.dll и / или libmysql.dll.
Runtime конфигурация
Behavior of MySQL функций зависит от настроек, установленных в php.ini.
Опции конфигурации MySQL:
| Название | По умолчанию | Описание | Изменяемый |
|---|---|---|---|
| mysql.allow_persistent | "1" | Разрешено ли использование持久ных подключений MySQL. | PHP_INI_SYSTEM |
| mysql.max_persistent | "-1" | Максимальное количество持久ных подключений в каждом процессе. | PHP_INI_SYSTEM |
| mysql.max_links | "-1" | Максимальное количество подключений в каждом процессе, включая持久ные подключения. | PHP_INI_SYSTEM |
| mysql.trace_mode | "0" | Режим отладки. Доступно с PHP 4.3.0. | PHP_INI_ALL |
| mysql.default_port | NULL | Указывается порт TCP по умолчанию для подключения к базе данных. | PHP_INI_ALL |
| mysql.default_socket | NULL | Используемый по умолчанию имя сокета. Доступно с PHP 4.0.1. | PHP_INI_ALL |
| mysql.default_host | NULL | Используемый по умолчанию адрес сервера. Не подходит для SQL безопасного режима. | PHP_INI_ALL |
| mysql.default_user | NULL | Используемый по умолчанию имя пользователя. Не подходит для SQL безопасного режима. | PHP_INI_ALL |
| mysql.default_password | NULL | Используемый по умолчанию пароль. Не подходит для SQL безопасного режима. | PHP_INI_ALL |
| mysql.connect_timeout | "60" | Секунды ожидания подключения. | PHP_INI_ALL |
Тип ресурсов
В модуле MySQL используются два типа ресурсов. Первый - это хендл для подключения к базе данных, второй - результат набора данных SQL-запроса.
Функции MySQL PHP
PHP:Указывает earliest PHP версия, поддерживающая эту функцию.
| Функция | Описание | PHP |
|---|---|---|
| mysql_affected_rows() | Получение количестваaffected строк последней операции MySQL. | 3 |
| mysql_change_user() | Не рекомендуется. Изменение текущего пользователя в активной сессии. | 3 |
| mysql_client_encoding() | Возврат имени текущего набора символов подключения. | 4 |
| mysql_close() | Закрытие непостоянного подключения MySQL. | 3 |
| mysql_connect() | Открытие непостоянного подключения MySQL. | 3 |
| mysql_create_db() | Не рекомендуется. Создание новой базы данных MySQL. Используйте mysql_query() вместо. | 3 |
| mysql_data_seek() | Перемещение指针 записи. | 3 |
| mysql_db_name() | Возврат данных库名ей из вызова mysql_list_dbs(). | 3 |
| mysql_db_query() |
Не рекомендуется. Отправка MySQL запроса. Использование mysql_select_db() и mysql_query() вместо. |
3 |
| mysql_drop_db() |
Не рекомендуется. Удаление (удаление) MySQL базы данных. Не рекомендуется. Используйте mysql_query() вместо этого. |
3 |
| mysql_errno() | Возврат числового кода ошибки последней операции MySQL. | 3 |
| mysql_error() | Возврат текстовой ошибки последней операции MySQL. | 3 |
| mysql_escape_string() |
Не рекомендуется. Эскейпинг строки для mysql_query. Использование mysql_real_escape_string() вместо. |
4 |
| mysql_fetch_array() | Получение строки из результатов в виде связанного массива, числового массива или обоих. | 3 |
| mysql_fetch_assoc() | Получение строки из результатов в виде связанного массива. | 4 |
| mysql_fetch_field() | Получение информации о столбцах из результатов и возврат её в виде объекта. | 3 |
| mysql_fetch_lengths() | Получение длины содержимого каждого поля в результатах. | 3 |
| mysql_fetch_object() | Получение строки из результатов в виде объекта. | 3 |
| mysql_fetch_row() | Получение строки из результатов в виде массива чисел. | 3 |
| mysql_field_flags() | Получение и关联指定字段的标志 из результатов. | 3 |
| mysql_field_len() | Возврат长度 указанного поля. | 3 |
| mysql_field_name() | Получите имя поля в результирующем наборе. | 3 |
| mysql_field_seek() | Установите указатель результирующего набора на указанное смещение поля. | 3 |
| mysql_field_table() | Получите имя таблицы, в которой находится поле. | 3 |
| mysql_field_type() | Получите тип поля в результирующем наборе. | 3 |
| mysql_free_result() | Освободите память результата. | 3 |
| mysql_get_client_info() | Получите информацию о клиенте MySQL. | 4 |
| mysql_get_host_info() | Получите информацию о хосте MySQL. | 4 |
| mysql_get_proto_info() | Получите информацию о протоколе MySQL. | 4 |
| mysql_get_server_info() | Получите информацию о сервере MySQL. | 4 |
| mysql_info() | Получите информацию о последнем запросе. | 4 |
| mysql_insert_id() | Получите ID, созданный последней операцией INSERT. | 3 |
| mysql_list_dbs() | Выведите все базы данных на сервере MySQL. | 3 |
| mysql_list_fields() |
Не рекомендуется. Выведите поля из результатов MySQL. Не рекомендуется. Используйте mysql_query() вместо этого. |
3 |
| mysql_list_processes() | Выведите процессы MySQL. | 4 |
| mysql_list_tables() |
Не рекомендуется. Выведите таблицы из базы данных MySQL. Не рекомендуется. Используйте mysql_query() вместо этого. |
3 |
| mysql_num_fields() | Получите количество полей в результирующем наборе. | 3 |
| mysql_num_rows() | Получите количество строк в результирующем наборе. | 3 |
| mysql_pconnect() | Откройте постоянное соединение с сервером MySQL. | 3 |
| mysql_ping() | Пинг-запрос к соединению с сервером, если соединение отсутствует, повторно установите соединение. | 4 |
| mysql_query() | Отправьте запрос MySQL. | 3 |
| mysql_real_escape_string() | Экранируйте особые символы в строках, используемых в SQL-запросах. | 4 |
| mysql_result() | Получите данные результатов. | 3 |
| mysql_select_db() | Выберите базу данных MySQL. | 3 |
| mysql_stat() | Получите текущее системное состояние. | 4 |
| mysql_tablename() | Не рекомендуется. Получите имя таблицы. Используйте mysql_query() вместо этого. | 3 |
| mysql_thread_id() | Возвращает ID текущей нити. | 4 |
| mysql_unbuffered_query() | Отправка SQL-запроса в MySQL (не получают / кэшируют результаты). | 4 |
Константы PHP MySQL
В версиях PHP 4.3.0 и выше, допускается указывать дополнительные флаги клиента в функциях mysql_connect() и mysql_pconnect():
PHP:Указывает на самую раннюю версию PHP, поддерживающую эту константу.
| Константы | Описание | PHP |
|---|---|---|
| MYSQL_CLIENT_COMPRESS | Использование сжатого протокола передачи данных. | 4.3 |
| MYSQL_CLIENT_IGNORE_SPACE | Разрешено оставлять пробельные символы после имени функции. | 4.3 |
| MYSQL_CLIENT_INTERACTIVE | Неактивное время ожидания взаимодействия до закрытия подключения. | 4.3 |
| MYSQL_CLIENT_SSL | Использование шифрования SSL (доступно только в версии клиентской библиотеки MySQL 4+). | 4.3 |
Функция mysql_fetch_array() использует константу для обозначения типа возвращаемого массива:
| Константы | Описание | PHP |
|---|---|---|
| MYSQL_ASSOC | Возвращаемые данные в столбцах используют имя поля в качестве имени индекса массива. | |
| MYSQL_BOTH | Возвращаемые данные в столбцах используют имя поля и числовой индекс в качестве имени индекса массива. | |
| MYSQL_NUM |
Возвращаемые данные в столбцах используют числовой индекс в качестве имени индекса массива. Индекс начинается с 0, что означает, что это первый возвращаемый результат. |
- Предыдущая страница PHP Math
- Следующая страница PHP MySQLi
