- PHP MySQLi Functions
- Installation / Runtime Configuration
- PHP MySQLi Functions
- Работа с MySQL в PHP
- Что такое mysqli?
- Как выглядит работа с базой данных
- Функция mysqli connect: соединение с MySQL
- Проверка соединения
- Установка кодировки
- Выполнение запросов
- Два вида запросов
- Добавление записи
- Функция insert id: как получить идентификатор добавленной записи
- Чтение записей
- Как получить сразу все записи в виде двумерного массива
- Как узнать количество записей
PHP MySQLi Functions
The MySQLi functions allows you to access MySQL database servers.
Note: The MySQLi extension is designed to work with MySQL version 4.1.13 or newer.
Installation / Runtime Configuration
For the MySQLi functions to be available, you must compile PHP with support for the MySQLi extension.
The MySQLi extension was introduced with PHP version 5.0.0. The MySQL Native Driver was included in PHP version 5.3.0.
PHP MySQLi Functions
| Function | Description |
|---|---|
| affected_rows() | Returns the number of affected rows in the previous MySQL operation |
| autocommit() | Turns on or off auto-committing database modifications |
| begin_transaction() | Starts a transaction |
| change_user() | Changes the user of the specified database connection |
| character_set_name() | Returns the default character set for the database connection |
| close() | Closes a previously opened database connection |
| commit() | Commits the current transaction |
| connect() | Opens a new connection to the MySQL server |
| connect_errno() | Returns the error code from the last connection error |
| connect_error() | Returns the error description from the last connection error |
| data_seek() | Adjusts the result pointer to an arbitrary row in the result-set |
| debug() | Performs debugging operations |
| dump_debug_info() | Dumps debugging info into the log |
| errno() | Returns the last error code for the most recent function call |
| error() | Returns the last error description for the most recent function call |
| error_list() | Returns a list of errors for the most recent function call |
| fetch_all() | Fetches all result rows as an associative array, a numeric array, or both |
| fetch_array() | Fetches a result row as an associative, a numeric array, or both |
| fetch_assoc() | Fetches a result row as an associative array |
| fetch_field() | Returns the next field in the result-set, as an object |
| fetch_field_direct() | Returns meta-data for a single field in the result-set, as an object |
| fetch_fields() | Returns an array of objects that represent the fields in a result-set |
| fetch_lengths() | Returns the lengths of the columns of the current row in the result-set |
| fetch_object() | Returns the current row of a result-set, as an object |
| fetch_row() | Fetches one row from a result-set and returns it as an enumerated array |
| field_count() | Returns the number of columns for the most recent query |
| field_seek() | Sets the field cursor to the given field offset |
| get_charset() | Returns a character set object |
| get_client_info() | Returns the MySQL client library version |
| get_client_stats() | Returns statistics about client per-process |
| get_client_version() | Returns the MySQL client library version as an integer |
| get_connection_stats() | Returns statistics about the client connection |
| get_host_info() | Returns the MySQL server hostname and the connection type |
| get_proto_info() | Returns the MySQL protocol version |
| get_server_info() | Returns the MySQL server version |
| get_server_version() | Returns the MySQL server version as an integer |
| info() | Returns information about the last executed query |
| init() | Initializes MySQLi and returns a resource for use with real_connect() |
| insert_id() | Returns the auto-generated id from the last query |
| kill() | Asks the server to kill a MySQL thread |
| more_results() | Checks if there are more results from a multi query |
| multi_query() | Performs one or more queries on the database |
| next_result() | Prepares the next result-set from multi_query() |
| options() | Sets extra connect options and affect behavior for a connection |
| ping() | Pings a server connection, or tries to reconnect if the connection has gone down |
| poll() | Polls connections |
| prepare() | Prepares an SQL statement for execution |
| query() | Performs a query against a database |
| real_connect() | Opens a new connection to the MySQL server |
| real_escape_string() | Escapes special characters in a string for use in an SQL statement |
| real_query() | Executes a single SQL query |
| reap_async_query() | Returns result from an async SQL query |
| refresh() | Refreshes/flushes tables or caches, or resets the replication server information |
| rollback() | Rolls back the current transaction for the database |
| select_db() | Select the default database for database queries |
| set_charset() | Sets the default client character set |
| set_local_infile_default() | Unsets user defined handler for load local infile command |
| set_local_infile_handler() | Set callback function for LOAD DATA LOCAL INFILE command |
| sqlstate() | Returns the SQLSTATE error code for the error |
| ssl_set() | Used to establish secure connections using SSL |
| stat() | Returns the current system status |
| stmt_init() | Initializes a statement and returns an object for use with stmt_prepare() |
| store_result() | Transfers a result-set from the last query |
| thread_id() | Returns the thread ID for the current connection |
| thread_safe() | Returns whether the client library is compiled as thread-safe |
| use_result() | Initiates the retrieval of a result-set from the last query executed |
| warning_count() | Returns the number of warnings from the last query in the connection |
Работа с MySQL в PHP
PHP поддерживает работу с базой данных MySQL. Специальные встроенные функции для работы с MySQL позволяют просто и эффективно работать с этой СУБД: выполнять любые запросы, читать и записывать данные, обрабатывать ошибки.
Сценарий, который подключается к БД, выполняет запрос и показывает результат, будет состоять всего из нескольких строк. Для работы с MySQL не надо ничего дополнительно устанавливать и настраивать; всё необходимое уже доступно вместе со стандартной поставкой PHP.
Что такое mysqli?
mysqli (MySQL Improved) — это расширение PHP, которое добавляет в язык полную поддержку баз данных MySQL. Это расширение поддерживает множество возможностей современных версий MySQL.
Как выглядит работа с базой данных
Типичный процесс работы с СУБД в PHP-сценарии состоит из нескольких шагов:
- Установить подключение к серверу СУБД, передав необходимые параметры: адрес, логин, пароль.
- Убедиться, что подключение прошло успешно: сервер СУБД доступен, логин и пароль верные и так далее.
- Сформировать правильный SQL запрос (например, на чтение данных из таблицы).
- Убедиться, что запрос был выполнен успешно.
- Получить результат от СУБД в виде массива из записей.
- Использовать полученные записи в своём сценарии (например, показать их в виде таблицы).
Функция mysqli connect: соединение с MySQL
Перед началом работы с данными внутри MySQL, нужно открыть соединение с сервером СУБД. В PHP это делается с помощью стандартной функции mysqli_connect() . Функция возвращает результат — ресурс соединения. Данный ресурс используется для всех следующих операций с MySQL.
Но чтобы выполнить соединение с сервером, необходимо знать как минимум три параметра:
Если вы следовали стандартной процедуре установки MySQL или используете OpenServer, то адресом сервера будет localhost , логином — root . При использовании OpenServer пароль для подключения — это пустая строка ‘’ , а при самостоятельной установке MySQL пароль вы задавали в одном из шагов мастера установки.
Базовый синтаксис функции mysqli_connect() :
Проверка соединения
Первое, что нужно сделать после соединения с СУБД — это выполнить проверку, что оно было успешным. Эта проверка нужна, чтобы исключить ошибку при подключении к БД. Неверные параметры подключения, неправильная настройка или высокая нагрузка заставит MySQL отвергать новые подключения. Все эти ситуации приведут к невозможности соединения, поэтому программист должен проверить успешность подключения к серверу, прежде чем выполнять следующие действия.
Соединение с MySQL устанавливается один раз в сценарии, а затем используется при всех запросах к БД.
Результатом выполнения функции mysqli_connect() будет значение специального типа — ресурс. Если подключение к MySQL не удалось, то функция mysqli_connect() вместо ресурса вернёт логическое значение типа «ложь» — false . Хорошей практикой будет всегда проверять результат выполнения этой функции и сравнивать его с ложью.
Соединение с MySQL и проверка на ошибки:
Функция mysqli_connect_error() просто возвращает текстовое описание последней ошибки MySQL.
Установка кодировки
Первым делом после установки соединения крайне желательно явно задать кодировку, которая будет использоваться при обмене данными с MySQL. Если этого не сделать, то вместо записей со значениями, написанными кириллицей, можно получить последовательность из знаков вопроса: . . Вызовите эту функцию сразу после успешной установки соединения: mysqli_set_charset($con, «utf8»);
Выполнение запросов
Установив соединение и определив кодировку мы готовы выполнить свои первые SQL-запросы. Вы уже умеете составлять корректные SQL команды и выполнять их через консольный или визуальный интерфейс MySQL-клиента. Те же самые запросы можно отправлять без изменений и из PHP-сценария. Помогут в этом несколько встроенных функций языка.
Два вида запросов
Следует разделять все SQL-запросы на две группы:
При выполнении запросов из среды PHP, запросы из второй группы возвращают только результат их исполнения: успех или ошибку.
Запросы первой группы при успешном выполнении возвращают специальный ресурс результата. Его, в свою очередь, можно преобразовать в ассоциативный массив (если нужна одна запись) или в двумерный массив (если требуется список записей).
Добавление записи
Вернёмся к нашему проекту — дневнику наблюдений за погодой. Начнём практическую работу с заполнения таблиц данными. Для начала добавим хотя бы один город в таблицу cities .
Выражение INSERT INTO используется для добавления новых записей в таблицу базы данных.
Составим корректный SQL-запрос на вставку записи с именем города, а затем выполним его путём передачи этого запроса в функцию mysqli_query() , чтобы добавить новые данные в таблицу.
Обратите внимание, что первым параметром для функции mysqli_query() передаётся ресурс подключения, полученный от функции mysqli_connect() , вторым параметром следует строка с SQL-запросом.
При запросах на изменение данных (не SELECT) результатом выполнения будет логическое значение — true или false , которое будет означать, что запрос выполнить не удалось. Для получения строки с описанием ошибки существует функция mysqli_error($link) .
Функция insert id: как получить идентификатор добавленной записи
Следующим шагом будет добавление погодной записи для нового города. Погодные записи хранит таблица weather_log, но, чтобы сослаться на город, необходимо знать идентификатор записи из таблицы cities.
Здесь пригодится функция mysqli_insert_id() . Она принимает единственный аргумент — ресурс соединения, а возвращает идентификатор последней добавленной записи.
Теперь у нас есть всё необходимое, чтобы добавить погодную запись. Вот как будет выглядеть комплексный пример с подключением к MySQL и добавлением двух новых записей:
Чтение записей
Другая частая операция при работе с базами данных в PHP — это получение записей из таблиц (запросы типа SELECT). Составим SQL-запрос, который будет использовать SELECT выражение. Затем выполним этот запрос с помощью функции mysqli_query() , чтобы получить данные из таблицы.
В этом примере показано, как вывести все существующие города из таблицы cities :
В примере выше результат выполнения функции mysqli_query() сохранён в переменной $result . В этой переменной находятся не данные из таблицы, а специальный тип данных — так называемая ссылка на результаты запроса.
Чтобы получить действительные данные, то есть записи из таблицы, следует использовать другую функцию — mysqli_fetch_array() — и передать ей единственным параметром эту самую ссылку. Теперь каждый вызов функции mysqli_fetch_array() будет возвращать следующую запись из всего результирующего набора записей в виде ассоциативного массива.
Цикл while здесь используется для «прохода» по всем записям из полученного набора записей. Значение поля каждой записи можно узнать просто обратившись по ключу этого ассоциативного массива.
Как получить сразу все записи в виде двумерного массива
Иногда бывает удобно после запроса на чтение не вызывать в цикле mysqli_fetch_array для извлечения очередной записи по порядку, а получить их сразу все одним вызовом. PHP так тоже умеет.
Функция mysqli_fetch_all($res, MYSQLI_ASSOC) вернёт двумерный массив со всеми записями из результата последнего запроса. Перепишем пример с показом существующих городов с её использованием:
Как узнать количество записей
Часто бывает необходимо узнать, сколько всего записей вернёт выполненный SQL-запрос. Это может помочь при организации постраничной навигации или просто в качестве информации. Узнать число записей поможет функция mysqli_num_rows() , которой следует передать ссылку на результат запроса.
«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.