Verbesserte MySQL Erweiterung
Einführung
Die mysqli-Erweiterung ermöglicht Ihnen den Zugriff auf Funktionalitäten von MySQL 4.1 und höher. Weitere Informationen über den MySQL Datenbankserver finden Sie unter » https://www.mysql.com/
Die Dokumentation von MySQL finden Sie unter » https://dev.mysql.com/doc/
Diese Erweiterung ist EXPERIMENTELL. Das Verhalten dieser Erweiterung, einschließlich der Funktionsnamen, und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Erweiterung auf eigenes Risiko.
Anforderungen
Um die Funktionalitäten dieser Erweiterung nutzen zu können, müssen Sie PHP mit Unterstützung für mysqli kompilieren.
Hinweis: Die mysqli-Erweiterung wurde erstellt, um mit den MySQL-Versionen >= 4.1 zu arbeiten. Wenn Sie eine ältere Version verwenden, sollten Sie einen Blick auf die Dokumentation der mysql-Erweiterung werfen.
Installation
Um die mysqli-Erweiterung für PHP zu installieren, benutzen Sie den Schalter --with-mysqli=mysql_config_path/mysql_config, wobei mysql_config_path auf das Verzeichnis des mysql_config-Programms verweist, das bei MySQL-Versionen größer als 4.1 vorhanden ist.
Wenn Sie die Standard-MySQL-Erweiterung zusammen mit der mysqli-Erweiterung installieren möchten, müssen Sie für beide die gleiche Client-Bibliothek verwenden, um Konflikten vorzubeugen.
Installation auf Windows-Systemen
MySQLi ist nicht standardmäßig aktiviert, daher muss die php_mysqli.dll-DLL in der php.ini selbst aktiviert werden. Dafür benötigt PHP den Zugriff auf die MySQL client library. Eine Datei namens libmysql.dll ist bereits in der PHP-Distribution für Windows enthalten, und um die Kommunikation zwischen PHP und MySQL herzustellen, muss die Datei über die Windows-Systemvariable PATH erreichbar sein. Lesen Sie dazu auch den FAQ-Eintrag "Wie füge ich unter Windows PATH mein PHP-Verzeichnis hinzu?", um weitere Informationen über das dafür benötigte Vorgehen zu erhalten. Obwohl es auch möglich wäre, die libmysql.dll in das Windows-Systemverzeichnis zu kopieren, um die Datei ansprechen zu können (das Systemverzeichnis ist standardmäßig in der PATH-Variable enthalten), wird dieses Vorgehen keinesfalls empfohlen.
Hinweis: Um MySQL 5 anzusprechen, empfehlen wir, die passenden Binärdateien direkt von » https://dev.mysql.com/downloads/connector/php/ herunterzuladen.
Wie bei der Aktivierung jeder anderen PHP-Extension (wie z.B. php_mysqli.dll) sollte auch hier die PHP-Direktive extension_dir auf das Verzeichnis zeigen, in dem die vorhandenen PHP-Extensions liegen. Lesen Sie dazu auch den Abschnitt Manual Windows Installation Instructions. Ein entsprechender extension_dir-Wert für PHP 5 könnte zum Beispiel c:\php\ext sein.
Hinweis: Wenn beim Starten des Webservers ein Fehler ähnlich dem folgenden auftritt: "Unable to load dynamic library './php_mysqli.dll'", wird im Normalfall die php_mysqli.dll und/oder die libmysql.dll nicht vom System gefunden.
Laufzeit Konfiguration
Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.
Name | Standard | Änderbar | Changelog |
---|---|---|---|
mysqli.max_links | "-1" | PHP_INI_SYSTEM | verfügbar seit PHP 5.0.0 |
mysqli.default_port | 3306 | PHP_INI_ALL | verfügbar seit PHP 5.0.0 |
mysqli.default_socket | NULL | PHP_INI_ALL | verfügbar seit PHP 5.0.0 |
mysqli.default_host | NULL | PHP_INI_ALL | verfügbar seit PHP 5.0.0 |
mysqli.default_user | NULL | PHP_INI_ALL | verfügbar seit PHP 5.0.0 |
mysqli.default_pw | NULL | PHP_INI_ALL | verfügbar seit PHP 5.0.0 |
Für weitere Details und Definitionen über die oben genannten PHP_INI_*-Konstanten sehen Sie im Kapitel über Konfigurations-Änderungen nach.
Hier eine kurze Erklärung der Konfigurationsoptionen:
- mysqli.max_links integer
-
Die maximale Anzahl von MySQL-Verbindungen pro Prozess.
- mysqli.default_port string
-
Die Standard-TCP-Portnummer, die benutzt werden soll, wenn eine Verbindung zum Datenbankserver aufgenommen werden soll und kein anderer Port explizit angegeben wurde. Wenn hier kein Standardport angegeben wird, wird der Port aus der MYSQL_TCP_PORT Umgebungs-Variable, dem mysql-tcp-Eintrag in der /etc/services oder der compile-time MYSQL_PORT-Konstante (in dieser Reihenfolge) verwendet.
- mysqli.default_socket string
-
Der Standard-Socketname, der beim Verbindungsaufbau zu einem lokalen Datenbankserver verwendet wird, sofern kein anderer Socketname angegeben wurde.
- mysqli.default_host string
-
Der Standard-Server-Host, der beim Verbindungsaufbau zu einem lokalen Datenbankserver verwendet wird, sofern kein anderer Host angegeben wurde. Funktioniert nicht im Safe Mode.
- mysqli.default_user string
-
Der Standard-Username, der beim Verbindungsaufbau zu einem lokalen Datenbankserver verwendet wird, sofern kein anderer Name angegeben wurde. Funktioniert nicht im Safe Mode.
- mysqli.default_password string
-
Das Standard-Passwort, das beim Verbindungsaufbau zu einem lokalen Datenbankserver verwendet wird, sofern kein anderes Passwort angegeben wurde. Funktioniert nicht im Safe Mode.
Resource Typen
mysqli_link
Stellt eine Verbindung zwischen PHP und einer MySQL-Datenbank dar.
mysqli_stmt
Stellt eine vorbereitete Anfrage dar.
mysqli_result
Stellt den Ergebnissatz einer zuvor ausgeführten Anfrage an die Datenbank dar.
Vordefinierte Konstanten
Name | Beschreibung |
---|---|
MYSQLI_READ_DEFAULT_GROUP (integer) | |
MYSQLI_READ_DEFAULT_FILE (integer) | |
MYSQLI_OPT_CONNECT_TIMEOUT (integer) | |
MYSQLI_OPT_LOCAL_INFILE (integer) | |
MYSQLI_INIT_COMMAND (integer) | |
MYSQLI_CLIENT_SSL (integer) | |
MYSQLI_CLIENT_COMPRESS (integer) | |
MYSQLI_CLIENT_INTERACTIVE (integer) | |
MYSQLI_CLIENT_IGNORE_SPACE (integer) | |
MYSQLI_CLIENT_NO_SCHEMA (integer) | |
MYSQLI_CLIENT_MULTI_QUERIES (integer) | |
MYSQLI_STORE_RESULT (integer) | |
MYSQLI_USE_RESULT (integer) | |
MYSQLI_ASSOC (integer) | |
MYSQLI_NUM (integer) | |
MYSQLI_BOTH (integer) | |
MYSQLI_NOT_NULL_FLAG (integer) | |
MYSQLI_PRI_KEY_FLAG (integer) | |
MYSQLI_UNIQUE_KEY_FLAG (integer) | |
MYSQLI_MULTIPLE_KEY_FLAG (integer) | |
MYSQLI_BLOB_FLAG (integer) | |
MYSQLI_UNSIGNED_FLAG (integer) | |
MYSQLI_ZEROFILL_FLAG (integer) | |
MYSQLI_AUTO_INCREMENT_FLAG (integer) | |
MYSQLI_TIMESTAMP_FLAG (integer) | |
MYSQLI_SET_FLAG (integer) | |
MYSQLI_NUM_FLAG (integer) | |
MYSQLI_PART_KEY_FLAG (integer) | |
MYSQLI_GROUP_FLAG (integer) | |
MYSQLI_TYPE_DECIMAL (integer) | |
MYSQLI_TYPE_TINY (integer) | |
MYSQLI_TYPE_SHORT (integer) | |
MYSQLI_TYPE_LONG (integer) | |
MYSQLI_TYPE_FLOAD (integer) | |
MYSQLI_TYPE_DOUBLE (integer) | |
MYSQLI_TYPE_NULL (integer) | |
MYSQLI_TYPE_TIMESTAMP (integer) | |
MYSQLI_TYPE_LONGLONG (integer) | |
MYSQLI_TYPE_INT24 (integer) | |
MYSQLI_TYPE_DATE (integer) | |
MYSQLI_TYPE_TIME (integer) | |
MYSQLI_TYPE_DATETIME (integer) | |
MYSQLI_TYPE_YEAR (integer) | |
MYSQLI_TYPE_NEWDATE (integer) | |
MYSQLI_TYPE_ENUM (integer) | |
MYSQLI_TYPE_SET (integer) | |
MYSQLI_TYPE_TINY_BLOB (integer) | |
MYSQLI_TYPE_MEDIUM_BLOB (integer) | |
MYSQLI_TYPE_LONG_BLOB (integer) | |
MYSQLI_TYPE_BLOB (integer) | |
MYSQLI_TYPE_VAR_STRING (integer) | |
MYSQLI_TYPE_STRING (integer) | |
MYSQLI_TYPE_CHAR (integer) | |
MYSQLI_TYPE_INTERVAL (integer) | |
MYSQLI_TYPE_GEOMETRY (integer) | |
MYSQLI_BIND_STRING (integer) | |
MYSQLI_BIND_INT (integer) | |
MYSQLI_BIND_DOUBLE (integer) | |
MYSQLI_BIND_SEND_DATA (integer) | |
MYSQLI_RPL_MASTER (integer) | |
MYSQLI_RPL_SLAVE (integer) | |
MYSQLI_RPL_ADMIN (integer) | |
MYSQLI_NEED_DATA (integer) | |
MYSQLI_NO_DATA (integer) | |
MYSQLI_PR_REPORT_STDERR (integer) | |
MYSQLI_PR_REPORT_PORT (integer) | |
MYSQLI_PR_REPORT_FILE (integer) |
Inhaltsverzeichnis
- mysqli_affected_rows — Gets the number of affected rows in a previous MySQL operation
- mysqli_autocommit — Turns on or off auto-commiting database modifications
- mysqli_bind_param — Alias for mysqli_stmt_bind_param
- mysqli_bind_result — Alias for mysqli_stmt_bind_result
- mysqli_change_user — Changes the user of the specified database connection
- mysqli_character_set_name — Returns the default character set for the database connection
- mysqli_client_encoding — Alias of mysqli_character_set_name
- mysqli_close — Closes a previously opened database connection
- mysqli_commit — Commits the current transaction
- mysqli_connect_errno — Returns the error code from last connect call
- mysqli_connect_error — Returns a string description of the last connect error
- mysqli_connect — Open a new connection to the MySQL server
- mysqli_data_seek — Adjusts the result pointer to an arbitary row in the result
- mysqli_debug — Performs debugging operations
- mysqli_disable_reads_from_master — Disable reads from master
- mysqli_disable_rpl_parse — Disable RPL parse
- mysqli_dump_debug_info — Dump debugging information into the log
- mysqli_embedded_server_end — Beschreibung
- mysqli_embedded_server_start — Beschreibung
- mysqli_enable_reads_from_master — Enable reads from master
- mysqli_enable_rpl_parse — Enable RPL parse
- mysqli_errno — Returns the error code for the most recent function call
- mysqli_error — Returns a string description of the last error
- mysqli_escape_string — Alias of mysqli_real_escape_string
- mysqli_execute — Alias for mysqli_stmt_execute
- mysqli_fetch_array — Fetch a result row as an associative, a numeric array, or both
- mysqli_fetch_assoc — Fetch a result row as an associative array
- mysqli_fetch_field_direct — Fetch meta-data for a single field
- mysqli_fetch_field — Returns the next field in the result set
- mysqli_fetch_fields — Returns an array of objects representing the fields in a result set
- mysqli_fetch_lengths — Returns the lengths of the columns of the current row in the result set
- mysqli_fetch_object — Returns the current row of a result set as an object
- mysqli_fetch_row — Get a result row as an enumerated array
- mysqli_fetch — Alias for mysqli_stmt_fetch
- mysqli_field_count — Returns the number of columns for the most recent query
- mysqli_field_seek — Set result pointer to a specified field offset
- mysqli_field_tell — Get current field offset of a result pointer
- mysqli_free_result — Frees the memory associated with a result
- mysqli_get_charset — Returns a character set object
- mysqli_get_client_info — Returns the MySQL client version as a string
- mysqli_get_client_version — Get MySQL client info
- mysqli_get_host_info — Returns a string representing the type of connection used
- mysqli_get_metadata — Alias for mysqli_stmt_result_metadata
- mysqli_get_proto_info — Returns the version of the MySQL protocol used
- mysqli_get_server_info — Returns the version of the MySQL server
- mysqli_get_server_version — Returns the version of the MySQL server as an integer
- mysqli_get_warnings — Beschreibung
- mysqli_info — Retrieves information about the most recently executed query
- mysqli_init — Initializes MySQLi and returns a resource for use with mysqli_real_connect()
- mysqli_insert_id — Returns the auto generated id used in the last query
- mysqli_kill — Asks the server to kill a MySQL thread
- mysqli_master_query — Enforce execution of a query on the master in a master/slave setup
- mysqli_more_results — Check if there are any more query results from a multi query
- mysqli_multi_query — Performs a query on the database
- mysqli_next_result — Prepare next result from multi_query
- mysqli_num_fields — Get the number of fields in a result
- mysqli_num_rows — Gets the number of rows in a result
- mysqli_options — Set options
- mysqli_param_count — Alias for mysqli_stmt_param_count
- mysqli_ping — Pings a server connection, or tries to reconnect if the connection has gone down
- mysqli_prepare — Prepare a SQL statement for execution
- mysqli_query — Performs a query on the database
- mysqli_real_connect — Opens a connection to a mysql server
- mysqli_real_escape_string — Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection
- mysqli_real_query — Execute an SQL query
- mysqli_report — Enables or disables internal report functions
- mysqli_rollback — Rolls back current transaction
- mysqli_rpl_parse_enabled — Check if RPL parse is enabled
- mysqli_rpl_probe — RPL probe
- mysqli_rpl_query_type — Returns RPL query type
- mysqli_select_db — Selects the default database for database queries
- mysqli_send_long_data — Alias for mysqli_stmt_send_long_data
- mysqli_send_query — Send the query and return
- mysqli_server_end — Shut down the embedded server
- mysqli_server_init — Initialize embedded server
- mysqli_set_charset — Sets the default client character set
- mysqli_set_local_infile_default — Unsets user defined handler for load local infile command
- mysqli_set_local_infile_handler — Set callback functions for LOAD DATA LOCAL INFILE command
- mysqli_set_opt — Alias of mysqli_options
- mysqli_slave_query — Force execution of a query on a slave in a master/slave setup
- mysqli_sqlstate — Returns the SQLSTATE error from previous MySQL operation
- mysqli_ssl_set — Used for establishing secure connections using SSL
- mysqli_stat — Gets the current system status
- mysqli_stmt_affected_rows — Returns the total number of rows changed, deleted, or inserted by the last executed statement
- mysqli_stmt_attr_get — Beschreibung
- mysqli_stmt_attr_set — Beschreibung
- mysqli_stmt_bind_param — Binds variables to a prepared statement as parameters
- mysqli_stmt_bind_result — Binds variables to a prepared statement for result storage
- mysqli_stmt_close — Closes a prepared statement
- mysqli_stmt_data_seek — Seeks to an arbitray row in statement result set
- mysqli_stmt_errno — Returns the error code for the most recent statement call
- mysqli_stmt_error — Returns a string description for last statement error
- mysqli_stmt_execute — Executes a prepared Query
- mysqli_stmt_fetch — Fetch results from a prepared statement into the bound variables
- mysqli_stmt_field_count — Returns the number of field in the given statement
- mysqli_stmt_free_result — Frees stored result memory for the given statement handle
- mysqli_stmt_get_warnings — Beschreibung
- mysqli_stmt_init — Initializes a statement and returns an object for use with mysqli_stmt_prepare
- mysqli_stmt_insert_id — Get the ID generated from the previous INSERT operation
- mysqli_stmt_num_rows — Return the number of rows in statements result set
- mysqli_stmt_param_count — Returns the number of parameter for the given statement
- mysqli_stmt_prepare — Prepare a SQL statement for execution
- mysqli_stmt_reset — Resets a prepared statement
- mysqli_stmt_result_metadata — Returns result set metadata from a prepared statement
- mysqli_stmt_send_long_data — Send data in blocks
- mysqli_stmt_sqlstate — Returns SQLSTATE error from previous statement operation
- mysqli_stmt_store_result — Transfers a result set from a prepared statement
- mysqli_store_result — Transfers a result set from the last query
- mysqli_thread_id — Returns the thread ID for the current connection
- mysqli_thread_safe — Returns whether thread safety is given or not
- mysqli_use_result — Initiate a result set retrieval
- mysqli_warning_count — Returns the number of warnings from the last query for the given link