com doc/ru: Обновлен ие до англи йской верси и: reference/filesystem/functions/dirname.xml refe
rence/mysqli/mysqli/connect-errno.xml reference/mysqli/mysq li/connect-error.xml reference/mysqli/mysqli/init.xml r
eference/mysqli/mysqli_stmt/get-result.xml reference/mysq linfo/concepts.xml reference/openssl/functions/openssl-pkcs 7-verify.xml

From: Date: Sun, 21 Feb 2021 14:12:14 +0000
Subject: com doc/ru: Обновлен ие до англи йской верси и: reference/filesystem/functions/dirname.xml refe
rence/mysqli/mysqli/connect-errno.xml reference/mysqli/mysq li/connect-error.xml reference/mysqli/mysqli/init.xml r
eference/mysqli/mysqli_stmt/get-result.xml reference/mysq linfo/concepts.xml reference/openssl/functions/openssl-pkcs 7-verify.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-8812@lists.php.net to get a copy of this message
Commit: 3ca9eb6e2f080b9f40487ca81a26a5f139b18307 Author: Sergey Panteleev <sergey@php.net> Sun, 21 Feb 2021 17:12:14 +0300 Parents: bc16ef73e397bb1a9e955ce6ca80ec2626c1876b Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=3ca9eb6e2f080b9f40487ca81a26a5f139b18307 Log: Обновление до английской версии Changed paths: M reference/filesystem/functions/dirname.xml M reference/mysqli/mysqli/connect-errno.xml M reference/mysqli/mysqli/connect-error.xml M reference/mysqli/mysqli/init.xml M reference/mysqli/mysqli_stmt/get-result.xml M reference/mysqlinfo/concepts.xml M reference/openssl/functions/openssl-pkcs7-verify.xml

diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml index 6b80ce7f6..58556020f 100644 --- a/reference/filesystem/functions/dirname.xml +++ b/reference/filesystem/functions/dirname.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: af6fdf16ab44bcf4d045407963e43c3d9dd2ff29 Maintainer: shein Status: ready --> +<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.dirname"> @@ -29,10 +29,15 @@ </note> <caution> <para> - <function>dirname</function> учитывает настройки локали, поэтому - для корректной обработки пути с многобайтовыми символами должна - быть установлена соответствующая локаль с помощью функции - <function>setlocale</function>. + В Windows <function>dirname</function> предполагает текущую установленную + кодовую страницу, поэтому для того, чтобы видеть правильное имя каталога + с путями многобайтовых символов, необходимо установить соответствующую кодовую страницу. + Если <parameter>path</parameter> содержит символы, недопустимые для текущей + кодовой страницы, поведение <function>basename</function> не определено. + </para> + <para> + В других системах <function>dirname</function> предполагает, что <parameter>path</parameter> + закодирован в кодировке, совместимой с ASCII. В противном случае поведение функции не определено. </para> </caution> </refsect1> diff --git a/reference/mysqli/mysqli/connect-errno.xml b/reference/mysqli/mysqli/connect-errno.xml index 3499c8f51..f97557dd0 100644 --- a/reference/mysqli/mysqli/connect-errno.xml +++ b/reference/mysqli/mysqli/connect-errno.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 1e1c3f01a2486b1f02faeef8f237972031ada307 Maintainer: bfl Status: ready --> +<!-- EN-Revision: efaedacb533200d9007d704d07e624b27c946036 Maintainer: bfl Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="mysqli.connect-errno" xmlns="http://docbook.org/ns/docbook"> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <para>&style.oop;</para> - <fieldsynopsis><type>int</type><varname linkend="mysqli.connect-errno">mysqli->connect_errno</varname></fieldsynopsis> + <fieldsynopsis><modifier>static</modifier> <type>int</type><varname linkend="mysqli.connect-errno">mysqli->connect_errno</varname></fieldsynopsis> <para>&style.procedural;</para> <methodsynopsis> <type>int</type><methodname>mysqli_connect_errno</methodname> diff --git a/reference/mysqli/mysqli/connect-error.xml b/reference/mysqli/mysqli/connect-error.xml index 1e525bc56..7c83833ed 100644 --- a/reference/mysqli/mysqli/connect-error.xml +++ b/reference/mysqli/mysqli/connect-error.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a714378ed87cdbdbde3b10ded183e8df7b243cb4 Maintainer: aur Status: ready --> +<!-- EN-Revision: efaedacb533200d9007d704d07e624b27c946036 Maintainer: aur Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="mysqli.connect-error" xmlns="http://docbook.org/ns/docbook"> @@ -12,7 +12,7 @@ <refsect1 role="description"> &reftitle.description; <para>&style.oop;</para> - <fieldsynopsis><type>string</type><varname linkend="mysqli.connect-error">mysqli->connect_error</varname></fieldsynopsis> + <fieldsynopsis><modifier>static</modifier> <type>string</type><varname linkend="mysqli.connect-error">mysqli->connect_error</varname></fieldsynopsis> <para>&style.procedural;</para> <methodsynopsis> <type>string</type><methodname>mysqli_connect_error</methodname> diff --git a/reference/mysqli/mysqli/init.xml b/reference/mysqli/mysqli/init.xml index 2afa6ff53..5649d4dc2 100644 --- a/reference/mysqli/mysqli/init.xml +++ b/reference/mysqli/mysqli/init.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: cea4f10f29c1e2ede3e5f42d0843195c17059362 Maintainer: tmn Status: ready --> +<!-- EN-Revision: 93577455fee1d0ab9d76350f500670b37216a66f Maintainer: tmn Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="mysqli.init" xmlns="http://docbook.org/ns/docbook"> @@ -26,8 +26,7 @@ </methodsynopsis> <para> Выделяет память или инициализирует объект MYSQL, пригодный для использования в - функциях <function>mysqli_options</function> и - <function>mysqli_real_connect</function>. + функциях <function>mysqli_options</function>. </para> <note> <para> diff --git a/reference/mysqli/mysqli_stmt/get-result.xml b/reference/mysqli/mysqli_stmt/get-result.xml index 101ecfeea..e181759d0 100644 --- a/reference/mysqli/mysqli_stmt/get-result.xml +++ b/reference/mysqli/mysqli_stmt/get-result.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: ac2f69b3d07ae6a4e89a742918b01881b7381bf4 Maintainer: bfl Status: ready --> +<!-- EN-Revision: b65a894b956f1a2aa99380afc6194944ccb1fa9f Maintainer: bfl Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="mysqli-stmt.get-result" xmlns="http://docbook.org/ns/docbook"> @@ -38,10 +38,14 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Возвращает результат для успешных запросов типа SELECT и &false; для - любых запросов DML (INSERT, UPDATE, DELETE), либо в случае ошибки. - Для точного установления причины получения &false; необходимо воспользоваться - функцией <function>mysqli_errno</function>. + Возвращает &false; в случае возникновения ошибки. Для успешных запросов, + которые производят набор результатов, таких как <literal>SELECT, SHOW, DESCRIBE</literal> или + <literal>EXPLAIN</literal> <function>mysqli_stmt_get_result</function> + вернёт объект <classname>mysqli_result</classname>. Для других успешных запросов + <function>mysqli_stmt_get_result</function> вернёт &false;. + Функцию <function>mysqli_stmt_errno</function> можно использовать, чтобы + различать две причины появления &false;; из-за ошибки до PHP 7.4.13 для этой цели + приходилось использовать <function>mysqli_errno</function>. </para> </refsect1> diff --git a/reference/mysqlinfo/concepts.xml b/reference/mysqlinfo/concepts.xml index 6ff41d073..b27191a6d 100644 --- a/reference/mysqlinfo/concepts.xml +++ b/reference/mysqlinfo/concepts.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: ee4558e955136c5a1dd8d6c34a61d786977ffd1c Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 383a659e1f0f7aa3330b31a095a1e927611d4c71 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <chapter xml:id="mysqlinfo.concepts" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Основные понятия</title> @@ -75,7 +75,6 @@ if ($uresult) { echo $row['Name'] . PHP_EOL; } } -$uresult->close(); ?> ]]> </programlisting> @@ -99,25 +98,6 @@ if ($uresult) { ]]> </programlisting> </example> - - <example> - <title>Пример небуферизированного запроса: mysql</title> - <programlisting role="php"> -<![CDATA[ -<?php -$conn = mysql_connect("localhost", "my_user", "my_pass"); -$db = mysql_select_db("world"); - -$uresult = mysql_unbuffered_query("SELECT Name FROM City"); -if ($uresult) { - while ($row = mysql_fetch_assoc($uresult)) { - echo $row['Name'] . PHP_EOL; - } -} -?> -]]> - </programlisting> - </example> </section> <section xml:id="mysqlinfo.concepts.charset"> @@ -137,8 +117,7 @@ if ($uresult) { <para> Кодировка символов должна быть чётко определена, поскольку влияет на каждое действие, в том числе на действия с последствиями для безопасности. - Например, механизмы экранирования (такие как <function>mysqli_real_escape_string</function> для mysqli, <function>mysql_real_escape_string</function> - для mysql и <methodname>PDO::quote</methodname> для PDO_MySQL) зависят от этих настроек. + Например, механизмы экранирования (такие как <function>mysqli_real_escape_string</function> для mysqli и <methodname>PDO::quote</methodname> для PDO_MySQL) зависят от этих настроек. Важно понимать, что эти функции не используют кодировку символов определённую в запросе, так например, следующие запросы не будут влиять на поведение этих функций: </para> </caution> @@ -162,7 +141,6 @@ $mysqli->set_charset('utf8mb4'); // а этот НЕ повлияет, потому что нельзя использовать "-" $mysqli->set_charset('UTF-8'); // (utf8mb4, а не UTF-8) - ?> ]]> </programlisting> @@ -189,16 +167,14 @@ $mysqli->set_charset('UTF-8'); // (utf8mb4, а не UTF-8) <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -printf("Первоначальная кодировка: %s\n", $mysqli->character_set_name()); +echo 'Первоначальная кодировка: ' . $mysqli->character_set_name() . "\n"; if (!$mysqli->set_charset('utf8mb4')) { printf("Ошибка загрузки кодировки utf8mb4: %s\n", $mysqli->error); exit; } -echo "Информация о новой кодировки:\n"; -print_r( $mysqli->get_charset() ); - +echo 'Ваша текущая кодировка: ' . $mysqli->character_set_name() . "\n"; ?> ]]> </programlisting> @@ -206,9 +182,6 @@ print_r( $mysqli->get_charset() ); <example> <title>Пример установки кодировки символов: <link linkend="ref.pdo-mysql.connection">pdo_mysql</link></title> - <para> - Примечание: Это работает только с PHP 5.3.6. - </para> <programlisting role="php"> <![CDATA[ <?php @@ -217,27 +190,6 @@ $pdo = new PDO("mysql:host=localhost;dbname=world;charset=utf8mb4", 'my_user', ' ]]> </programlisting> </example> - - <example> - <title>Пример установки кодировки символов: mysql</title> - <programlisting role="php"> -<![CDATA[ -<?php -$conn = mysql_connect("localhost", "my_user", "my_pass"); -$db = mysql_select_db("world"); - -echo 'Первоначальная кодировка: ' . mysql_client_encoding($conn) . "\n"; - -if (!mysql_set_charset('utf8mb4', $conn)) { - echo "Ошибка: не удаётся установить кодировку.\n"; - exit; -} - -echo 'Ваша текущая кодировка: ' . mysql_client_encoding($conn); -?> -]]> - </programlisting> - </example> </section> </chapter> diff --git a/reference/openssl/functions/openssl-pkcs7-verify.xml b/reference/openssl/functions/openssl-pkcs7-verify.xml index ab084c073..0985fc04a 100644 --- a/reference/openssl/functions/openssl-pkcs7-verify.xml +++ b/reference/openssl/functions/openssl-pkcs7-verify.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 7ae2b3f82dfae417a0107b69a1ae7d7658652a7a Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <refentry xml:id="function.openssl-pkcs7-verify" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -124,35 +124,17 @@ <parameter>content</parameter> и <parameter>output_filename</parameter> теперь допускают значение null. </entry> </row> + <row> + <entry>7.2.0</entry> + <entry> + Добавлен параметр <parameter>output_filename</parameter>. + </entry> + </row> </tbody> </tgroup> </informaltable> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>7.2.0</entry> - <entry> - Добавлен параметр <parameter>output_filename</parameter>. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="notes"> &reftitle.notes; <note>
« previous php.doc.ru (#8812) next »