Работа с MySQL через PDO
Для создания подключения к серверу базы данных в PDO применяется конструктор new PDO() , который принимает в качестве параметров настройки подключения:
new PDO("mysql:host=адрес_сервера;port=номер_порта;dbname=имя_базы_данных", "имя_пользователя", "пароль") - Сначала указывается строка подключечения, которая состоит из ряда настроек. Первая настройка — название драйвера базы данных. Так, в данном случае подключение осуществляется к MySQL, то тип баз данных будет mysql: . Далее идет настройка host , которая задает хост сервера, например, host=localhost (если сервер MySQL запущен локально). Затем дополнительно можно указать номер порта через параметр port . Если он не указан, то используется порт по умолчанию — для mysql это 3306. И далее идет настройка dbname , которая устанавливает имя базы данных. Кроме этих настроек строка подключения может включать еще ряд других, но это самые основные.
- Второй параметр задает имя пользователя MySQL
- Третий параметр устанавливает пароль для выше указанного пользователя
При успешном подключении вызов конструктора new PDO() возвращает созданный объект PDO, который представляет установленное подключение и через который мы сможем взавмодействовать с базой данных. Однако если установка подключения прошла неудачно (например, сервер базы данных недоступен, указаны неправильные имя пользователя и/или пароль, какая-то еще ошибка), то вызов конструктора генерирует исключение. Соответственно вызов данного конструктора лучше помещать в конструкцию try..catch
Определим простейший скрипт для подключения к серверу базы данных MySQL:
catch (PDOException $e) < echo "Connection failed: " . $e->getMessage(); > ?>
Здесь производится подключение к локальному серверу, поэтому в строке подключения параметр host имеет значение «localhost». Поскольку база данных пока не важна, то параметр dbname не указан. Подключение производится для пользователя — пользователя «root», для которого установлен пароль «mypassword».
«root» — это пользователь по умолчанию, который существует для сервера MySQL. А «mypassword» — пароль, установленный для этого пользователя. Естественно в каждом конкретном случае пароль для этого пользователя может отличаться. Однако если на сервере MySQL созданы другие пользователи, то можно указывать этих пользователей и их пароли.
При успешном подключении созданный объект PDO будет сохранен в переменную $conn , через которую мы затем сможем взаимодействовать с MySQL:
$conn = new PDO("mysql:host=localhost", "root", "mypassword"); Если произойдет ошибка, то будет сгенерировано исключение типа PDOException . Как и у других классов исключений с помощью метода getMessage() мы можем получить сообщение об ошибке.
И при успешном подключении мы увидим в браузере следующее сообщение:
А если произойдет ошибка, то браузер выведет сообщение об ошибке. Например, сообщение об ошибке при некорректном пароле:
Connection failed: SQLSTATE[HY000] [1045] Access denied for user ‘root’@’localhost’ (using password: YES)
Установка режима вывода ошибок
Если при взаимодействии с MySQL произойдет ошибка, то, как правило, ожидается, что мы получим сообщение об ошибке. Однако реальное поведение зависит от редима вывода ошибок, который установлен для объекта PDO. Режим вывода ошибок задается с помощью атрибута PDO::ATTR_ERRMODE , который может принимать следующие значения:
- PDO::ERRMODE_SILENT : PDO просто устанавливает код ошибки. Для получения которого и для получения информации об ошибке по которому необходимо было вызывать специальные методы. Поскольку при этом режиме необходимо вызывать дополнительные методы, то этот способ обычно рассматривался как не самый удобный. Он был значением по умолчанию до версии PHP 8.0.
- PDO::ERRMODE_WARNING : PDO генерирует сообщение типа E_WARNING . Обычно применяется при отладке или тестировании
- PDO::ERRMODE_EXCEPTION : PDO передает информацию об ошибке в объект PDOException, благодаря чему через блок catch в конструкции try..catch мы можем отловить ошибку и получить информацию об этом исключении. Этот режим применяется как режим по умолчанию начиная с версии PHP 8.0.
Если мы хотим получать информацию об ошибке через исключение PDOException и обрабатывать его в блоке catch , то нам нужно значение PDO::ERRMODE_EXCEPTION . В PHP 8.0 и выше это значение применяется по умолчанию, однако, если версия ниже 8.0, то необходимо это значение установить явным образом с помощью метода setAttribute() объекта PDO:
try < $conn = new PDO("mysql:host=localhost", "root", "mypassword"); // установка режима вывода ошибок $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo "Database connection established"; > catch (PDOException $e) < echo "Connection failed: " . $e->getMessage(); > Закрытие подключения
После завершения работы скрипта PHP автоматически закрывает открытые подключения к базе данных. Но может потребоваться закрыть подключение еще в процессе работы скрипта. В этом случае объекту PDO можно присвоить значение null :
$conn = null; // отключаемся от сервера базы данных
oci_connect
Returns a connection identifier needed for most other OCI8 operations.
For performance, most applications should use persistent connections with oci_pconnect() instead of oci_connect() . See Connection Handling for general information on connection management and connection pooling.
The second and subsequent calls to oci_connect() with the same parameters will return the connection handle returned from the first call. This means that transactions in one handle are also in the other handles, because they use the same underlying database connection. If two handles need to be transactionally isolated from each other, use oci_new_connect() instead.
Parameters
The password for username .
Contains the Oracle instance to connect to. It can be an » Easy Connect string, or a Connect Name from the tnsnames.ora file, or the name of a local Oracle instance.
If not specified or null , PHP uses environment variables such as TWO_TASK (on Linux) or LOCAL (on Windows) and ORACLE_SID to determine the Oracle instance to connect to.
To use the Easy Connect naming method, PHP must be linked with Oracle 10g or greater Client libraries. The Easy Connect string for Oracle 10g is of the form: [//]host_name[:port][/service_name]. From Oracle 11g, the syntax is: [//]host_name[:port][/service_name][:server_type][/instance_name]. Further options were introduced with Oracle 19c, including timeout and keep-alive settings. Refer to Oracle documentation. Service names can be found by running the Oracle utility lsnrctl status on the database server machine.
The tnsnames.ora file can be in the Oracle Net search path, which includes /your/path/to/instantclient/network/admin , $ORACLE_HOME/network/admin and /etc . Alternatively set TNS_ADMIN so that $TNS_ADMIN/tnsnames.ora is read. Make sure the web daemon has read access to the file.
Determines the character set used by the Oracle Client libraries. The character set does not need to match the character set used by the database. If it doesn’t match, Oracle will do its best to convert data to and from the database character set. Depending on the character sets this may not give usable results. Conversion also adds some time overhead.
If not specified, the Oracle Client libraries determine a character set from the NLS_LANG environment variable.
Passing this parameter can reduce the time taken to connect.
This parameter is available since version PHP 5 (PECL OCI8 1.1) and accepts the following values: OCI_DEFAULT , OCI_SYSOPER and OCI_SYSDBA . If either OCI_SYSOPER or OCI_SYSDBA were specified, this function will try to establish privileged connection using external credentials. Privileged connections are disabled by default. To enable them you need to set oci8.privileged_connect to On .
PHP 5.3 (PECL OCI8 1.3.4) introduced the OCI_CRED_EXT mode value. This tells Oracle to use External or OS authentication, which must be configured in the database. The OCI_CRED_EXT flag can only be used with username of «/» and a empty password. oci8.privileged_connect may be On or Off .
OCI_CRED_EXT may be combined with the OCI_SYSOPER or OCI_SYSDBA modes.
OCI_CRED_EXT is not supported on Windows for security reasons.
Return Values
Returns a connection identifier or false on error.